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
@@ -0,0 +1,93 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Plan: _TASK_ID_
4
+
5
+ ## 1. このフェーズで行うこと
6
+
7
+ _PHASE_DESCRIPTION_
8
+
9
+ ## 2. 対象成果物
10
+
11
+ - `name`: _DELIVERABLE_NAME_
12
+ - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
16
+ - `overview`: _DELIVERABLE_OVERVIEW_
17
+ - `path`: `_DELIVERABLE_PATH_`
18
+ - `result`: `_RESULT_REF_`
19
+
20
+ _PROJECT_CONTEXT_
21
+
22
+ ## 3. owner ロールとしての記述ポイント
23
+
24
+ frontmatter の `owner` に記載された role の視点で成果物を記述する。owner ロールの責務と、そのロールが重視するレビュー観点は次のとおり。
25
+
26
+ - owner role: **_OWNER_ROLE_LABEL_**
27
+ - 責務: _OWNER_ROLE_NOTE_
28
+
29
+ このロールが重視するレビュー観点:
30
+
31
+ _OWNER_ROLE_VIEWPOINTS_
32
+
33
+ ## 4. 進め方
34
+
35
+ draft は、文脈で任された範囲を調べて成果物を下書きする進め方である。雛形に人が記入した文脈を読み、調査・選定を任された範囲と、既に決まっている前提を区別する。未作成なら template を骨組みにし、既存の下書きがあればそれを尊重して加筆する。必要な型の新規整備は本タスクの範囲に含めず、申し送る。
36
+
37
+ 人による文脈の記入が無い場合も、未作成なら template から下書きする。rulebook / recipe / sample と宣言された先行成果物・前提で根拠を確認できる内容を埋め、文脈が無いことを調査・選定の委任とは解釈しない。根拠のない値や未委任の判断は _TODO_ / _ASSUMPTION_ と次のアクションを残す。
38
+
39
+ ### 4.1. 参照範囲
40
+
41
+ 次の文書・情報を実際に読み込む。宣言の無い項目は推測で補わない。
42
+
43
+ - rulebook(構造・必須要素・禁止事項): `_RULEBOOK_REF_`
44
+ - 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
45
+ - recipe(問い・組み立て方): `_RECIPE_REF_`
46
+ - sample(完成例の粒度・文体・表現): `_SAMPLE_REF_`
47
+ - template(開始時の雛形): `_TEMPLATE_REF_`
48
+ - 対象成果物の `depends_on` 成果物と frontmatter の `based_on`(「対象成果物」に表示)。
49
+ - プロジェクトコンテキスト(`project_context`)。
50
+ - 個票の `入力` とカタログの `brief`(「対象成果物」に表示。値が無いときは載せない)。
51
+ - 対象成果物内の文脈(`_CONTEXT_:` など、人が記入した指示)。
52
+ - 文脈で任された調査・選定に必要な外部の情報(出典つき)。
53
+
54
+ rulebook を構造の基準とし、文書間に矛盾がある場合は rulebook を正とする。sample は形式の参考とし、その業務内容・固有名詞・値を対象成果物の事実として転記しない。`_MISSING_` は未宣言・未整備または非適用を示す。必要な型の欠落や内容の薄さは result に記録し、存在する型・対象成果物・上記の文脈を用いて進める。
55
+
56
+ ### 4.2. 調査・下書きと具体化の許可
57
+
58
+ 1. 文脈から、対象成果物の責務、固定された前提、調査・選定を任された範囲を特定する。指示が曖昧なら、任されていない範囲まで選定を広げない。
59
+ 2. 文脈で任された範囲に限り「根拠のない具体化の禁止」を外し、外部の情報を調べて値を決めてよい。技術・設定値などを選ぶ場合は、出典を確認し、対象の前提と選定理由を説明する。
60
+ 3. 選んだ値は成果物で「提案」と分かる形で示す。既存の決定事項や実装済みの事実として断定しない。出典と選定理由を result の `進め方と実践の型の適用` セクションに残す。
61
+ 4. 任されていない範囲は従来どおり _TODO_ / _ASSUMPTION_ で残し、不足する根拠と次のアクションを記録する。外部調査で得た情報を理由に、未委任の業務判断や将来方針を決めない。
62
+ 5. 成果物内の `_CONTEXT_:` は、指示を本文へ反映したら目印と元の指示を消し、元の指示を result に写す。元の指示と反映箇所を対にして記録する。executor / reporter pipeline では、元の指示と反映箇所を報告の `handoff` に書き、reporter と runner が result へ転記する。反映できない指示は削除せず、未反映の理由と次の行動を記録する。
63
+
64
+ ### grade result から展開された finding
65
+
66
+ _GRADE_FINDINGS_
67
+
68
+ plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result に記録する。grade result サイドカーは本タスクでは直接編集しない。
69
+
70
+ ### 4.3. 判断根拠の記録
71
+
72
+ result の `進め方と実践の型の適用` セクションに、任された範囲、参照した型と文脈、選んだ提案値ごとの出典と選定理由、本文へ反映した元の指示、未決事項を記録する。外部の情報には URL・文書名など、後から出典へ到達できる情報を付ける。下書きの後は fully-guided で磨き込み、finalize で人が確定する。
73
+
74
+ ## 5. 完了の狙い
75
+
76
+ この成果物が満たすべき狙い(成果物カタログの `done_criteria`)を、owner ロールの狙いと下流ロールの入力適合に分けて示す。「進め方」に従って実践の型に沿って記述する中で、owner の狙いを作成目標として満たすことを目指す。下流ロールの項目は、その文書から各ロールが自分の責務の成果物を作成できるよう入力として最低限成立させる範囲にとどめ、各ロールの内容を成果物に作り込まない(一文書一責務)。下流ロールの適合性検証や観点別の自己レビュー・修正ループは行わず、多観点での検証は後続の独立した review task に委ねる。
77
+
78
+ _DONE_CRITERIA_GOALS_
79
+
80
+ ## 6. 完了手順
81
+
82
+ 1. 「このフェーズで行うこと」と「進め方」に従って成果物を更新する。
83
+ 2. 「完了の狙い」を満たしているかを確認し、不足があれば加筆・補強する(観点別の自己レビューや再確認ループは行わない)。
84
+ 3. 共通規約に従って、必要な整形・静的検査を実行する。
85
+ 4. result に実施内容・変更ファイル・進め方と実践の型の適用を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
86
+
87
+ ## 7. 異常終了の条件
88
+
89
+ - 依存未解決・対象ファイル不明・lint/test 未解消の場合は異常終了する(終了コード 1)。
90
+ - 標準エラー出力に理由を出力する(例: `blocked: <reason>; need=<next action>; ref=<path>`)。
91
+ - agent 自身は claim / complete / reopen / block を記録せず、終了コードと標準エラー出力で runner に結果を返す。
92
+
93
+ _COMMON_CONVENTIONS_
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
10
10
 
