@namewta/speculo 0.2.2 → 0.2.6

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 (134) hide show
  1. package/README.md +11 -15
  2. package/dist/src/index.js +72 -8
  3. package/dist/src/index.js.map +1 -1
  4. package/dist/src/migrate.js +8 -8
  5. package/dist/src/migrate.js.map +1 -1
  6. package/dist/src/workflows.js +2 -2
  7. package/dist/src/workflows.js.map +1 -1
  8. package/package.json +1 -1
  9. package/template/.speculo/README.md +3 -3
  10. package/template/AGENTS.md +4 -0
  11. package/template/CLAUDE.md +3 -0
  12. package/template/canonical/README.md +114 -0
  13. package/template/canonical/canonical-domain-modeling.md +289 -0
  14. package/template/canonical/canonical-skill-example.md +608 -0
  15. package/template/canonical/canonical-teach.md +296 -0
  16. package/template/commands/archive-and-consolidate.md +49 -0
  17. package/template/commands/docs-sync.md +2 -2
  18. package/template/commands/retro.md +9 -7
  19. package/template/commands/status.md +2 -2
  20. package/template/skills/archive-and-consolidate/SKILL.md +179 -0
  21. package/template/skills/archive-and-consolidate/assets/archive-plan-template.md +34 -0
  22. package/template/skills/archive-and-consolidate/assets/cleanup-candidate-template.md +69 -0
  23. package/template/skills/archive-and-consolidate/assets/consolidation-plan-template.md +67 -0
  24. package/template/skills/archive-and-consolidate/references/archive-rules.md +48 -0
  25. package/template/skills/archive-and-consolidate/references/cleanup-rules.md +73 -0
  26. package/template/skills/archive-and-consolidate/references/consolidation-rules.md +70 -0
  27. package/template/skills/archive-and-consolidate/references/knowledge-graduation.md +50 -0
  28. package/template/skills/docs-sync/SKILL.md +1 -1
  29. package/template/skills/docs-sync/references/readme-contract.md +2 -0
  30. package/template/skills/docs-sync/references/readme-writing-guide.md +294 -0
  31. package/template/skills/docs-sync/references/workflow-scope-contract.md +3 -3
  32. package/template/skills/speculo-retro/SKILL.md +1 -1
  33. package/template/skills/speculo-retro/references/issue-drafting-sop.md +1 -1
  34. package/template/skills/worktree-isolation/references/merge-and-cleanup.md +2 -2
  35. package/template/vendor/README.md +3 -3
  36. package/template/vendor/khazix-skills/neat-freak/SKILL.md +210 -0
  37. package/template/vendor/khazix-skills/neat-freak/references/agent-paths.md +72 -0
  38. package/template/vendor/khazix-skills/neat-freak/references/governance.md +88 -0
  39. package/template/vendor/khazix-skills/neat-freak/references/sync-matrix.md +77 -0
  40. package/template/vendor/khazix-skills/neat-freak/references/verification.md +92 -0
  41. package/template/vendor/khazix-skills/neat-freak/scripts/audit-inventory.sh +106 -0
  42. package/template/workflows/person/INDEX.md +12 -0
  43. package/template/workflows/person/M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md +73 -74
  44. package/template/workflows/specdev/D-diagnose-bugs/D-diagnose-bugs.md +85 -0
  45. package/template/workflows/specdev/D-diagnose-bugs/cleanup-postmortem.md +37 -0
  46. package/template/workflows/specdev/D-diagnose-bugs/feedback-loop-techniques.md +84 -0
  47. package/template/workflows/specdev/D-diagnose-bugs/hypothesis-format.md +46 -0
  48. package/template/workflows/specdev/D-diagnose-bugs/instrumentation-rules.md +51 -0
  49. package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +54 -0
  50. package/template/workflows/specdev/G-grill-with-docs/adr-format.md +77 -0
  51. package/template/workflows/specdev/G-grill-with-docs/context-format.md +63 -0
  52. package/template/workflows/specdev/G-grill-with-docs/domain-modeling-rules.md +93 -0
  53. package/template/workflows/specdev/G-grill-with-docs/grilling-protocol.md +54 -0
  54. package/template/workflows/specdev/G-grill-with-docs/log-format.md +99 -0
  55. package/template/workflows/specdev/I-implement/I-implement.md +85 -0
  56. package/template/workflows/specdev/I-implement/code-review-process.md +83 -0
  57. package/template/workflows/specdev/I-implement/codebase-design-glossary.md +109 -0
  58. package/template/workflows/specdev/I-implement/deepening.md +37 -0
  59. package/template/workflows/specdev/I-implement/design-it-twice.md +44 -0
  60. package/template/workflows/specdev/I-implement/tdd-examples.md +139 -0
  61. package/template/workflows/specdev/I-implement/tdd-rules.md +31 -0
  62. package/template/workflows/specdev/I-init-setup/I-init-setup.md +132 -0
  63. package/template/workflows/specdev/I-init-setup/domain-layout.md +90 -0
  64. package/template/workflows/specdev/I-init-setup/status-labels.md +54 -0
  65. package/template/workflows/specdev/I-init-setup/tracking-convention.md +58 -0
  66. package/template/workflows/specdev/INDEX.md +81 -0
  67. package/template/workflows/specdev/S-spec/S-spec.md +91 -0
  68. package/template/workflows/specdev/T-tickets/T-tickets.md +241 -0
  69. package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +209 -0
  70. package/template/workflows/specdev/_state/adr/.gitkeep +0 -0
  71. package/template/workflows/specdev/_state/archive/.gitkeep +0 -0
  72. package/template/workflows/specdev/_state/changes/.gitkeep +0 -0
  73. package/template/workflows/specdev/_state/context/.gitkeep +0 -0
  74. package/template/workflows/{matt-pocock → specdev}/_state/status.json +1 -1
  75. package/template/commands/finalize.md +0 -37
  76. package/template/commands/knowledge-prune.md +0 -20
  77. package/template/skills/change-lifecycle/SKILL.md +0 -25
  78. package/template/skills/change-lifecycle/assets/completion-summary-template.md +0 -25
  79. package/template/skills/change-lifecycle/assets/completion-verification-template.md +0 -29
  80. package/template/skills/change-lifecycle/references/completion-gate.md +0 -19
  81. package/template/skills/change-lifecycle/references/finalize-archive.md +0 -32
  82. package/template/skills/knowledge-prune/SKILL.md +0 -29
  83. package/template/skills/knowledge-prune/references/audit-rules.md +0 -24
  84. package/template/skills/runtime-context/SKILL.md +0 -54
  85. package/template/skills/runtime-context/references/path-resolution.md +0 -41
  86. package/template/workflows/matt-pocock/PERSISTENCE.md +0 -80
  87. package/template/workflows/matt-pocock/WORKFLOW.md +0 -103
  88. package/template/workflows/matt-pocock/_state/archive/.gitkeep +0 -1
  89. package/template/workflows/matt-pocock/_state/changes/.gitkeep +0 -1
  90. package/template/workflows/matt-pocock/atomic-skills/ask-matt.md +0 -21
  91. package/template/workflows/matt-pocock/atomic-skills/claude-handoff.md +0 -21
  92. package/template/workflows/matt-pocock/atomic-skills/code-review.md +0 -21
  93. package/template/workflows/matt-pocock/atomic-skills/codebase-design.md +0 -21
  94. package/template/workflows/matt-pocock/atomic-skills/diagnosing-bugs.md +0 -21
  95. package/template/workflows/matt-pocock/atomic-skills/domain-modeling.md +0 -21
  96. package/template/workflows/matt-pocock/atomic-skills/grill-me.md +0 -21
  97. package/template/workflows/matt-pocock/atomic-skills/grill-with-docs.md +0 -21
  98. package/template/workflows/matt-pocock/atomic-skills/grilling.md +0 -21
  99. package/template/workflows/matt-pocock/atomic-skills/handoff.md +0 -21
  100. package/template/workflows/matt-pocock/atomic-skills/implement.md +0 -21
  101. package/template/workflows/matt-pocock/atomic-skills/improve-codebase-architecture.md +0 -21
  102. package/template/workflows/matt-pocock/atomic-skills/loop-me.md +0 -21
  103. package/template/workflows/matt-pocock/atomic-skills/prototype.md +0 -21
  104. package/template/workflows/matt-pocock/atomic-skills/research.md +0 -21
  105. package/template/workflows/matt-pocock/atomic-skills/resolving-merge-conflicts.md +0 -21
  106. package/template/workflows/matt-pocock/atomic-skills/setup-matt-pocock-skills.md +0 -21
  107. package/template/workflows/matt-pocock/atomic-skills/tdd.md +0 -21
  108. package/template/workflows/matt-pocock/atomic-skills/teach.md +0 -21
  109. package/template/workflows/matt-pocock/atomic-skills/to-spec.md +0 -21
  110. package/template/workflows/matt-pocock/atomic-skills/to-tickets.md +0 -21
  111. package/template/workflows/matt-pocock/atomic-skills/triage.md +0 -21
  112. package/template/workflows/matt-pocock/atomic-skills/wayfinder.md +0 -21
  113. package/template/workflows/matt-pocock/atomic-skills/wizard.md +0 -21
  114. package/template/workflows/matt-pocock/atomic-skills/writing-beats.md +0 -21
  115. package/template/workflows/matt-pocock/atomic-skills/writing-fragments.md +0 -21
  116. package/template/workflows/matt-pocock/atomic-skills/writing-great-skills.md +0 -21
  117. package/template/workflows/matt-pocock/atomic-skills/writing-shape.md +0 -20
  118. package/template/workflows/matt-pocock/routes/architecture.md +0 -24
  119. package/template/workflows/matt-pocock/routes/diagnose.md +0 -22
  120. package/template/workflows/matt-pocock/routes/experimental.md +0 -18
  121. package/template/workflows/matt-pocock/routes/idea-to-delivery.md +0 -63
  122. package/template/workflows/matt-pocock/routes/merge-conflicts.md +0 -19
  123. package/template/workflows/matt-pocock/routes/productivity.md +0 -25
  124. package/template/workflows/matt-pocock/routes/research-prototype.md +0 -20
  125. package/template/workflows/matt-pocock/routes/review.md +0 -19
  126. package/template/workflows/matt-pocock/routes/setup.md +0 -42
  127. package/template/workflows/matt-pocock/routes/triage.md +0 -25
  128. package/template/workflows/matt-pocock/routes/wayfinder.md +0 -27
  129. package/template/workflows/person/PERSISTENCE.md +0 -56
  130. package/template/workflows/person/WORKFLOW.md +0 -50
  131. package/template/workflows/person/_state/.config/LESSONS.md +0 -3
  132. package/template/workflows/person/_state/.config/RULES.md +0 -3
  133. package/template/workflows/person/_state/.config/context/.gitkeep +0 -1
  134. package/template/workflows/person/_templates/mao-consultation-output-template.md +0 -55
