Objetivo
Explorar orquestração modular de agentes para produzir mudanças em websites de forma mais consistente, revisável e segura do que uma geração única e direta.
agentes · automação self-hosted
AI Agent Infrastructure
Arquitetura sanitizada de um sistema self-hosted com múltiplos estágios para gerar, refinar, validar, publicar previews e versionar mudanças em websites de forma revisável.
Visão geral
Um sistema de geração assistida tratado como fluxo de engenharia, não como prompt único.
Este projeto documenta uma arquitetura em que diferentes agentes participam de etapas distintas de pesquisa, contexto, planejamento visual, desenvolvimento, refinamento, validação e preview. A versão pública descreve o desenho do sistema sem expor segredos, credenciais ou detalhes sensíveis da infraestrutura real.
Abordagem
Separar contexto, planejamento, geração, refinamento e QA em etapas distintas, com preview publicável e branch isolada por tarefa antes de qualquer merge.
Estado
Projeto além da fase puramente conceitual, com fluxo já exercitado na prática e documentado em forma pública sanitizada.
Fluxo documentado
1. Research
Coleta de informações iniciais e entendimento do objetivo da mudança.
2. Context Builder
Injeção de identidade persistente do site, regras editoriais e limites de conteúdo antes da geração.
3. Design Planner
Definição de direção visual, seções, hierarquia e notas de interface antes do código.
4. Development
Geração das alterações estruturais e implementação inicial da página ou ajuste solicitado.
5. UI Refinement
Polimento da interface com foco em espaçamento, tipografia, cards, botões e acabamento visual.
6. QA + Preview + Git
Validação, deploy de preview, criação de branch isolada e revisão humana antes do merge.
Decisões importantes de arquitetura
Identidade persistente do site
A introdução de um documento estável de identidade melhorou a consistência entre gerações e reduziu desvios editoriais.
Homepage como manifesto
A homepage deixou de ser apenas uma lista de projetos e passou a funcionar como entrada editorial e filosófica para o restante do site.
Git como fronteira de revisão
Cada mudança gerada pode ser isolada em sua própria branch, facilitando inspeção, comparação e aprovação humana antes de estabilizar a alteração.
Separação público / privado
A documentação pública existe para explicar o sistema com segurança, sem misturar repositórios, runtime real e segredos operacionais.
Repositório
Explorar a documentação pública do projeto
O repositório reúne visão arquitetural, fluxo de trabalho, decisões de design do sistema e exemplos seguros do pipeline documentado.