La spec nace antes que el código
Nada se implementa sin una spec que diga qué construir. La IA (o tú) escribe a partir de ella — nunca al revés.
Anchors es un framework spec-first de continuidad para desarrollo asistido por IA: anclas que guían el trabajo de ida, sostienen la cuerda, y confrontan el código a la vuelta — y no pueden mentir.
El nombre viene de la escalada: puntos fijos que dicen hacia dónde ir y marcan por dónde pasaste.
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
Spec-first significa que la spec viene antes del código — y sigue siendo la verdad después de él. No es documentación escrita después de los hechos: es el origen del que todo lo demás deriva, y aquello contra lo que todo se confronta.
Nada se implementa sin una spec que diga qué construir. La IA (o tú) escribe a partir de ella — nunca al revés.
Si el código diverge de la spec, Anchors lo detecta y lo confronta — la spec sigue siendo la verdad, o se actualiza explícitamente.
Cada requisito de la spec lleva un código de identidad que atraviesa feature, test y código — la trazabilidad sabe exactamente qué cubre qué.
En una pared, un ancla hace tres cosas — y cada una resuelve un problema real de quien sube sin poder confiar solo en la memoria. Anchors aplica la misma lógica al desarrollo.
En la escalada: Marca el próximo punto en terreno sin apoyo — saber hacia dónde ir es lo que te permite arriesgar el siguiente paso.
En Anchors: El plan y la spec dicen qué construir antes de la primera línea — la IA (o tú) decide con dirección, no a ciegas.
En la escalada: Si resbalas, el ancla se convierte en el safepoint que detiene la caída — sin ella, un error costaría toda la escalada.
En Anchors: Los gates de calidad son ese safepoint: atrapan la divergencia al instante, así un error cuesta una corrección — nunca el proyecto entero.
En la escalada: La ruta queda registrada — quien venga después no tiene que descifrar la pared de nuevo, solo seguir lo ya validado.
En Anchors: El grafo de dependencias y el historial de issues hacen lo mismo: la próxima sesión lee lo ya probado y continúa desde ahí — no empieza de cero.
Otro agente, otro día, otro humano — la próxima sesión empieza de cero sin saber las reglas, sin saber qué se decidió y por qué.
El proyecto gana líneas pero pierde rumbo. Las herramientas de agentes ya resuelven la amnesia dentro de una sesión — no entre sesiones.
La suite pasa mientras partes enteras de la spec siguen sin cobertura — y nadie lo nota hasta que duele.
Lo que falta no es memoria. Es artefacto anclado en el repositorio — algo que la próxima sesión está obligada a respetar.
Cada ancla cumple una o más de las tres funciones de la escalada: indica hacia dónde ir, sostiene la cuerda para que no caigas, y marca por dónde pasaste. Juntas forman un grafo material, versionado — y cada arista sabe si está al día.
# 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
Un proyecto es maduro cuando tiene todos sus pilares implementados y vigorosos — no cuando un dashboard aislado lo dice.
La forma del repositorio, leída de modo determinístico y confirmada contigo.
El norte: el plan vivo que siembra las specs.
El origen de la verdad: el ancla base, el safepoint del cual todo pende.
La cola: identidad continua de spec → feature → test → código, y el mapa entre los archivos.
El motor: hace que un cambio recorra el organismo, marcando lo que quedó stale.
Los gates: determinísticos donde se puede, juicio por IA donde no.
El plan vivo (anclas + grafo, la verdad actual) y el histórico (issues resueltas, informes fechados e inmutables).
Renunciar a un requisito es explícito, registrado y fechado. Exime del requisito, nunca del registro de que fue eximido.
Cada arista del grafo sabe si está al día. Un cambio repropaga solo lo que tocó — nunca el proyecto entero.
Cuando una confrontación falla y Anchors no puede resolverla solo, registra una issue inmutable. La recurrencia es una issue nueva — el histórico nunca se reescribe.
anchors guide planguía de plananchors guide spec.spec.mdanchors map buildgrafo de dependenciasanchors guide codecódigo + featureanchors guide testtestsanchors check / doctorissue si divergeAnchors no integra IA: es la herramienta que una IA usa, en cualquier cliente — Claude Code, GPT, Gemini. Lee `anchors guide`, aprende el flujo, y opera los comandos.
Del mecanismo común a los seis pilares: entiende cómo Anchors mantiene un proyecto coherente a lo largo del tiempo.