@@ -1,25 +0,0 @@
1
- # Triage
2
-
3
- ## 阶段
4
-
5
- ```xml
6
- <sequence>
7
- <phase id="collect" order="1">
8
- <instructions root="workflow" path="atomic-skills/triage.md" activation="adapted" />
9
- <artifact root="change" path="triage/{item}/record.md" />
10
- <completion>完整正文、评论、标签、diff、冗余性与私有 out-of-scope 已检查。</completion>
11
- </phase>
12
- <phase id="recommend" order="2">
13
- <completion>类别与状态建议已向维护者展示并等待决定。</completion>
14
- </phase>
15
- <phase id="validate-grill" order="3">
16
- <when>声明需要复现或需求仍不完整。</when>
17
- <instructions root="workflow" path="atomic-skills/grilling.md" activation="conditional" />
18
- <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional" />
19
- <completion>事实已验证,问题逐个解决。</completion>
20
- </phase>
21
- <phase id="apply" order="4">
22
- <completion>拟发布评论、标签、关闭动作先本地记录并经确认;结果引用已写回。</completion>
23
- </phase>
24
- </sequence>
25
- ```
@@ -1,27 +0,0 @@
1
- # Wayfinder
2
-
3
- ## 阶段
4
-
5
- ```xml
6
- <sequence>
7
- <phase id="name-destination" order="1">
8
- <instructions root="workflow" path="atomic-skills/wayfinder.md" activation="required" />
9
- <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
10
- <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
11
- <completion>目的地与范围边界已确认。</completion>
12
- </phase>
13
- <phase id="map-frontier" order="2">
14
- <artifact root="change" path="wayfinder/map.md" />
15
- <artifact root="change" path="wayfinder/tickets/" />
16
- <completion>只创建当前可明确的 tickets,战争迷雾留在 map。</completion>
17
- </phase>
18
- <phase id="walk-one-ticket" order="3">
19
- <completion>一次会话只领取并解决一个前沿 ticket;本地先记录,外发需确认。</completion>
20
- </phase>
21
- <phase id="handoff" order="4">
22
- <when>路径已清晰。</when>
23
- <instructions root="workflow" path="routes/idea-to-delivery.md" />
24
- <completion>已转入 spec 或 implement,未把寻路当成交付。</completion>
25
- </phase>
26
- </sequence>
27
- ```
@@ -1,56 +0,0 @@
1
- # Person Persistence
2
-
3
- 本文件是 `person` 的唯一运行契约。`WORKFLOW.md` 只能引用本文件,不得复制 runtime roots、store、change 启动或副作用规则。进入 person workflow 时先读取项目根 `speculo/.speculo/workspace.json`,再执行本文件。
4
-
5
- ## 运行时根
6
-
7
- ```xml
8
- <runtime-context>
9
- <root id="workflow" base="workflows" path="person" />
10
- <root id="state" base="state" path="person" />
11
- </runtime-context>
12
- ```
13
-
14
- ## 持久化命名空间
15
-
16
- ```xml
17
- <persistence root="state">
18
- <store id="index" role="index" kind="file" path="status.json" create="initialize" />
19
- <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
20
- <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
21
- <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
22
- </persistence>
23
- ```
24
-
25
- ## 启动协议
26
-
27
- ```xml
28
- <sequence>
29
- <phase id="resolve-runtime" order="1">
30
- <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
31
- <completion>workspace、config 与 workflow/state roots 均已解析并通过边界检查;同一运行已解析时复用结果。</completion>
32
- </phase>
33
- <phase id="select-change" order="2">
34
- <artifact root="state" path="status.json" />
35
- <completion>已选择用户指定或唯一 active change;没有 active change 时原子创建 `changes/YYYY-MM-DD-&lt;kebab-topic&gt;/.status.json` 并更新索引;多个候选时先消歧。</completion>
36
- </phase>
37
- </sequence>
38
- ```
39
-
40
- 创建 change 时初始化 schema version 1、workflow/name/timestamps、`change_status: active`、空的 `route_history`。已有 change 缺少数组时按空数组读取,在下一次真实更新时补齐,不要求迁移。
41
-
42
- ## 状态字段
43
-
44
- ```xml
45
- <state-schema>
46
- <field name="current_route" type="string|null" />
47
- <field name="route_history" type="array" />
48
- </state-schema>
49
- ```
50
-
51
- ## 路径与副作用
52
-
53
- - route 产物只写当前 change;已声明 knowledge store 只接收 workflow 确认的长期内容。
54
- - 用户要求的项目产物不是 Speculo 运行状态;保存项目相对指针,不把派生绝对路径写入状态。
55
- - 发布、提交、移动或删除外部/项目资源前展示动作并取得明确确认。
56
-
@@ -1,50 +0,0 @@
1
- ---
2
- id: person
3
- type: workflow
4
- workflow: person
5
- name: Person Workflow
6
- description: 以人物方法论为底座并共享独立持久化契约的咨询 workflow
7
- keywords: [person, methodology, consulting, 人物, 方法论]
8
- ---
9
-
10
- # Person Workflow
11
-
12
- 先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源;本入口只负责选择人物方法论 route。
13
-
14
- ## 进入协议
15
-
16
- ```xml
17
- <sequence>
18
- <phase id="load-persistence" order="1">
19
- <instructions root="workflow" path="PERSISTENCE.md" activation="required" />
20
- <completion>runtime context 与 current change 已按唯一持久化契约解析。</completion>
21
- </phase>
22
- </sequence>
23
- ```
24
-
25
- ## 路由
26
-
27
- ```xml
28
- <routes>
29
- <route id="mao-zedong-cognitive-os" order="1" root="workflow" path="M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md">
30
- <when>用户希望以毛泽东方法论分析问题、制定战略或组织行动。</when>
31
- </route>
32
- </routes>
33
- ```
34
-
35
- ## 依赖
36
-
37
- ```xml
38
- <dependencies />
39
- ```
40
-
41
- ## 状态转移
42
-
43
- ```xml
44
- <transitions>
45
- <transition from="active" to="archived">
46
- <command root="commands" path="finalize.md" />
47
- <when>用户确认咨询交付完成且完成门禁通过。</when>
48
- </transition>
49
- </transitions>
50
- ```
@@ -1,3 +0,0 @@
1
- # Person Workflow Lessons
2
-
3
- 仅记录经验证、可跨咨询 change 复用的经验。
@@ -1,3 +0,0 @@
1
- # Person Workflow Rules
2
-
3
- 本文件由用户维护,用于记录人物方法论咨询的边界与硬约束。
@@ -1,55 +0,0 @@
1
- > **服务工作流:** `../M-mao-zedong-cognitive-os/M-mao-zedong-cognitive-os.md`
2
- > **产物文件名:** `consultation-output.md`
3
- > **父目录规则:** 本模板产物写入 `YYYY-MM-DD-<kebab-name>/` change 目录内
4
-
5
- # 咨询输出
6
-
7
- > 以下为教员第一人称的整合咨询答复。由 Phase 1-4 的 problem-statement、analysis、strategy、action-plan 整合而成。
8
-
9
- ## 问题回顾
10
-
11
- 同志,你来找我谈的是这么一件事——
12
-
13
- [TODO: 从 problem-statement.md 提炼,2-3 句概括用户处境]
14
-
15
- ## 诊断
16
-
17
- [TODO: 从 analysis.md 提炼主要矛盾判断,遵循五拍论证节奏——破题→切割→定向→点睛→收尾]
18
-
19
- 谁是我们的朋友?谁是我们的敌人?[TODO: 力量格局定性]
20
-
21
- 这件事的根本问题,不是……而是……[TODO: 剥掉表象]
22
-
23
- 捉住了这个主要矛盾——[TODO: 明确写出],一切问题就迎刃而解了。
24
-
25
- 这就像 [TODO: 1 个比喻点睛]
26
-
27
- ## 战略
28
-
29
- 我们的方针是——[TODO: 从 strategy.md 提炼,一句话方向判断]
30
-
31
- 分几步走:[TODO: 阶段划分与关键战役]
32
-
33
- 在战略上我们要藐视它,在战术上我们要重视它。[TODO: 具体展开]
34
-
35
- ## 行动
36
-
37
- 怎么打?[TODO: 从 action-plan.md 提炼,每个阶段配方法]
38
-
39
- 桥和船在这里:[TODO: 具体方法,2-3 步]
40
-
41
- 打了再看。实践是检验真理的唯一标准。[TODO: 检验方式]
42
-
43
- ## 收尾
44
-
45
- [TODO: 给信心,承认道路曲折,落脚到"人"和"群众"]
46
-
47
- 道路是曲折的,前途是光明的。
48
-
49
- ---
50
-
51
- ## 引用索引
52
-
53
- | 引文 | 篇目 | 编号 |
54
- |------|------|------|
55
- [TODO: 逐条列出本文引用的毛泽东原文、篇目名、编号]