11
11
  - `name`: _DELIVERABLE_NAME_
12
12
  - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
13
16
  - `overview`: _DELIVERABLE_OVERVIEW_
14
17
  - `path`: `_DELIVERABLE_PATH_`
15
18
  - `result`: `_RESULT_REF_`
@@ -29,6 +32,10 @@ _OWNER_ROLE_VIEWPOINTS_
29
32
 
30
33
  ## 4. 進め方
31
34
 
35
+ fully-guided は既存成果物の磨き込み専用である。雛形からの下書きや、調査して新しい値を選ぶ作業は draft で行う。対象成果物が未作成、または文脈だけの状態なら、下書きが必要なことを result に記録し、draft へ申し送る。
36
+
37
+ 成果物内に `_CONTEXT_:` が残っている場合は、その指示を本文へ反映・削除せず、元の指示、未反映の箇所、必要な下書きを論点として result の `進め方と実践の型の適用` セクションに残し、draft へ申し送る。executor / reporter pipeline では報告の `handoff` に記載し、reporter と runner が result へ転記する。
38
+
32
39
  対象成果物に必要と宣言された rulebook / recipe / sample は、指定されたファイルを実際に読み込んだうえで、次の役割に沿って参照する。読み込まずに記憶や推測で代替しない。
33
40
 
