@MindContext
Contexto de negócio/domínio
CodeSteer: Inteligência guiada por contexto.

O volante da sua operação de engenharia com IA. O CodeSteer Squad instala no seu repositório agents, skills, rules, memória e checkpoints para que a IA trabalhe com contexto, sequência e rastreabilidade, sem improvisar arquitetura ou pular etapas.
Framework instalado no repositório. Operação executada dentro da IDE.
IDEs suportadas
Pipeline SDD
Teaser do mecanismo interno: contexto, fases e handoffs explícitos governando a execução dentro da IDE.
6 fases · 2 checkpoints humanos · 19 etapas
Você instala o CodeSteer no repositório e usa a IDE que já faz parte do seu fluxo. A IA lê o contrato do projeto, recebe contexto antes de agir e trabalha por fases com handoffs explícitos.
De prompt solto para contexto validado e execução governada.
| Sem CodeSteer | Com CodeSteer |
|---|---|
| Prompt solto em cada sessão | Execução por fases com handoffs e checkpoints explícitos |
| Sem contexto estruturado | Contrato do projeto, memória e rules carregados antes da ação |
| IA adivinha arquitetura e convenções | IA recebe contexto validado e respeita o contrato local |
| Ambiguidade vira retrabalho | Gaps, riscos e lacunas aparecem antes de virar código |
| Código sem rastreabilidade | Cada mudança rastreia até spec → plano → task |
| Review depende só de disciplina manual | Review, verification e policies fazem parte do fluxo |
| Conhecimento se perde entre sessões | Memória local + conhecimento curado preservam contexto e intenção |
CodeSteer roda dentro de Cursor, GitHub Copilot e Antigravity e projeta a mesma base canônica para as demais plataformas suportadas. Você mantém um único modelo operacional no repositório e troca apenas o target.
.cursor/
agents, skills, rules, commands
.claude/
CLAUDE.md, agents, rules, skills (workflow-skills incluídas)
.github/
agents, instructions, prompts, skills
.agents/
skills, rules, workflows
.codex/
agents, skills, policies, workflows, templates, checkpoints
.kiro/
agents, skills, steering complementar
Context Engineer é o mecanismo do CodeSteer que prepara contexto útil, reduz ruído, explicita regras e remove ambiguidades antes da execução.
Em vez de jogar mais prompt em cima da IA, o CodeSteer organiza o contexto certo antes da execução. Isso reduz ruído, explicita contratos e evita que lacunas virem código.
Seleciona o mínimo contexto necessário para a tarefa: contrato local, memória da execução, regras e referências relevantes.
Converte padrões, workflows e convenções do repositório em agents, skills e rules que a IDE consegue executar.
Detecta lacunas, riscos e contradições cedo, para que a IA não precise adivinhar política, fluxo ou contrato.
Conecta memória local da execução com conhecimento curado, para que decisões e aprendizados não se percam no próximo ciclo.
Resultado operacional
É o mecanismo interno que governa a execução dentro da IDE. Cada fase recebe contexto, produz artefatos rastreáveis e entrega o próximo handoff com checkpoints humanos explícitos.
Mapa do pipeline
Seis fases com ritmo próprio: definição, dois gates humanos explícitos, planejamento, entrega com qualidade e fechamento com memória curada.
Definição
Normalizar o pedido, recuperar conhecimento e fechar a especificação com revisão interna.
Checkpoint humano — Spec
Aprovação explícita antes de qualquer planejamento formal.
Planejamento
Plano executável, revisão crítica, arquitetura quando necessário e quebra em tarefas.
Checkpoint humano — Plano
Validação do plano e escopo antes da execução no código.
Construção & qualidade
Implementação, diagnóstico quando preciso, testes e gate de code review.
Verificação & conhecimento
Aderência a spec/plano, encerramento da execução e promoção do aprendizado curado.
Cada transição produz artefatos em .memory-bank/ — handoffs explícitos, orchestration viva e policies ativas em toda a trilha.
Cada agent tem papel, momento de atuação e responsabilidade explícitos. Isso distribui o trabalho, reduz improviso e aumenta previsibilidade em vez de concentrar tudo num único assistente.
Um agente único tende a misturar planejamento, implementação e revisão na mesma conversa, com mais decisões implícitas e sobrecarga contextual. O CodeSteer separa papéis: quem especifica, quem planeja, quem executa e quem valida entra no fluxo nos pontos certos, com handoffs e gates que mantêm a operação governada.
Governa workflow, fase, policies e gates Quando atua: Início obrigatório de toda execução
Consolida discovery, plano e tasks em um único passo Quando atua: Mudanças L1–L2 sem cerimônia formal
Recupera conhecimento reutilizável e reduz ruído Quando atua: Antes da especificação
Converte request em especificação formal Quando atua: Features que exigem definição precisa
Critica a spec para expor ambiguidades e gaps Quando atua: Antes do checkpoint humano
Produz plano executável (inclui quick-planner) Quando atua: Após spec aprovada ou intake (minor)
Revisa plano para expor falhas de sequência e premissas Quando atua: Antes do checkpoint humano
Orientação arquitetural para mudanças estruturais Quando atua: Quando fronteiras ou contratos mudam
Quebra plano em tarefas executáveis com dependências Quando atua: Após plano aprovado
Implementa mudanças no código Quando atua: Fase de execução
Diagnostica bugs complexos e isola causa raiz Quando atua: Chamado pelo Dev ou em hotfixes
Desenha, adiciona e executa testes Quando atua: Após implementação
Gate técnico de qualidade Quando atua: Antes de verificação final
Gate final de aderência à spec, plano e evidência Quando atua: Trilhas formais
Encerramento com resumo e candidatos a aprendizado Quando atua: Final de trilhas completas
Promove conhecimento validado para a base global Quando atua: Último passo do pipeline
Mapeia arquitetura real de projetos legados Quando atua: Trilha de enablement
Converte discovery em skills específicas do projeto Quando atua: Após discovery
Valida se skills funcionam com cenários reais Quando atua: Após autoria
Automação E2E: discovery, cobertura, geração e estabilização Quando atua: Trilha dedicada
Cada card resume função e momento de atuação; a lista completa dos 20 agents está alinhada ao AGENTS.md do repositório.
CodeSteer torna o repositório legível para agentes: `_codesteer/` como base canônica, `AGENTS.md` como contrato local e memória segmentada entre execução e organização.
projeto/
├── _codesteer/ # ← Pasta canônica do CodeSteer
│ ├── agents/ # 20 agents especializados
│ ├── skills/ # 58+ skills reutilizáveis
│ ├── workflows/ # 9 workflows adaptáveis
│ ├── rules/ # Policies de execução
│ ├── templates/ # Templates de artefatos SDD
│ ├── targets/ # Configuração por IDE
│ └── docs/ # Documentação arquitetural
├── .memory-bank/{spec-slug}/ # Memória local da execução
├── .knowledge/ # Conhecimento organizacional curado
├── AGENTS.md # Contrato local do projeto
└── scripts/ # Bootstrap e higiene operacionalSolicitação do Usuário
└── 01-request.md (normalizado pelo Orchestrator)
└── 02-knowledge-retrieval.md
└── 03-specification.md
└── 05-plan.md
└── 07-architecture.md
└── 08-task.md
└── Código implementado
└── Testes automatizados
└── Verificação final
└── Conhecimento atualizadoO Orchestrator escolhe o menor rito ainda seguro. Cada workflow responde ao risco real da mudança, sem cerimônia genérica.
“O menor rito ainda seguro.”
Selecione a complexidade
L1quick-plan-deliveryBaixa (L1)
Code Review (08-task + 09-report) → Dev/Debugger → Code Review
Baixa (L1)
Quick Plan → Dev → Code Review → Verification
Alta (L3–L4)
Spec → Review → Plan → Architect → Dev → Test → Verification
Média (L1–L2)
Intake → Plan (quick-planner) → Dev → Code Review
Muito Alta (L4)
Múltiplas fases de feature-delivery
Muito Alta (L4)
ADR → Architect → Plan → Dev → Verification
Variável
Reprodução → Causa Raiz → Correção → Validação
Urgente
Debugger → Dev → Code Review
Média
Discovery → Cobertura → Geração → Estabilização
Alta
Mapper → Author → Validator → Knowledge
quick-plan-delivery: Quick Plan → Dev → Code Review → Verification. Minutos, sem spec formal e com task artifact unico.
feature-delivery: Spec → Spec Review → checkpoint → Planner → Plan Review → Architect → Task Decomposer → checkpoint → Dev → Test → Code Review → Verification. Ciclo completo com governança total.
Terra incógnita vira mapa navegável: três agents especializados e skills de discovery antes de qualquer entrega arriscada.
“O LLM consegue identificar o componente correto para uma mudança, contratos são preservados, componentes proprietários são usados conforme a convenção local e as skills evitam defaults genéricos de framework.”
Skills curtas, especializadas e combináveis para orquestração, design, debugging, testes e governança.
Governa todo o pipeline SDD — da escolha do workflow ao último handoff. Precedência determinística e reenfileiramento por falha.
9 tags semânticas inline. A IA lê @MindWhy, @MindRisk e @MindDecision e entende o raciocínio por trás de cada decisão.
Mapeia a arquitetura real de legados — entrypoints, fronteiras, contratos e hotspots — sem inventar o que não existe.
Fast path L1/L2: plano enxuto e verificável sem cerimônia desnecessária.
Isola causa raiz com evidência e descarte de hipóteses — prova onde está o bug.
APIs, eventos, schemas e integrações não quebram silenciosamente.
Lacunas entre risco da mudança e evidência de teste — o que falta provar.
Snapshot contextual da base .knowledge/ focado na execução atual.
| Skill | Função |
|---|---|
| squad-orchestration | Governa pipeline: workflow, fase, policies, handoffs |
| codesteer-complexity | Classifica tasks em L1–L4 para calibrar rigor |
execution-policy
Regras globais de execução
context-loading-policy
Carregamento mínimo de contexto necessário
memory-policy
Escrita e leitura de artefatos
review-policy
Critérios de review e requeue
verification-policy
Gate final de aderência
debug-escalation-policy
Quando escalar para Debugger
e2e-automation-policy
Regras da trilha E2E
subagents-protocol
Protocolo de comunicação entre agents

Instale no repositório. Opere dentro da IDE.
Instale o CodeSteer no repositório e use a sua IDE como superfície de execução. O resultado é uma operação de engenharia com contexto, handoffs e checkpoints: spec, plano, execução, review e knowledge update com rastreabilidade.