Orquestre agentes de IA com checkpoints, não com prompts soltos
CodeSteer instala uma squad cognitiva no repositório: spec, plano, código e QA via filesystem, com gates humanos antes de cada escrita.
Camada operacional em .memory-bank/ · implantação guiada pela consultoria
spec.md — escopo e critérios de aceite · aprovado por você
plan.md + task.md — arquivos e estratégia · aprovado por você
código + testes — escopo travado · code-review: APROVAR
PR aberta pela squad — o merge é sempre seu
Cada passo vira artefato auditável no repositório. Ver o pipeline completo
Compatível com sua IDE
Cursor
Claude Code
GitHub Copilot
Antigravity
Kiro
CodexMais que um assistente. Uma squad com handoffs no filesystem.
Agentes genéricos editam tudo de uma vez. O CodeSteer separa Product Owner, Planner, Implementer e QA, cada um escrevendo artefatos em .memory-bank/.
Handoffs via filesystem
Comunicação assíncrona com relatórios markdown persistentes.
Escopo travado por agente
Cada agente só grava onde repo_write_scope permite.
Squad vs IA tradicional
IA genérica
Um prompt, quatro arquivos alterados, testes quebrados, zero documentação.
CodeSteer
spec.md aprovado → plan.md → código com escopo travado → QA local. Tudo auditável.
Orquestração centralizada
Orquestrador
codesteer.orchestrator — classifica o track, mantém state.yaml, delega cada fase e para nos gates humanos.
Fase 1
Definição
- product-manager (opcional)
- spec
- artifact-reviewer
- architect (se exigido)
prd.md · spec.md · architecture.md
Fase 2
Planejamento
- planner
- artifact-reviewer
plan.md · task.md
Fase 3
Execução
- implementer
- verifier (por risco)
- code-reviewer
- tester (por risco)
código · delivery.md · quality.md · code-review.md
Fase 4
Fechamento
- task-retrospective
retrospective.md · commit + PR governados
Suporte em qualquer fase: debugger — RCA, auto-healing e caça-regressão.
A squad abre a PR; o merge é sempre humano.
Pipeline SDD
Quatro fases de execução, com checkpoints HITL obrigatórios por padrão antes do plano e do código — a autonomia só aumenta quando você autoriza, com registro auditável.
1. Definição & Spec
O fluxo se inicia com o pedido do desenvolvedor. O orquestrador classifica a complexidade (score 0–7+) e aciona product-manager, codesteer.spec e codesteer.artifact-reviewer (perfil spec) para PRD e TSD. Nenhuma linha de código é alterada nesta fase.
Entradas
- Pedido do usuário
- Memory Bank (.memory-bank/)
- Arquitetura existente
Saídas
- prd.md (Product Requirements)
- spec.md (Technical Specs)
- spec-review.md
Como confiar no código gerado?
Velocidade sem governança quebra produção. CodeSteer prioriza gates humanos, escopo isolado e QA local.
Checkpoints HITL
A IA pausa para aprovação de spec e plano antes de editar código.
Isolamento de escopo
Escrita restrita via
repo_write_scopeno state.yaml.QA local
Testes e regressão rodam no repositório antes da entrega.
Handoffs auditáveis
Tudo registrado no filesystem, sem caixa preta.
PR governada, merge humano
A squad abre a PR com evidências dos gates; o merge é sempre decisão sua.
Comparativo de Ciclo de Confiança
| Característica | IA Tradicional na IDE | CodeSteer Squad AI |
|---|---|---|
| Confirmação de Escopo | Improvise e escreva na hora | Especificação formal (spec.md) com HITL |
| Planejamento de Código | Inexistente (sai escrevendo) | Plano técnico isolado (plan.md) com HITL |
| Escopo de Escrita | Todo o repositório aberto | Restrito via `repo_write_scope` no state.yaml |
| Testes de Regressão | O desenvolvedor precisa testar manualmente | O Agente QA cria e executa testes locais |
| Fechamento da Entrega | Commits soltos, sem rastreabilidade | Commit e PR governados; merge sempre humano |
Os agentes da squad
Doze subagentes especializados cobrem orquestração, definição, planejamento, construção e fechamento — cada um com escopo travado no filesystem e responsabilidade única no pipeline.
Orquestrador (Cérebro da Squad)
Agente especializadoMissão
Conduzir o pipeline CodeSteer: recuperar ou criar slug em `.memory-bank/specs/{slug}/`, selecionar track, delegar fases reais, validar reports/blockers, atualizar state.yaml e parar apenas em hitl, done ou blocked.
Lê
- Pedido do desenvolvedor
- state.yaml e artefatos canônicos
- Reports e blockers das fases
Escreve
- Roteamento de track (HOTFIX, BUGFIX, TASK, FEATURE, EPIC)
- Score de complexidade (0–7+)
- state.yaml atualizado
- Orquestração de handoffs entre agentes
Trilhas dinâmicas
- HOTFIX / BUGFIX: debugger primeiro, checkpoints simplificados para correções.
- TASK: planner (plan.md + task.md) → implementer → code-reviewer.
- FEATURE / EPIC: squad completa com spec, artifact-reviewer, architect, planner e gates HITL.
Apenas artefatos canônicos em `.memory-bank/specs/{slug}/**`Estado persistido vence narrativa — adapta a profundidade do pipeline ao tamanho real do problema.
A squad entrega. O segundo cérebro lembra.
Sem curadoria, o conhecimento de cada entrega evapora em threads de chat e na memória de quem participou. A Base Cognitiva transforma decisões, regras e lições em um segundo cérebro do projeto: notas em Markdown versionadas no repositório, conectadas por wikilinks e navegáveis no Obsidian com Graph View.
O agente propõe, o humano valida
Mesma governança da squad: nenhuma nota vira conhecimento aprovado sem revisão sua.
Markdown no repositório, sem lock-in
Versionado no Git junto do código — auditável, portátil e legível por humanos e agentes.
Legado vira conhecimento rastreável
Extração de regras de sistemas legados com proveniência e status de migração — antes de desligar o sistema antigo.
Seis quadrantes, seis perguntas
Cada nota mora no quadrante da pergunta cognitiva que ela responde.
decisions/
Por que fizemos assim?
ADRs, trade-offs e alternativas descartadas
specs/
O que o sistema deve fazer?
Regras de negócio, contratos e invariantes
system/
Como o sistema é hoje?
Arquitetura, componentes e integrações
guides/
Como fazer?
How-tos, padrões e convenções do time
ops/
Como operar?
Runbooks, incidentes e lições de produção
meta/
Como falamos?
Glossário, taxonomia e correções da IA
Conhecimento que compõe a cada ciclo
A squad entrega
Pipeline SDD produz código, testes e artefatos auditáveis.
A retrospectiva captura
Decisões, desvios e lições viram candidatos a conhecimento.
O curador organiza
Notas atômicas conectadas por wikilinks; toda nota nasce draft.
A próxima entrega começa mais inteligente
Spec e plano consultam a base antes de escrever qualquer linha.
É o efeito composto que assistente nenhum entrega sozinho: cada ciclo da squad deixa o repositório mais fácil de evoluir — para humanos e para os próprios agentes. A Base Cognitiva acompanha a implantação da consultoria, nas mesmas IDEs da squad.
Implantação guiada, instalação em minutos
O CodeSteer é oferecido via consultoria: no onboarding, sua equipe recebe acesso ao pacote e implanta junto com a gente. A CLI detecta suas IDEs, cria symlinks para skills e agents e cria a pasta operacional .memory-bank/ no repositório.
Pré-requisito: uv instalado na máquina.
uv tool install git+https://github.com/LuisCarlosLopes/codesteer-squad-ai.gitcd /meu/projeto && codesteer-squad install