34
41
  参照ファイル(成果物カタログの rulebook ID と rulebook frontmatter から解決。`_MISSING_` は `undecided`、`not-needed`、未整備、または `kind: generated` による非適用を表す。fully-guided では通常 `not-needed` の項目だけが該当する):
@@ -51,7 +58,7 @@ _GRADE_FINDINGS_
51
58
 
52
59
  plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result の `進め方と実践の型の適用` セクションに記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
53
60
 
54
- 参照してよい文書は、この plan に記載されたものに限定する。具体的には、本セクションの rulebook / 併せて適用する rulebook / recipe / sample、`対象成果物` セクションの `depends_on` 成果物、プロジェクトコンテキストである。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。成果物の作成・更新は plan に記載された資料とこの plan 自身の記述(フェーズ説明・レビュー観点)だけを根拠に行い、不足があっても未記載の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
61
+ 参照してよい文書は、宣言された文書だけに限る。具体的には、対象成果物、本セクションの rulebook / 併せて適用する rulebook / recipe / sample、`対象成果物` セクションの `depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief` である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。磨き込みは宣言された資料とこの plan 自身の記述(フェーズ説明・完了の狙い)だけを根拠に行い、不足があっても未宣言の文書を追加で読んで補わない。それでも判断できない箇所は憶測で埋めず _TODO_ / _ASSUMPTION_ として論点を残す。
55
62
 
56
63
  本タスクの実行に必要な fully-guided の参照方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や review への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
57
64
 
@@ -79,7 +86,7 @@ plan に展開された finding は、message と同じ viewpoint ID の判定
79
86
 
80
87
  ### 4.3. 根拠のない具体化の禁止
81
88
 
82
- - ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、プロジェクトコンテキスト)で裏付けが取れる場合に限る。sample は別文脈の完成例であり、対象成果物の具体的な記述の裏付けにしない。
89
+ - ファイルパス・コマンド・設定値など、実装や設定の実態を示す具体的な記述を新たに書き加える場合は、本セクションの宣言された参照範囲(rulebook / 併せて適用する rulebook / recipe、`depends_on` 成果物、`based_on`、プロジェクトコンテキスト、個票の `入力`、カタログの `brief`)で裏付けが取れる場合に限る。sample は別文脈の完成例であり、対象成果物の具体的な記述の裏付けにしない。
83
90
  - 既存記述が曖昧・不完全(ファイル名のみでパスが無い、値が未確定など)であっても、裏付けが無ければ推測で具体化しない。完成度を上げる目的だけで、もっともらしい値を断定的に書き加えない。
84
91
  - 裏付けが無く判断できない箇所は、既存の曖昧な記述を残したまま _TODO_ / _ASSUMPTION_ として論点を残す。
85
92
 
@@ -18,6 +18,8 @@ _PJR_DESCRIPTION_
18
18
  - `個票`: _PJR_TICKET_REF_
19
19
  - `result`: `_RESULT_REF_`
20
20
 
21
+ _REGISTER_INPUT_
22
+
21
23
  ## 3. 進め方
22
24
 
23
25
  1. 個票(存在する場合)を読み、問い・リスク内容・判断に必要な条件を把握する。登録簿の一覧は大きいため読まない。
@@ -18,6 +18,8 @@ _PJR_DESCRIPTION_
18
18
  - `個票`: _PJR_TICKET_REF_
19
19
  - `result`: `_RESULT_REF_`
20
20
 
21
+ _REGISTER_INPUT_
22
+
21
23
  ## 3. 進め方
22
24
 
23
25
  1. 個票(存在する場合)を読み、目的・完了条件・制約を把握する。登録簿の一覧は大きいため読まない。
@@ -15,6 +15,8 @@ done_criteria の各項目を確認し、満たしていればチェックを付
15
15
 
16
16
  _DONE_CRITERIA_CHECKLIST_
17
17
 
18
+ - [ ] 確定対象の成果物と実践の型の本文に未反映の `_CONTEXT_:` が残っていない(残っていれば承認せず、draft へ差し戻す)
19
+
18
20
  ## 3. 実践の型の確認
