specdojo 0.5.0 → 0.6.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 (93) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +60 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +1 -0
  5. package/dist/deliverable/deliverable.js +77 -4
  6. package/dist/exec/core.js +1 -0
  7. package/dist/exec/parent-validation.js +7 -0
  8. package/dist/exec/plans-core.js +46 -1
  9. package/dist/exec/plans-generation.js +39 -3
  10. package/dist/exec/plans-planning.js +1 -1
  11. package/dist/exec/plans-storage.js +1 -0
  12. package/dist/exec/product-branch-records.js +105 -0
  13. package/dist/exec/product-branches.js +52 -0
  14. package/dist/exec/register-product-message.js +50 -0
  15. package/dist/exec/register.js +6 -0
  16. package/dist/exec/repo-integration-sync.js +4 -2
  17. package/dist/exec/repo-integration.js +41 -4
  18. package/dist/exec/repo-trace.js +2 -0
  19. package/dist/exec/results.js +9 -5
  20. package/dist/exec/run/register-command.js +16 -0
  21. package/dist/exec/run/register-resume.js +11 -1
  22. package/dist/exec/run/register-worktree.js +29 -8
  23. package/dist/exec/run/schedule-prepare.js +7 -3
  24. package/dist/exec/strategy.js +2 -1
  25. package/dist/exec/task-repos.js +78 -16
  26. package/dist/exec/worktree-command.js +2 -2
  27. package/dist/exec/worktree.js +3 -3
  28. package/dist/register/core.js +5 -0
  29. package/dist/register/create-commands.js +54 -2
  30. package/dist/register/deliverable-target.js +24 -17
  31. package/dist/register/event-merge.js +4 -0
  32. package/dist/register/events.js +6 -0
  33. package/dist/register/external-project.js +2 -0
  34. package/dist/register/input.js +168 -0
  35. package/dist/register/item.js +61 -0
  36. package/dist/register/register.js +2 -2
  37. package/dist/register/renumber.js +4 -0
  38. package/dist/register/update.js +6 -0
  39. package/dist/schedule/approach.js +9 -0
  40. package/dist/schedule/strategy-profiles.js +22 -2
  41. package/dist/shared/agent-types.js +4 -1
  42. package/dist/shared/branch-template.js +26 -0
  43. package/dist/shared/commit-message-template.js +38 -0
  44. package/dist/shared/commit-types.js +15 -0
  45. package/dist/shared/specdojo-config.js +35 -4
  46. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  47. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  48. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  49. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  50. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  51. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  52. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  53. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  54. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  55. package/docs/ja/specdojo/guides/exec-operation-guide.md +96 -2
  56. package/docs/ja/specdojo/guides/register-operation-guide.md +14 -1
  57. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  58. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  59. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  60. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  61. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  62. package/docs/ja/specdojo/references/command-reference.md +44 -11
  63. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  64. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  65. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  66. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  67. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  68. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  69. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  70. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  71. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  72. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  73. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  74. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  75. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  76. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  77. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  78. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  79. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  80. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  81. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  82. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  83. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  84. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  85. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  86. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -2
  87. package/package.json +3 -2
  88. package/templates/antigravity/orchestrator.md +2 -0
  89. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  90. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  91. package/templates/codex/orchestrator.md +2 -0
  92. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  93. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -121,6 +121,7 @@ exec の result の commit 前検査にも、利用リポジトリに設定が
121
121
  | -------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
122
122
  | `integration_branch` | `project/<project-id>/develop` | 別 project の作業ツリーから `register add --project <project-id> --commit` で直接記帳する統合ブランチです。 |
123
123
  | `project_context` | `["prj-overview"]` | edit / review plan へ常に渡す project 共通文書のローカル ID です。空配列 `[]` で無効化できます。`depends_on` や成果物の `based_on` は変更しません。 |
124
+ | `commit_types` | なし | 登録項目 type(`todo`・`issue` 等)から Conventional Commits type への対応マッピングです。 |
124
125
  | `run` | `{}` | agent 実行、worktree、登録日の表示に関する project 単位の設定です。 |
125
126
  | `repos` | なし | project のタスクが変更するプロダクトリポジトリの宣言です。詳細は「`repos`のキー」を参照してください。 |
126
127
 
@@ -188,16 +189,76 @@ project の `integration_branch` は、`repos[].integration_branch` とは別の
188
189
 
189
190
  `projects.<project-id>.repos` は、プロジェクトリポジトリとは別のプロダクトリポジトリを配列で宣言します。プロジェクトリポジトリ自身は宣言しません。キーを省略した project(または空配列)は、従来どおりプロジェクトリポジトリ 1 つだけを扱います。
190
191
 
