@haaaiawd/loom 0.10.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/LICENSE +21 -0
  3. package/README.md +147 -74
  4. package/cli/bin/loom.js +428 -105
  5. package/cli/help/asset.md +36 -0
  6. package/cli/help/atelier.md +37 -0
  7. package/cli/help/capability.md +68 -0
  8. package/cli/help/concepts.md +100 -72
  9. package/cli/help/doctor.md +71 -121
  10. package/cli/help/loop.md +120 -135
  11. package/cli/help/patch.md +33 -0
  12. package/cli/help/preview.md +2 -1
  13. package/cli/help/proposals.md +21 -0
  14. package/cli/help/version.md +92 -16
  15. package/cli/help/workflow.md +101 -100
  16. package/cli/src/activate.js +349 -73
  17. package/cli/src/asset-library.js +384 -0
  18. package/cli/src/atelier.js +331 -0
  19. package/cli/src/capability-graph.js +351 -0
  20. package/cli/src/capability-proposals.js +225 -0
  21. package/cli/src/diagnostics.js +240 -44
  22. package/cli/src/guide.js +155 -40
  23. package/cli/src/init.js +58 -32
  24. package/cli/src/intent-draft.js +303 -0
  25. package/cli/src/intent-map.js +560 -54
  26. package/cli/src/patch.js +214 -0
  27. package/cli/src/philosophy.js +177 -154
  28. package/cli/src/preview-prompt.md +13 -6
  29. package/cli/src/preview.js +1 -0
  30. package/cli/src/shared/intent-ref.js +38 -0
  31. package/cli/src/shared/proof-reference.js +19 -0
  32. package/cli/src/shared/verification-method.js +32 -0
  33. package/cli/src/verify.js +202 -62
  34. package/cli/src/version.js +5 -4
  35. package/dimensions/AUTHORSHIP.md +45 -0
  36. package/dimensions/PART_DECOMPOSITION.md +42 -203
  37. package/dimensions/SEARCH_METHODOLOGY.md +101 -97
  38. package/dimensions/examples/AGENT_SYSTEM/README.md +1 -1
  39. package/dimensions/examples/CLI_TOOL/README.md +1 -1
  40. package/dimensions/universal/COLLABORATION_PHILOSOPHY.md +28 -77
  41. package/dimensions/universal/ENGINEERING_CREED.md +30 -74
  42. package/dimensions/universal/PRODUCT_PHILOSOPHY.md +32 -70
  43. package/meta/BASELINE.md +91 -276
  44. package/meta/INTENT_LOOP.md +289 -737
  45. package/meta/PHILOSOPHY_WEAVER.md +110 -343
  46. package/meta/ROLE_ACTIVATION.md +109 -267
  47. package/package.json +13 -7
  48. package/roles/architect.md +84 -111
  49. package/roles/forge.md +105 -126
  50. package/roles/keeper.md +109 -223
  51. package/roles/visionary.md +57 -86
  52. package/templates/ASSET_LIBRARY_MANIFEST_TEMPLATE.json +10 -0
  53. package/templates/ATELIER_RECORD_TEMPLATE.json +48 -0
  54. package/templates/CAPABILITY_BRIEF_TEMPLATE.md +34 -0
  55. package/templates/CAPABILITY_GRAPH_TEMPLATE.json +11 -0
  56. package/templates/INTENT_MAP_TEMPLATE.json +26 -10
  57. package/templates/PHILOSOPHY_TEMPLATE.md +44 -75
  58. package/templates/VISION_TEMPLATE.md +44 -67