19
21
 
20
22
  実践の型を種別ごとに確認し、満たしていればチェックを付ける。「確定対象」に無い種別はスキップし、行を削除する。
@@ -0,0 +1,23 @@
1
+ _FRONTMATTER_
2
+
3
+ # Edit Result
4
+
5
+ この human タスクは雛形作成と文脈の記入を担当する。plan は生成せず、claim / complete で状態を記録する。対象は frontmatter の `targets` を成果物カタログで確認する。
6
+
7
+ 1. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成する。既存ファイルは上書きしない。`--force` は指定しない。
8
+ 2. 対象本文の必要な箇所に `_CONTEXT_:` を付け、固定前提・制約・調査や選定を任せる範囲を記入する。例: `_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。`
9
+ 3. 以下へ対象ファイルと記入した文脈を記録し、`specdojo exec complete --project <project-id> --task <task-id> --by <human>` で完了する。後続の agent が draft で文脈を下書きへ反映する。
10
+
11
+ ## 1. 実施内容
12
+
13
+ _TODO_: 雛形の作成有無と記入した文脈を記録する。
14
+
15
+ ## 2. 変更ファイル
16
+
17
+ _TODO_: 雛形を作成した、または文脈を記入した成果物のパスを記録する。
18
+
19
+ ## 3. 申し送り
20
+
21
+ _TODO_: 後続の draft へ渡す前提・委任範囲・確認事項を記録する(なければ削除)。
22
+
23
+ _APPROACH_SECTION_
@@ -15,6 +15,8 @@ done_criteria の各項目を確認し、満たしていればチェックを付
15
15
 
16
16
  _DONE_CRITERIA_CHECKLIST_
17
17
 
18
+ - [ ] 確定対象の本文に未反映の `_CONTEXT_:` が残っていない(残っていれば承認せず、draft へ差し戻す)
19
+
18
20
  ## 3. 確定対象
19
21
 
20
22
  最終確認と frontmatter の `status` の `ready` への昇格が済んだ対象にチェックを付ける。
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
10
10
 
11
11
  - `name`: _DELIVERABLE_NAME_
12
12
  - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
13
16
  - `overview`: _DELIVERABLE_OVERVIEW_
14
17
  - `path`: `_DELIVERABLE_PATH_`
15
18
  - `rulebook`: `_RULEBOOK_REF_`(`_MISSING_` は `undecided`、`not-needed`、または未整備)
@@ -43,20 +46,20 @@ _DONE_CRITERIA_ROWS_
43
46
 
44
47
  ## 5. 進め方
45
48
 
46
- fully-guided のタスクは、rulebook / recipe / sample / template に従って成果物を作成・更新することを求めた。rulebook の必須要素・禁止事項、recipe の問い、sample の粒度・文体、template の章構成との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
49
+ fully-guided のタスクは、宣言された文書だけを参照し、rulebook / recipe / sample に沿って既存成果物を磨き込むことを求めた。下書きや調査による新しい値の選定は draft の役割である。磨き込みでは template を読み込まない。rulebook の必須要素・禁止事項、recipe の問い、sample の形式との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
47
50
 
48
51
  参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備):
49
52
 
50
53
  - rulebook: `_RULEBOOK_REF_`
51
54
  - recipe: `_RECIPE_REF_`
52
55
  - sample: `_SAMPLE_REF_`
53
- - template: `_TEMPLATE_REF_`
56
+ - 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
54
57
 
55
- 1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
58
+ 1. フェーズ説明と完了条件が求めた磨き込みが、対象成果物に行われたかを確認する。
56
59
  2. 実践の型の欠落(`_MISSING_`)や内容の薄さがある場合は、実行記録にその扱いが残っているかを確認する。実践の型そのものの整備が必要な場合は、改善指示に残す。
57
60
  3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook の必須要素の欠落や禁止事項への抵触など、完了条件に直結する finding は完了を妨げる。
58
61
 