191
- | キー | 必須 | 既定値 | 役割・利用箇所 |
192
- | ---------------------- | ---- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
193
- | `name` | 必須 | なし | `targets`・`paths` の接頭辞に使うリポジトリ名です。`[a-z0-9-]` だけを使い、project 内で一意です。`project` は予約名で使えません。 |
194
- | `path` | 必須 | なし | リポジトリのルートです。SpecDojo ルートからの相対パスで書き、実在するディレクトリを指します。 |
195
- | `integration_branch` | 任意 | そのリポジトリの現在のブランチ | exec が変更を統合する先のブランチです。exec branch もこのブランチの先端から作ります。 |
196
- | `integration_strategy` | 任意 | `merge` | `merge` はローカルの merge commit で統合します。`branch-only` は exec branch に commit して保持し、プロダクト側の PR レビューに渡します。 |
197
- | `setup` | 任意 | 両方 `true` | worktree 作成時の準備の有無です。`install`(依存導入)と `build`(生成物の build)を真偽値で指定します。 |
192
+ | キー | 必須 | 既定値 | 役割・利用箇所 |
193
+ | ------------------------- | ---- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
194
+ | `name` | 必須 | なし | `targets`・`paths` の接頭辞に使うリポジトリ名です。`[a-z0-9-]` だけを使い、project 内で一意です。`project` は予約名で使えません。 |
195
+ | `path` | 必須 | なし | リポジトリのルートです。SpecDojo ルートからの相対パスで書き、実在するディレクトリを指します。 |
196
+ | `integration_branch` | 任意 | そのリポジトリの現在のブランチ | exec が変更を統合する先のブランチです。exec branch もこのブランチの先端から作ります。 |
197
+ | `integration_strategy` | 任意 | `merge` | `merge` は merge commit、`ff` は早送りだけで統合します。`branch-only` は作業ブランチを保持してプロダクト側の PR レビューに渡します。 |
198
+ | `branch_template` | 任意 | `exec/{project}-{id}` | プロダクトの作業ブランチ名です。`{id}` または `{topic}` を含めます。 |
199
+ | `setup` | 任意 | 両方 `true` | worktree 作成時の準備の有無です。`install`(依存導入)と `build`(生成物の build)を真偽値で指定します。 |
200
+ | `commit_types` | 任意 | なし | このリポジトリ固有の登録項目 type から Conventional Commits type への対応マッピングです。project の指定より優先されます。 |
201
+ | `commit_subject_template` | 任意 | `exec(register {id}): {title}` | register の exec がプロダクトへ積む commit の 1 行目を指定します。 |
202
+ | `merge_message_template` | 任意 | `exec(register {id}): {title}` | register の exec がプロダクトへ積む merge commit のメッセージを指定します。改行で本文も指定できます。 |
198
203
 
199
204
  register の worktree 実行では、`exec run --integration-branch <repo>=<branch>` により `integration_branch` を run ごとに上書きできます。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定方法、ローカルブランチの検査、並列実行と再開時の扱いは [[specdojo:command-reference]] を参照してください。
200
205
 