package/CHANGELOG.md ADDED
@@ -0,0 +1,22 @@
1
+ # Changelog
2
+
3
+ ## 1.1.0 — 2026-07-30
4
+
5
+ ### Added
6
+
7
+ - Capability Graph、Capability Brief 与 coverage/compile 命令,将项目问题面、能力缺口、
8
+ 风险和证据显式回链到 Intent。
9
+ - provenance-backed Capability Graph Proposal 工作流,由 Architect 裁决新发现对 Graph、
10
+ Intent、acceptance 或版本边界的影响。
11
+ - 版本化 Asset Library,校验来源、作者、许可、本地哈希、批准状态与 evidence 双向引用。
12
+ - Authorship System:第五种认知职能 Author、Identity Compiler、可选 Atelier Path,以及
13
+ `loom atelier init|get|validate`。
14
+ - Atelier Record 的 `intent_revision`、`stance_revision`、候选、修正、基线与选择证据校验。
15
+ - Keeper/Quality Proof 的 Atelier 闭合门;`doctor`、`guide` 与 `intent done` 可识别缺失、
16
+ 过期或未绑定的创作证据。
17
+
18
+ ### Compatibility
19
+
20
+ - 旧 Intent 缺少 `quality_strategy` 时等价于 `adaptive`,不会创建 Atelier Record。
21
+ - Atelier 是按需深路径,不增加角色、Intent 状态或验证维度。
22
+ - 旧项目缺少 Capability Graph 时保留兼容诊断,可在后续架构修订中迁移。
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 haaaiawd
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -8,15 +8,16 @@
8
8
 
9
9
  ## LOOM 是什么
10
10
 
11
- LOOM 是一个**规范驱动开发框架**,核心理念:
11
+ LOOM 是一个**哲学驱动的 Agent 质量框架**,核心理念:
12
12
 
13
- **不写死规范模板,让 Agent 根据项目特征从真实存在的思想体系中织造定制化哲学,作为所有开发角色的共同锚点。**
14
-
15
- LOOM 的核心机制:
16
- 1. **Philosophy Weaver** 根据项目特征织造定制化哲学
17
- 2. **Intent-Driven Loop** 以意图为 loop 单元,验证实现是否忠实于原始意图
18
- 3. **独立 Keeper** 作为子代理验证意图忠实度
19
- 4. **底线内化** 把不可妥协的约束写进哲学,角色激活时强制加载
13
+ **让 Agent 先拥有项目判断,再为当前任务编译专业能力;在可靠完成之上,通过比较与独立证据追求出众。**
14
+
15
+ LOOM 的核心机制:
16
+ 1. **Project Doctrine** 从项目事实中形成长期判断,而不是套用规范模板
17
+ 2. **Intent + Contract** 同时定义可靠完成的底线与可选的质量上限
18
+ 3. **Expertise Compiler** 为当前任务临时组装领域、品味、作者、批评与验证能力
19
+ 4. **Quality Arena + Quality Proof** 用机制不同的候选和独立证据支撑质量提升
20
+ 5. **Authorship + Atelier** 在真正需要创作判断时形成作者命题、媒介原型与可审计选择
20
21
 
21
22
  ---
22
23
 
@@ -26,21 +27,27 @@ LOOM 的核心机制:
26
27
  |---|---|
27
28
  | **哲学** | 项目的价值观和工程原则——为什么存在、什么不做、冲突时谁优先。由 Weaver 从真实思想体系织造,不是模板填空 |
28
29
  | **Intent** | 一个意图单元——不是"做什么"(任务),是"为什么做"(意图)。每个 Intent 有验收契约,Keeper 据此判定实现是否忠实 |
29
- | **Intent Map** | 所有 Intent 的依赖图(JSON)。Architect 绘制,定义拓扑序和依赖关系 |
30
- | **Intent Loop** | 核心循环:Keeper Intent Forge 实现 → Keeper 验证 → 闭合或修正。每个 Intent 独立走一圈 |
31
- | **Keeper** | 独立验证子代理——不继承 Forge 的实现上下文,从磁盘重新加载意图和契约,判定 passed/deviated/blocked/pending_human |
30
+ | **Intent Map** | 所有 Intent 的依赖图(JSON)。Architect 绘制,定义拓扑序和依赖关系 |
31
+ | **Capability Graph** | Intent 前展开项目问题面、能力缺口、风险和证据;高影响节点必须路由,并回链到 Intent |
32
+ | **Expertise Pack** | Forge 针对当前任务临时编译的专业认知,不成为永久规则 |
33
+ | **Authorial Stance** | 针对单个 Intent 编译的创作命题、选择、拒绝项、媒介语法和验证视角,不是 Persona 扮演 |
34
+ | **Atelier Path** | 可选创作深路径:冻结基线、形成机制不同候选、比较或保留原版,并把证据写入唯一 Atelier Record |
35
+ | **Quality Arena** | 以基线和机制不同候选进行探索、比较、实现与观察 |
36
+ | **Quality Proof** | Keeper 独立验证完成与质量声明,证据不足时不允许宣称提升 |
37
+ | **Intent Loop** | 选择 → 编译专业能力 → 实现/比较 → 独立证明 → 闭合或回流 |
38
+ | **Keeper** | 独立验证角色——不继承 Forge 的解释,从磁盘重新加载意图和契约 |
32
39
  | **底线** | 不可妥协的约束(BASELINE.md 5 条 + 项目特定底线)。角色激活时强制加载,哲学不能覆盖 |