59
- 確認に用いてよい文書は、この plan に記載されたものに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、プロジェクトコンテキスト、実行記録である。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
62
+ 確認に用いてよい文書は、宣言された文書だけに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief`、実行記録である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。
60
63
 
61
64
  本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
62
65
 
@@ -334,6 +334,8 @@ routing:
334
334
 
335
335
  `lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)は、executor が残した ESLint・frontmatter・Markdown の lint エラーを agent の段階で検出します。指定しない場合、これらのエラーは統合後の `npm run check` まで持ち越されます(PJR-K1Z5)。
336
336
 
337
+ `lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
338
+
337
339
  `build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
338
340
 
339
341
  `specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
@@ -555,7 +557,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
555
557
  - 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
556
558
  - evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
557
559
  - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
558
- - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
560
+ - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
559
561
  - executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
560
562
  - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
561
563
  - `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
@@ -17,7 +17,7 @@ Exec Operation Guide
17
17
 
18
18
  **この文書で分かること**
19
19
 
20
- - 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順
20
+ - 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順、文脈を渡して段階的に作成する流れ
21
21
 
22
22
  **次に読む文書**
23
23
 
@@ -653,7 +653,7 @@ specdojo:
653
653
  #### 4.3.1. 成果物を対象にする場合
654
654
 
655
655
  - **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