206
+ `commit_types` は項目の type ごとに既定の commit type を上書きします。値は個票の `commit_type` と同じ 11 種類(`feat`・`fix`・`docs`・`refactor`・`test`・`chore`・`perf`・`build`・`ci`・`style`・`revert`)です。空文字や一覧外の値は設定読み込み時にエラーになります。未指定のキーは「個票の `commit_type` → `repos[].commit_types` → `projects.<project-id>.commit_types` → 既定対応」の順に解決します。`commit_scope` は個票で指定した場合だけ使います。
207
+
208
+ 既定対応は `issue` が `fix`、`todo`・`change-request`・`epic` が `feat`、`decision`・`note`・`question`・`risk` が `docs` です。未知の type は `chore` にフォールバックします。たとえば、project に `"commit_types": { "todo": "chore", "issue": "fix" }`、ドキュメント用の repo に `"commit_types": { "todo": "docs" }` を設定すると、その repo の todo は `docs`、他の repo の todo は `chore` になります。個票で `commit_type` を明示すれば、設定より優先されます。
209
+
210
+ `commit_subject_template` と `merge_message_template` はプロダクトリポジトリごとに独立して指定できます。設定がない場合は commit・merge とも従来の `exec(register <ID>): <タイトル>` を保ちます。SpecDojo の記録のリポジトリの start・review・wait・merge などの記帳には適用しません。
211
+
212
+ 使える変数は次の 8 種類です。未知の変数、対応しない波括弧、空白だけのテンプレートは設定エラーです。値の中の波括弧は再展開しません。
213
+
214
+ | 変数 | 値 |
215
+ | ----------- | --------------------------------------------------------------------------------------- |
216
+ | `{id}` | 登録項目の ID(例: `PJR-AB12`) |
217
+ | `{project}` | project ID(例: `prj-0001`) |
218
+ | `{topic}` | 個票ファイル名 `pjr-ab12-<topic>.md` の topic 部分。個票パスがない場合は小文字の項目 ID |
219
+ | `{type}` | 個票・repo・project・既定対応の優先順で解決した commit type |
220
+ | `{scope}` | 個票の `commit_scope`。未指定なら空文字 |
221
+ | `{title}` | 改行などの空白を 1 つにまとめた項目のタイトル |
222
+ | `{branch}` | そのプロダクトの実際の作業ブランチ名 |
223
+ | `{target}` | run の上書きを含む、そのプロダクトの実際の統合先 |
224
+
225
+ commit/merge の scope が空のときは、テンプレートに書いた `({scope})` を括弧ごと取り除きます。たとえば `{type}({scope}): {title}` は `feat: 機能追加` になります。commit のテンプレートは空白と改行を 1 つの空白にまとめて 1 行にします。merge のテンプレートは本文の改行を保ちます。どちらも 1 行目は従来どおり最大 100 文字(超過時は末尾を `…` にして切り詰める)です。本文の末尾には設定にかかわらず `Refs: <project-id>:<ID>` を付けます。テンプレート自身に同じ `Refs:` 行があっても、末尾に 1 回だけ置きます。
226
+
227
+ git-flow で develop へローカル統合する場合の `repos` 要素の例です。作業ブランチは `feature/{topic}` とし、`ff` で早送りだけを許可する例です。`merge_message_template` は `integration_strategy` を `merge` にした場合に使います。
228
+
229
+ ```json
230
+ {
231
+ "name": "app1",
232
+ "path": "../app1",
233
+ "integration_branch": "develop",
234
+ "branch_template": "feature/{topic}",
235
+ "integration_strategy": "ff",
236
+ "commit_subject_template": "{type}({scope}): {title}",
237
+ "merge_message_template": "Merge branch '{branch}' into {target}"
238
+ }
239
+ ```
240
+
241
+ GitHub flow で作業ブランチを保持して PR レビューへ渡す場合の例です。`branch-only` では runner が merge commit を作らないため、`merge_message_template` は使いません。作業ブランチ名には項目の commit type と topic を使います。
242
+
243
+ ```json
244
+ {
245
+ "name": "app1",
246
+ "path": "../app1",
247
+ "integration_branch": "main",
248
+ "integration_strategy": "branch-only",
249
+ "branch_template": "{type}/{topic}",
250
+ "commit_subject_template": "{type}: {title}"
251
+ }
252
+ ```
253
+
254
+ `branch_template` の変数は上表の `{project}`・`{id}`・`{topic}`・`{type}`・`{scope}`・`{title}` の 6 個です。`{branch}`・`{target}` は使えません。`{id}` も `{topic}` も含まない値、未知の変数、不正な波括弧、空白や `..` など Git のブランチ名に使えない文字を含む値は設定エラーです。展開後の名前も開始時に Git で検証し、空の scope や空白を含む title で不正になった場合は停止します。名前の自動修正・連番付与は行いません。register 以外のタスクでは `{topic}` は task ID の小文字、`{title}` は task ID、`{type}` は `feat`、`{scope}` は空文字です。
255
+
256
+ 名前の優先順位は、再開時の runner 記録 → `exec run --branch <repo>=<name>` → `branch_template` → 既定値です。別項目の記録や既存の管理外ブランチと名前が重なる場合は、register の start より前に停止し、topic の変更か `--branch` を案内します。同じ項目の再開では、設定や topic が変わっても記録された名前を使い、異なる `--branch` は拒否します。SpecDojo の記帳用リポジトリの `exec/{project}-{id}` は変更しません。
257
+
258
+ 対応記録は各プロダクトの Git 共通管理ディレクトリの `specdojo/product-branches/` に置き、項目の修飾 ID・ブランチ名・開始 commit を保存します。全 worktree とプロジェクトで共有し、名前の予約は排他的に作成します。再開と片付けはこの記録を参照し、`exec/` 以外の名前でも動きます。旧 run の記録がない場合だけ、従来の名前を互換用に探索します。
259
+
260
+ `ff` は統合先を作業ブランチの先端へ進め、merge commit を作りません。統合先が作業ブランチの祖先でない場合は、どのリポジトリも統合する前に理由を示して停止します。統合直前にも祖先関係を確かめ、checkout されていない統合先は比較交換で更新します。再開時にも `ff` の worktree へ統合先を自動 merge せず、rebase もしません。利用者が履歴を整理してから同じ run を再開します。`merge` の既定動作は変わりません。
261
+
201
262
  GitHub flow などで PR レビューを必須にするリポジトリには、`"integration_strategy": "branch-only"` を指定します。`integration_branch` は exec branch の作成元と、プロダクト側で PR を作る際の統合先の目安です。runner は統合先へ merge せず、push・PR 作成(`gh` を含む)も行いません。プロダクトの commit とプロジェクトの記帳が成功すると、プロジェクト側は通常どおり `review` へ進み、result に `branch-only`(未統合)、exec branch 名、trace key を残します。プロダクト側のレビューやリリースが完了したことは意味しません。
202
263
 
203
264
  成功後は全 worktree を撤去し、`branch-only` の exec branch だけを残します。利用者はその branch を必要な承認のもと push し、プロダクト側の手順で PR を作成します。squash merge でも追跡できるよう、commit メッセージの `Refs: <project-id>:<item-id>` を保持してください。失敗時は worktree と branch を残して `--resume` で再開し、`branch-only` の worktree へ統合先を自動で取り込みません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除してから実行します。`exec worktree prune` は未統合の branch を削除しません。