33
40
 
34
41
  ### Intent Loop 怎么跑
35
42
 
36
43
  ```
37
- Keeper 选 Intent(拓扑序第一个 pending 且依赖都 completed 的)
38
-
39
- Keeper 更新 status → in_progress
40
-
41
- Forge 实现(加载意图叙事 + 哲学 + 验收契约)
44
+ Host/Orchestrator 选 Intent(拓扑序第一个 pending 且依赖都 completed 的)
45
+
46
+ Host/Orchestrator 更新 status → in_progress
42
47
 
43
- Keeper 验证(四维度:意图忠实度 / 哲学一致性 / 底线合规 / 验收达成)
48
+ Forge 编译 Expertise Pack,并在需要时运行 Quality Arena
49
+
50
+ Keeper 验证(基础四维;有质量契约时增加 quality_achievement,相对提升时附 Quality Proof)
44
51
 
45
52
  判定结果:
46
53
  passed → status → completed,回到选 Intent
@@ -49,13 +56,28 @@ Keeper 验证(四维度:意图忠实度 / 哲学一致性 / 底线合规 /
49
56
  pending_human → 等用户补充判定(L3 人类反馈,如游戏手感)
50
57
  ```
51
58
 
52
- **Loop 终止**:所有 Intent 的 status 为 completed → 项目阶段完成。
59
+ **Loop 终止**:所有 Intent 的 status 为 completed → 项目阶段完成。
60
+
61
+ 对会变更既有用户或系统状态的 Intent,Architect 设 `continuity_required: true`。它不创建第二份需求文档,而是要求同一份 acceptance 明确“哪些旧状态不得消失”与“旧状态 → 操作 → 新状态”的验证序列。此类 Intent 只有结果、守恒、可复现证据(以及按需的质量证明)同时通过,才允许闭合。
53
62
 
54
63
  ---
55
64
 
56
- ## 快速开始
57
-
58
- ### 步骤 0:诊断当前阶段
65
+ ## 快速开始
66
+
67
+ ### 安装
68
+
69
+ ```bash
70
+ npm install --global @haaaiawd/loom
71
+ loom --version
72
+ ```
73
+
74
+ 也可以不做全局安装,直接运行:
75
+
76
+ ```bash
77
+ npx @haaaiawd/loom --help
78
+ ```
79
+
80
+ ### 步骤 0:诊断当前阶段
59
81
 
60
82
  ```bash
61
83
  loom guide
@@ -114,26 +136,29 @@ loom activate architect
114
136
  ```
115
137
 
116
138
  **输入**:愿景文档 + 哲学文档
117
- **Architect 会做什么**:设计系统结构 → 绘制 Intent Map(依赖图 + 验收契约 + 哲学锚点)
118
- **产出**:`.loom/v1/02_ARCHITECTURE.md` + `.loom/v1/04_INTENT_MAP.json`
119
- **怎么判断合格**:验收契约具体到可验证(不是"实现正确即可"),依赖关系无环,每个 Intent 有意图叙事引用
139
+ **Architect 会做什么**:先展开 Capability Graph 设计系统边界 → 绘制 Intent Map 定义完成契约、按需的质量契约与专业能力需求
140
+ **产出**:`.loom/v1/07_CAPABILITY_GRAPH.json` + `07_CAPABILITY_BRIEFS/` + `.loom/v1/02_ARCHITECTURE.md` + `.loom/v1/04_INTENT_MAP.json`
141
+ **怎么判断合格**:高影响图谱节点都有路由、Intent 都可回链到图谱,完成契约可观察,质量契约可比较,依赖无环
120
142
  **下一步**:进入 Intent Loop