656
- - **進め方(`approach`)**: 成果物を作成・修正する進め方(`fully-guided`、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
656
+ - **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
657
657
 
658
658
  #### 4.3.2. kata(実践の型)を対象にする場合
659
659
 
@@ -711,3 +711,97 @@ specdojo register close \
711
711
  --id <PJR-ID> \
712
712
  --conclusion "設定ガイドを改訂し検証を通過"
713
713
  ```
714
+
715
+ ### 4.7. 文脈を渡して段階的に作成する手順
716
+
717
+ 成果物をゼロから作成する場合や、技術スタックの選定などの調査を伴う場合は、成果物の雛形作成から文脈の記入、下書き(`draft`)、磨き込み(`fully-guided`)、人間の確定(`finalize`)へと段階的に個票を分けて進めます。
718
+
719
+ #### 4.7.1. 5つの段階と役割分担
720
+
721
+ 成果物作成の流れは、次の 5 段階で役割を分担します。
722
+
723
+ | 段階 | 実行主体 | approach | 役割と進め方 |
724
+ | ----------------------- | -------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
725
+ | 1. 雛形作成(scaffold) | CLI / 人 | - | `deliverable scaffold` で成果物のファイル雛形を生成する |
726
+ | 2. 文脈の記入 | 人 | - | 成果物内に `_CONTEXT_:` を記入、または個票の `入力`(`--input`)で前提・制約・調査委任の指示を渡す |
727
+ | 3. 下書き(draft) | agent | `draft` | 文脈で任された範囲を調査・選定して下書きする。選定値を提案として示し、出典と選定理由を result に記録する。反映した `_CONTEXT_:` は削除して result に写す |
728
+ | 4. 磨き込み(refine) | agent | `fully-guided` | 既存成果物を実践の型(rulebook / recipe / sample)に照らして構造・用語・整合性を磨き込む(磨き込み専用)。新たな調査や外部情報の追加は行わない |
729
+ | 5. 確定(finalize) | 人 | `finalize` | `done_criteria` や未反映の文脈指示(`_CONTEXT_:` の残り)がないことを確認し、成果物の `status` を `ready` へ昇格する |
730
+
731
+ #### 4.7.2. 個票の分割と `depends_on` による連携
732
+
733
+ この流れをプロジェクト登録簿(register)で進める場合は、`draft`、`fully-guided`、`finalize` の各段階を個票(`todo`)として起票し、`depends_on` で先行タスクに依存させて順に実行します。
734
+
735
+ たとえば、フロントエンドの技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して段階的に作成する場合の手順は次のとおりです。
736
+
737
+ ```bash
738
+ # 1. 雛形を作成する
739
+ # カタログにある成果物を 1 件だけ指定して作成する場合:
740
+ specdojo deliverable scaffold \
741
+ --project prj-0001 \
742
+ --target prj-0001:tsd-frontend-site
743
+
744
+ # カタログにない成果物を雛形にする場合は --target-path と --target-rulebook を指定する:
745
+ specdojo deliverable scaffold \
746
+ --project prj-0001 \
747
+ --target prj-0001:tsd-custom-tool \
748
+ --target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
749
+ --target-rulebook specdojo:tsd-rulebook
750
+ ```
751
+
752
+ `deliverable scaffold` は `--target <doc-id>` で成果物を 1 つだけ指定して雛形を作成できます。カタログにない成果物は、`--target-path` と `--target-rulebook` を添えて作成します(PJR-S23T)。また、`specdojo:tsd-rulebook` のように template を持たない(`template: not-needed` と宣言された)rulebook であっても、最小構成の雛形(frontmatter、見出し、本文の `_TODO_`)が生成されます。その際、雛形 frontmatter の `type` は rulebook の `deliverable_type`(TSD の場合は `architecture`)が自動設定されるため(未宣言なら `project`)、`docs-lint` の `frontmatter-deliverable-type` 検証をそのまま通過できます(PJR-YKYK)。
753
+
754
+ ```bash
755
+ # 2. 成果物に文脈を記入する(または個票の --input で渡す)
756
+ # 生成された docs/.../tsd-frontend-site.md の先頭章などに次のように記入する:
757
+ # _CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、採用理由・全体構成・導入手順を下書きしてください。
758
+
759
+ # 3. 下書き(draft)の個票を起票する(対話から得た前提は --input でも渡せる)
760
+ specdojo register add \
761
+ --project prj-0001 \
762
+ --type todo \
763
+ --title "フロントエンドTSDの下書き(draft)" \
764
+ --topic tsd-frontend-draft \
765
+ --difficulty medium \
766
+ --approach draft \
767
+ --target prj-0001:tsd-frontend-site \
768
+ --input "静的サイトで主流の技術スタック(Astro 等)を調査して選定する" \
769
+ --owner DEV
770
+
771
+ # 4. 磨き込み(fully-guided)の個票を起票し、draft 個票に依存させる
772
+ specdojo register add \
773
+ --project prj-0001 \
774
+ --type todo \
775
+ --title "フロントエンドTSDの磨き込み(fully-guided)" \
776
+ --topic tsd-frontend-refine \
777
+ --difficulty medium \
778
+ --approach fully-guided \
779
+ --target prj-0001:tsd-frontend-site \
780
+ --depends-on <DRAFT-PJR-ID> \
781
+ --owner DEV
782
+
783
+ # 5. 確定(finalize)の個票を起票し、fully-guided 個票に依存させる
784
+ specdojo register add \
785
+ --project prj-0001 \
786
+ --type todo \
787
+ --title "フロントエンドTSDの確定(finalize)" \
788
+ --topic tsd-frontend-finalize \
789
+ --difficulty easy \
790
+ --approach finalize \
791
+ --target prj-0001:tsd-frontend-site \
792
+ --depends-on <REFINE-PJR-ID> \
793
+ --owner PO
794
+ ```
795
+
796
+ #### 4.7.3. 順次実行と引き継ぎ
797
+
798
+ 起票した個票は、`depends_on` の順序に従って実行します。
799
+
800
+ 1. **下書き(draft)の実行**:
801
+ `exec run --register <DRAFT-PJR-ID> --worktree` を実行します。agent は成果物内の `_CONTEXT_:` や個票の `入力` を読み取り、技術スタックを調べて下書きします。反映した `_CONTEXT_:` は削除され、元の指示と選定理由は draft の result に記録されます。実行完了後に内容を確認し、`register close` します。
802
+ 2. **磨き込み(fully-guided)の実行**:
803
+ draft が完了したら、後続の `exec run --register <REFINE-PJR-ID> --worktree` を実行します。agent は draft で作成された草案を rulebook や recipe に適合するように磨き込みます。この段では外部調査を行わず、既存の草案の構造・記述を整理します。実行完了後に内容を確認し、`register close` します。
804
+ 3. **人間による確定(finalize)**:
805
+ 人が成果物を確認し、`done_criteria` を満たしていること、未反映の `_CONTEXT_:` が残っていないことをチェックします。問題がなければ `status` を `ready` へ昇格し、個票を close します。
806
+
807
+ 夜間や自動でまとめて実行する場合は、本ガイドの「2. 実行の列の組み方」と同様に、これらを 1 本の列に並べて順に流します。先行タスクが成功して統合されることで、後続タスクがその成果物を引き継いで実行されます。
@@ -114,6 +114,19 @@ SpecDojo 自身のリポジトリへ起票する場合も、同じように別
114
114
 
115
115
  タイトルが日本語の場合は、内容を表す英語の `--topic` を小文字・ハイフン区切りで指定します。省略して `item` や日本語タイトル中の英単語だけが topic になった場合、`register add` は作成を続けたうえで警告します。警告後も、`register update --topic` で個票名と文書 ID を変更できます。成果物や kata(実践の型)を作成・修正する todo では、`--approach <approach> --target <doc-id>` を指定して進め方と対象を宣言できます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
116
116
 
117
+ 対話で確かめた前提・制約・調査を任せる範囲は、`--input <text>` を繰り返して個票本文の `入力` 節へ記録します。完了条件は別に記載します。
118
+
119
+ ```bash
120
+ specdojo register add --project prj-0001 --type todo \
121
+ --title "技術案を作る" --topic technology-proposal \
122
+ --input "対象は社内向けの利用者100名" \
123
+ --input "認証方式の調査と選定を任せる"
124
+ ```
125
+
126
+ `register update --input` は入力一覧を置き換えます。追記したい場合も既存分を含めてすべて指定し、全削除は `--input -` 単独で行います。未指定なら保持し、空文字や削除と他の入力の混在は拒否します。節のない既存個票には更新時に節を追加します。変更は event の `input` に変更前後の JSON 配列(未入力は `-`)で残ります。同じ値への再更新は event を増やしません。
127
+
128
+ register 経由の plan では、approach がある成果物の plan と approach がない edit / investigate plan のどちらにも、入力がある場合だけ「個票の入力(前提)」が載ります。前提を読む範囲と完了を判定する条件を区別できます。
129
+
117
130
  `--priority` は次の目安で付けます(省略時は `medium`)。
118
131
 
119
132
  | priority | 目安 |
@@ -387,7 +400,7 @@ specdojo register history --project <project-id> --since 2026-08-01 --json
387
400
  ```
388
401
 
389
402
  - `register add`、状態遷移、`register update`、`register renumber` は、現在値を個票へ、event を項目別イベントファイルへ書き込みます。`--by` と `--reason` を指定すると actor と理由を明示できます。記帳と再生成を `register lifecycle` 枠の内側で commit まで完了させる場合は `--commit` を付けます。
390
- - 一覧の列に現れない変更(対応結果本文の追記、個票 `status` の昇格など)は event になりません。個票の全差分が必要な場合は `git log -p` を使います。
403
+ - 入力は一覧に出なくても `input` の変更として event に記録します。それ以外の一覧の列に現れない変更(対応結果本文の追記、個票 `status` の昇格など)は event になりません。個票の全差分が必要な場合は `git log -p` を使います。
391
404
  - `--status-only` は追加・削除・状態遷移だけを残し、変更内容も遷移に関わる項目(`status` / `type` / `completed` / `conclusion`)へ絞ります。
392
405
  - `renumber` による ID 付け替えは、`id` の変更を含む `updated` イベントとして現れます。
393
406
  - 複数の遷移を1コミットへまとめたり squash したりしても、項目別イベントファイルに残る各 event の発生日時・actor・変更内容は失われません。`register start` を含む遷移時の commit policy は別の運用判断です。
@@ -84,7 +84,7 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
84
84
 
85
85
  scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
86
86
 
87
- - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。devcontainer が停止していれば `devcontainer up` で起動し、コンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
87
+ - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。ラベル(`devcontainer.local_folder`)が一致するコンテナだけを探して接続し、停止していれば `devcontainer up` で起動してからコンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
88
88
  - `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。`RemoteCommand` では端末の `PATH` の設定が読み込まれないため、接続元から `ssh <host> 'command -v devcontainer'` を実行して Dev Container CLI が見つかるか確かめられます。
89
89
 
90
90
  `devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。