指明方向
在攀登中: 标记出无支撑地形上的下一个点 —— 正因为知道该往哪走,你才敢迈出下一步。
在 Anchors 中: 计划和 spec 在写下第一行之前就说明要构建什么 —— AI(或你)是带着方向做决定,而不是在黑暗中摸索。
Anchors 是面向 AI 辅助开发的连续性框架:锚点在去程引导工作、拉住绳索,在回程与代码对照 —— 它们不能说谎。
这个名字来自攀登:固定点指明方向,并标记你走过的路。
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
在岩壁上,一个锚点做三件事 —— 每一件都解决了一个不能仅凭记忆安全攀登的人所面临的真实问题。Anchors 将同样的逻辑应用到开发中。
在攀登中: 标记出无支撑地形上的下一个点 —— 正因为知道该往哪走,你才敢迈出下一步。
在 Anchors 中: 计划和 spec 在写下第一行之前就说明要构建什么 —— AI(或你)是带着方向做决定,而不是在黑暗中摸索。
在攀登中: 如果你滑落,锚点就成了阻止坠落的安全点 —— 没有它,一次失误就会葬送整次攀登。
在 Anchors 中: 质量关卡就是这个安全点:它当场捕获偏差,让一次失误的代价只是一次修正 —— 而不是整个项目。
在攀登中: 路线被记录下来 —— 后来者不必重新解读岩壁,只需沿着已验证的路径前进。
在 Anchors 中: 依赖图和 issue 历史做的是同一件事:下一次会话读取已经证实的内容,从那里继续 —— 而不是从零开始。
另一个代理、另一天、另一个人 —— 下一次会话从零开始,不知道规则,不知道已经决定了什么、为什么。
项目行数增加,方向却在流失。代理工具已经解决了单次会话内的失忆问题 —— 但会话之间还没有。
测试套件通过了,而规范中的整块内容仍未被覆盖 —— 直到出问题才有人注意到。
缺少的不是记忆,而是固定在仓库中的产物—— 下一次会话必须遵守的东西。
每个锚点履行攀登三种功能中的一项或多项:指明方向、拉住绳索防止跌落、标记走过的路。它们共同构成一个具体的、受版本控制的图 —— 每条边都知道自己是否同步。
# 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
一个项目成熟,是因为它的所有支柱 都已实现且充满活力—— 而不是因为某个孤立的仪表盘这么说。
仓库的形态,以确定性方式读取,并与你确认。
方向:播种规范的活计划。
真相的起源:一切依附其上的基础锚点。
粘合剂:从 spec → feature → test → code 的连续标识,以及文件之间的映射。
引擎:让一次变更传遍整个系统,标记出已过期(stale)的部分。
关卡:能确定性的地方就确定性判断,不能的地方交给 AI 判断。
活的计划(锚点 + 图,当前的真相)与历史(已解决的 issue,带日期且不可变的报告)。
豁免一项要求是显式的、被记录的、带日期的。它豁免的是要求本身,而不是"曾被豁免"这一记录。
图中的每条边都知道自己是否同步。一次变更只重新传播它触及的部分 —— 从不是整个项目。
当一次对照失败、Anchors 无法独自解决时,它会记录一个不可变的 issue。再次发生就是新的 issue —— 历史从不被改写。
anchors guide plan计划指南anchors guide spec.spec.mdanchors map build依赖图anchors guide code代码 + featureanchors guide test测试anchors check / doctor偏差则生成 issueAnchors 不内置 AI:它是 AI 在任何客户端中使用的工具 —— Claude Code、GPT、Gemini。它读取 `anchors guide`,学习流程,并操作命令。