121
143
 
122
144
  ### 步骤 5:进入 Intent Loop
123
145
 
124
146
  ```bash
125
147
  # Keeper 选 Intent 并更新状态
126
- loom activate keeper
127
- loom intent next # 查看下一个可执行 Intent
128
- loom intent update INT-001 --status in_progress
129
-
130
- # Forge 实现
131
- loom activate forge # Forge 加载意图叙事 + 哲学 + 验收契约,实现代码
132
-
133
- # Keeper 验证
134
- loom activate keeper # Keeper 独立验证四维度
135
- loom verify contract INT-001 # 查看验收契约
136
- loom verify write --json-file verification.json # 写入验证记录
148
+ loom intent next # 查看下一个可执行 Intent
149
+ loom intent update INT-001 --status in_progress
150
+
151
+ # Forge 编译专业能力并实现
152
+ loom activate forge --intent INT-001
153
+
154
+ # 仅当 Architect 为该 Intent 声明 quality_strategy=atelier
155
+ loom atelier init INT-001
156
+ loom atelier validate INT-001
157
+
158
+ # Keeper 独立形成 Quality Proof
159
+ loom activate keeper --intent INT-001
160
+ loom verify contract INT-001 # 查看验收契约
161
+ loom verify write --json-file verification.json # 写入验证记录
137
162
 
138
163
  # 根据判定结果
139
164
  loom intent update INT-001 --status completed # passed
@@ -160,8 +185,18 @@ preview 是人类总览用的只读投影:哲学、愿景、架构、Intent
160
185
  - 强行打开旧投影:`loom preview --stale`
161
186
 
162
187
  Agent 在用户说"看看进度 / 打开 preview / 看全局"时,先跑 `loom preview status`。
163
-
164
- **CLI 命令一览**:
188
+
189
+ **版本演进三档**:
190
+
191
+ | 档位 | 什么时候用 | LOOM 流程 |
192
+ |---|---|---|
193
+ | Patch | 不触及 Intent,只修 bug / 样式 / 实现细节 | 不走 Intent Loop;跑验证并用 `loom patch record` 记录 |
194
+ | Minor | 新增或修改 Intent,但不改变哲学前提、愿景北极星、架构边界 | 当前版本内变更;相关 Intent 进入 `pending` / `needs_review` |
195
+ | Major | 哲学前提、愿景北极星或架构边界变化 | `loom version new` 创建新版本,全套重跑 |
196
+
197
+ 当前版本全部完成后,运行 `loom guide` 会提示按三档判断,而不是默认开新版本。
198
+
199
+ **CLI 命令一览**:
165
200
 
166
201
  | 命令 | 用途 |
167
202
  |---|---|
@@ -170,28 +205,52 @@ Agent 在用户说"看看进度 / 打开 preview / 看全局"时,先跑 `loom
170
205
  | `loom guide --dry-run` | 只读诊断当前阶段,不写 heartbeat |
171
206
  | `loom auto on\|off\|status` | AUTO 模式开关 |
172
207
  | `loom activate <role>` | 输出角色激活提示词 |
208
+ | `loom activate <role> --intent <id>` | 输出仅含指定 draft/官方 Intent 的角色上下文 |
173
209
  | `loom preview` | 打开新鲜 HTML 预览;过期时提示重新生成 |
174
210
  | `loom preview status` | 检查 `loom-preview.html` 是否存在、是否新鲜 |
175
211
  | `loom preview --regen` | 输出提示词,让 Agent 重写 HTML 预览 |
176
212
  | `loom preview --stale` | 强行打开过期预览 |
