intent-planner 0.13.1

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 (334) hide show
  1. package/LICENSE +21 -0
  2. package/README.en.md +225 -0
  3. package/README.md +225 -0
  4. package/bin/cli.mjs +289 -0
  5. package/package.json +46 -0
  6. package/src/install.mjs +527 -0
  7. package/templates/en/agents/claude/CLAUDE.md +62 -0
  8. package/templates/en/agents/codex/AGENTS.md +62 -0
  9. package/templates/en/agents/gemini/GEMINI.md +62 -0
  10. package/templates/en/claude/skills/CONTRACT.md +86 -0
  11. package/templates/en/claude/skills/intent-compass/SKILL.md +55 -0
  12. package/templates/en/claude/skills/intent-compass/rules/algo-qoc.md +62 -0
  13. package/templates/en/claude/skills/intent-compass/rules/constraint-surfacing.md +41 -0
  14. package/templates/en/claude/skills/intent-discover/SKILL.md +63 -0
  15. package/templates/en/claude/skills/intent-discover/rules/algo-drift-analysis.md +34 -0
  16. package/templates/en/claude/skills/intent-discover/rules/algo-gore-lite.md +35 -0
  17. package/templates/en/claude/skills/intent-discover/rules/algo-impact-analysis.md +37 -0
  18. package/templates/en/claude/skills/intent-discover/rules/algo-intent-recovery.md +39 -0
  19. package/templates/en/claude/skills/intent-discover/rules/designer-questions.md +78 -0
  20. package/templates/en/claude/skills/intent-discover/rules/drift-terrain.md +105 -0
  21. package/templates/en/claude/skills/intent-discover/rules/mode-selection.md +31 -0
  22. package/templates/en/claude/skills/intent-export-cc-sdd/SKILL.md +88 -0
  23. package/templates/en/claude/skills/intent-export-cc-sdd/rules/drift-export-check.md +75 -0
  24. package/templates/en/claude/skills/intent-export-cc-sdd/rules/export-questions.md +23 -0
  25. package/templates/en/claude/skills/intent-export-cc-sdd/rules/map-cc-sdd.md +62 -0
  26. package/templates/en/claude/skills/intent-export-openspec/SKILL.md +90 -0
  27. package/templates/en/claude/skills/intent-export-openspec/rules/drift-export-check.md +50 -0
  28. package/templates/en/claude/skills/intent-export-openspec/rules/export-questions.md +23 -0
  29. package/templates/en/claude/skills/intent-export-openspec/rules/map-openspec.md +75 -0
  30. package/templates/en/claude/skills/intent-from-spec/SKILL.md +60 -0
  31. package/templates/en/claude/skills/intent-from-spec/rules/extract-intent.md +56 -0
  32. package/templates/en/claude/skills/intent-from-spec/rules/gap-readout.md +54 -0
  33. package/templates/en/claude/skills/intent-from-spec/rules/load-bearing.md +48 -0
  34. package/templates/en/claude/skills/intent-from-spec/rules/omission-recap.md +42 -0
  35. package/templates/en/claude/skills/intent-improve/SKILL.md +70 -0
  36. package/templates/en/claude/skills/intent-improve/rules/improve-axes.md +121 -0
  37. package/templates/en/claude/skills/intent-overview/SKILL.md +63 -0
  38. package/templates/en/claude/skills/intent-overview/rules/aggregate-sources.md +61 -0
  39. package/templates/en/claude/skills/intent-overview/rules/gap-readout.md +54 -0
  40. package/templates/en/claude/skills/intent-overview/rules/mermaid-tree.md +78 -0
  41. package/templates/en/claude/skills/intent-overview/rules/progress-readout.md +119 -0
  42. package/templates/en/claude/skills/intent-packets/SKILL.md +97 -0
  43. package/templates/en/claude/skills/intent-packets/rules/algo-additive-slicing.md +55 -0
  44. package/templates/en/claude/skills/intent-packets/rules/algo-characterization-test.md +40 -0
  45. package/templates/en/claude/skills/intent-packets/rules/algo-example-mapping.md +47 -0
  46. package/templates/en/claude/skills/intent-packets/rules/algo-migration-slicing.md +47 -0
  47. package/templates/en/claude/skills/intent-packets/rules/decision-slots.md +88 -0
  48. package/templates/en/claude/skills/intent-packets/rules/export-route.md +54 -0
  49. package/templates/en/claude/skills/intent-packets/rules/first-packet.md +35 -0
  50. package/templates/en/claude/skills/intent-packets/rules/packet-format.md +207 -0
  51. package/templates/en/claude/skills/intent-packets/rules/walking-skeleton.md +35 -0
  52. package/templates/en/claude/skills/intent-release-note/SKILL.md +58 -0
  53. package/templates/en/claude/skills/intent-release-note/rules/format-changelog.md +40 -0
  54. package/templates/en/claude/skills/intent-release-note/rules/format-github-releases.md +41 -0
  55. package/templates/en/claude/skills/intent-release-note/rules/format-select.md +32 -0
  56. package/templates/en/claude/skills/intent-release-note/rules/source-scope.md +42 -0
  57. package/templates/en/claude/skills/intent-status/SKILL.md +171 -0
  58. package/templates/en/claude/skills/intent-status/rules/decision-table.md +47 -0
  59. package/templates/en/claude/skills/intent-to-spec/SKILL.md +68 -0
  60. package/templates/en/claude/skills/intent-to-spec/rules/fabrication-guard.md +41 -0
  61. package/templates/en/claude/skills/intent-to-spec/rules/format-integrated.md +42 -0
  62. package/templates/en/claude/skills/intent-to-spec/rules/format-nonprogram.md +45 -0
  63. package/templates/en/claude/skills/intent-to-spec/rules/format-upstream.md +41 -0
  64. package/templates/en/claude/skills/intent-to-spec/rules/source-scope.md +50 -0
  65. package/templates/en/claude/skills/intent-validate/SKILL.md +80 -0
  66. package/templates/en/claude/skills/intent-validate/rules/validate-checks.md +121 -0
  67. package/templates/en/claude/skills/intent-writeback/SKILL.md +71 -0
  68. package/templates/en/claude/skills/intent-writeback/rules/writeback-protocol.md +139 -0
  69. package/templates/en/codex/skills/CONTRACT.md +77 -0
  70. package/templates/en/codex/skills/intent-compass/SKILL.md +52 -0
  71. package/templates/en/codex/skills/intent-compass/rules/algo-qoc.md +62 -0
  72. package/templates/en/codex/skills/intent-compass/rules/constraint-surfacing.md +41 -0
  73. package/templates/en/codex/skills/intent-discover/SKILL.md +60 -0
  74. package/templates/en/codex/skills/intent-discover/rules/algo-drift-analysis.md +34 -0
  75. package/templates/en/codex/skills/intent-discover/rules/algo-gore-lite.md +35 -0
  76. package/templates/en/codex/skills/intent-discover/rules/algo-impact-analysis.md +37 -0
  77. package/templates/en/codex/skills/intent-discover/rules/algo-intent-recovery.md +39 -0
  78. package/templates/en/codex/skills/intent-discover/rules/designer-questions.md +78 -0
  79. package/templates/en/codex/skills/intent-discover/rules/drift-terrain.md +105 -0
  80. package/templates/en/codex/skills/intent-discover/rules/mode-selection.md +31 -0
  81. package/templates/en/codex/skills/intent-export-cc-sdd/SKILL.md +85 -0
  82. package/templates/en/codex/skills/intent-export-cc-sdd/rules/drift-export-check.md +75 -0
  83. package/templates/en/codex/skills/intent-export-cc-sdd/rules/export-questions.md +23 -0
  84. package/templates/en/codex/skills/intent-export-cc-sdd/rules/map-cc-sdd.md +62 -0
  85. package/templates/en/codex/skills/intent-export-openspec/SKILL.md +87 -0
  86. package/templates/en/codex/skills/intent-export-openspec/rules/drift-export-check.md +50 -0
  87. package/templates/en/codex/skills/intent-export-openspec/rules/export-questions.md +23 -0
  88. package/templates/en/codex/skills/intent-export-openspec/rules/map-openspec.md +75 -0
  89. package/templates/en/codex/skills/intent-from-spec/SKILL.md +58 -0
  90. package/templates/en/codex/skills/intent-from-spec/rules/extract-intent.md +56 -0
  91. package/templates/en/codex/skills/intent-from-spec/rules/gap-readout.md +54 -0
  92. package/templates/en/codex/skills/intent-from-spec/rules/load-bearing.md +48 -0
  93. package/templates/en/codex/skills/intent-from-spec/rules/omission-recap.md +42 -0
  94. package/templates/en/codex/skills/intent-improve/SKILL.md +67 -0
  95. package/templates/en/codex/skills/intent-improve/rules/improve-axes.md +121 -0
  96. package/templates/en/codex/skills/intent-overview/SKILL.md +61 -0
  97. package/templates/en/codex/skills/intent-overview/rules/aggregate-sources.md +61 -0
  98. package/templates/en/codex/skills/intent-overview/rules/gap-readout.md +54 -0
  99. package/templates/en/codex/skills/intent-overview/rules/mermaid-tree.md +78 -0
  100. package/templates/en/codex/skills/intent-overview/rules/progress-readout.md +119 -0
  101. package/templates/en/codex/skills/intent-packets/SKILL.md +94 -0
  102. package/templates/en/codex/skills/intent-packets/rules/algo-additive-slicing.md +55 -0
  103. package/templates/en/codex/skills/intent-packets/rules/algo-characterization-test.md +40 -0
  104. package/templates/en/codex/skills/intent-packets/rules/algo-example-mapping.md +47 -0
  105. package/templates/en/codex/skills/intent-packets/rules/algo-migration-slicing.md +47 -0
  106. package/templates/en/codex/skills/intent-packets/rules/decision-slots.md +88 -0
  107. package/templates/en/codex/skills/intent-packets/rules/export-route.md +54 -0
  108. package/templates/en/codex/skills/intent-packets/rules/first-packet.md +35 -0
  109. package/templates/en/codex/skills/intent-packets/rules/packet-format.md +207 -0
  110. package/templates/en/codex/skills/intent-packets/rules/walking-skeleton.md +35 -0
  111. package/templates/en/codex/skills/intent-release-note/SKILL.md +56 -0
  112. package/templates/en/codex/skills/intent-release-note/rules/format-changelog.md +40 -0
  113. package/templates/en/codex/skills/intent-release-note/rules/format-github-releases.md +41 -0
  114. package/templates/en/codex/skills/intent-release-note/rules/format-select.md +32 -0
  115. package/templates/en/codex/skills/intent-release-note/rules/source-scope.md +42 -0
  116. package/templates/en/codex/skills/intent-status/SKILL.md +169 -0
  117. package/templates/en/codex/skills/intent-status/rules/decision-table.md +47 -0
  118. package/templates/en/codex/skills/intent-to-spec/SKILL.md +66 -0
  119. package/templates/en/codex/skills/intent-to-spec/rules/fabrication-guard.md +41 -0
  120. package/templates/en/codex/skills/intent-to-spec/rules/format-integrated.md +42 -0
  121. package/templates/en/codex/skills/intent-to-spec/rules/format-nonprogram.md +45 -0
  122. package/templates/en/codex/skills/intent-to-spec/rules/format-upstream.md +41 -0
  123. package/templates/en/codex/skills/intent-to-spec/rules/source-scope.md +50 -0
  124. package/templates/en/codex/skills/intent-validate/SKILL.md +78 -0
  125. package/templates/en/codex/skills/intent-validate/rules/validate-checks.md +121 -0
  126. package/templates/en/codex/skills/intent-writeback/SKILL.md +68 -0
  127. package/templates/en/codex/skills/intent-writeback/rules/writeback-protocol.md +139 -0
  128. package/templates/en/intent/README.md +118 -0
  129. package/templates/en/intent/cc-sdd/README.md +28 -0
  130. package/templates/en/intent/compass-archive/README.md +9 -0
  131. package/templates/en/intent/compass-archive/archive/.gitkeep +0 -0
  132. package/templates/en/intent/compass-archive.md +7 -0
  133. package/templates/en/intent/constraint-library.md +32 -0
  134. package/templates/en/intent/constraint-starters.md +58 -0
  135. package/templates/en/intent/context-cost-cues.md +55 -0
  136. package/templates/en/intent/deltas/README.md +11 -0
  137. package/templates/en/intent/deltas/archive/.gitkeep +0 -0
  138. package/templates/en/intent/deltas.md +34 -0
  139. package/templates/en/intent/drift-log/README.md +11 -0
  140. package/templates/en/intent/drift-log/archive/.gitkeep +0 -0
  141. package/templates/en/intent/drift-log.md +41 -0
  142. package/templates/en/intent/drift-patterns.md +68 -0
  143. package/templates/en/intent/export-log/README.md +12 -0
  144. package/templates/en/intent/export-log/archive/.gitkeep +0 -0
  145. package/templates/en/intent/export-log.md +6 -0
  146. package/templates/en/intent/glossary.md +23 -0
  147. package/templates/en/intent/intent-compass.md +55 -0
  148. package/templates/en/intent/intent-tree.md +59 -0
  149. package/templates/en/intent/milestones/README.md +10 -0
  150. package/templates/en/intent/milestones/archive/.gitkeep +0 -0
  151. package/templates/en/intent/milestones.md +22 -0
  152. package/templates/en/intent/mode.local.md +23 -0
  153. package/templates/en/intent/mode.md +32 -0
  154. package/templates/en/intent/modes/README.md +28 -0
  155. package/templates/en/intent/modes/behavior-unknown.md +57 -0
  156. package/templates/en/intent/modes/feature-growth.md +57 -0
  157. package/templates/en/intent/modes/non-code.md +46 -0
  158. package/templates/en/intent/modes/refactor.md +56 -0
  159. package/templates/en/intent/modes/standard.md +50 -0
  160. package/templates/en/intent/nl-spec/README.md +18 -0
  161. package/templates/en/intent/openspec/proposal.md +15 -0
  162. package/templates/en/intent/openspec/spec-delta.md +25 -0
  163. package/templates/en/intent/overview/README.md +18 -0
  164. package/templates/en/intent/packets/README.md +29 -0
  165. package/templates/en/intent/packets/index.md +6 -0
  166. package/templates/en/intent/packets/plan.md +23 -0
  167. package/templates/en/intent/release-note/README.md +18 -0
  168. package/templates/en/intent/scripts/intent-check.mjs +786 -0
  169. package/templates/en/intent/scripts/pre-push +27 -0
  170. package/templates/en/intent/spec-ingest/README.md +18 -0
  171. package/templates/ja/agents/claude/CLAUDE.md +62 -0
  172. package/templates/ja/agents/codex/AGENTS.md +62 -0
  173. package/templates/ja/agents/gemini/GEMINI.md +62 -0
  174. package/templates/ja/claude/skills/CONTRACT.md +90 -0
  175. package/templates/ja/claude/skills/intent-compass/SKILL.md +55 -0
  176. package/templates/ja/claude/skills/intent-compass/rules/algo-qoc.md +62 -0
  177. package/templates/ja/claude/skills/intent-compass/rules/constraint-surfacing.md +41 -0
  178. package/templates/ja/claude/skills/intent-discover/SKILL.md +63 -0
  179. package/templates/ja/claude/skills/intent-discover/rules/algo-drift-analysis.md +34 -0
  180. package/templates/ja/claude/skills/intent-discover/rules/algo-gore-lite.md +35 -0
  181. package/templates/ja/claude/skills/intent-discover/rules/algo-impact-analysis.md +37 -0
  182. package/templates/ja/claude/skills/intent-discover/rules/algo-intent-recovery.md +39 -0
  183. package/templates/ja/claude/skills/intent-discover/rules/designer-questions.md +78 -0
  184. package/templates/ja/claude/skills/intent-discover/rules/drift-terrain.md +105 -0
  185. package/templates/ja/claude/skills/intent-discover/rules/mode-selection.md +31 -0
  186. package/templates/ja/claude/skills/intent-export-cc-sdd/SKILL.md +88 -0
  187. package/templates/ja/claude/skills/intent-export-cc-sdd/rules/drift-export-check.md +75 -0
  188. package/templates/ja/claude/skills/intent-export-cc-sdd/rules/export-questions.md +23 -0
  189. package/templates/ja/claude/skills/intent-export-cc-sdd/rules/map-cc-sdd.md +62 -0
  190. package/templates/ja/claude/skills/intent-export-openspec/SKILL.md +90 -0
  191. package/templates/ja/claude/skills/intent-export-openspec/rules/drift-export-check.md +50 -0
  192. package/templates/ja/claude/skills/intent-export-openspec/rules/export-questions.md +23 -0
  193. package/templates/ja/claude/skills/intent-export-openspec/rules/map-openspec.md +75 -0
  194. package/templates/ja/claude/skills/intent-from-spec/SKILL.md +60 -0
  195. package/templates/ja/claude/skills/intent-from-spec/rules/extract-intent.md +56 -0
  196. package/templates/ja/claude/skills/intent-from-spec/rules/gap-readout.md +54 -0
  197. package/templates/ja/claude/skills/intent-from-spec/rules/load-bearing.md +48 -0
  198. package/templates/ja/claude/skills/intent-from-spec/rules/omission-recap.md +42 -0
  199. package/templates/ja/claude/skills/intent-improve/SKILL.md +70 -0
  200. package/templates/ja/claude/skills/intent-improve/rules/improve-axes.md +121 -0
  201. package/templates/ja/claude/skills/intent-overview/SKILL.md +63 -0
  202. package/templates/ja/claude/skills/intent-overview/rules/aggregate-sources.md +61 -0
  203. package/templates/ja/claude/skills/intent-overview/rules/gap-readout.md +54 -0
  204. package/templates/ja/claude/skills/intent-overview/rules/mermaid-tree.md +78 -0
  205. package/templates/ja/claude/skills/intent-overview/rules/progress-readout.md +119 -0
  206. package/templates/ja/claude/skills/intent-packets/SKILL.md +97 -0
  207. package/templates/ja/claude/skills/intent-packets/rules/algo-additive-slicing.md +55 -0
  208. package/templates/ja/claude/skills/intent-packets/rules/algo-characterization-test.md +40 -0
  209. package/templates/ja/claude/skills/intent-packets/rules/algo-example-mapping.md +47 -0
  210. package/templates/ja/claude/skills/intent-packets/rules/algo-migration-slicing.md +47 -0
  211. package/templates/ja/claude/skills/intent-packets/rules/decision-slots.md +88 -0
  212. package/templates/ja/claude/skills/intent-packets/rules/export-route.md +54 -0
  213. package/templates/ja/claude/skills/intent-packets/rules/first-packet.md +35 -0
  214. package/templates/ja/claude/skills/intent-packets/rules/packet-format.md +207 -0
  215. package/templates/ja/claude/skills/intent-packets/rules/walking-skeleton.md +35 -0
  216. package/templates/ja/claude/skills/intent-release-note/SKILL.md +58 -0
  217. package/templates/ja/claude/skills/intent-release-note/rules/format-changelog.md +40 -0
  218. package/templates/ja/claude/skills/intent-release-note/rules/format-github-releases.md +41 -0
  219. package/templates/ja/claude/skills/intent-release-note/rules/format-select.md +32 -0
  220. package/templates/ja/claude/skills/intent-release-note/rules/source-scope.md +42 -0
  221. package/templates/ja/claude/skills/intent-status/SKILL.md +171 -0
  222. package/templates/ja/claude/skills/intent-status/rules/decision-table.md +47 -0
  223. package/templates/ja/claude/skills/intent-to-spec/SKILL.md +68 -0
  224. package/templates/ja/claude/skills/intent-to-spec/rules/fabrication-guard.md +41 -0
  225. package/templates/ja/claude/skills/intent-to-spec/rules/format-integrated.md +42 -0
  226. package/templates/ja/claude/skills/intent-to-spec/rules/format-nonprogram.md +45 -0
  227. package/templates/ja/claude/skills/intent-to-spec/rules/format-upstream.md +41 -0
  228. package/templates/ja/claude/skills/intent-to-spec/rules/source-scope.md +50 -0
  229. package/templates/ja/claude/skills/intent-validate/SKILL.md +80 -0
  230. package/templates/ja/claude/skills/intent-validate/rules/validate-checks.md +121 -0
  231. package/templates/ja/claude/skills/intent-writeback/SKILL.md +71 -0
  232. package/templates/ja/claude/skills/intent-writeback/rules/writeback-protocol.md +139 -0
  233. package/templates/ja/codex/skills/CONTRACT.md +81 -0
  234. package/templates/ja/codex/skills/intent-compass/SKILL.md +52 -0
  235. package/templates/ja/codex/skills/intent-compass/rules/algo-qoc.md +62 -0
  236. package/templates/ja/codex/skills/intent-compass/rules/constraint-surfacing.md +41 -0
  237. package/templates/ja/codex/skills/intent-discover/SKILL.md +60 -0
  238. package/templates/ja/codex/skills/intent-discover/rules/algo-drift-analysis.md +34 -0
  239. package/templates/ja/codex/skills/intent-discover/rules/algo-gore-lite.md +35 -0
  240. package/templates/ja/codex/skills/intent-discover/rules/algo-impact-analysis.md +37 -0
  241. package/templates/ja/codex/skills/intent-discover/rules/algo-intent-recovery.md +39 -0
  242. package/templates/ja/codex/skills/intent-discover/rules/designer-questions.md +78 -0
  243. package/templates/ja/codex/skills/intent-discover/rules/drift-terrain.md +105 -0
  244. package/templates/ja/codex/skills/intent-discover/rules/mode-selection.md +31 -0
  245. package/templates/ja/codex/skills/intent-export-cc-sdd/SKILL.md +85 -0
  246. package/templates/ja/codex/skills/intent-export-cc-sdd/rules/drift-export-check.md +75 -0
  247. package/templates/ja/codex/skills/intent-export-cc-sdd/rules/export-questions.md +23 -0
  248. package/templates/ja/codex/skills/intent-export-cc-sdd/rules/map-cc-sdd.md +62 -0
  249. package/templates/ja/codex/skills/intent-export-openspec/SKILL.md +87 -0
  250. package/templates/ja/codex/skills/intent-export-openspec/rules/drift-export-check.md +50 -0
  251. package/templates/ja/codex/skills/intent-export-openspec/rules/export-questions.md +23 -0
  252. package/templates/ja/codex/skills/intent-export-openspec/rules/map-openspec.md +75 -0
  253. package/templates/ja/codex/skills/intent-from-spec/SKILL.md +58 -0
  254. package/templates/ja/codex/skills/intent-from-spec/rules/extract-intent.md +56 -0
  255. package/templates/ja/codex/skills/intent-from-spec/rules/gap-readout.md +54 -0
  256. package/templates/ja/codex/skills/intent-from-spec/rules/load-bearing.md +48 -0
  257. package/templates/ja/codex/skills/intent-from-spec/rules/omission-recap.md +42 -0
  258. package/templates/ja/codex/skills/intent-improve/SKILL.md +67 -0
  259. package/templates/ja/codex/skills/intent-improve/rules/improve-axes.md +121 -0
  260. package/templates/ja/codex/skills/intent-overview/SKILL.md +61 -0
  261. package/templates/ja/codex/skills/intent-overview/rules/aggregate-sources.md +61 -0
  262. package/templates/ja/codex/skills/intent-overview/rules/gap-readout.md +54 -0
  263. package/templates/ja/codex/skills/intent-overview/rules/mermaid-tree.md +78 -0
  264. package/templates/ja/codex/skills/intent-overview/rules/progress-readout.md +119 -0
  265. package/templates/ja/codex/skills/intent-packets/SKILL.md +94 -0
  266. package/templates/ja/codex/skills/intent-packets/rules/algo-additive-slicing.md +55 -0
  267. package/templates/ja/codex/skills/intent-packets/rules/algo-characterization-test.md +40 -0
  268. package/templates/ja/codex/skills/intent-packets/rules/algo-example-mapping.md +47 -0
  269. package/templates/ja/codex/skills/intent-packets/rules/algo-migration-slicing.md +47 -0
  270. package/templates/ja/codex/skills/intent-packets/rules/decision-slots.md +88 -0
  271. package/templates/ja/codex/skills/intent-packets/rules/export-route.md +54 -0
  272. package/templates/ja/codex/skills/intent-packets/rules/first-packet.md +35 -0
  273. package/templates/ja/codex/skills/intent-packets/rules/packet-format.md +207 -0
  274. package/templates/ja/codex/skills/intent-packets/rules/walking-skeleton.md +35 -0
  275. package/templates/ja/codex/skills/intent-release-note/SKILL.md +56 -0
  276. package/templates/ja/codex/skills/intent-release-note/rules/format-changelog.md +40 -0
  277. package/templates/ja/codex/skills/intent-release-note/rules/format-github-releases.md +41 -0
  278. package/templates/ja/codex/skills/intent-release-note/rules/format-select.md +32 -0
  279. package/templates/ja/codex/skills/intent-release-note/rules/source-scope.md +42 -0
  280. package/templates/ja/codex/skills/intent-status/SKILL.md +169 -0
  281. package/templates/ja/codex/skills/intent-status/rules/decision-table.md +47 -0
  282. package/templates/ja/codex/skills/intent-to-spec/SKILL.md +66 -0
  283. package/templates/ja/codex/skills/intent-to-spec/rules/fabrication-guard.md +41 -0
  284. package/templates/ja/codex/skills/intent-to-spec/rules/format-integrated.md +42 -0
  285. package/templates/ja/codex/skills/intent-to-spec/rules/format-nonprogram.md +45 -0
  286. package/templates/ja/codex/skills/intent-to-spec/rules/format-upstream.md +41 -0
  287. package/templates/ja/codex/skills/intent-to-spec/rules/source-scope.md +50 -0
  288. package/templates/ja/codex/skills/intent-validate/SKILL.md +78 -0
  289. package/templates/ja/codex/skills/intent-validate/rules/validate-checks.md +121 -0
  290. package/templates/ja/codex/skills/intent-writeback/SKILL.md +68 -0
  291. package/templates/ja/codex/skills/intent-writeback/rules/writeback-protocol.md +139 -0
  292. package/templates/ja/intent/README.md +118 -0
  293. package/templates/ja/intent/cc-sdd/README.md +28 -0
  294. package/templates/ja/intent/compass-archive/README.md +9 -0
  295. package/templates/ja/intent/compass-archive/archive/.gitkeep +0 -0
  296. package/templates/ja/intent/compass-archive.md +7 -0
  297. package/templates/ja/intent/constraint-library.md +32 -0
  298. package/templates/ja/intent/constraint-starters.md +58 -0
  299. package/templates/ja/intent/context-cost-cues.md +55 -0
  300. package/templates/ja/intent/deltas/README.md +11 -0
  301. package/templates/ja/intent/deltas/archive/.gitkeep +0 -0
  302. package/templates/ja/intent/deltas.md +34 -0
  303. package/templates/ja/intent/drift-log/README.md +11 -0
  304. package/templates/ja/intent/drift-log/archive/.gitkeep +0 -0
  305. package/templates/ja/intent/drift-log.md +41 -0
  306. package/templates/ja/intent/drift-patterns.md +68 -0
  307. package/templates/ja/intent/export-log/README.md +12 -0
  308. package/templates/ja/intent/export-log/archive/.gitkeep +0 -0
  309. package/templates/ja/intent/export-log.md +6 -0
  310. package/templates/ja/intent/glossary.md +23 -0
  311. package/templates/ja/intent/intent-compass.md +55 -0
  312. package/templates/ja/intent/intent-tree.md +59 -0
  313. package/templates/ja/intent/milestones/README.md +10 -0
  314. package/templates/ja/intent/milestones/archive/.gitkeep +0 -0
  315. package/templates/ja/intent/milestones.md +22 -0
  316. package/templates/ja/intent/mode.local.md +23 -0
  317. package/templates/ja/intent/mode.md +32 -0
  318. package/templates/ja/intent/modes/README.md +28 -0
  319. package/templates/ja/intent/modes/behavior-unknown.md +57 -0
  320. package/templates/ja/intent/modes/feature-growth.md +57 -0
  321. package/templates/ja/intent/modes/non-code.md +46 -0
  322. package/templates/ja/intent/modes/refactor.md +56 -0
  323. package/templates/ja/intent/modes/standard.md +50 -0
  324. package/templates/ja/intent/nl-spec/README.md +18 -0
  325. package/templates/ja/intent/openspec/proposal.md +15 -0
  326. package/templates/ja/intent/openspec/spec-delta.md +25 -0
  327. package/templates/ja/intent/overview/README.md +18 -0
  328. package/templates/ja/intent/packets/README.md +29 -0
  329. package/templates/ja/intent/packets/index.md +6 -0
  330. package/templates/ja/intent/packets/plan.md +23 -0
  331. package/templates/ja/intent/release-note/README.md +18 -0
  332. package/templates/ja/intent/scripts/intent-check.mjs +786 -0
  333. package/templates/ja/intent/scripts/pre-push +27 -0
  334. package/templates/ja/intent/spec-ingest/README.md +18 -0