@@ -265,7 +326,7 @@ exec worktree の中で設定を読む場合(agent が worktree で `specdojo`
265
326
  - `name` がいずれかの project ID と同じである。`<name>:<...>` が doc id とリポジトリのパスのどちらか区別できなくなるためです。
266
327
  - `name` が予約名 `project` である。プロジェクトリポジトリの worktree のディレクトリ名と重なるためです。
267
328
  - `path` が空、絶対パス、存在しない、またはディレクトリでない。
268
- - 宣言に無いキーがある、`integration_branch` が空文字、`integration_strategy` が `merge` / `branch-only` 以外、`setup` の値が真偽値でない。
329
+ - 宣言に無いキーがある、`integration_branch` が空文字、`integration_strategy` が `merge` / `branch-only` / `ff` 以外、`setup` の値が真偽値でない。
269
330
 
270
331
  設定の形は `docs/specdojo/schemas/v1/specdojo-config.schema.yaml` でも検証できます。リポジトリ名と project ID の重複と `path` の実在は schema で表せないため、CLI の読み込み時の検証が正本です。
271
332
 
@@ -129,6 +129,7 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
129
129
 
130
130
  | `depends_on` | 任意 | 依存する成果物の `local_id` 配列。なければ空配列 `[]` |
131
131
  | `overview` | ○ | 成果物の目的を1文で記述 |
132
+ | `brief` | 任意 | 成果物の外から継続して渡す前提(技術スタックや制約など) |
132
133
  | `path` | ○(`work`) | 成果物のファイルパス |
133
134
  | `rulebook` | 任意 | rulebook の文書 ID、未判断なら `undecided`、不要なら `not-needed` |
134
135
  | `evidence_refs` | 任意 | `retrofit` で読む非成果物エビデンス |
@@ -269,6 +270,13 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
269
270
  - 既存カタログとの差分は `--dry-run` で確認する。既存ファイルは既定で保護し、内容が異なる場合の上書きには `--force` を必要とする。同一入力の再実行で内容が同じ場合は書き込まない。
270
271
  - 生成されたカタログの `status` は template に従い `draft` のままとする。生成成功を理由に Timeline の `catalog_status` を `primary` へ変更せず、人間の内容確認後に別途更新する。
271
272
 
273
+ ### 6.14. `brief`・`overview`・`done_criteria` の使い分けと YAML アンカー
274
+
275
+ - `overview`: 成果物の目的・責務を 1 文で記述する。カタログの表・一覧(Markdown 表示ページ)に配置され、ドメイン全体の俯瞰や成果物の責務把握に用いる。
276
+ - `brief`: 成果物の外から継続して渡す前提(採用する技術スタック、アーキテクチャ上の制約、設計・選定方針など)を記述する。schedule の task の plan や register 経由の plan に「前提」として展開される。未指定の場合は plan に載せない。
277
+ - `done_criteria`: 成果物が満たすべき完了条件・受入基準を記述する。ロールコード(`roles`)とレビュー観点(`viewpoint`)を紐づけ、客観的に検証可能な形で記載する。前提や指示そのものはここに書かず、成果物が達成した検証可能な振る舞い・状態を記載する。
278
+ - 複数の成果物で前提を共有する場合は、YAML のアンカー(`&anchor`)とエイリアス(`*anchor`)を利用して記述の重複を防ぐ。同一カタログファイル内で共通の前提をアンカー定義し、各成果物の `brief` から参照する。
279
+
272
280
  ## 7. 禁止事項
273
281
 
274
282
  | 禁止事項 | 理由 |
@@ -117,6 +117,7 @@ Project Register Documentation Rules
117
117
  | 末尾 | 関連ドキュメント | ○ | 根拠、影響先、追跡先を文書 ID で示す |
118
118
 
119
119
  - H1 は `PJR-XXXX <タイトル>` 形式とする。
120
+ - 実行対象の `todo`・`issue`・`change-request`・`question`・`risk` の個票は、対話で得た前提・制約・委任範囲を箇条書きで残す `入力` 節を持つ。入力がない場合は `-` とする。完了条件・回答の確定条件とは分ける。既存個票に節がなくても読み込め、初回の入力更新時に節を追加する。
120
121
  - `epic` は概要、範囲(track と domain)、完了の判断の基準、子項目、対応結果、関連ドキュメントを持つ。範囲には domain と境界、完了の基準には子項目と schedule を確認する判断条件、対応結果には人が完了を判断した根拠を記録する。
121
122
  - 子 todo は `--from <epic-id>` で起票する。`derived_from` を逆引きした epic 別ビューは直接の子を type と状態付きで表示し、子がない epic も表示する。別 project の子は project 修飾 ID で識別する。孫を再帰的に含めず、状態の自動集約や自動 close は行わない。
122
123
  - type 固有の構成は `todo` の概要・完了条件・作業内容・対応結果など、各 type 用テンプレートに従う。
@@ -158,6 +159,9 @@ Project Register Documentation Rules
158
159
  - カタログなしの `bootstrap` は `target_path`、新しい `target_rulebook`、設定の `kata_authority` を必須とする。既存 rulebook を再利用しない。rulebook の名前部分から recipe・sample・template の ID を導出し、`docs/ja/specdojo/<kind>s/<kata_authority>/` に配置する候補を plan へ示す。成果物には新しい `specdojo.rulebook` を記録する。
159
160
  - `finalize`・`bootstrap-finalize` は既存成果物だけを対象にし、カタログなしでは個票の完了条件を確認チェック表にする。後者は成果物と frontmatter から辿る kata 一式を確定対象とする。
160
161
 
162
+ - 対話で得た前提は `register add --input <text>` で個票本文の `入力` へ記録する。繰り返し指定した順に箇条書きとし、`register update --input` は指定した一覧で置換する。追記する場合は既存分を含めて渡し、`--input -` 単独で全削除する。未指定時は保持する。空文字、削除指定と他の入力の混在、add での削除指定は拒否する。
163
+ - 入力の変更は event の `input` フィールドへ変更前後の JSON 配列として記録し、値がない場合は `-` とする。register 経由の plan は approach の有無を問わず、入力がある場合だけ「個票の入力(前提)」に展開する。入力を完了条件へ転記しない。
164
+
161
165
  ### 5.2. 構造化フィールドと生成
162
166
 
163
167
  - 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
@@ -117,8 +117,10 @@ schema で機械検証できない記述規範だけを定める。設計の考
117
117
  ### 5.5. intent と grade からの strategy 生成
118
118
 
119
119
  - `schedule strategy generate --track <track>` は、既存 strategy の `scope.catalogs` と catalog ごとの `local_ids` を優先し、新規 track では Timeline の `domains` から物理分割を含む DCT を解決する。scope は `include_kinds: [work]` 固定とし、既存の `local_ids` がある場合は選択部分集合だけを生成対象にする。
120
- - `approach_rules` は scope の全 work 成果物を重複なく網羅し、7 種の intent を成果物別に宣言する。`improve-kata` は `kata_target`、`bootstrap-kata-set` と `confirm-with-kata-set` は `bootstrap_scope` も宣言する。
120
+ - `approach_rules` は scope の全 work 成果物を重複なく網羅し、8 種の intent を成果物別に宣言する。`improve-kata` は `kata_target`、`bootstrap-kata-set` と `confirm-with-kata-set` は `bootstrap_scope` も宣言する。
121
121
  - `author-deliverable` の approach は Kata 宣言と保存済み grade から `fully-guided` / `recipe-guided` / `freeform` へ導出する。他の intent は目的別 approach へ一意に写像し、必要な evidence や追加パラメータがなければ生成を停止する。
122
+ - 人が雛形に文脈を記入してから下書きする場合は `draft-with-context` を宣言する。必要な Kata がすべて利用可能な場合だけ `draft` profile を生成し、雛形作成・文脈記入(human)、下書き(`draft`)、磨き込み(`fully-guided`)、review、finalize(human)の順とする。human の着手と完了は claim / complete で記録する。
123
+ - `guided-pass` の草案作成は `draft` とし、文脈がない場合も template を骨組みにして根拠のある内容を下書きする。未委任の調査・選定を行わず、`fully-guided` は後続の既存草案の磨き込みに使う。
122
124
  - 導出した approach は標準 profile へ写像し、`phase_sets`、`default_phase_sets`、`owner_rules`、phase gate、finalize 系フェーズをコードで組み立てる。profile は duration、`execution`、`mode`、`approach`、agent pipeline を一元管理する。
123
125
  - 主担当は `--owner <local_id>=<ROLE>`、既存 strategy の `owner_rules`、`--default-owner <ROLE>` の順に解決する。`done_criteria.roles` はレビュー観点であり主担当の根拠にしない。未解決または `pm-roles.yaml` に存在しない owner があれば生成を停止する。
124
126
  - `bootstrap` と他の approach が同一 track に混在する場合は成果物別に profile を分け、既定では同一カタログの非 bootstrap 成果物を代表 bootstrap 成果物の後に配置する。不要な場合だけ `--no-bootstrap-ordering` を明示する。
@@ -3,7 +3,7 @@
3
3
  # 成果物カタログ(ドメイン別)の完成例。
4
4
  # 駄菓子屋きぬや販売管理システム構築プロジェクトのプロジェクト定義ドメインを題材とする。
5
5
  # 構造・必須キー・型制約は docs/specdojo/schemas/v1/dct.schema.yaml に従う。
6
- # work / control / generated の3種別と、done_criteria の記述例を示す。
6
+ # work / control / generated の3種別と、done_criteria、および brief(YAML アンカー共有)の記述例を示す。
7
7
  id: specdojo:dct-sample
8
8
  type: project
9
9
  status: draft
@@ -21,6 +21,9 @@ groups:
21
21
  kind: work
22
22
  depends_on: []
23
23
  overview: 駄菓子屋きぬや販売管理システムの目的・背景・ゴールを定義する
24
+ brief: &project_baseline_brief |
25
+ - 駄菓子屋の既存店舗業務を止めない段階的な移行を前提とする
26
+ - POS 端末および在庫管理端末はタブレット Web アプリケーションとする
24
27
  path: prj-overview.md
25
28
  rulebook: specdojo:prj-overview-rulebook
26
29
  done_criteria:
@@ -42,6 +45,7 @@ groups:
42
45
  depends_on:
43
46
  - prj-overview
44
47
  overview: 対象業務と対象外業務を明確化し、合意境界を固定する
48
+ brief: *project_baseline_brief
45
49
  path: prj-scope.md
46
50
  rulebook: specdojo:prj-scope-rulebook
47
51
  done_criteria:
@@ -141,6 +141,22 @@ specdojo:
141
141
  - 生成時プレースホルダは `frontmatter_template` と本文の相互参照の両方に現れ、生成処理が一括置換する。
142
142
  - 記入プレースホルダは生成物に残し、recipe に従って作成者が埋める。生成処理は置換しない。
143
143
 
144
+ ### 2.4. 文脈の目印
145
+
146
+ - 本文の斜体は、共通の目印 `_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` / `_CONTEXT_` に限って使用する。
147
+ - `_CONTEXT_` は、成果物を下書きするために人が記入する前提や調査・選定の指示を示す。適用する場所の段落の先頭に `_CONTEXT_:` と書く。文書全体にかかる指示は先頭の章に置き、文脈専用の章は増やさない。
148
+ - 一つの指示は一つの段落にまとめる。記法の説明や元の指示の引用では、インラインコードまたはコードブロックを使い、未反映の指示と区別する。
149
+ - `draft` は指示を本文へ反映した後、その段落から目印と元の指示を消し、元の指示と反映箇所を result に記録する。反映できない指示は残し、理由と次の行動を記録する。executor / reporter pipeline では元の指示と反映箇所を executor の報告の `handoff` に記載し、reporter と runner が result へ転記する。
150
+ - `fully-guided` は残った指示を反映・削除せず、未反映の指示と必要な下書きを論点として result に記録し、`draft` へ申し送る。
151
+ - `finalize` / `bootstrap-finalize` は、確定対象に未反映の指示が残っていれば承認せず差し戻す。
152
+ - `lint:fm` の `remark-md-content` は、コード例を除き段落先頭の `_CONTEXT_:` を検出する。Frontmatter の `specdojo.status` が `ready` なら error、それ以外(状態の指定なしを含む)は情報とする。
153
+
154
+ ```markdown
155
+ ## 1. 概要
156
+
157
+ _CONTEXT_: 静的サイトに適した技術を調べ、候補と選定理由を提案する。
158
+ ```
159
+
144
160
  ## 3. 独立 YAML データファイルのメタ情報
145
161
 
146
162
  独立 YAML データファイルは Frontmatter を持たないため、ファイル先頭のトップレベル項目でメタ情報を表す。
@@ -40,6 +40,7 @@ Human Finalize Execution Standard
40
40
  ### 3.2. 本文
41
41
 
42
42
  - 「確認チェックリスト」には catalog の全 `done_criteria` を重複なく展開します。
43
+ - 「確認チェックリスト」には、確定対象の本文に未反映の `_CONTEXT_:` が残っていないことを含めます。残っていれば承認せず、理由を result に記録して `draft` へ差し戻します。
43
44
  - 「確定対象」には `targets` から解決した実在文書を列挙し、確認と `ready` 昇格後にチェックします。
44
45
  - 「確定判断」は承認または差し戻しのどちらかを実値で記録し、プレースホルダを残しません。
45
46
  - `bootstrap-finalize` では実践の型の種別別確認を追加し、対象に存在しない種別の行は削除します。
@@ -104,6 +104,7 @@ specdojo:
104
104
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
105
105
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
106
106
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
107
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
107
108
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
108
109
 
109
110
  ## 7. 禁止事項
@@ -113,7 +114,7 @@ specdojo:
113
114
  - 規範(must ルール・規約)を guide で新規に定義しない。standard / rulebook を正本とする。
114
115
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
115
116
  - デッドリンクを記載しない。
116
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
118
  - `導入ブロック` の3ブロックを省略しない。ラベル名を変えない。順序を入れ替えない。
118
119
  - 全 guide / reference を並べた目的別の横断一覧を、`specdojo:specdojo-overview-guide` 以外に置かない。
119
120
 
@@ -95,6 +95,7 @@ specdojo:
95
95
  - 比較・対応・区別など、見比べる情報は表に置く。
96
96
  - 例を用いる場合は、[sample-authoring-standard.md](sample-authoring-standard.md) の `共通サンプル文脈` に合わせる。
97
97
  - 未確定事項や仮置き情報は、`_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` のラベルで記述する。
98
+ - 下書きへの指示には `_CONTEXT_:` を使う。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
98
99
 
99
100
  ## 7. 禁止事項
100
101
 
@@ -71,6 +71,7 @@ Recipe Authoring Standard
71
71
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
72
72
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
73
73
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
74
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
74
75
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
75
76
 
76
77
  ### 5.1. Why・What・How・Trace の共通原則
@@ -134,7 +135,7 @@ Why は What の必要性を説明し、What は How が満たすべき境界を
134
135
  - rulebook / recipe / sample / template の種別ごとの役割分担表を recipe 本文に置かない(実践の型全体の役割は [kata-guide.md](../guides/kata-guide.md) が扱う)。
135
136
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
136
137
  - recipe 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
137
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
139
 
139
140
  ## 8. 運用ルール
140
141
 
@@ -111,6 +111,7 @@ specdojo:
111
111
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
112
112
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
113
113
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
114
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
114
115
  - `サンプル` 章を置く場合は、最小例をコードブロックで本文内に自己完結して埋め込む。sample ファイルの要否と所在は Frontmatter の `sample` で宣言し、本文にリンクを記載しない。
115
116
  - template が不要な場合は Frontmatter へ `template: not-needed`、要否未判断なら `template: undecided` を宣言する。項目省略は必要だが未整備を表す。いずれも `deliverable scaffold` は最小雛形へ退避する。
116
117
 
@@ -131,7 +132,7 @@ specdojo:
131
132
  - 本文に sample / recipe / template への wikilink・リンク章を置かない。対応関係は Frontmatter の `sample` / `recipe` / `template` で示す。
132
133
  - rulebook 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
133
134
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
134
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
135
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
135
136
  - 確定済みの内容をラベル付きのまま放置したり、ラベルを本文の代替として多用したりしない。
136
137
 
137
138
  ## 8. 運用ルール
@@ -82,6 +82,7 @@ specdojo:
82
82
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
83
83
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
84
84
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
85
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
85
86
 
86
87
  ## 6. 内容充実化(薄いドキュメント防止)
87
88
 
@@ -99,7 +100,7 @@ specdojo:
99
100
  - 手順・操作・使い方など guide が担う説明を standard の主目的にしない。
100
101
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
101
102
  - schema で機械検証する制約を本文に二重定義し、両者を乖離させない。
102
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
104
 
104
105
  ## 8. 運用ルール
105
106
 
@@ -27,7 +27,13 @@ specdojo:
27
27
  | 申請日 | _TODO_ |
28
28
  | 変更理由 | _TODO_ |
29
29
 
30
- ## 2. 影響評価
30
+ ## 2. 入力
31
+
32
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
33
+
34
+ -
35
+
36
+ ## 3. 影響評価
31
37
 
32
38
  | 観点 | 影響 |
33
39
  | ------------ | ------ |
@@ -37,7 +43,7 @@ specdojo:
37
43
  | 品質 | _TODO_ |
38
44
  | 運用 | _TODO_ |
39
45
 
40
- ## 3. 審査・決定
46
+ ## 4. 審査・決定
41
47
 
42
48
  | 項目 | 内容 |
43
49
  | -------- | --------------------------------- |
@@ -46,7 +52,7 @@ specdojo:
46
52
  | 決定日 | _TODO_ |
47
53
  | 実施条件 | _TODO_ |
48
54
 
49
- ## 4. 実施追跡
55
+ ## 5. 実施追跡
50
56
 
51
57
  | 項目 | 内容 |
52
58
  | -------- | ------ |
@@ -55,6 +61,6 @@ specdojo:
55
61
  | 完了条件 | _TODO_ |
56
62
  | 対応結果 | _TODO_ |
57
63
 
58
- ## 5. 関連ドキュメント
64
+ ## 6. 関連ドキュメント
59
65
 
60
66
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,7 +22,13 @@ specdojo:
22
22
 
23
23
  _TODO_: すでに顕在化している問題、発生日、影響を記載する。
24
24
 
25
- ## 2. 影響範囲
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 影響範囲
26
32
 
27
33
  | 観点 | 影響 |
28
34
  | ------------ | ------ |
@@ -32,7 +38,7 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
32
38
  | 品質 | _TODO_ |
33
39
  | 関係者 | _TODO_ |
34
40
 
35
- ## 3. 対応方針
41
+ ## 4. 対応方針
36
42
 
37
43
  | 項目 | 内容 |
38
44
  | -------- | ------ |
@@ -41,10 +47,10 @@ _TODO_: すでに顕在化している問題、発生日、影響を記載する
41
47
  | 依存事項 | _TODO_ |
42
48
  | 完了条件 | _TODO_ |
43
49
 
44
- ## 4. 対応結果
50
+ ## 5. 対応結果
45
51
 
46
52
  _TODO_: 解決内容、確認結果、再発防止策を記載する。未解決の場合は `-` とする。
47
53
 
48
- ## 5. 関連ドキュメント
54
+ ## 6. 関連ドキュメント
49
55
 
50
56
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,21 +22,27 @@ specdojo:
22
22
 
23
23
  _TODO_: 確認したい論点を、回答者が判断できる粒度で記載する。
24
24
 
25
- ## 2. 背景
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 背景
26
32
 
27
33
  _TODO_: この確認が必要になった背景、前提、制約を記載する。
28
34
 
29
- ## 3. 回答候補
35
+ ## 4. 回答候補
30
36
 
31
37
  | 候補 | 内容 | 利点 | 懸念 |
32
38
  | ---- | ------ | ------ | ------ |
33
39
  | A | _TODO_ | _TODO_ | _TODO_ |
34
40
 
35
- ## 4. 回答・結論
41
+ ## 5. 回答・結論
36
42
 
37
43
  _TODO_: 回答または採択した方針を記載する。未回答の場合は `-` とする。
38
44
 
39
- ## 5. 承認
45
+ ## 6. 承認
40
46
 
41
47
  | 項目 | 内容 |
42
48
  | -------- | ------ |
@@ -48,6 +54,6 @@ _TODO_: 回答または採択した方針を記載する。未回答の場合は
48
54
  - 承認方式は既定で `commit`(`register close` により `decided` へ遷移)を用いる。
49
55
  - 回答が不可逆・高リスク・framework schema 破壊的変更を伴う場合は `PR` 方式で承認し、証跡に PR URL と merge SHA を記載する。
50
56
 
51
- ## 6. 関連ドキュメント
57
+ ## 7. 関連ドキュメント
52
58
 
53
59
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,7 +22,13 @@ specdojo:
22
22
 
23
23
  _TODO_: 将来発生し得る不確実な事象と、その原因を記載する。
24
24
 
25
- ## 2. 影響評価
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 影響評価
26
32
 
27
33
  | 項目 | 評価 |
28
34
  | -------- | ------------------- |
@@ -31,7 +37,7 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
31
37
  | 影響範囲 | _TODO_ |
32
38
  | 兆候 | _TODO_ |
33
39
 
34
- ## 3. 対応方針
40
+ ## 4. 対応方針
35
41
 
36
42
  | 項目 | 内容 |
37
43
  | ------------------ | ------------------------- |
@@ -40,10 +46,10 @@ _TODO_: 将来発生し得る不確実な事象と、その原因を記載する
40
46
  | トリガー | _TODO_ |
41
47
  | エスカレーション先 | _TODO_ |
42
48
 
43
- ## 4. モニタリング
49
+ ## 5. モニタリング
44
50
 
45
51
  _TODO_: 監視周期、確認方法、状態更新の条件を記載する。
46
52
 
47
- ## 5. 関連ドキュメント
53
+ ## 6. 関連ドキュメント
48
54
 
49
55
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -22,20 +22,26 @@ specdojo:
22
22
 
23
23
  _TODO_: 実施すべき作業と、その作業が必要になった理由を 1〜3 文で記載する。
24
24
 
25
- ## 2. 完了条件
25
+ ## 2. 入力
26
+
27
+ <!-- 対話で得た前提・制約・委任範囲を記録する。完了・回答の判定条件とは分ける。 -->
28
+
29
+ -
30
+
31
+ ## 3. 完了条件
26
32
 
27
33
  - _TODO_: 完了と判断できる具体的な条件を記載する。
28
34
 
29
- ## 3. 作業内容
35
+ ## 4. 作業内容
30
36
 
31
37
  | No | 作業 | 担当 | 状態 | メモ |
32
38
  | --- | ------ | ------ | ---- | ---- |
33
39
  | 1 | _TODO_ | _TODO_ | open | - |
34
40
 
35
- ## 4. 対応結果
41
+ ## 5. 対応結果
36
42
 
37
43
  _TODO_: 完了時に、実施内容・成果物・残課題を記載する。未完了の場合は `-` とする。
38
44
 
39
- ## 5. 関連ドキュメント
45
+ ## 6. 関連ドキュメント
40
46
 
41
47
  - _TODO_: 根拠・影響先・追跡先を `[[doc-id]]` 形式で記載する。
@@ -300,6 +300,15 @@ $defs:
300
300
  minLength: 1
301
301
  description: "One-sentence description of the deliverable's purpose."
302
302
 
303
+ brief:
304
+ type: string
305
+ minLength: 1
306
+ description: >
307
+ Optional assumptions or context passed continuously from outside the deliverable
308
+ (e.g., tech stack, architecture constraints, baseline policies).
309
+ Populates the plan's brief field for schedule and register paths.
310
+ Multiple deliverables may share a brief via YAML anchors (&anchor / *anchor).
311
+
303
312
  path:
304
313
  type: string
305
314
  pattern: "^[^\\s]+$"
@@ -48,6 +48,7 @@ $defs:
48
48
  type: string
49
49
  enum:
50
50
  [
51
+ "draft",
51
52
  "fully-guided",
52
53
  "recipe-guided",
53
54
  "freeform",
@@ -69,7 +70,7 @@ $defs:
69
70
  ]
70
71
  description: >
71
72
  How the task is carried out. catalog-planning and strategy-planning create a catalog
72
- or schedule strategy from register-only domain:<id> / track:<id> targets. fully-guided/recipe-guided/freeform describe how strictly
73
+ or schedule strategy from register-only domain:<id> / track:<id> targets. draft researches and drafts within delegated context; fully-guided refines existing deliverables using declared references. fully-guided/recipe-guided/freeform describe how strictly
73
74
  the agent follows reference materials (rulebook/recipe/sample/template) when working on
74
75
  a deliverable. bootstrap authors the deliverable and its full reference set
75
76
  (rulebook/recipe/sample/template) together in one task as a mutually consistent whole;
@@ -108,6 +108,7 @@ $defs:
108
108
  lint-ts,
109
109
  lint-fm,
110
110
  lint-md,
111
+ lint-mermaid,
111
112
  build,
112
113
  format-check,
113
114
  ]
