积极开发中

会话结束,上下文消失。
项目仍在继续。

Anchors 是面向 AI 辅助开发的连续性框架:锚点在去程引导工作、拉住绳索,在回程与代码对照 —— 它们不能说谎。

阅读概念在 GitHub 查看

这个名字来自攀登:固定点指明方向,并标记你走过的路。

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
灵感来源

我们借用了攀登的逻辑。

在岩壁上,一个锚点做三件事 —— 每一件都解决了一个不能仅凭记忆安全攀登的人所面临的真实问题。Anchors 将同样的逻辑应用到开发中。

01

指明方向

在攀登中: 标记出无支撑地形上的下一个点 —— 正因为知道该往哪走,你才敢迈出下一步。

在 Anchors 中: 计划和 spec 在写下第一行之前就说明要构建什么 —— AI(或你)是带着方向做决定,而不是在黑暗中摸索。

02

拉住绳索

在攀登中: 如果你滑落,锚点就成了阻止坠落的安全点 —— 没有它,一次失误就会葬送整次攀登。

在 Anchors 中: 质量关卡就是这个安全点:它当场捕获偏差,让一次失误的代价只是一次修正 —— 而不是整个项目。

03

标记走过的路

在攀登中: 路线被记录下来 —— 后来者不必重新解读岩壁,只需沿着已验证的路径前进。

在 Anchors 中: 依赖图和 issue 历史做的是同一件事:下一次会话读取已经证实的内容,从那里继续 —— 而不是从零开始。

问题

每一次 AI 会话都患有结构性失忆。

01

会话结束,上下文消失

另一个代理、另一天、另一个人 —— 下一次会话从零开始,不知道规则,不知道已经决定了什么、为什么。

02

代码在增长,方向没有

项目行数增加,方向却在流失。代理工具已经解决了单次会话内的失忆问题 —— 但会话之间还没有。

03

测试全绿,需求却未被证明

测试套件通过了,而规范中的整块内容仍未被覆盖 —— 直到出问题才有人注意到。

缺少的不是记忆,而是固定在仓库中的产物—— 下一次会话必须遵守的东西。

解决方案

引导、支撑、标记的锚点。

每个锚点履行攀登三种功能中的一项或多项:指明方向、拉住绳索防止跌落、标记走过的路。它们共同构成一个具体的、受版本控制的图 —— 每条边都知道自己是否同步。

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. 01规划播种
  2. 02Spec定义真相
  3. 03可追溯性连接
  4. 04传播与质量对照
论点

成熟度不是一个数字,而是支柱的活力。

一个项目成熟,是因为它的所有支柱 都已实现且充满活力—— 而不是因为某个孤立的仪表盘这么说。

01项目结构

仓库的形态,以确定性方式读取,并与你确认。

02规划

方向:播种规范的活计划。

03Spec

真相的起源:一切依附其上的基础锚点。

04可追溯性

粘合剂:从 spec → feature → test → code 的连续标识,以及文件之间的映射。

05传播

引擎:让一次变更传遍整个系统,标记出已过期(stale)的部分。

06质量

关卡:能确定性的地方就确定性判断,不能的地方交给 AI 判断。

两条轨道,从不矛盾

活的计划(锚点 + 图,当前的真相)与历史(已解决的 issue,带日期且不可变的报告)。

诚实的豁免,从不悄悄发生

豁免一项要求是显式的、被记录的、带日期的。它豁免的是要求本身,而不是"曾被豁免"这一记录。

增量同步

图中的每条边都知道自己是否同步。一次变更只重新传播它触及的部分 —— 从不是整个项目。

issue 永不重新打开

当一次对照失败、Anchors 无法独自解决时,它会记录一个不可变的 issue。再次发生就是新的 issue —— 历史从不被改写。

CLI

AI 用来运行这个循环的工具。

  1. 规划anchors guide plan计划指南
  2. 定义规范anchors guide spec.spec.md
  3. 映射anchors map build依赖图
  4. 实现anchors guide code代码 + feature
  5. 测试anchors guide test测试
  6. 对照anchors check / doctor偏差则生成 issue

Anchors 不内置 AI:它是 AI 在任何客户端中使用的工具 —— Claude Code、GPT、Gemini。它读取 `anchors guide`,学习流程,并操作命令。

浏览文档。

从共同机制到六大支柱:理解 Anchors 如何让项目长期保持一致。

阅读文档 GitHub