177
- | `loom help <topic>` | 分层指南(workflow\|concepts\|loop\|version\|doctor\|preview) |
213
+ | `loom help <topic>` | 分层指南(含 workflowconceptsloop、capability、atelier、version、patch、doctorpreview) |
178
214
  | `loom version list` | 列出所有版本(* 标记当前) |
179
215
  | `loom version new` | 创建新版本 + 自动切换(Major 升级) |
180
216
  | `loom version use <v>` | 切换当前版本 |
181
- | `loom version diff <v1> <v2>` | 对比两个版本的文件差异 |
217
+ | `loom version diff <v1> <v2>` | 对比两个版本的文件差异 |
218
+ | `loom patch record --json-file <path>` | 写入权威 Patch JSON 并生成 Markdown 投影 |
219
+ | `loom patch list` | 列出当前版本 Patch |
220
+ | `loom patch get <id>` | 查看单条 Patch |
221
+ | `loom patch validate` | 校验 Patch ledger 和生成投影 |
182
222
  | `loom intent next` | 下一个可执行 Intent |
183
223
  | `loom intent status` | 进度概览 |
184
- | `loom intent get <id>` | Intent 详情 |
185
- | `loom intent narrative <id>` | Intent 意图叙事 |
186
- | `loom intent trace <id>` | Intent 完整追溯链(依赖+验证+哲学+叙事) |
224
+ | `loom intent get <id>` | Intent 详情 |
225
+ | `loom intent add --title <text> [--depends-on <ids>]` | 创建当前版本新增 Intent draft |
226
+ | `loom intent revise <id> --reason <text>` | 创建修订 draft 并报告反向依赖 |
227
+ | `loom intent draft <id>` | 查看 draft |
228
+ | `loom intent finalize <id> [--review <ids> --unaffected <ids>]` | 校验 draft 并原子更新官方 Map/topo_order;修订时必须分类全部下游影响 |
229
+ | `loom capability graph\|frontier\|get\|coverage\|compile` | 查看能力图谱、未路由前沿、覆盖缺口和当前 Intent 的能力编译输入 |
230
+ | `loom capability proposal list\|get\|submit\|decide\|close` | 以 provenance 提交新发现,并由 Architect 裁决和闭合 |
231
+ | `loom asset import\|list\|search\|get\|validate` | 管理带来源、许可、哈希、批准状态与 evidence 回链的本地素材 |
232
+ | `loom atelier init\|get\|validate <id>` | 为显式 Atelier Intent 创建、读取和校验创作记录 |
233
+ | `loom intent deprecate <id> --reason <text>` | 只读评估当前版本弃用影响;加 `--confirm` 并完整分类依赖方后原子写入 |
234
+ | `loom intent narrative <id>` | Intent 意图叙事 |
235
+ | `loom intent trace <id>` | Intent 完整追溯链(依赖+验证+哲学+叙事) |
236
+ | `loom intent diff <v1> <v2>` | 按显式 lineage 比较新建、修订、拆分、合并和未映射 Intent |
187
237
  | `loom intent reverse-dep <id>` | 反向依赖(谁依赖这个 Intent) |
188
238
  | `loom intent reverse-ref <anchor>` | 反向哲学引用(哪些 Intent 引用这个锚点) |
189
239
  | `loom intent update <id> --status <s>` | 更新状态(Keeper 用) |
190
- | `loom philosophy get <anchor>` | 加载哲学章节 |
191
- | `loom verify contract <id>` | 获取验收契约 |
192
- | `loom verify write --json-file <path>` | 写入验证记录 |
240
+ | `loom philosophy get <anchor>` | 加载哲学章节 |
241
+ | `loom philosophy impact <anchor>` | 只读返回直接引用该锚点的 Intent 及传递依赖影响 |
242
+ | `loom philosophy revise <anchor> --classification <clarification\|minor\|major> --reason <text>` | 只读评估哲学修订;clarification/minor 加 `--confirm` 和完整分区后写审计 ADR |
243
+ | `loom verify contract <id>` | 获取验收契约 |
244
+ | `loom verify write --json-file <path>` | 写入验证记录 |
245
+ | `loom verify history <ref> --across-versions` | 沿 predecessors 读取各 owning version 的本地验证历史 |
193
246
  | `loom doctor` | 项目健康检查 |
