本目录是
Cairn协议的完整示例项目。它不包含真实代码、截图、构建产物或依赖，只模拟一个前后端项目在多轮代理协作后的 Markdown 文件状态。
Northstar Ops 是一个虚构的内部运营工单平台。这个目录展示一个项目复制 Cairn 模板（template/AGENTS.zh.md）为 AGENTS.md 后，如何用文件记录开发全流程和持续约束。
本示例只保留 AGENTS.md 提到的 md 形态：
| 文件 | 展示内容 |
|---|---|
AGENTS.md |
从 Cairn 中文模板复制而来，展示代理协作规则 |
plan.md |
项目定位、目标、核心对象、验收标准 |
ARCHITECTURE.md |
前端、后端、worker、外部系统的组织边界 |
README.md |
本示例项目的阅读入口 |
TODO.md |
当前执行台账，含完成、待办、修改、阻塞、归档面包屑 |
fix_audit-batch.md |
一批审查 / 人工测试反馈的闭环 |
HUMAN.md |
真实 SSO 权限验证、批量分派通知策略等人工干预事项 |
INTERFACE.md |
对外接口契约 |
TEST.md |
测试方法和回归矩阵 |
NICKNAME.md |
项目术语字典 |
archive/*.md |
已完成步骤、已归档 fix、已完成人工干预事项 |
Northstar Ops 面向客服、履约、财务和运营主管。它包含 Web 前端、HTTP API、后台任务、审计日志和通知系统。当前故事线中，项目已完成登录、权限、工单列表和详情页，正在推进“批量分派”和“客服备注审计”。
示例文件会提到虚构路径，例如 apps/web、apps/api、packages/contracts、db/migrations。这些路径只用于说明项目上下文，不对应真实源码。
- 读
AGENTS.md，理解代理进入项目时会遵守什么规则。 - 读
NICKNAME.md，先消除术语歧义。 - 读
fix_audit-batch.md，看当前反馈批次。 - 读
HUMAN.md，看哪些事项已经转人工执行或人工决策。 - 读
TODO.md，看当前执行台账。 - 读
ARCHITECTURE.md、plan.md，理解架构和大纲。 - 按需读
INTERFACE.md、TEST.md。 - 读
archive/，看历史如何保留。
- 语义命名 fix：当前反馈批次命名为
fix_audit-batch.md，而不是fix_01.md。 - fix 优先：TODO 步骤 9 来源于
fix_audit-batch.md，表示反馈先落到执行台账。 - 人工干预：真实 SSO 账号验证转入
HUMAN.md#H-20260506-01，批量分派通知策略决策转入HUMAN.md#H-20260506-02，对应 TODO 保持阻塞。 - 接口同步：批量分派和备注接口变化记录在
INTERFACE.md。 - 测试方法独立：
TEST.md写怎么测，测试发现的问题仍回到 fix。 - 术语前置：
NICKNAME.md收录项目黑话，代理进入项目时先读。 - 归档保留：
archive/保存已完成步骤、已归档反馈和人工干预历史。
真实项目通常只需要复制一份模板：
cp template/AGENTS.zh.md your-project/AGENTS.md然后按 AGENTS.md 规则创建项目自己的 plan.md、ARCHITECTURE.md、README.md、TODO.md，并在触发条件出现时创建 fix_<desc>.md、fix-plan_<desc>.md、HUMAN.md、INTERFACE.md、TEST.md、NICKNAME.md。