@@ -63,6 +63,7 @@ $defs:
63
63
  - status
64
64
  - title
65
65
  - description
66
+ - input
66
67
  - type
67
68
  - track
68
69
  - priority
@@ -81,6 +82,8 @@ $defs:
81
82
  - derived_from
82
83
  - depends_on
83
84
  - autopilot
85
+ - commit_type
86
+ - commit_scope
84
87
  from:
85
88
  type: string
86
89
  to:
@@ -99,6 +99,7 @@ properties:
99
99
  approach:
100
100
  enum:
101
101
  [
102
+ draft,
102
103
  fully-guided,
103
104
  recipe-guided,
104
105
  freeform,
@@ -262,6 +263,18 @@ properties:
262
263
  Human approval that the item's stated completion conditions may be executed by the
263
264
  night orchestrator. Omit the key to keep the item out of the approved queue.
264
265
 
266
+ commit_type:
267
+ $ref: "#/$defs/CommitType"
268
+ description: >
269
+ Conventional Commits type for commits generated from this item.
270
+ Omit the key to derive it from item_type and configuration.
271
+
272
+ commit_scope:
273
+ $ref: "#/$defs/CommitScope"
274
+ description: >
275
+ Conventional Commits scope for commits generated from this item.
276
+ Omit the key when no scope applies.
277
+
265
278
  approach:
266
279
  $ref: "#/$defs/Approach"
267
280
  description: >
@@ -368,6 +381,7 @@ $defs:
368
381
  Approach:
369
382
  type: string
370
383
  enum:
384
+ - draft
371
385
  - fully-guided
372
386
  - recipe-guided
373
387
  - freeform
@@ -413,3 +427,24 @@ $defs:
413
427
  type: string
414
428
  pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
415
429
  description: "Project-qualified display id of a register item in another project."
430
+
431
+ CommitType:
432
+ type: string
433
+ enum:
434
+ - feat
435
+ - fix
436
+ - docs
437
+ - refactor
438
+ - test
439
+ - chore
440
+ - perf
441
+ - build
442
+ - ci
443
+ - style
444
+ - revert
445
+ description: "Conventional Commits type."
446
+
447
+ CommitScope:
448
+ type: string
449
+ pattern: "^[a-z0-9][a-z0-9-]*$"
450
+ description: "Conventional Commits scope."