194
- | `loom context` | 上下文摘要(Agent 重启后一条命令获取状态) |
247
+ | `loom context` | 上下文摘要(Agent 重启后一条命令获取状态) |
248
+
249
+ 读命令 `intent get`、`intent narrative`、`intent trace` 和 `verify history` 支持 `v1:INT-003` 形式的跨版本引用;裸 ID 仍指当前版本。历史引用只读。跨版本沿革必须显式写在可选 `lineage.predecessors` 中,同 ID 或同标题不会建立映射,且 lineage 不属于 `depends_on`。
250
+
251
+ 弃用只适用于当前版本中已 `completed` 的 Intent。首次运行 `loom intent deprecate <id> --reason "<why>"` 只返回目标、直接/传递依赖方、各自状态和确认命令,不写文件。确认时用 `--review` 与 `--unaffected` 将所有依赖方恰好分类一次;叶子 Intent 不需要分类参数。弃用记录写入 `lifecycle.deprecation`,目标仍为 `completed`,依赖和契约不被修改。重复确认会明确失败。
252
+
253
+ 哲学修订由 CLI 分析后果和记录审计,不由 CLI 自动改写哲学文本。`philosophy impact` 与未确认的 `philosophy revise` 严格只读。确认 clarification 时全部受影响 Intent 必须归入 `--unaffected`;确认 minor 时可将确需重验的 Intent 归入 `--review`,其中 `completed` 才转为 `needs_review`。两者都不改 acceptance,并在 `03_DECISIONS/PHIL-REV-NNN.md` 记录审计。Major 永不修改当前版本,只返回 `loom version new`。
195
254
 
196
255
  ---
197
256
 
@@ -207,27 +266,33 @@ LOOM/
207
266
  │ ├── INTENT_LOOP.md Loop 控制流 + Intent Map + Verification 底线
208
267
  │ └── PHILOSOPHY_WEAVER.md 哲学织造器规范
209
268
 
210
- ├── dimensions/ 哲学维度库(Weaver 的弹药库)
211
- │ ├── SEARCH_METHODOLOGY.md 检索方法论(怎么找到优质思想)
212
- │ ├── universal/ 通用层:产品/工程/协作(按需填充)
269
+ ├── dimensions/ 哲学维度库(Weaver 的弹药库)
270
+ │ ├── SEARCH_METHODOLOGY.md 检索方法论(怎么找到优质思想)
271
+ │ ├── AUTHORSHIP.md Atelier 启用时加载的作者性方法
272
+ │ ├── universal/ 通用层:产品/工程/协作(按需填充)
213
273
  │ ├── domain/ 领域层:UX/游戏/后端/AI(按需填充)
214
274
  │ └── crosscutting/ 交叉层:性能/安全/心理学/增长(按需填充)
215
275
 
216
276
  ├── roles/ 角色原型定义
217
277
  │ ├── visionary.md 远见者——定义愿景,织造意图叙事
218
- │ ├── architect.md 建筑师——设计系统,绘制 Intent Map
278
+ │ ├── architect.md 建筑师——展开图谱,设计系统,绘制 Intent Map
219
279
  │ ├── forge.md 锻造师——在哲学约束下自主实现
220
280
  │ └── keeper.md 守护者——验证意图忠实度
221
281
 
222
282
  ├── cli/ CLI 传感器层(Agent 通过 CLI 访问磁盘数据)
223
- │ ├── bin/loom.js 命令入口
224
- │ ├── src/ 核心库(intent-map / philosophy / verify)
225
- └── test/ 端到端测试
283
+ │ ├── bin/loom.js 命令入口
284
+ │ ├── src/ 核心库(intent-map / capability / atelier / verify)
285
+ ├── help/ Agent 可直接读取的工作流指南
286
+ │ └── test/ 端到端测试
226
287
 
227
288
  └── templates/ 项目级起点骨架
228
289
  ├── PHILOSOPHY_TEMPLATE.md 哲学文档起点
229
290
  ├── VISION_TEMPLATE.md 愿景文档起点
