Contexto Estruturado é Tudo
Claude Code só é poderoso quando entende profundamente o seu projeto. 11 agentes especializados capturam o substrato de engenharia de software em documentação modular otimizada.
Claude Code é uma ferramenta incrível, mas tem uma dependência crítica: CONTEXTO
Você já percebeu que às vezes o Claude Code gera código que não segue os padrões do seu projeto? Ou sugere arquiteturas completamente diferentes do que você usa?
Não é falha do Claude. É falta de contexto estruturado sobre o substrato de engenharia do seu projeto.
São as camadas fundamentais que definem como seu software é construído, testado, implantado e mantido. É o DNA do seu projeto.
Como seu sistema é estruturado? REST ou GraphQL? Microserviços ou monolito? Que padrões você segue?
Como você configura o ambiente? Docker? Kubernetes? Que variáveis de ambiente são críticas?
Como você escreve código? Que idiomática segue? Como gerencia concorrência e memória?
Como você testa? Que frameworks usa? Qual coverage esperado? Como rodam os testes?
Como você persiste dados? PostgreSQL? MongoDB? Como faz migrations? Cache strategies?
Como você autentica? JWT? OAuth? Como gerencia secrets? Certificados SSL?
Em vez de tentar explicar tudo manualmente para o Claude Code toda vez, estruture o substrato de engenharia uma única vez usando agentes especializados.
Cada agente faz perguntas abertas inteligentes e análise automática para capturar um aspecto específico do substrato, gerando documentação modular otimizada.
Resultado: Claude Code trabalha como um membro sênior do seu time que conhece TUDO sobre o projeto
Cada agente é especializado em uma dimensão do substrato de engenharia de software
Visão de negócio, domínio, métricas, stakeholders, objetivos
/swe-substrate-project-context
Docker, IaC, env vars, scripts de setup, toolchain
/swe-substrate-tooling-config
Convenções de código, concorrência, memória, guidelines
/swe-substrate-languages
REST, GraphQL, gRPC, versionamento, contratos, endpoints
/swe-substrate-api-design
Unitários, integração, E2E, coverage, mocks, fixtures
/swe-substrate-testing-strategy
Daemons, workers, schedulers, LLM agents, queue systems
/swe-substrate-agents
npm, pip, cargo, dependências, versionamento, lockfiles
/swe-substrate-package-mgmt
Logs, métricas, traces, monitoring, alertas, dashboards
/swe-substrate-observability
Databases, schemas, migrations, cache, storage, backups
/swe-substrate-data
Autenticação, autorização, secrets, certificados, compliance
/swe-substrate-security
Comentários, diagramas, ADRs, RFCs, knowledge base
/swe-substrate-documentation
git clone https://github.com/zarathon/swe-substrate-agents.git
cd swe-substrate-agents
cp -r .claude /seu-projeto/
/swe-substrate-init
Ele lista todos os agentes disponíveis e explica o sistema
/swe-substrate-languages
/swe-substrate-testing-strategy
/swe-substrate-data
/swe-substrate-security
Execute apenas os agentes relevantes para seu projeto. Cada um fará perguntas abertas.
Os agentes combinam análise automática do código com suas respostas para gerar documentação estruturada em .claude/swe-substrate/
Documentação cresce sem limites. Cada módulo é independente e pode ser atualizado separadamente.
Fácil de navegar, atualizar e revisar. Sem arquivo CLAUDE.md monolítico gigante.
Menos conflitos em PRs. Times podem trabalhar em módulos diferentes simultaneamente.
Claude Code carrega apenas o contexto relevante para cada tarefa, otimizando velocidade.