@@ -0,0 +1,55 @@
1
+ # Intent Compass
2
+
3
+ > `/intent-compass` が更新します。局所最適を防ぐための判断基準を管理します。
4
+
5
+ ## North Star
6
+
7
+ この変更で近づきたい最終状態。
8
+
9
+ ## Current Drift
10
+
11
+ 現状、どの intent からどうズレているか(このズレを drift と呼ぶ)。
12
+
13
+ ## Direction
14
+
15
+ 今回の作業で強める方向。
16
+
17
+ ## Anti-direction
18
+
19
+ 今回避ける方向。Claude がやりがちな局所最適(全体の意図より目先の修正を優先してしまうこと)・小手先リファクタもここに明示列挙する。例: 「ついでに別の処理も直す」「テストなしの一括置換」「ドメインロジックを UI に寄せる」。
20
+
21
+ ## Invariants
22
+
23
+ 絶対に壊してはいけない振る舞い・API・データ・UX・運用制約。
24
+
25
+ > 否定形発問(「これを無視したら最悪何が起きるか」等)で確認した結果、真に守るべきと確定した**普遍**制約のみをここへ記入する(過剰前提は混入しない)。packet 固有の制約候補は Open Questions に保留する。
26
+
27
+ ここに保持するのは**プロジェクト普遍 invariant** のみ:
28
+
29
+ - **プロジェクト普遍 invariant**: feature を問わず全作業で守る少量の制約。`/kiro-steering-custom` で `.kiro/steering/` に置くと全作業で効く(起動時コンテキスト増を最小化するため少量に限る)。
30
+ - **packet 固有 invariant**(特定の作業単位でのみ守る制約)の正本は各 packet ファイル(`.intent/packets/active/<packet_id>.md`)の Safety / Invariants 節。compass には書かない。export 時は packet ファイルから cc-sdd の tasks へ焼き込まれる。packet が archive へ移動すると packet 固有 invariant も packet ファイルとともに退場する(compass 側に残骸を残さない)。
31
+
32
+ ## Decision Rules
33
+
34
+ 迷ったときの判断基準。1判断1エントリの軽量 ADR として残す: **Context**(問いと状況)/ **Decision**(採る選択肢)/ **Why**(基準)/ **Alternatives considered**(検討した代替案。QOC の不採用 Options とその理由の要約)/ **Consequences**(Invariants・Anti-direction への接続)/ **Revisit when**(見直し条件。定まらない場合は「未定」と明示し空欄にしない)。決定を覆すときは、新しいエントリを追加し、古いエントリに superseded と後継への参照を明記したうえで6欄のまま `.intent/compass-archive.md` へ移動する(compass には現役の判断基準だけが残る)。
35
+
36
+ 例:
37
+ - **Context**: 集計ロジックの置き場所(UI で完結 vs ドメイン層) / **Decision**: ドメイン層に置く / **Why**: L3 の境界 intent(UI は表示のみ)に一致 / **Alternatives considered**: UI で完結 — 表示と集計が混在し L3 の境界 intent に反するため不採用 / **Consequences**: Invariant「Domain logic を UI framework に寄せない」を全 packet に課す / **Revisit when**: 表示専用の集計がドメイン層を肥大化させ始めたとき
38
+ - **Context**: 大きな置換の進め方(一括置換 vs 段階移行) / **Decision**: rollback 可能な slice を優先 / **Why**: behavior-preserving を観測可能に保つ / **Alternatives considered**: 一括置換 — 失敗時に切り戻せず behavior-preserving を観測できないため不採用 / **Consequences**: Anti-direction「テストなしの大規模置換」を禁止に追加 / **Revisit when**: 未定
39
+
40
+ ## Evidence
41
+
42
+ この intent を支える証拠。README、コード、テスト、ログ、ユーザー課題、運用課題など。
43
+
44
+ Updated (Invariants): —
45
+ Updated (Decision Rules): —
46
+
47
+ > Invariants 節 / Decision Rules 節それぞれを最後に更新した時点。`/intent-compass` が当該節を更新したときに ISO 8601 で打刻する(初期値の `—` は未打刻を表す)。read-only 検証(intent-validate の stale 検査)が packet の `updated_at` と比較する際の compass 側の基準であり、`—` の節は比較対象外(未検証としてスキップ)になる。
48
+
49
+ ## Open Questions
50
+
51
+ 判断に必要だが未確定の問い。
52
+
53
+ > 否定形発問で挙がった制約のうち、特定の作業単位でのみ守る **packet 固有制約(候補)** は、行き先の packet が定まるまでここに保留する(packet 起票時に当該 packet の Safety / Invariants へ転記される)。
54
+
55
+ > 回答はいつでも構いません(未回答でも planning は先に進められます)。このファイルを直接編集するか、会話で伝えると次のスキル実行時に反映されます。export までに回答が必要な問いにのみ `[export まで]` タグを付けます(タグのない問いはいつでも回答可)。
@@ -0,0 +1,59 @@
1
+ # Intent Tree
2
+
3
+ > `/intent-discover` が更新します。canonical(確定)と inferred(推測=Assumptions)を混ぜないこと。L0〜L4 は意図の階層レベル(Level。L0=目的 〜 L4=作業単位候補)。
4
+
5
+ ## L0: Product Purpose
6
+
7
+ このプロダクト / アプリ / サブシステムは何のために存在するか。
8
+
9
+ > 推論した目的をユーザーに追認した結果(確定した目的)を canonical として記入する。未追認・推測のものは Assumptions へ。
10
+
11
+ ## L1: Desired Outcomes
12
+
13
+ ユーザー・事業・運用・開発体験にどんな状態変化を起こしたいか。designer-questions が on のときは、各 L1 項目に `計測基準:` 行(達成をどう観測・判定するか)を併記する。
14
+
15
+ > 追認した想定ユーザー(Actor)と成功の定義をここに記入する(誰のどんな状態変化か)。追認できていないものは Assumptions / Open Questions へ。
16
+
17
+ ## L2: Capabilities
18
+
19
+ Desired Outcome を支える能力。機能名ではなく、責務・能力として書く。
20
+
21
+ ## L3: Behavioral / Architectural Intents
22
+
23
+ Capability を成立させるための振る舞い・設計意図。境界、依存方向、副作用、データ整合性、UI/UX 制約などを含める。
24
+
25
+ ## L4: Candidate Packets
26
+
27
+ 実装に落とす前の候補作業単位。Issue より少し上位、spec より少し手前の粒度。
28
+
29
+ ## PoC 実験定義(purpose: poc のとき記入)
30
+
31
+ > `/intent-discover` が purpose=poc のときに更新します。purpose が poc でない場合は空のままで構いません。
32
+
33
+ ### 仮説
34
+
35
+ この PoC で何を確かめるか。
36
+
37
+ ### 反証条件
38
+
39
+ 何が観測できなければ仮説を棄却するか。
40
+
41
+ ### GO/NO-GO 基準
42
+
43
+ PoC 完了後に先へ進む / やめるを判定する条件。
44
+
45
+ ## 画面ラフ参照(designer-questions: on のとき記入)
46
+
47
+ > `/intent-discover` が designer-questions=on のときに更新します。ユーザー向け画面を含む場合はラフ(ワイヤーフレーム・スケッチ等)のパスまたはリンク、無しと判断した場合はその理由。UI 非該当の場合は「対象外」。
48
+
49
+ ## Open Questions
50
+
51
+ 人間が確認すべき未確定事項。
52
+
53
+ > 追認できなかった目的・成功の定義・想定ユーザーは、確定するまでここに保留する(確定したら L0 / L1 へ移す)。
54
+
55
+ > 回答はいつでも構いません(未回答でも planning は先に進められます)。このファイルを直接編集するか、会話で伝えると次のスキル実行時に反映されます。export までに回答が必要な問いにのみ `[export まで]` タグを付けます(タグのない問いはいつでも回答可)。
56
+
57
+ ## Assumptions
58
+
59
+ AI が推測した前提。推測は canonical な intent と混ぜない。
@@ -0,0 +1,10 @@
1
+ # milestones/(分割形の active 面)
2
+
3
+ milestones は **事象由来**の記録なので、**日付+slug 単位ファイル** `milestones/<date>-<event-slug>.md` に分割して書く。別事象が別ファイルを触るため末尾衝突が原理的に消える。
4
+
5
+ - ここ(active 面)には現在参照する節目イベントだけを薄く置く。
6
+ - 終端した(もう参照しない)エントリは `milestones/archive/<年>/` へ退避する。
7
+ - ファイル名の `<event-slug>` は event 自然文を既存のスラッグ規則(`intent-packets/rules/packet-format.md`)で導出する。`<date>` は recorded_at。連番(`0001` 等の中央カウンタ)は使わない。
8
+ - **手動記入**: milestones は利用者が宣言的に記入する記録です。分割形では、節目イベントごとに `milestones/<date>-<event-slug>.md` を1ファイル作って `| event | recorded_at | note |` の1行を書きます(event 自然文はそのまま保持=improve の Revisit 照合・status の未消化検出が読む)。
9
+
10
+ > この README は規約の**言い換え**であり、規約の単一正本は CONTRACT.md「append-only 記録の分割・archive 規約」。置き方の判断は CONTRACT を参照すること。
@@ -0,0 +1,22 @@
1
+ # Milestones
2
+
3
+ > プロジェクトの節目イベント(「本番構成確定」「外部公開 API 化」等)を1行追記で記録します。書き手は利用者だけで、読み手は `/intent-improve`(各 event を Decision Rules の `Revisit when` と照合)と `/intent-status`(未消化 milestone の残課題表示)です。決定・学び・状態は持たず、節目イベントの記録専用です。
4
+
5
+ ## 運用説明
6
+
7
+ - **append-only**: 行は追記のみです。過去の行を書き換えたり削除したりしません(世界線アンカーの非対称を生まないため)。
8
+ - **利用者が宣言的に記入する**: 節目イベントは利用者が手で記入します。このファイルは自動検出をしません(記録の主体は利用者です)。
9
+ - **分割形で記入する(CONTRACT「append-only 記録の分割・archive 規約」)**: milestones は事象由来なので、この単一ファイル末尾へ追記する代わりに、節目イベントごとに **日付+slug 単位の分割ファイル** `milestones/<date>-<event-slug>.md` を1ファイル作って `| event | recorded_at | note |` の1行を書きます。`<date>` は recorded_at、`<event-slug>` は event 自然文を既存スラッグ規則(`intent-packets/rules/packet-format.md`)で導出します(連番は使いません)。event 自然文はそのまま保持してください(読み手の照合対象)。置き方の詳細は `milestones/README.md`、規約の正本は CONTRACT を参照。終端した節目は `milestones/archive/<年>/` へ退避できます。
10
+ - **読み手の参照**: `/intent-improve` が各 `event` を全 Decision Rule の `Revisit when` 欄と substring(部分文字列)照合し、合致した Rule を見直し再提案へ挙げます。`/intent-status` は記録済みだが対応する見直しが未処理の milestone を残課題として併記します。いずれも read-only の照合で、compass を自動書き換えしません。
11
+
12
+ ## 記入の指針
13
+
14
+ - **event**: Decision Rule の `Revisit when` と substring 照合する自然文の文字列です。短すぎると過剰一致するため、何が確定した節目かが分かる十分に具体的な自然文を書いてください(例:「本番構成を AWS ECS に確定」)。
15
+ - **recorded_at**: ISO 8601(例: `2026-06-18`)で記入します。
16
+ - **note**: 任意の補足です(不要なら `-`)。
17
+
18
+ | event | recorded_at | note |
19
+ |---|---|---|
20
+ <!-- 記入例(このコメント行は実テーブルに含めません):
21
+ | 本番構成を AWS ECS に確定 | 2026-06-18 | 開発合宿でインフラ方針を確定 |
22
+ -->
@@ -0,0 +1,23 @@
1
+ # Active Mode(ローカル)
2
+
3
+ > `/intent-discover` がモードを確定したときに更新します。これは intent-* スキル間で共有される作業状態(mode の詰め方)です。
4
+ > **このファイルはローカル専用(git 非追跡)です。** チーム/並行セッションで各自の作業モードが衝突しないよう、`mode` / `designer-questions` / `purpose`(作業の詰め方)をここに置きます。共有したいポリシー(Enforcement / Drift-watch)は `mode.md`(追跡)にあります。
5
+
6
+ - **mode**: (未確定 — `/intent-discover` を実行すると推奨・確定されます)
7
+ - **selected**: (確定日 ISO 8601)
8
+ - **reason**: (なぜこのモードが選ばれたか)
9
+ - **definition**: (例: `.intent/modes/standard.md`)
10
+ - **designer-questions**: (未確定 — on / off。設計者役の詰めの問い。`/intent-discover` が説明・確認・記録します)
11
+ - **purpose**: (未確定 — poc / product。designer-questions が on のとき `/intent-discover` が確認・記録します)
12
+ - **format**: (未確定 — cc-sdd / openspec / to-spec。案件の出力体裁=どの出口へ進むか。任意。`/intent-discover` が推奨・確認・記録します。未指定なら出口は案件種別から推論されます)
13
+
14
+ ## このファイルの扱い(スキル共通の規約)
15
+
16
+ - `/intent-discover` がモード推奨 → 利用者確認 → ここに確定結果を書きます。
17
+ - `/intent-compass` / `/intent-packets` / `/intent-export-cc-sdd` 等は、このファイルを読み、`definition` のモード定義に従って動きます。
18
+ - **読み取りの後方互換(read fallback)**: 読み手は **このファイル(`mode.local.md`)→ 無ければ旧 `mode.md` の mode 状態 → どちらにも無ければ `standard` 既定** の順で読みます。旧 scaffold(mode 状態が `mode.md` にしか無い既存環境)でも壊れません。
19
+ - **このファイルが未確定 / 不在のとき**: 各スキルは停止せず `standard` を既定モードとして続行し、出力の Open Questions に「モードが未確定。`/intent-discover` でモードを確定することを推奨」を併記します。
20
+ - これは「前段の成果物(tree/compass/packets)が無いとき停止案内する」のとは区別されます。mode 状態の不在だけでは停止しません。
21
+ - **designer-questions / purpose が未記録・行自体が無い(旧 scaffold)とき**: 各スキルは停止せず未確定として続行し、出力の Open Questions に告知します。読み手は必ず designer-questions を先に判定します(on と記録されていない限り purpose の値を参照しません)。designer-questions / purpose を書くのは `/intent-discover` のみです。
22
+ - **format の読み取り契約(未指定の3形態)**: `format` は案件の出力体裁(どの出口へ進むか= cc-sdd / openspec / to-spec)を記録する任意フィールドです。読み手(`/intent-packets` の出口判定・export 系の preflight)は、次の3形態をすべて「**未指定**」として同一に扱い、停止せず案件種別(mode・`.kiro/` の有無等)からの**推論**へ倒します: ①`format` 行が無い(旧 scaffold / 既存環境)②プレースホルダ値(`(未確定 — …)`)③値域(cc-sdd / openspec / to-spec)外の値。`format` が有効値で明示されているときのみ、その出口を確定的に読み取ります。`format` を書くのは `/intent-discover` のみで、未指定でも各スキルは従来どおり動作します(後方互換)。
23
+ - **ローカル専用の理由**: `mode` / `designer-questions` / `purpose` は「いま誰が・どの作業をしているか」に紐づく動的な状態です。git で共有すると、チーム開発で他メンバーの作業モードが pull で降ってきたり、並行セッションで上書きされて衝突します。そのため git 非追跡にします(installer が `.gitignore` に登録します)。共有したいポリシー(Enforcement / Drift-watch)は追跡される `mode.md` に置きます。
@@ -0,0 +1,32 @@
1
+ # Shared Policy(共有ポリシー)
2
+
3
+ > このファイルは **チームで共有する(git 追跡される)** ポリシーを置きます: `Enforcement`(書き戻し強制)と `Drift-watch`(逸脱監視)。
4
+ > **作業の詰め方(`mode` / `designer-questions` / `purpose`)は `mode.local.md`(ローカル専用・git 非追跡)にあります。** チーム/並行セッションでの衝突を避けるため分離しています。
5
+ > **後方互換**: 旧 scaffold ではこのファイルに mode 状態も同居していました。読み手は `mode.local.md` を先に読み、無ければこのファイルの mode 状態行(在れば)にフォールバックします。
6
+
7
+ ## Enforcement(ユーザー管理)
8
+
9
+ > このセクションは利用者だけが編集します。`/intent-discover` を含むスキルはこのセクションを変更しません(読み取りのみ)。
10
+
11
+ - **enforcement**: off
12
+ - **enforcement-threshold**: 5
13
+ - **enforcement-exclude**:
14
+
15
+ - **enforcement** — 書き戻し(writeback)強制の強度。値は `off` | `remind` | `gate` の3つです:
16
+ - `off`(既定): 検査を行いません。従来どおりの動作です。
17
+ - `remind`: 書き戻し漏れを検出したら警告のみ表示します。停止はしません。
18
+ - `gate`: 書き戻し漏れを検出したら export / push を停止します(明示的な続行指示や `--no-verify` の逃げ道は残ります)。
19
+ - **enforcement-threshold** — staleness(書き戻し漏れ)と判定するコミット数の閾値です。正の整数(既定: 5)。
20
+ - **enforcement-exclude** — staleness の計数から除くパス(カンマ区切りの相対パス接頭辞。空のままで構いません)。`.intent/` は常に暗黙で除外されます。
21
+ - 切り替えはこのファイルを直接編集して行います。未記載・不正値のときは off / 5 / 除外なし として扱われ、停止しません。
22
+
23
+ ## Drift-watch(ユーザー管理)
24
+
25
+ > このセクションは利用者だけが編集します。`/intent-discover` を含むスキルはこのセクションを変更しません(読み取りのみ)。
26
+
27
+ - **drift-watch**: off
28
+
29
+ - **drift-watch** — 逸脱(drift)監視の強度。値は `off` | `on` の2つです:
30
+ - `off`(既定): 何もしません。従来どおりの動作です。
31
+ - `on`: discover で地形診断、export 水際で compass 照合の警告を出し、検知を drift-log.md に記録します。**いずれも警告のみで、停止はしません**(enforcement の gate とは別概念。誤検知前提のため停止しません)。
32
+ - 切り替えはこのファイルを直接編集して行います。off|on の2値のみで、停止(gate 相当)の値は持ちません。未記載・不正値のときは off として扱われ、停止しません。
@@ -0,0 +1,28 @@
1
+ # Modes — Intent の詰め方アルゴリズムの拡張点
2
+
3
+ このディレクトリは「モード」を保持します。モードとは、Intent をどう詰めるか(アルゴリズムの組み合わせ)を定義した戦略です。`/intent-discover` がリポジトリ状況からモードを推奨し、確定したモードは `../mode.md` に記録されます。以降のコマンドは `mode.md` を読み、対応するモード定義に従って動きます。
4
+
5
+ ## 3層構造
6
+
7
+ Intent の詰め方は3層に分離されています。
8
+
9
+ 1. **Mode**(`modes/*.md`)— フェーズ → アルゴリズムの組み合わせ表(このディレクトリ)
10
+ 2. **Algorithm**(各 skill の `rules/algo-*.md` / `rules/map-*.md`)— 個別の Intent 抽出・変換技法
11
+ 3. **Skill**(`.claude/skills/intent-*/SKILL.md`)— モードを読み込んで実行する実体
12
+
13
+ ## 同梱モード
14
+
15
+ - `standard.md` — GORE-lite + QOC + Example Mapping + map-cc-sdd。標準(既定)の汎用モード。新規プロダクトに加え、状況特化モードが当てはまらない既存プロジェクトでも使う。
16
+ - `refactor.md` — GORE-lite + Drift Analysis + Migration Slicing + QOC + map-cc-sdd。既存大規模プロジェクトのリファクタ・再設計向け。
17
+ - `behavior-unknown.md` — GORE-lite + Example Mapping + Characterization Test + QOC + map-cc-sdd。振る舞いが不明なレガシー向け。
18
+ - `feature-growth.md` — GORE-lite + Impact Analysis + QOC + Example Mapping + Additive Slicing + map-cc-sdd。既存の稼働中システムへの新機能追加向け。
19
+ - `non-code.md` — GORE-lite + QOC + Example Mapping + map-cc-sdd。非プログラム成果物(文書・業務プロセス・研究/意思決定)向け(cc-sdd/openspec を使わず読める成果物を出す)。
20
+
21
+ ## 新しいモードを追加する
22
+
23
+ 1. このディレクトリに `modes/<your-mode>.md` を1枚追加する。`standard.md` を雛形に、各フェーズ(discover/compass/packets/export)でどのアルゴリズムを使うかの組み合わせ表と適合状況を書く。
24
+ 2. 既存のアルゴリズム(GORE-lite/QOC/Example Mapping/map-cc-sdd)で足りる場合は、それらを参照するだけでよい。
25
+ 3. 新しいアルゴリズムが必要な場合のみ、対応する skill の `rules/` に `algo-<name>.md` を追加し、モード定義から参照する。
26
+ 4. `/intent-discover` のモード推奨ロジック(`intent-discover/rules/mode-selection.md`)に、新モードを推奨する条件を追記する。
27
+
28
+ `refactor.md` / `behavior-unknown.md` / `feature-growth.md` は同梱済みです。さらに別のモードを足したい場合に、上記の手順で追加してください。
@@ -0,0 +1,57 @@
1
+ # Mode: behavior-unknown
2
+
3
+ 振る舞いが不明なレガシーコードを対象に、観測可能な挙動を例で固定し、未知の振る舞いを characterization で押さえてから意図を起こすモード。
4
+
5
+ ## このモードが組み合わせるアルゴリズム
6
+
7
+ | フェーズ | アルゴリズム | 目的 |
8
+ |---|---|---|
9
+ | Intent Tree 構築 | **GORE-lite** (Goal-Oriented Requirements Engineering の軽量版) | L0(目的)→L1(成果)→L2(能力)→L3(振る舞い/設計意図)→L4(候補パケット) へゴールを段階分解する。仕様が失われている場合、L3 は確定でなく inferred(推測) として置き、後段の characterization で裏取りする |
10
+ | 判断の記録 | **QOC** (Questions-Options-Criteria) | 設計判断を「問い・選択肢・選択基準」で残し、Compass の Decision Rules / Open Questions に流す |
11
+ | 振る舞いの具体化 / packet 分解 | **Characterization Test** → **Example Mapping** | 未知の挙動はまず Characterization Test で「現状こう動く」を観測点として固定し、その観測事実を Example Mapping でルール・例・疑問・切り出しへ整理して、packet の Expected Behavior と Validation を導く(既知の部分集合のみ Example Mapping 先行可) |
12
+ | spec への橋渡し | **map-cc-sdd** | 選んだ packet を cc-sdd の Project Description / design・tasks ヒントへ変換する |
13
+
14
+ 各アルゴリズムの詳細は、対応する skill の `rules/algo-*.md`(map-cc-sdd は `rules/map-cc-sdd.md`)にあります。このモード定義はそれらを「どのフェーズで使うか」の組み合わせ表です。
15
+
16
+ ## 各コマンドでの適用
17
+
18
+ ### intent-discover (GORE-lite)
19
+ - L0: なぜ存在するか。1〜2文。
20
+ - L1: 誰の・何の状態をどう変えたいか(ユーザー/事業/運用/開発体験)。
21
+ - L2: L1 を支える能力。機能名でなく責務として書く。
22
+ - L3: L2 を成立させる振る舞い・設計意図(境界・依存方向・副作用・整合性・UX制約)。
23
+ - L4: 実装手前の候補作業単位。Issue より上位、spec より手前。
24
+ - 仕様やテストが失われている対象では、現状の挙動が正しいとは限らない。観測から起こした L3 は canonical(確定) ではなく inferred(推測=Assumptions) として置き、絶対に確定と混ぜない。
25
+ - 「現状の挙動が正なのか不明」な分岐は QOC の種として Open Questions に置き、後段の Characterization Test で観測して裏取りする。
26
+
27
+ ### intent-compass (QOC)
28
+ - Intent Tree から North Star を引く。
29
+ - 各 Decision Rule は軽量 ADR として凝縮: Context(問いと状況) / Decision(採る選択肢) / Why(基準) / Consequences(Invariants・Anti-direction への接続)。QOC は選択肢を比較する探索の道具、Decision Rule は将来の実装セッションを拘束する正本。
30
+ - Anti-direction には Claude がやりがちな局所最適を必ず明示列挙する。特に「未確認の挙動を正しいと決めつけて変更する」傾向を明示する。
31
+ - Invariants は壊してはいけない振る舞い/API/データ/UX/運用制約。プロジェクト普遍 / packet 固有 の2層に区別する。振る舞い不明な対象では、まず Characterization Test で観測して確定した挙動だけを Invariant に昇格させる。
32
+
33
+ ### intent-packets (Example Mapping + Characterization Test)
34
+ - **実行順序(重要)**: 振る舞いが不明な対象では、知らない挙動の「例」は書けない。よって **Characterization Test を先に**走らせて現状の生の挙動を観測・固定し、その観測事実を入力に **Example Mapping で後から**ルール・例・疑問・切り出しへ整理する。すでに理解できている挙動の部分集合についてのみ、Example Mapping を先行させてよい。
35
+ - **どちらに振り分けるか(ルーティング)**: ある挙動を「すでにルールとして言語化できる」なら Example Mapping、「経験的に観測してしか押さえられない(仕様が失われ確証がない)」なら Characterization Test。両者とも観測可能な挙動を扱うが、判断軸は「articulate できるか / pin するしかないか」。
36
+ - Characterization Test(先):
37
+ - 現状のコードを入力し、「今こう動く」を観測してそのまま観測点に固定する(正しさの判断は保留し、現状を記録する)。意図的な挙動か偶発的な挙動かを仕分け、仕分け不能なものは Open Questions へ送る。
38
+ - 観測した現状挙動を packet の Expected Behavior / Validation の出発点にし、未知の挙動を回帰の安全網として押さえる。
39
+ - Example Mapping(後/既知部分は先):
40
+ - ルール: その能力が従う規則(characterization の観測事実、または既知の挙動から導く)
41
+ - 例: 観測可能な具体シナリオ → packet の Expected Behavior
42
+ - 疑問: 未確定 → packet の Open Questions / Compass へ差し戻し
43
+ - 切り出し: 今回やらないと決めたこと → 黙って落とさず `.intent/packets/plan.md` の Deferred 節に記録し、後続 packet の種 / Open Questions にする
44
+ - 例と characterization 観測点から Validation(テスト/手動/型/ログ)と Rollback を導く。
45
+ - packet は testable / rollbackable を満たす。数は改修見込みの規模に応じて可変とし、数合わせをしない(小規模なら 1 個でよい・1〜7 を緩い目安とする)。各 packet に parent intent と、characterization で押さえた観測点への参照を残す。ここでの **behavior-preserving は「characterization で固定した現状挙動を回帰ベースラインとして保つ」意味**であり、現状の挙動が正しいと主張するものではない(誤った挙動の修正は別途 intent として明示する)。
46
+
47
+ ### intent-export-cc-sdd (map-cc-sdd)
48
+ - packet 1つを cc-sdd の Project Description(凝縮)と design/tasks ヒントへ変換。
49
+ - 入力は対象 packet と Compass の Invariants/Anti-direction に限定する。
50
+ - tasks ヒントには必ず parent intent と invariant への参照を残す。
51
+
52
+ ## 適合する状況
53
+ - 振る舞いが不明なレガシーコードが対象のとき
54
+ - テストがない、または少なく、現状の挙動を保証する安全網が欠けているとき
55
+ - 仕様・設計意図が失われており、コードの観測からしか振る舞いを起こせないとき
56
+ - 現状の挙動が正しいのか不明で、まず「今どう動くか」を固定してから意図を構造化したいとき
57
+ - **refactor との使い分け**: 現状の振る舞いが既知で信頼できる(あるべき設計を言語化できる)なら refactor。現状の振る舞いが不明・信頼できず、観測して固定するところから始める必要があるなら behavior-unknown。
@@ -0,0 +1,57 @@
1
+ # Mode: feature-growth
2
+
3
+ 既存の稼働中システムに新機能を安全に付加するためのモード。新機能が触れる既存の境界・契約を実装前に棚卸して保護し、接合面(seam)を先に確立してから付加的に積むことで、既存のアーキテクチャ境界を守ったまま機能を育てる。
4
+
5
+ ## このモードが組み合わせるアルゴリズム
6
+
7
+ | フェーズ | アルゴリズム | 目的 |
8
+ |---|---|---|
9
+ | Intent Tree 構築 | **GORE-lite** (Goal-Oriented Requirements Engineering の軽量版) + **Impact Analysis** | L0(目的)→L1(成果)→L2(能力)→L3(振る舞い/設計意図)→L4(候補パケット) へゴールを段階分解し、新機能の intent を既存の Intent Tree へ追記する。続いて新機能が触れる既存の境界・契約・データフローを読解で棚卸し、影響リスト(触れる境界 / 依存する既存契約 / 影響の種類)を起こす |
10
+ | 判断の記録 | **QOC** (Questions-Options-Criteria) | 設計判断を「問い・選択肢・選択基準」で残し、Compass の Decision Rules / Open Questions に流す |
11
+ | 振る舞いの具体化 / packet 分解 | **Example Mapping** + **Additive Slicing** | 新機能の振る舞いを観測可能な具体例(ルール・例・疑問・切り出し)に落とし、接合面(seam)の確立→付加→結線の3段の付加スライスへ分解して、packet の Expected Behavior と Validation を導く |
12
+ | spec への橋渡し | **map-cc-sdd** | 選んだ packet を cc-sdd の Project Description / design・tasks ヒントへ変換する |
13
+
14
+ 各アルゴリズムの詳細は、対応する skill の `rules/algo-*.md`(map-cc-sdd は `rules/map-cc-sdd.md`)にあります。このモード定義はそれらを「どのフェーズで使うか」の組み合わせ表です。
15
+
16
+ ## 各コマンドでの適用
17
+
18
+ ### intent-discover (GORE-lite + Impact Analysis)
19
+ - 冒頭に**簡易 Impact Mapping**(Adzic: Why→Who→How→What の一方向ツリー)を一枚書き、機能追加と事業成果の接続を確認してから GORE-lite へ移る。機能追加は「何を作るか(What)」が先行して Why が切れやすい。確認した Impact の階層はそのまま GORE-lite の L0–L2 へ深化させる: Why は L0/L1(目的・成果)へ、Who/How は L1(誰の・何の状態をどう変えるか)へ、What は L2 以下の候補の種へ。
20
+ - GORE-lite で新機能の intent を既存の Intent Tree へ**追記**する(インクリメンタル更新)。既存 tree がまだ無い場合は、新機能の範囲で L0–L4 を起こす。
21
+ - L0: なぜ存在するか。1〜2文。
22
+ - L1: 誰の・何の状態をどう変えたいか(ユーザー/事業/運用/開発体験)。
23
+ - L2: L1 を支える能力。機能名でなく責務として書く。
24
+ - L3: L2 を成立させる振る舞い・設計意図(境界・依存方向・副作用・整合性・UX制約)。
25
+ - L4: 実装手前の候補作業単位。Issue より上位、spec より手前。
26
+ - 続いて Impact Analysis で、新機能が触れる既存の境界・契約・データフローを読解で棚卸し、影響リスト(各項目: 触れる境界 / 依存する既存契約 / 影響の種類、証拠付き)を作成する(詳細は `algo-impact-analysis.md`)。影響リストは compass の Invariants 化と packets の接合点設計の入力になる。
27
+ - canonical(確定) と inferred(推測=Assumptions) を絶対に混ぜない。
28
+ - **drift を発見したら直さない**: 調査中に既存設計の構造的問題(drift: feature-growth の目的外の問題)を見つけたら、本モード内で修正せず Open Questions へ記録し、refactor モードでの別作業を推奨する。
29
+
30
+ ### intent-compass (QOC)
31
+ - Intent Tree から North Star を引く。
32
+ - 影響リストの各境界を Invariants 化する(「X の既存契約を変えない」)。Invariants は壊してはいけない振る舞い/API/データ/UX/運用制約。プロジェクト普遍 / packet 固有 の2層に区別する。
33
+ - Anti-direction には Claude がやりがちな局所最適を必ず明示列挙する。feature-growth 固有の典型をプレモータム(先回りの失敗想定)で列挙する: 「ついでに既存をリファクタする」「seam を作らず既存モジュールへ直埋めする」「既存テストを書き換えて辻褄を合わせる」。
34
+ - 各 Decision Rule は軽量 ADR として凝縮: Context(問いと状況) / Decision(採る選択肢) / Why(基準) / Consequences(Invariants・Anti-direction への接続)。QOC は選択肢を比較する探索の道具、Decision Rule は将来の実装セッションを拘束する正本。
35
+
36
+ ### intent-packets (Example Mapping + Additive Slicing)
37
+ - Example Mapping で新機能の振る舞いを具体化する:
38
+ - ルール: その能力が従う規則
39
+ - 例: 観測可能な具体シナリオ → packet の Expected Behavior
40
+ - 疑問: 未確定 → packet の Open Questions / Compass へ差し戻し
41
+ - 切り出し: 今回やらないと決めたこと → 黙って落とさず `.intent/packets/plan.md` の Deferred 節に記録し、後続 packet の種 / Open Questions にする
42
+ - **入力契約(重要)**: Additive Slicing は discover フェーズの Impact Analysis が出した**影響リストを入力に取る**。薄い影響リストはスライスを推測にする — 接合点を設計できる厚みが無ければ discover に戻って影響リストを厚くする。
43
+ - Additive Slicing で、Example Mapping の例が流れ込んだ新機能を「接合面(seam)の確立 → 新機能の付加的な積み上げ → 既存への結線」の3段の付加スライスへ分解する(詳細は `algo-additive-slicing.md`)。
44
+ - **影響リストのトレーサビリティ(必須)**: 影響リストの各項目は「いずれかのスライスの Safety / Invariants で保護される」か「Open Questions へ送られる」かのいずれかに終端させる。項目を黙って落とさない。
45
+ - 例から Validation(テスト/手動/型/ログ)と Rollback を導き、各 packet に Toggle Plan(どの範囲が off-by-default か / toggle の削除条件)を付ける。
46
+ - packet は behavior-preserving / testable / rollbackable を満たす。数は改修見込みの規模に応じて可変とし、数合わせをしない(小規模なら 1 個でよい・1〜7 を緩い目安とする)。各 packet に parent intent(影響リスト項目の保護なら元の項目も)への参照を残す。
47
+
48
+ ### intent-export-cc-sdd (map-cc-sdd)
49
+ - packet 1つを cc-sdd の Project Description(凝縮)と design/tasks ヒントへ変換。
50
+ - 入力は対象 packet と Compass の Invariants/Anti-direction に限定する。
51
+ - tasks ヒントには必ず parent intent と invariant への参照を残す。
52
+
53
+ ## 適合する状況
54
+ - 既存の稼働中システムに新機能を追加するとき(extend / integrate / add-to 系の要望)
55
+ - 対象の振る舞いが既知で、再設計(drift 解消)が目的でないとき
56
+ - 新しい作業が既存のアーキテクチャ境界・依存方向を壊さないよう、触れる境界を体系的に棚卸して保護したいとき
57
+ - **standard / refactor / behavior-unknown との使い分け**: 既存の構造を変えたい(drift 解消・再設計が目的)なら refactor。現状の振る舞い自体が不明で、まず観測・固定が必要なら behavior-unknown。新規プロダクトや汎用的な意図整理なら standard。既存システムへの機能の付加が目的なら feature-growth。
@@ -0,0 +1,46 @@
1
+ # Mode: non-code
2
+
3
+ 非プログラム成果物(文書・業務プロセス・研究/意思決定など)の意図を詰めるためのモード。コードという成果物を前提にせず、文章・手順・判断といった非実行物を成果物として、その意図を段階分解し具体化する。詰め方(how-to-elaborate)の軸のみを担い、最終的な出力フォーマット(target format)は別の軸(format)が担当するため、このモード定義には出力形式の取り決めを書かない。
4
+
5
+ ## このモードが組み合わせるアルゴリズム
6
+
7
+ 非プログラム成果物(文書・業務プロセス・研究/意思決定)の意図をどう詰めるか(how-to-elaborate)の組み合わせ表。standard と同じ基幹 algo を流用し、目的列の語彙だけを非プログラム成果物(文書・業務・研究)向けに読み替える。新しい algo rule ファイルは追加しない(流用)。
8
+
9
+ | フェーズ | アルゴリズム | 目的 |
10
+ |---|---|---|
11
+ | Intent Tree 構築 | **GORE-lite** (Goal-Oriented Requirements Engineering の軽量版) | L0(目的)→L1(成果)→L2(能力)→L3(振る舞い/設計意図)→L4(候補パケット) へゴールを段階分解する。ここでの「能力・振る舞い」は実装ではなく、文書・手順・判断という非実行物が満たすべき内容・流れ・論点として読み替える |
12
+ | 判断の記録 | **QOC** (Questions-Options-Criteria) | 設計判断を「問い・選択肢・選択基準」で残し、Compass の Decision Rules / Open Questions に流す。非プログラム案件では「どう書くか・どう進めるか・何を決めるか」の判断を残す |
13
+ | 成果物の具体化 | **Example Mapping** | 抽象的な能力を、観測可能な具体例(ルール・例・疑問・切り出し)に落とし、packet の Expected Behavior と Validation を導く。非プログラム成果物では「観測可能」を受容基準で判定可能な記述(読めば合否が分かる例)として扱う |
14
+ | spec への橋渡し | **map-cc-sdd** | 選んだ packet を cc-sdd の Project Description / design・tasks ヒントへ変換する(export 経路。非プログラム向け target format への射影は format 軸が担当) |
15
+
16
+ 各アルゴリズムの詳細は、対応する skill の `rules/algo-*.md`(map-cc-sdd は `rules/map-cc-sdd.md`)にあります。このモード定義はそれらを「どのフェーズで使うか」の組み合わせ表です。新規 algo は導入せず、既存 algo を非プログラム成果物へ流用します。
17
+
18
+ ## 各コマンドでの適用
19
+
20
+ ### intent-discover (GORE-lite)
21
+ - L0: なぜこの成果物(文書・業務プロセス・研究/意思決定)が要るか。1〜2文。
22
+ - L1: 誰の・何の状態をどう変えたいか(読者/業務/意思決定/合意形成)。
23
+ - L2: L1 を支える成果物の責務。章立てや機能名でなく「何を満たすか」として書く。
24
+ - L3: L2 を成立させる内容・流れ・論点(網羅範囲・順序・前提・整合性・読者制約)。
25
+ - L4: 実装手前ならぬ清書手前の候補作業単位(書く章/詰める手順/決める論点)。
26
+ - canonical(確定) と inferred(推測=Assumptions) を絶対に混ぜない。
27
+
28
+ ### intent-compass (QOC)
29
+ - Intent Tree から North Star を引く。
30
+ - 各 Decision Rule は軽量 ADR として凝縮: Context / Decision / Why / Consequences。非プログラム案件では「どう書くか・どう進めるか・何を決めるか」の判断を拘束力ある正本として残す。
31
+ - Invariants は壊してはいけない内容/合意/体裁/運用制約(既存成果物の意味・合意を壊さない)。プロジェクト普遍 / packet 固有 の2層に区別する。
32
+
33
+ ### intent-packets (Example Mapping)
34
+ - 各 L2/L3 能力について Example Mapping を行う(ルール・例・疑問・切り出し)。例は packet の Expected Behavior、疑問は Open Questions、切り出しは `.intent/packets/plan.md` の Deferred 節へ。
35
+ - 非プログラム成果物では Validation/Rollback の検証語彙をコード前提から degrade して読み替える(testable→受容基準で判定可能 / rollback→版管理・差し戻し / behavior-preserving→既存成果物の意味・合意を壊さない)。この読み替えは任意の degrade であり、コード前提の語彙を必須にしない。読み替え語彙の定義は packet-format 側を参照し、ここでは二重定義しない。
36
+ - packets 段はスキップせず、決定スロットの播種を残す。
37
+
38
+ ### intent-export-cc-sdd (map-cc-sdd)
39
+ - packet 1つを cc-sdd の Project Description(凝縮)と design/tasks ヒントへ変換。入力は対象 packet と Compass の Invariants/Anti-direction に限定する。
40
+ - 非プログラム向けの読める成果物体裁への射影は本モード(詰め方)ではなく format 軸(target format)が担当する。
41
+
42
+ ## 適合する状況
43
+
44
+ - 成果物がコードでない案件(文書・仕様書・業務プロセス・手順・研究/意思決定の記録など)の意図を言語化したいとき
45
+ - 「何を実装するか」ではなく「何を書くか・どう進めるか・何を決めるか」を段階分解して詰めたいとき
46
+ - standard などコード前提のモードでは詰め方が成果物と噛み合わない、非プログラム案件のとき
@@ -0,0 +1,56 @@
1
+ # Mode: refactor
2
+
3
+ 既存の大規模プロジェクトを、振る舞いを保ったままリファクタ・再設計するためのモード。設計意図と実装のドリフトを捉え、安全な移行スライスへ落とす。
4
+
5
+ ## このモードが組み合わせるアルゴリズム
6
+
7
+ | フェーズ | アルゴリズム | 目的 |
8
+ |---|---|---|
9
+ | Intent Tree 構築 | **GORE-lite** (Goal-Oriented Requirements Engineering の軽量版) + **Intent Recovery**(意図不在のコードのみ)+ **Drift Analysis** | L0(目的)→L1(成果)→L2(能力)→L3(振る舞い/設計意図)→L4(候補パケット) へゴールを段階分解する。意図を書かずに作られたコード(vibe coding 等)では Intent Recovery でコードから候補 intent を逆算してから、現状の実装とあるべき設計意図とのドリフトを観測可能に捉える |
10
+ | 判断の記録 | **QOC** (Questions-Options-Criteria) | 設計判断を「問い・選択肢・選択基準」で残し、Compass の Decision Rules / Open Questions に流す |
11
+ | 振る舞いの具体化 / packet 分解 | **Migration Slicing** | あるべき設計と現状の差分を、behavior-preserving / testable / rollbackable な移行スライスへ分解し、packet の Expected Behavior と Validation を導く |
12
+ | spec への橋渡し | **map-cc-sdd** | 選んだ packet を cc-sdd の Project Description / design・tasks ヒントへ変換する |
13
+
14
+ 各アルゴリズムの詳細は、対応する skill の `rules/algo-*.md`(map-cc-sdd は `rules/map-cc-sdd.md`)にあります。このモード定義はそれらを「どのフェーズで使うか」の組み合わせ表です。
15
+
16
+ ## 各コマンドでの適用
17
+
18
+ ### intent-discover (GORE-lite + Intent Recovery + Drift Analysis)
19
+ - GORE-lite で L0–L4 を起こす。特に L3(振る舞い・設計意図)を、既存実装の暗黙の意図として丁寧に言語化する。
20
+ - L0: なぜ存在するか。1〜2文。
21
+ - L1: 誰の・何の状態をどう変えたいか(ユーザー/事業/運用/開発体験)。
22
+ - L2: L1 を支える能力。機能名でなく責務として書く。
23
+ - L3: L2 を成立させる振る舞い・設計意図(境界・依存方向・副作用・整合性・UX制約)。
24
+ - L4: 実装手前の候補作業単位。Issue より上位、spec より手前。
25
+ - **意図が書かれずに作られたコード(vibe coding 等)の場合**は、Drift Analysis の前に Intent Recovery を挟む。コードの構造・振る舞いから候補 intent を逆算し、すべて inferred(推測)として置く(確定と混ぜない)。これが無いと「あるべき設計意図」の基準点が存在せず Drift Analysis が空回りする。意図が明示的に存在するコードでは Intent Recovery は不要。
26
+ - 続いて Drift Analysis で、現状の構造・依存方向・振る舞いを棚卸しし、各 L3(Intent Recovery を経た場合は復元した inferred intent)と突き合わせて「今こうなっている → 本来こうあるべき」の drift を列挙する。突き合わせは Reflexion worksheet(意図された責務・依存 vs 観測された責務・依存)で行い、各要素を整合 / 乖離 / 欠落に分類する(詳細は `algo-drift-analysis.md`)。
27
+ - 各 drift は逸脱 / 腐敗 / 局所最適の蓄積として種類を区別し、対応する parent intent(L1/L2/L3)へ紐づける。
28
+ - canonical(確定) と inferred(推測=Assumptions) を絶対に混ぜない。紐づく intent が曖昧な drift は Open Questions へ送る。
29
+
30
+ ### intent-compass (QOC)
31
+ - Intent Tree から North Star を引く。
32
+ - 各 Decision Rule は軽量 ADR として凝縮: Context(問いと状況) / Decision(採る選択肢) / Why(基準) / Consequences(Invariants・Anti-direction への接続)。QOC は選択肢を比較する探索の道具、Decision Rule は将来の実装セッションを拘束する正本。
33
+ - Anti-direction には Claude がやりがちな局所最適を必ず明示列挙する。リファクタ固有の典型として、最低限「drift を直すついでに無関係な箇所まで触る(スコープ膨張)」「behavior-preserving を口実に実は挙動を変える」を明示する。
34
+ - Invariants は壊してはいけない振る舞い/API/データ/UX/運用制約。プロジェクト普遍 / packet 固有 の2層に区別する。リファクタでは「移行中も保たれる既存の振る舞い」を特に明示する。
35
+
36
+ ### intent-packets (Migration Slicing)
37
+ - **入力契約(重要)**: Migration Slicing は discover フェーズの Drift Analysis が出した **drift リストを入力に取る**。drift リストが薄い・曖昧だとスライスは推測になり質が落ちる。スライスを切る前に drift リストが十分かを確認し、不足なら discover に戻って drift を厚くする。
38
+ - スライスを切る前に **Mikado pre-pass**(Mikado Method = 安全な変更順序を前提の逆算で求める手法)で「これを安全に変えるには先に何が真である必要があるか」を逆算して前提グラフを書き、前提を持たない葉から着手する(机上の逆算であり、試しのコード変更はしない。詳細は `algo-migration-slicing.md`)。
39
+ - あるべき設計と現状の差分(drift リスト)を、振る舞いを壊さずに適用できる最小の移行スライスへ切る。
40
+ - 各スライスは単体でデプロイ可能で、既存の振る舞いを保ったまま設計を一歩進めるものにする。
41
+ - スライスを依存順に並べ、前のスライスが次を unblock する連鎖にする。どこで止めても中間状態が一貫している(behavior-preserving)ことを確認する。
42
+ - 各スライスに characterization / 回帰の検証点(Validation)と、失敗時の巻き戻し(Rollback)を付ける(現状挙動の観測・固定の手順は `intent-packets/rules/algo-characterization-test.md` を流用してよい)。
43
+ - **drift トレーサビリティ(必須)**: 列挙した drift は必ずいずれかに終端させる — (a) 移行スライス(packet)になる / (b) 今回やらないなら Open Questions か明示的な先送り(理由付き)にする。drift を見つけたまま黙って落とさない(局所最適の蓄積を放置しないという North Star の核心)。
44
+ - packet は behavior-preserving / testable / rollbackable を満たす。数は改修見込みの規模に応じて可変とし、数合わせをしない(小規模なら 1 個でよい・1〜7 を緩い目安とする)。各 packet に parent intent(drift 由来なら元の drift も)への参照を残す。
45
+
46
+ ### intent-export-cc-sdd (map-cc-sdd)
47
+ - packet 1つを cc-sdd の Project Description(凝縮)と design/tasks ヒントへ変換。
48
+ - 入力は対象 packet と Compass の Invariants/Anti-direction に限定する。
49
+ - tasks ヒントには必ず parent intent と invariant への参照を残す。
50
+
51
+ ## 適合する状況
52
+ - 既存の大規模プロジェクトのリファクタ・再設計が対象のとき
53
+ - 既存コード規模が大きく、設計意図と実装のドリフトが蓄積しているとき
54
+ - 振る舞いを保ったまま(behavior-preserving に)段階的に設計を進めたいとき
55
+ - 意図を書かずに作られたコード(vibe coding、prototype の本番化など)を、事後的に intent 体系へ取り込みたいとき(discover で Intent Recovery を併用する)
56
+ - **behavior-unknown との使い分け**: 現状の振る舞いがある程度把握できており、あるべき設計を言語化できるなら refactor。現状の振る舞い自体が不明で、まず観測・固定が必要なら behavior-unknown。vibe coding は「振る舞いは観測できるが意図が不在」なケースが多く、refactor + Intent Recovery が適する。
@@ -0,0 +1,50 @@
1
+ # Mode: standard
2
+
3
+ 意図の言語化を汎用に行う標準(既定)モード。グリーンフィールド専用ではない: 新規プロジェクトに加え、状況特化モード(refactor / behavior-unknown / feature-growth)が当てはまらない既存プロジェクトの意図言語化にも使う。組み合わせるアルゴリズム(GORE-lite + QOC + Example Mapping)は全モードの基幹となる汎用の詰め方である。
4
+
5
+ ## このモードが組み合わせるアルゴリズム
6
+
7
+ | フェーズ | アルゴリズム | 目的 |
8
+ |---|---|---|
9
+ | Intent Tree 構築 | **GORE-lite** (Goal-Oriented Requirements Engineering の軽量版) | L0(目的)→L1(成果)→L2(能力)→L3(振る舞い/設計意図)→L4(候補パケット) へゴールを段階分解する |
10
+ | 判断の記録 | **QOC** (Questions-Options-Criteria) | 設計判断を「問い・選択肢・選択基準」で残し、Compass の Decision Rules / Open Questions に流す |
11
+ | 振る舞いの具体化 | **Example Mapping** | 抽象的な能力を、観測可能な具体例(ルール・例・疑問・切り出し)に落とし、packet の Expected Behavior と Validation を導く |
12
+ | spec への橋渡し | **map-cc-sdd** | 選んだ packet を cc-sdd の Project Description / design・tasks ヒントへ変換する |
13
+
14
+ 各アルゴリズムの詳細は、対応する skill の `rules/algo-*.md`(map-cc-sdd は `rules/map-cc-sdd.md`)にあります。このモード定義はそれらを「どのフェーズで使うか」の組み合わせ表です。
15
+
16
+ ## 各コマンドでの適用
17
+
18
+ ### intent-discover (GORE-lite)
19
+ - L0: なぜ存在するか。1〜2文。
20
+ - L1: 誰の・何の状態をどう変えたいか(ユーザー/事業/運用/開発体験)。
21
+ - L2: L1 を支える能力。機能名でなく責務として書く。
22
+ - L3: L2 を成立させる振る舞い・設計意図(境界・依存方向・副作用・整合性・UX制約)。
23
+ - L4: 実装手前の候補作業単位。Issue より上位、spec より手前。
24
+ - canonical(確定) と inferred(推測=Assumptions) を絶対に混ぜない。
25
+ - 分解中に出た判断の分岐は QOC の種として Open Questions に置く。
26
+
27
+ ### intent-compass (QOC)
28
+ - Intent Tree から North Star を引く。
29
+ - 各 Decision Rule は軽量 ADR として凝縮: Context(問いと状況) / Decision(採る選択肢) / Why(基準) / Consequences(Invariants・Anti-direction への接続)。QOC は選択肢を比較する探索の道具、Decision Rule は将来の実装セッションを拘束する正本。
30
+ - Anti-direction には Claude がやりがちな局所最適を必ず明示列挙する。
31
+ - Invariants は壊してはいけない振る舞い/API/データ/UX/運用制約。プロジェクト普遍 / packet 固有 の2層に区別する。
32
+
33
+ ### intent-packets (Example Mapping)
34
+ - 各 L2/L3 能力について Example Mapping を行う:
35
+ - ルール: その能力が従う規則
36
+ - 例: 観測可能な具体シナリオ → packet の Expected Behavior
37
+ - 疑問: 未確定 → packet の Open Questions / Compass へ差し戻し
38
+ - 切り出し: 今回やらないと決めたこと → 黙って落とさず `.intent/packets/plan.md` の Deferred 節に記録し、後続 packet の種 / Open Questions にする
39
+ - 例から Validation(テスト/手動/型/ログ)と Rollback を導く。
40
+ - packet は behavior-preserving / testable / rollbackable を満たす。数は改修見込みの規模に応じて可変とし、数合わせをしない(小規模なら 1 個でよい・1〜7 を緩い目安とする)。
41
+
42
+ ### intent-export-cc-sdd (map-cc-sdd)
43
+ - packet 1つを cc-sdd の Project Description(凝縮)と design/tasks ヒントへ変換。
44
+ - 入力は対象 packet と Compass の Invariants/Anti-direction に限定する。
45
+ - tasks ヒントには必ず parent intent と invariant への参照を残す。
46
+
47
+ ## 適合する状況
48
+ - 新規プロダクト/サブシステム
49
+ - 意図が暗黙知のまま膨らんだ機能群を言語化したいとき
50
+ - 既存プロジェクトでの汎用的な意図整理で、状況特化モード(refactor / behavior-unknown / feature-growth)が当てはまらないとき。既存システムへの機能追加が目的なら feature-growth を使う
@@ -0,0 +1,18 @@
1
+ # 自然言語 Spec 出力派生ビュー置き場
2
+
3
+ > `/intent-to-spec` が canonical な意図(`.intent/intent-tree.md` / `.intent/intent-compass.md` など)と packet を読み、外向きに人間可読な自然言語の仕様書としてこの配下に書きます。この README 以外は **Git 非追跡(ローカル専用)** です。ここに置かれるビューは **派生(derived)であり正本ではありません**。正本は canonical な意図ファイルのままで、本ビューは生成時点での射影(スナップショット)です。
4
+
5
+ ## 構造
6
+
7
+ ```
8
+ .intent/nl-spec/
9
+ ├── README.md # この説明(Git 追跡対象)
10
+ └── nl-spec.md # /intent-to-spec が生成する自然言語 Spec 本体(非追跡・全置換で再生成)
11
+ ```
12
+
13
+ ## このディレクトリの性質
14
+
15
+ - **派生・再生成可能**: `nl-spec.md` は `/intent-to-spec` を実行するたびに canonical な意図から**全置換**で再生成されます。手で編集しても次回実行で上書きされます(編集禁止)。
16
+ - **正本ではない**: 設計意図の正本は canonical な `.intent/intent-tree.md` / `.intent/intent-compass.md` です。本ビューは意図を外向きに射影した**読み物(自然言語 Spec)**であり、ここを書き換えても canonical には反映されません。仕様を変えたい場合は、利用者が discover / compass の対話へ戻って意図を更新し、再度 `/intent-to-spec` を実行してください(ビューから canonical への自動の継ぎ目はありません)。
17
+ - **Git 非追跡**: `nl-spec.md` をはじめ、この README 以外はローカル専用で Git に追跡されません(追跡対象はこの README のみ)。これによりチームでのマージ衝突や上書きによる喪失は設計上起きません。
18
+ - **read-only な射影層 + 限定 Write**: `/intent-to-spec` は canonical な意図を変更せず(読み取りのみ)、生成物の書込み先はこの `.intent/nl-spec/` 配下に限定されます。
@@ -0,0 +1,15 @@
1
+ # OpenSpec Proposal 下書きテンプレ
2
+
3
+ > `/intent-export-openspec` が packet ごとの下書きをこの書式で `.intent/openspec/<packetスラッグ>/proposal.md` に書き出します。このファイルは出力の書式テンプレ(見出し + 用途説明)であり、ここに具体的な内容は書きません。マッピングの正は export skill の rule(map-openspec)にあります。読み手は OpenSpec へ受け渡す利用者と、続行時に起動される `/opsx:propose` です。
4
+
5
+ ## Why
6
+
7
+ この変更を行う理由。packet の intent / Why を写し、parent intent(この packet が仕える上位の狙い)を明示する。なぜ今この変更が必要かを OpenSpec の change-proposal が引き継げる形で述べる。
8
+
9
+ ## What Changes
10
+
11
+ この変更で何を足す・変える・やめるか。packet の deliverables / Scope を箇条書きで列挙する。compass の Anti-direction はこの節の中で out-of-scope(やらないこと)として明示する。
12
+
13
+ ## Impact
14
+
15
+ この変更が影響する spec / 契約と、守るべき制約。compass の Invariants を写し、normative(SHALL / MUST)で表現できるものはその形で残す。OpenSpec が生成する成果物へ invariant が取り込まれるようにする。
@@ -0,0 +1,25 @@
1
+ # OpenSpec Spec Delta 下書きテンプレ
2
+
3
+ > `/intent-export-openspec` が packet の受け入れ条件を OpenSpec の delta spec ヒントとしてこの書式で `.intent/openspec/<packetスラッグ>/spec-delta.md` に書き出します。これは本体を完成させない **ヒント skeleton** です(OpenSpec 本体生成・突き合わせは `/opsx:propose` 以降に委ねる)。`### Requirement:` / `#### Scenario:` の見出し構文を正確に seed し、OpenSpec の validate に通る構造へ誘導します。振り分け規則(ADDED 既定 / 条件付き MODIFIED・REMOVED)の正は export skill の rule(map-openspec)にあります。
4
+
5
+ ## ADDED Requirements
6
+
7
+ 新たに追加する能力・振る舞い。既定では packet の受け入れ条件をすべてここに置く。
8
+
9
+ ### Requirement: <name>
10
+
11
+ normative な要件文(SHALL / MUST)。compass の Invariants が関わる場合はその制約をここへ落とす。
12
+
13
+ #### Scenario: <name>
14
+
15
+ - **GIVEN** 前提
16
+ - **WHEN** 起きること
17
+ - **THEN** 期待する結果
18
+
19
+ ## MODIFIED Requirements
20
+
21
+ 既存の能力・振る舞いを変更する場合のみ置く(packet の Scope または compass の Anti-direction が既存能力の変更を明示参照する場合)。「変更対象の能力名 + 変更方向」のヒントに留め、突き合わせは OpenSpec 側に委ねる。
22
+
23
+ ## REMOVED Requirements
24
+
25
+ 既存の能力・振る舞いを廃止する場合のみ置く(同上の条件)。廃止対象の能力名をヒントとして示す。