230
- └── INTENT_MAP_TEMPLATE.json Intent Map 起点
291
+ ├── INTENT_MAP_TEMPLATE.json Intent Map 起点
292
+ ├── CAPABILITY_GRAPH_TEMPLATE.json Capability Graph 起点
293
+ ├── CAPABILITY_BRIEF_TEMPLATE.md Capability Brief 起点
294
+ ├── ASSET_LIBRARY_MANIFEST_TEMPLATE.json Asset Library 起点
295
+ └── ATELIER_RECORD_TEMPLATE.json Atelier Record 起点
231
296
  ```
232
297
 
233
298
  ### 文档导航
@@ -245,8 +310,10 @@ LOOM/
245
310
  | Forge 做什么 | `roles/forge.md` |
246
311
  | Keeper 做什么 | `roles/keeper.md` |
247
312
  | 哲学文档长什么样 | `templates/PHILOSOPHY_TEMPLATE.md` |
248
- | 愿景文档长什么样 | `templates/VISION_TEMPLATE.md` |
249
- | Intent Map 长什么样 | `templates/INTENT_MAP_TEMPLATE.json` |
313
+ | 愿景文档长什么样 | `templates/VISION_TEMPLATE.md` |
314
+ | Capability Graph 与 Brief 长什么样 | `cli/help/capability.md`、`templates/CAPABILITY_GRAPH_TEMPLATE.json` |
315
+ | Author 与 Atelier 怎么工作 | `cli/help/atelier.md`、`dimensions/AUTHORSHIP.md` |
316
+ | Intent Map 长什么样 | `templates/INTENT_MAP_TEMPLATE.json` |
250
317
  | 怎么搜索高质量参考 | `dimensions/SEARCH_METHODOLOGY.md` |
251
318
 
252
319
  ---
@@ -261,8 +328,9 @@ LOOM/
261
328
  **Agent 生成的**(每个项目跑出来的,厚而灵活):
262
329
  - 哲学文档体系(Weaver 决定要几个、多详细)
263
330
  - 愿景文档(带意图叙事)
264
- - 架构文档(根据哲学决定结构)
265
- - Intent Map(意图依赖图,JSON)
331
+ - 架构文档(根据哲学决定结构)
332
+ - Capability Graph 与按需生成的 Capability Brief
333
+ - Intent Map(意图依赖图,JSON)
266
334
  - 验证契约和验证记录
267
335
 
268
336
  **我们的规范是元规范**——规范"怎么生成规范",不直接规范"规范长什么样"。
@@ -274,9 +342,9 @@ LOOM/
274
342
  | 角色 | 原型 | 职责 | 激活时机 |
275
343
  |---|---|---|---|
276
344
  | **Visionary** 远见者 | 产品联合创始人 | 定义愿景,织造意图叙事 | 项目启动 |
277
- | **Architect** 建筑师 | 系统建筑师 | 设计系统,绘制 Intent Map | Visionary 完成后 |
345
+ | **Architect** 建筑师 | 系统建筑师 | 展开 Capability Graph,设计系统,绘制 Intent Map | Visionary 完成后 |
278
346
  | **Forge** 锻造师 | 高级工程师 | 在哲学约束下自主实现 | Intent Loop 实现阶段 |
279
- | **Keeper** 守护者 | 产品联合创始人(独立激活) | Intent,验证意图忠实度 | Intent Loop 选择和验证阶段 |
347
+ | **Keeper** 守护者 | 独立验证者(独立激活) | 从磁盘事实验证意图与质量主张 | Intent Loop 验证阶段 |
280
348
 
281
349
  Visionary 和 Keeper **同源但独立**——同一个产品哲学,但 Keeper 是"回溯验证者",作为子代理运行,不继承 Forge 的实现上下文。
282
350
 
@@ -285,7 +353,7 @@ Visionary 和 Keeper **同源但独立**——同一个产品哲学,但 Keeper
285
353
  ## Intent-Driven Loop
286
354
 
287
355
  ```
288
- Keeper 选 Intent → Forge 加载意图链并自主实现 → Keeper 子代理独立验证 → 判定
356
+ Host/Orchestrator 选 Intent → Forge 加载意图链并自主实现 → Keeper 子代理独立验证 → 判定
289
357
  ↑ │
