Anchors — Documentação Oficial
Um framework spec-first — a spec vem antes do código, e continua sendo a verdade depois dele. Mantém um projeto coerente ao longo do tempo através de âncoras que guiam o trabalho na ida e o confrontam na volta, sem permitir mentiras sobre o código.
🌟 O que é o Anchors?
Seção intitulada “🌟 O que é o Anchors?”Se você nunca usou o Anchors, pense nele como o sistema imunológico e a bússola do seu repositório.
Quando você programa com Inteligência Artificial (ChatGPT, Claude, Copilot, etc.), ela frequentemente sofre de amnésia estrutural: a cada nova sessão, ela esquece as decisões arquiteturais tomadas ontem, quebra regras de negócio silenciosamente e cria códigos órfãos que ninguém sabe como testar.
O Anchors resolve isso com três princípios inegociáveis:
- Spec-First: A especificação nasce antes do código e continua sendo a dona da verdade depois dele.
- A Unidade (The Unit): Nenhuma regra de negócio existe sem Spec, Feature, Teste e Código conectados por códigos de identidade.
- Gates Automatizados: Portais de qualidade que seguram a corda do projeto antes do commit ou no CI, impedindo regressões e código desgovernado.
🧭 Por Onde Começar?
Seção intitulada “🧭 Por Onde Começar?”1. Se você quer ENTENDER como tudo funciona (A Teoria Descomplicada)
Seção intitulada “1. Se você quer ENTENDER como tudo funciona (A Teoria Descomplicada)”Leia os guias conceituais escritos de forma simples e direta para quem está chegando agora:
- O que é uma Âncora? — A metáfora da escalada: como as âncoras apontam, seguram o safepoint e demarcam o caminho.
- A Unidade — Por que código sem spec ou teste é débito técnico imediato.
- Camadas do Projeto — A planta da casa: diferença entre Camadas Regidas (negócio) e Reconhecidas (infra/doc).
- Rastreabilidade e Códigos — Como códigos curtos (ex:
AUTH-B01) conectam requisitos do início ao fim. - Gates e Vereditos — Os 4 desfechos (
✓,✗,~,Skip) e a regra de ouro: todo gate nasce informativo. - Maturidade e Saúde — O comando
anchors doctore como transformar seu projeto em uma fortaleza.
2. Se você vai APLICAR o Anchors no seu código hoje (Operação Prática)
Seção intitulada “2. Se você vai APLICAR o Anchors no seu código hoje (Operação Prática)”Siga o roteiro operacional:
- O CLI — Como instalar o binário e rodar seus primeiros comandos.
- O fluxo de trabalho — Como trabalhar no dia a dia, da criação de uma spec até o merge seguro.
- O anchors.yaml — O arquivo central de configuração do seu projeto.
- Catálogo de Gates — O catálogo com mais de 90 verificadores prontos para ativar.
3. A Doutrina Completa dos 7 Pilares
Seção intitulada “3. A Doutrina Completa dos 7 Pilares”Para quem busca a formulação arquitetural profunda:
- Estrutura de Projeto — A planta da casa e as fronteiras arquiteturais.
- Planejamento — Como semear specs e fases ordenadas.
- Spec — A disciplina de especificação executável.
- Tipos de Spec — Specs de interface, usecase, serviço e arquitetura.
- Rastreabilidade — A fiação contínua entre requisitos e testes.
- Propagação — A onda de alterações que mantém o sistema coerente.
- Qualidade — A teoria da qualidade medida e os limiares de bloqueio.
🚨 Em Caso de Emergência
Seção intitulada “🚨 Em Caso de Emergência”- Congelar o projeto — O botão de pânico: como interromper o trabalho de todos os agentes quando uma inconformidade crítica precisar ser resolvida primeiro.