Em desenvolvimento ativo

A sessão termina. O contexto some.
O projeto continua.

Anchors é um framework de continuidade para desenvolvimento assistido por IA: âncoras que guiam o trabalho na ida, seguram a corda, e confrontam o código na volta — e não podem mentir.

Ler o conceitoVer no GitHub

O nome vem da escalada: pontos fixos que dizem para onde ir e demarcam por onde você passou.

anchors check --all
  spec-completeness   bloqueante  ✓12 ✗3 ~1
  test-coverage       julgamento  ⏳2 pendente(s) de IA

~ 1 indeterminado — não é falha:
  o gate não teve o que confrontar

3 issue(s) — divergências registradas:
  ✗ [BLOQUEIA] spec-completeness @ Foo.spec.md
      faltam 2 cenários sem teste correspondente

✗ barrado — 1 gate(s) bloqueante(s) reprovaram
A inspiração

Pegamos emprestada a lógica da escalada.

Numa parede, uma âncora faz três coisas — e cada uma resolve um problema real de quem sobe sem poder confiar só na memória. O Anchors aplica a mesma lógica ao desenvolvimento.

01

Aponta para onde ir

Na escalada: Marca o próximo ponto na superfície sem apoio — é por saber para onde ir que você ousa dar o passo seguinte.

No Anchors: O plano e a spec dizem o que construir antes da primeira linha — a IA (ou você) decide com direção, não no escuro.

02

Segura a corda

Na escalada: Se você escorregar, a âncora vira o safepoint que interrompe a queda — sem ela, um erro custaria a escalada inteira.

No Anchors: Os gates de qualidade são esse safepoint: pegam a divergência na hora, então um erro custa uma correção — nunca o projeto inteiro.

03

Demarca por onde você passou

Na escalada: A rota fica registrada — quem vier depois não precisa decifrar a parede de novo, só seguir o que já foi validado.

No Anchors: O grafo de dependências e o histórico de issues fazem o mesmo: a próxima sessão lê o que ficou provado e continua dali — não recomeça do zero.

O problema

Toda sessão de IA sofre de amnésia estrutural.

01

A sessão acaba, o contexto some

Outro agente, outro dia, outro humano — a próxima sessão recomeça sem saber as regras, sem saber o que já foi decidido e por quê.

02

Código cresce, direção não

O projeto ganha linhas, mas perde rumo. Ferramentas de agente já resolvem a amnésia dentro de uma sessão — não entre elas.

03

Testes verdes, requisitos sem prova

A suíte passa enquanto pedaços inteiros da spec seguem sem cobertura nenhuma — e ninguém percebe até doer.

O que falta não é memória. É artefato ancorado no repositório — algo que a sessão futura é obrigada a respeitar.

A solução

Âncoras que apontam, seguram e demarcam.

Cada âncora cumpre uma ou mais das três funções da escalada: diz para onde ir, segura a corda para você não cair, e marca por onde você passou. Juntas formam um grafo material, versionado — e cada aresta sabe se está em dia.

ciclo.sh
# planejar: a IA lê o guide de plano, decide o norte
$ anchors guide plan

# spec — a origem da verdade: o requisito ganha um código de cenário
SPCR-V01: usuário autentica com e-mail e senha

# map — rastreabilidade: liga spec → feature → teste → código
$ anchors map build

# check — qualidade: gates determinísticos + julgamento por IA
$ anchors check --all
  1. 01Planejamentosemeia
  2. 02Specdefine a verdade
  3. 03Rastreabilidadeconecta
  4. 04Propagação e Qualidadeconfrontam
A tese

Maturidade não é um número. É o vigor dos pilares.

Um projeto é maduro quando tem todos os seus pilares implementados e vigorosos — não quando um dashboard isolado diz que sim.

01Estrutura de Projeto

A forma do repositório, lida de modo determinístico e confirmada com você.

02Planejamento

O norte: o plano vivo que semeia as specs.

03Spec

A origem da verdade: a âncora-base, o safepoint do qual tudo pende.

04Rastreabilidade

A cola: identidade contínua de spec → feature → teste → código, e o mapa entre os arquivos.

05Propagação

O motor: faz uma alteração percorrer o organismo, marcando o que ficou stale.

06Qualidade

Os gates: determinísticos onde dá, julgamento por IA onde não dá.

Duas vias, nunca se contradizem

O plano vivo (âncoras + grafo, a verdade atual) e o histórico (issues resolvidas, laudos, datados e imutáveis).

Opt-out honesto, não silencioso

Dispensar uma exigência é explícito, registrado e datado. Dispensa a exigência, nunca o registro de que foi dispensada.

Sincronia incremental

Cada aresta do grafo sabe se está em dia. Uma mudança repropaga só o que ela tocou — nunca o projeto inteiro.

Issue nunca reabre

Quando um confronto falha e o Anchors não resolve sozinho, registra uma issue imutável. Recorrência é issue nova — o histórico nunca é reescrito.

O CLI

A ferramenta que uma IA opera para exercitar o ciclo.

  1. Planejaranchors guide planguia de plano
  2. Especificaranchors guide spec.spec.md
  3. Mapearanchors map buildgrafo de dependências
  4. Implementaranchors guide codecódigo + feature
  5. Testaranchors guide testtestes
  6. Confrontaranchors check / doctorissue se divergir

O Anchors não embute IA: é a ferramenta que a IA usa, em qualquer cliente — Claude Code, GPT, Gemini. Ela lê `anchors guide`, aprende o fluxo, e opera com os comandos.

Explore a documentação.

Do mecanismo comum aos seis pilares: entenda como o Anchors mantém um projeto coerente ao longo do tempo.

Ler os docs GitHub