落点决策树:我有内容 X,放哪里?
跟自己提 4 个问题,30 秒能定落点。
Q1: 这是「所有项目必须对齐」的生态级判断吗?
包括:对象定义、对象边界、阶段判断、当前基线、统一术语、对象间接口口径。
- ✅ 是 → 落在
ecosystem/。改源前先走 变更协议 的 L1 流程。 - ❌ 否 → Q2
Q2: 这是「某一个项目自己」的战略 / 产品 / 设计 / 执行内容吗?
- ✅ 是 → 落在
projects/<id>/。文档形状按 项目 README 模板 和projects/README.md的 maturity 分级约束。 - ❌ 否 → Q3
Q3: 这是「跨项目可复用」的吗?
按类型选 commons 子桶:
| 内容类型 | 落点 | 何时进入 |
|---|---|---|
| 抽象原则、评估方法、判断标准 | commons/methodology/ | 需要统一判断标准时 |
| Schema、协议、评测框架、协作骨架 | commons/frameworks/ | 需要可实施结构时 |
| 可复制填写的文档模板 | commons/templates/ | 需要快速创建标准 artifact 时 |
| 已落地实践、测试 case、复盘样本 | commons/case-library/ | 需要复用真实案例或验收样本时 |
| 第三方项目分析、竞品 / 反例 / 可吸收能力 | commons/references/ | 需要外部证据或设计参照时 |
| 可直接执行的步骤清单 | commons/playbooks/ | 需要按步骤完成任务时 |
| Agent skill 形状定义 | commons/skills-library/ | 当前冻结;仅 ADR 启用后新增 |
⚠️ commons 资料的 frontmatter 必须有 scope 字段(取值:individual / team / ecosystem,多选至少 1)。
- ❌ 都不符合 → Q4
Q4: 这是治理 / 协议 / 决策 / 提案吗?
| 内容类型 | 落点 |
|---|---|
| 治理协议(变更 / 对齐 / 升级 / 工具接入 / 闭环 / reader testing 等) | governance/ 顶层 |
| 治理级决策记录(ADR) | governance/decisions/ |
| 提案 inbox / 评审中 | governance/proposals/inbox/ |
- ❌ 都不是 → 这份内容可能不属于本仓。确认是不是该放工程仓 / 私有运行环境 / Graphiti 动态记忆。
升降级判断(什么时候动 ecosystem)
- commons → ecosystem:当跨项目沉淀的方法 / 案例证明会改变生态对象、接口、风险边界或统一术语时——走 change-protocol L1。
- projects → ecosystem:当某项目的局部判断需要所有项目都对齐时——走 change-protocol L1。
- ecosystem 内部调整:术语更新 / 阶段切换 / 接口口径调整——走 change-protocol L1-L2。
升级方向是单向收口,不是装饰升级。把"信息很重要"误判为"必须上升 ecosystem"是常见错误。
一句话原则
「所有项目必须对齐」→
ecosystem/;「能复用」→commons/<bucket>/;「只是某个项目自己的事」→projects/<id>/;「外部材料或初步分析」→commons/references/。