290
358
  │ │
291
359
  └────────────── passed: 闭合,下一个 Intent ──────────────────────────┘
@@ -326,10 +394,13 @@ Agent 在项目中生成的文档结构:
326
394
  ├── 01_VISION.md Visionary 产出(带意图叙事)
327
395
  ├── 02_ARCHITECTURE.md Architect 产出
328
396
  ├── 03_DECISIONS/ 架构决策记录
329
- ├── 04_INTENT_MAP.json 意图依赖图(DAG)
397
+ ├── 04_INTENT_MAP.json 意图依赖图(DAG)
330
398
  ├── 05_VERIFICATION.md 每个 Intent 的验证契约
331
- ├── 06_CHANGELOG.md 版本变更记录
332
- └── verifications/ Keeper 的验证记录
399
+ ├── 06_CHANGELOG.json Patch 变更记录(唯一权威来源)
400
+ ├── 06_CHANGELOG.md 确定性生成的只读投影
401
+ ├── 07_CAPABILITY_GRAPH.json 问题面、能力缺口、风险、证据与 Intent 回链
402
+ ├── 07_CAPABILITY_BRIEFS/ 按需生成的项目化能力 Brief
403
+ └── verifications/ Keeper 的验证记录
333
404
  ├── INT-001.json
334
405
  ├── INT-001.md
335
406
  └── ...
@@ -352,18 +423,19 @@ Agent 通过 **CLI 访问** JSON,不直接读文件——省 token、更高效
352
423
  ## 运行流程
353
424
 
354
425
  ```
355
- 1. Philosophy Weaver 织造哲学
356
- 识别项目特征激活哲学维度逐维度搜索/萃取/转译/落地整合冲突 版本锚定
426
+ 1. Weaver 织造 Project Doctrine
427
+ 读取项目事实提炼长期判断按决策未知搜索转译为原则、边界与 Evidence Map
357
428
 
358
429
  2. Visionary 定义愿景
359
430
  → 基于哲学写愿景 → 每个意图带意图叙事 → 识别需要的哲学维度
360
431
 
361
- 3. Architect 设计系统
362
- 基于愿景设计结构 → 绘制 Intent Map → 定义验证契约
432
+ 3. Architect 先展开 Capability Graph,再设计系统
433
+ 基于愿景检查问题面、能力缺口、风险与证据路由高影响节点 → 绘制 Intent Map → 定义验证契约
363
434
 
364
- 4. Intent Loop
365
- Keeper Intent Forge 实现 Keeper 验证 判定 下一个
366
- 循环直到所有 Intent 闭合
435
+ 4. LOOM Quality Engine
436
+ Forge 编译 Expertise Pack按需编译 Authorial Stance / 进入 Atelier
437
+ Quality Arena 实现/比较 → Keeper 形成 Quality Proof
438
+ → 循环直到所有 Intent 闭合
367
439
  ```
368
440
 
369
441
  ---
@@ -372,11 +444,12 @@ Agent 通过 **CLI 访问** JSON,不直接读文件——省 token、更高效
372
444
 
373
445
  - [x] `meta/` 元规范(4 个文件)
374
446
  - [x] `roles/` 角色原型(4 个角色)
375
- - [x] `templates/` 起点骨架(3 个模板)
447
+ - [x] `templates/` 起点骨架
376
448
  - [x] `README.md` 系统总览
377
449
  - [x] `dimensions/SEARCH_METHODOLOGY.md` 检索方法论
378
- - [x] `cli/` CLI 访问层(56 个测试全过)
379
- - [ ] `dimensions/` 维度文件(按需填充,Weaver 可自主判断)
450
+ - [x] `cli/` CLI 访问层(Capability Graph / Proposal / Asset Library / Atelier / Quality Proof)
451
+ - [x] `dimensions/AUTHORSHIP.md` 按需创作方法
452
+ - [ ] 继续通过真实项目校准专业维度与 Atelier 的质量增益
380
453
 
381
454
  ---
382
455