specdojo 0.6.0 → 0.7.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 (60) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +2 -2
  3. package/dist/commands/agent.js +33 -0
  4. package/dist/commands/init.js +1 -0
  5. package/dist/commands/orchestrator.js +10 -1
  6. package/dist/devcontainer/command.js +18 -0
  7. package/dist/devcontainer/host-script.js +21 -0
  8. package/dist/devcontainer/scaffold.js +4 -3
  9. package/dist/exec/antigravity-session.js +154 -0
  10. package/dist/exec/parent-validation.js +7 -0
  11. package/dist/exec/plan-markdownlint.js +89 -0
  12. package/dist/exec/plans-generation.js +6 -2
  13. package/dist/exec/register-resume.js +28 -0
  14. package/dist/exec/run/lifecycle-commands.js +85 -16
  15. package/dist/exec/run/register-command.js +6 -0
  16. package/dist/exec/run/schedule-mode.js +22 -2
  17. package/dist/exec/run/schedule-prepare.js +42 -1
  18. package/dist/exec/run/schedule-task.js +3 -0
  19. package/dist/exec/worktree-ops-commit.js +1 -13
  20. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  21. package/dist/register/register.js +31 -23
  22. package/dist/shared/git.js +7 -0
  23. package/dist/shared/provider-scaffold.js +2 -0
  24. package/dist/shared/specdojo-gitignore.js +1 -0
  25. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  26. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  27. package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
  28. package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
  29. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  30. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  31. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  32. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  33. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  34. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  35. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  36. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  37. package/docs/ja/specdojo/references/command-reference.md +69 -37
  38. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  39. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  40. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  41. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  42. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  43. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  44. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  45. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  46. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  47. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  48. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  49. package/package.json +5 -2
  50. package/templates/antigravity/README.md +19 -46
  51. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  52. package/templates/antigravity/settings.edit.json +73 -0
  53. package/templates/antigravity/settings.orchestrator.json +15 -0
  54. package/templates/antigravity/settings.report.json +7 -0
  55. package/templates/antigravity/settings.review.json +7 -0
  56. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  57. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  58. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  59. package/templates/init-agent-members.yaml +1 -0
  60. package/templates/init-exec-defaults.yaml +1 -1
@@ -11,49 +11,43 @@ specdojo:
11
11
 
12
12
  Conceptual Data Flow Diagram Use Case Writing Recipe
13
13
 
14
- 全体概要で選定した横断ユースケースを、プロセスグループの順序、引き渡す情報、引き渡し条件、条件不成立時の戻り先へ具体化し、グループ内部を重複させずに合意するための作成手順です。
14
+ 全体概要で選定した一つのユースケースまたは系統について、開始から終了までの流れと、受け渡す情報・物を具体化するための作成手順です。参加単位と詳細化の境界は rulebook の「描き方の選択」に従います。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、全体概要から一つのケース ID、業務目的、横断するプロセスグループを抜き出し、開始イベントと終了条件を短いメモにします。
19
- - 次に、正常系のグループごとに、説明文、主要入力・主要出力・データストアの箇条書き、横断上の役割表を作ります。
20
- - 全体概要の「データストア」から引き渡しに使う部分集合を切り出し、グループ代表ノードと引き渡し条件だけで図を作ります。
21
- - その後、隣接するグループ間ごとに渡す情報、受け側を開始できる条件、受け取れない場合の戻す条件を具体化し、条件不成立時の戻り先と再開条件を表へ整理します。
22
- - 最後に、全体概要との名称整合、全引き渡しの追跡、グループ内部と状態遷移の非重複をレビューします。
18
+ - 全体概要からケース ID、業務目的、参加単位、開始・終了を抜き出します。
19
+ - 目的、適用範囲、役割表、データストアの部分集合を作り、上から下へ進む図で受け渡しを示します。
20
+ - 最後に表と図の名称・順序、全体概要との境界、有効な参照先を確認します。業務上重要な戻りだけ、任意の図を追加します。
23
21
 
24
- この成果物は、上位で合意した業務目的を Why として引き継ぎ、グループ間で成立させる情報と条件を What、順序と戻し方を How、ケース ID・引き渡し ID・参照先の対応を Trace として整理します。内部プロセスや状態遷移を複製せず、責任を持つ文書へ接続します。
22
+ ケース ID、参加単位の名称・領域 ID、データストア名を軸に、範囲・表・図を対応させます。引き渡し ID を追加せず、情報・物の名前を線のラベルにします。
25
23
 
26
24
  ## 2. 作成前に集める情報
27
25
 
28
- | 項目 | 集める情報 |
29
- | ---------------- | ---------------------------------------------------------------------------------- |
30
- | 対象ケース | 全体概要にある `C-<nn>`、ユースケース名、業務目的 |
31
- | 開始と終了 | 最初のグループを起動するイベント、最後のグループが成果を利用可能と判断する条件 |
32
- | 参加グループ | 正常系で通過する二つ以上のプロセスグループ名、領域 ID、通過順、主要入出力 |
33
- | グループ別責務 | 各グループが前段から受け取るものと、次段へ引き渡す成果 |
34
- | グループ別 CDFD | 各参加グループの `cdfd-<group>` と、そこに定義された境界入出力 |
35
- | 引き渡す情報 | 受け側が業務を始めるために必要な情報・物・承認結果 |
36
- | 引き渡し条件 | 必須情報の充足、承認、記録確定、現物との一致など、受け側が確認できる条件 |
37
- | 戻す条件 | 情報不足、不一致、承認未了など、受け側が引き渡しを受理できない条件 |
38
- | 関連データストア | 引き渡す情報または条件判定の正本となる、全体概要の「データストア」にある名称と区分 |
39
- | 判断者 | 引き渡し可否、戻し、再開を最終判断する人間のロール |
40
- | 状態の参照先 | 状態一覧と状態遷移図を統合した STSD。内容は転記せず参照先だけ控える |
41
- | 未決事項 | 横断境界、条件、戻り先、判断者が未確定な論点と、影響、決定者、決定時期 |
26
+ | 項目 | 集める情報 |
27
+ | ------------ | ---------------------------------------------------------------------------- |
28
+ | 対象ケース | 全体概要にあるケース ID、業務名、業務目的 |
29
+ | 描く単位 | rulebook の「描き方の選択」で決める参加単位と詳細化の境界 |
30
+ | 開始と終了 | 開始する出来事と、最後に利用可能になる成果 |
31
+ | 役割と順序 | 全体概要と同じグループ・区分、領域 ID、正常系の通過順、各参加単位の責務 |
32
+ | 受け渡し | 隣接する参加単位やデータストアの間で渡す情報・物 |
33
+ | データストア | 全体概要にある名称、マスタ・構成/トランザクションの区分、参照・更新する内容 |
34
+ | 共通の約束 | 全体概要の責任分担、凡例、Orchestrator の指示の図 |
35
+ | 参照先 | 有効な全体概要、必要な詳細文書と STSD。status が `deprecated` の文書は除く |
36
+ | 重要な戻り | 補完・再判断を担う参加単位、返す不足情報や差異。業務上重要な場合だけ集める |
37
+ | 未決事項 | 境界、名称、責務、判断者が未確定な論点、影響、決定者、決定時期 |
42
38
 
43
39
  ## 3. 全体の作成手順
44
40
 
45
- 1. 全体概要から対象のケース ID、ユースケース名、業務目的、参加グループを抜き出します。
46
- 2. 最初のグループが動き始める出来事を開始イベント、最後のグループが成果を受理した状態を終了条件として一文ずつ書きます。
47
- 3. 正常系の参加グループを順に並べ、各グループについて役割の説明文、主要入力・主要出力・データストアの箇条書き、横断上の役割表を作ります。
48
- 4. グループ名、含む領域 ID、境界入出力を全体概要と各 `cdfd-<group>` で突き合わせ、名称ゆれを解消します。
49
- 5. 隣接グループ間ごとに引き渡し候補を作り、正常順序に沿って `H-<nn>` を仮置きします。
50
- 6. 全体概要の「データストア」から、引き渡す情報または条件判定に使う行だけを同じ区分で転記し、関連する引き渡し ID と利用内容を記入します。
51
- 7. 開始イベント、グループ代表ノード、引き渡し条件、終了条件を左から右へ並べ、引き渡し ID と情報名を付けて図にします。
52
- 8. 「データストア」の各行を同名ノードとして図へ加え、行とノードが一対一で対応することを確認します。
53
- 9. 各引き渡しについて、情報、受け側が yes / no で判定できる引き渡し条件、送り元へ戻す条件を書きます。
54
- 10. 条件不成立ごとに、補完責任を持つ戻り先、戻す情報、同じ引き渡しを再評価できる再開条件を整理します。
55
- 11. 内部プロセス名、内部例外、状態名・遷移、実装項目を探し、対応する `cdfd-<group>` と STSD の参照へ置き換えます。
56
- 12. ケース ID と引き渡し ID を使って、範囲、プロセス領域、データストア、図、引き渡し表、戻り先表の重複・欠落を解消します。
41
+ 1. 全体概要の「詳細 CDFD 一覧」からケースを選び、rulebook の「描き方の選択」で参加単位を決めます。
42
+ 2. その業務が何のためにあるかを、開始からどの成果までを成立させるかという 1〜2 文で書きます。読み手の承認・設計・確認作業は含めません。
43
+ 3. 対象と対象外を 1 行ずつ書き、共通原則は全体概要を参照します。`based_on` と本文の参照先が有効な文書であることを確認します。
44
+ 4. 全体概要と同じグループ・区分ごとに節を設け、正常系の順序と責務を役割表だけで示します。PDCA が必要なら独立した任意の列を追加します。
45
+ 5. 全体概要から、このケースで参照・更新するデータストアを同じ名称・区分で切り出し、関連する参加単位と利用内容を書きます。
46
+ 6. 開始イベント、参加単位、終了の出来事を上から下へ並べ、渡す情報・物の名前を線のラベルにします。D2 は `direction: down` とし、引き渡し条件のイベントや Orchestrator は置きません。
47
+ 7. データストアを同名ノードで加え、表の各行と図を対応させます。イベントは一ノード一出来事の短い文とし、長ければ原文を保って改行します。
48
+ 8. 図に業務の言葉で題を付け、読み取れることを 1 文で説明します。凡例は全体概要への短い参照にします。
49
+ 9. 業務上重要な戻りがある場合だけ、「概念データフロー」に「例外時の戻り」の図を追加し、返す情報を線にします。戻りの線は上側のノードを左辺にした `a <- b` で書きます。
50
+ 10. ケース ID、名称、領域 ID で範囲・表・図を突き合わせ、内部処理や状態定義・遷移の重複を除きます。
57
51
 
58
52
  ## 4. 各章の書き方
59
53
 
@@ -61,138 +55,118 @@ Conceptual Data Flow Diagram Use Case Writing Recipe
61
55
 
62
56
  問い:
63
57
 
64
- - 誰がグループの通過順と責任境界を承認しますか。
65
- - 誰が引き渡す情報と条件を設計入力として使いますか。
66
- - 誰がグループ間の重複・欠落と戻り経路を確認しますか。
58
+ - そのユースケースまたは系統は何のためにありますか。
59
+ - どの出来事から、どの成果または判断までを成立させますか。
67
60
 
68
- 「業務を分かりやすくする」ではなく、「店主代表が在庫・仕入・販売の引き渡し条件を承認する」のように、対象者と利用結果を結び付けます。上位の業務目的はケース ID で引き継ぎ、同じ背景説明を繰り返しません。
61
+ 「欠品した商品を補充し、売場で販売できるようにする」のように業務の目的を 1〜2 文で書きます。BA・QE・承認者などの読み手の役割は書きません。
69
62
 
70
63
  ### 4.2. 適用範囲
71
64
 
72
65
  問い:
73
66
 
74
- - ケース ID、ユースケース名、参加グループは全体概要と一致していますか。
75
- - どの出来事で最初のグループが始まり、どの成果を誰が受理すれば終わりますか。
76
- - 対象となる組織、システム境界、現物の範囲を説明できますか。
77
- - 内部プロセス、補助操作、状態遷移、実装詳細をどこへ委ねますか。
78
- - 承認と最終判断を担う人間のロールを参照できますか。
67
+ - ケース ID、参加単位、開始・終了は全体概要と一致していますか。
68
+ - 対象と対象外がそれぞれ 1 行で分かりますか。
69
+ - 共通原則と調整役の指示を全体概要に委ねていますか。
70
+ - 本文と `based_on` に `deprecated` の文書が残っていませんか。
79
71
 
80
- 開始と終了は単なる期間ではなく、発生または成立を判定できる出来事・成果で区切ります。参加グループの追加や削除が必要なら、横断図だけで補正せず、全体概要へ判断を戻します。
72
+ 全体概要の選定を変える必要があれば先に全体概要を見直します。未作成の参照先は ID をインラインコードで仮置きします。
81
73
 
82
74
  ### 4.3. プロセス領域
83
75
 
84
76
  問い:
85
77
 
86
- - 正常系のグループを開始から終了まで一節ずつ順に並べましたか。
87
- - 各節が、説明文、主要入力・主要出力・データストアの箇条書き、横断上の役割表の順になっていますか。
88
- - 各グループの名称と領域 ID は全体概要と同じですか。
89
- - 主要入力・主要出力と横断上の役割は、前段から受け取るものと次段へ渡すものに限定されていますか。
90
- - 各グループの内部を確認できる `cdfd-<group>` を一意に示せますか。
78
+ - rulebook の「描き方の選択」に従い、全体概要と同じまとまりの節にしていますか。
79
+ - 各節は役割表だけですか。主要入力・主要出力・データストアの箇条書きが残っていませんか。
80
+ - 順序、プロセスグループ・区分、含む領域、横断上の役割、参照先を示していますか。
81
+ - PDCA を示す場合は独立した任意の列にし、全体概要の区分と混同していませんか。
91
82
 
92
- 各節の表の一行を一つの代表ノードへ対応させます。同じグループが正常系で再登場する場合は節を分け、前回と異なる引き渡し目的を説明します。内部の処理順や担当は書き写しません。
83
+ 表の一行を図の一つのプロセスノードに対応させます。全体概要を名称と領域の正本とし、入力・出力の正本は図にします。
93
84
 
94
85
  ### 4.4. データストア
95
86
 
96
87
  問い:
97
88
 
98
- - 引き渡す情報または引き渡し条件の判定に必要なデータストアだけを掲載していますか。
99
- - 名称と区分は全体概要の「データストア」と一致していますか。
100
- - 各行に関連する引き渡し ID と、横断上の利用内容がありますか。
101
- - 各行が概念データフローの同名ノードに対応していますか。
89
+ - 対象ケースで参照・更新する正本だけですか。
90
+ - 名称と区分は全体概要と一致していますか。
91
+ - 関連する参加単位を名称・領域 ID で示し、利用内容を説明していますか。
92
+ - 表の各行と図の同名ノードが対応していますか。
102
93
 
103
- 全体概要の「データストア」から必要な行を切り出し、マスタ・構成データとトランザクションデータの区分を保ちます。グループ内部だけで使うデータストアは載せません。新しい名称や区分が必要なら、先に全体概要を見直します。
94
+ マスタ・構成データとトランザクションデータに分け、該当する行がない区分は節ごと省略します。
104
95
 
105
96
  ### 4.5. 概念データフロー
106
97
 
107
98
  問い:
108
99
 
109
- - 一つの角丸長方形が一つのプロセスグループを表していますか。
110
- - 開始イベントから終了条件まで、正常系のグループ順序を左から右へ追えますか。
111
- - 引き渡し ID と情報名を、図と引き渡し表で対応付けられますか。
112
- - 図へ置いたデータストアは、引き渡し条件または引き渡す情報の正本として必要ですか。
113
- - グループ内部のプロセス、例外、状態遷移を図へ混ぜていませんか。
100
+ - 正常系の参加単位を開始から終了まで上から下へ追えますか。
101
+ - 一つのイベントに一つの出来事だけを書き、短い文または改行で読めますか。入口の文言は選んだ方式の規定に合っていますか。
102
+ - 渡す情報・物を線の名詞ラベルから読み取れますか。条件のイベントや引き渡し ID が残っていませんか。
103
+ - Orchestrator と調整要求・応答を図から外していますか。
104
+ - 図の題は業務の言葉ですか。説明は読み取れることの 1 文ですか。
114
105
 
115
- グループ代表ノードの間に、引き渡し条件を表すイベントノードを置きます。データストアを加える場合も、どの内部処理が読む・書くかは描かず、横断条件の根拠となる情報だけを示します。図直後の注記で凡例、線種、省略境界、選定したデータストアを説明します。
106
+ D2 は `direction: down` とします。必要な承認は「承認済みの補充依頼」など成果の性質として線に表し、条件の判定ノードは置きません。凡例は全体概要を参照します。
116
107
 
117
- ### 4.6. 引き渡し
108
+ ### 4.6. 例外時の戻りの図(任意)
118
109
 
119
110
  問い:
120
111
 
121
- - 隣接するすべてのグループ間に一つ以上の引き渡しがありますか。
122
- - 引き渡す情報は、受け側が何を受け取るか分かる名詞になっていますか。
123
- - 引き渡し条件は、情報の充足、承認、記録確定、現物との一致を判定できますか。
124
- - 条件を満たさないとき、何をどのグループへ戻すか分かりますか。
112
+ - 先行する参加単位へ情報や判断を戻すことが、業務として重要ですか。
113
+ - 戻す不足情報・差異と、補完・再判断を担う参加単位が線から分かりますか。
114
+ - 再提示も「修正・承認済みの補充依頼」などの情報として描いていますか。
125
115
 
126
- まず受け側が開始前に確認するチェックを列挙し、そのチェックに必要な情報だけを引き渡しへ残します。送り元の作業完了を条件にするのではなく、受け側が受理できる成果の状態を記述します。
116
+ 必要な場合だけ「概念データフロー」の節に追加し、通常の図と名称・領域 ID をそろえます。「引き渡し」「例外時の戻り先」の章や、戻す条件・再開条件の表は作りません。
127
117
 
128
- ### 4.7. 例外時の戻り先
129
-
130
- 問い:
131
-
132
- - 各引き渡しの戻す条件を、戻り先表の条件不成立へ対応させましたか。
133
- - 不足を補完または再判断できるグループが戻り先になっていますか。
134
- - 戻す情報から、不足・不一致・判断待ちの内容が分かりますか。
135
- - 再開条件は同じ引き渡しを再評価できる形になっていますか。
136
-
137
- 戻り先は内部プロセスではなくグループまでに留めます。受け側内部の再試行やログは扱わず、先行グループへ情報・判断を戻すことで横断順序が変わる場合だけを記載します。
138
-
139
- ### 4.8. 未決事項(任意)
118
+ ### 4.7. 未決事項(任意)
140
119
 
141
120
  - 調査で確定できる不足情報は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きする前提は _ASSUMPTION_: とします。
142
- - 未決論点には、影響するケース ID または引き渡し ID、決定者、決定時期を添えます。
143
- - 未決事項がない場合は章を省略し、空表や「なし」だけの章を残しません。
121
+ - 未決論点には影響するケース・参加単位、決定者、決定時期を添えます。
122
+ - ない場合は章を省略し、空表や「なし」だけの章を残しません。
144
123
 
145
124
  ## 5. 深掘り手順
146
125
 
147
- 1. 最後のグループが受理する成果から逆向きにたどり、直前の引き渡し情報と条件が本当に必要かを確認します。
148
- 2. 開始イベントから順方向にたどり、各グループが前段から受け取らないと作れない成果を特定します。
149
- 3. 各引き渡し条件を yes / no の質問へ置き換え、判定者と根拠情報を答えられない条件を具体化します。
150
- 4. グループ代表ノードを隠し、内部プロセス名が図や表に残っていないか検索します。残っていればグループ責務または参照へ置き換えます。
151
- 5. 状態を表す語を検索し、状態の意味や遷移を定義している箇所を STSD の参照へ移します。
152
- 6. 引き渡し ID を一つずつ追い、データストア、図、引き渡し表、戻り先表で情報と条件が一致するか確認します。
153
- 7. 条件不成立を一つずつ仮定し、戻り先が不足を補完でき、再開条件の成立後に同じ引き渡しへ戻れるか確認します。
154
- 8. データストアを一つずつ外しても引き渡し条件を説明できるか試し、不要なものを図から削除します。
126
+ 1. 最後の成果から逆にたどり、各参加単位と受け渡しが業務目的に必要か確認します。
127
+ 2. 開始イベントから順にたどり、前段の成果が次段へ情報・物として渡っているか確認します。
128
+ 3. 全体概要の区分と領域 ID を突き合わせ、PDCA の値で区分を置き換えた行を直します。
129
+ 4. データストアを一つずつ確かめ、このケースの情報・物の受け渡しに不要なものを除きます。
130
+ 5. 状態定義・遷移や内部プロセスが残っていれば、責任を持つ有効な文書の参照へ移します。
131
+ 6. 戻りの図がある場合だけ、不足情報や差異が補完責任のある参加単位へ届くか確認します。
132
+ 7. D2 を `d2 --layout elk` で SVG に出力し、上下の順序、ノードとラベルの大きさを確認します。読みづらい場合はイベントの改行や図の分割を見直します。
155
133
 
156
134
  ## 6. 良い例 / 悪い例
157
135
 
158
- | 観点 | 良い例 | 悪い例 |
159
- | -------------- | ------------------------------------------------------------- | ---------------------------------------------------- |
160
- | 対象ケース | `C-02` の在庫 → 仕入 → 販売を扱う | 在庫グループ内の在庫確認だけを扱う |
161
- | グループノード | 「在庫(P-05〜P-06)」を一つの代表ノードにする | 補充判定や在庫更新を別々のプロセスノードにする |
162
- | 引き渡す情報 | 在庫から仕入へ「補充対象、数量、判断者」を渡す | 必要なデータ一式を渡す |
163
- | 引き渡し条件 | 補充対象と数量が確定し、店主代表が発注判断を承認した | 在庫処理が適切に完了した |
164
- | 戻す条件 | 商品または数量を一意に特定できない場合は在庫へ戻す | エラー時は前へ戻す |
165
- | 再開条件 | 修正済みの補充依頼を店主代表が再承認し、`H-01` を再評価できる | 問題が解決したら再開する |
166
- | データストア | 引き渡し判定に使う在庫記録を全体概要と同じ名称で置く | 図だけ「在庫 DB」と改名し、内部テーブルまで描く |
167
- | 状態責務 | 商品状態は STSD を参照し、図には引き渡し成立条件だけを描く | 未発注 → 入荷済み → 販売可能の遷移を横断図で定義する |
168
- | グループ内例外 | 発注不可の結果を在庫へ戻す条件だけを扱う | 仕入先選定、再発注、返品処理の手順を横断図へ展開する |
136
+ | 観点 | 良い例 | 悪い例 |
137
+ | ----------- | ------------------------------------------------ | -------------------------------------------------- |
138
+ | 目的 | 欠品した商品を補充し、売場で販売できるようにする | BA が承認し、QE が検証へ使う |
139
+ | 区分と PDCA | 区分は実行サイクル、PDCA は別列で Do | 区分を Do に置き換える |
140
+ | 渡す情報 | 在庫から仕入へ「承認済みの補充依頼」を直接つなぐ | 途中に「H-01 受理できる」というイベントを置く |
141
+ | イベント | 「在庫が補充基準を下回った」を必要なら改行 | 複数の出来事を一つの長い六角形に詰める |
142
+ | 戻り | 仕入から在庫へ「不足項目・商品候補」を返す線 | すべての受け渡しについて戻り先表を必須にする |
143
+ | 参照先 | 有効な全体概要を参照する | `deprecated` のグループ別 CDFD を参照する |
144
+ | 調整役 | Orchestrator の指示は全体概要の図に任せる | 詳細の図に Orchestrator と各段階への要求を再掲する |
145
+ | 状態責務 | 商品状態は STSD を参照する | 未発注から販売可能への状態遷移を本書で定義する |
169
146
 
170
147
  ## 7. レビュー観点
171
148
 
172
- | 観点 | 確認内容 | 主な確認者 |
173
- | ------------ | -------------------------------------------------------------------------------- | -------------------------- |
174
- | 業務価値 | ケースの終了条件が上位の業務目的を満たし、各引き渡しがその成立に必要と説明できる | 業務分析担当、店主代表 |
175
- | 横断範囲 | 二つ以上の参加グループ、通過順、領域 ID が全体概要と一致する | 業務分析担当 |
176
- | 引き渡し | 情報、条件、戻す条件を受け側が yes / no で判定できる | 業務分析担当、技術メンター |
177
- | 責任境界 | 戻り先と判断者が明確で、内部プロセスを横断側で再定義していない | 店主代表、アーキテクト |
178
- | 図の追跡性 | ケース ID、引き渡し ID、グループ名、領域 ID を表と図で対応付けられる | 品質確認担当 |
179
- | データ整合 | 関連データストアの名称・区分が全体概要と一致し、条件判定に必要なものだけがある | 技術メンター、品質確認担当 |
180
- | 状態責務 | 状態定義・遷移を複製せず、必要な STSD へ接続している | 技術メンター |
181
- | 例外時の再開 | 条件不成立から戻り先、戻す情報、再開条件、再評価する引き渡しまでたどれる | 品質確認担当、店主代表 |
149
+ | 観点 | 確認内容 | 主な確認者 |
150
+ | ---------- | ---------------------------------------------------------- | -------------------------- |
151
+ | 業務価値 | 目的が業務の存在理由・成果を示し、終了時の成果と一致する | 業務分析担当、業務責任者 |
152
+ | 範囲と粒度 | rulebook の「描き方の選択」と全体概要に合う | 業務分析担当 |
153
+ | 表と図 | 順序・名称・領域 ID が対応し、受け渡しを線から読み取れる | 品質確認担当 |
154
+ | データ整合 | データストアの名称・区分と凡例が全体概要に合う | 技術メンター、品質確認担当 |
155
+ | 戻り | 図が必要な場合だけあり、戻す情報と責任が分かる | 業務責任者、品質確認担当 |
156
+ | 正本の境界 | 調整・状態遷移・内部処理を重複させず、有効な文書を参照する | アーキテクト |
182
157
 
183
- 「業務分析担当」「品質確認担当」「技術メンター」「アーキテクト」は、対象プロジェクトのロール定義または責任分担文書で正式な担当へ対応付けます。
158
+ 確認者の呼称は、対象プロジェクトのロール定義または責任分担文書で正式な担当へ対応付けます。
184
159
 
185
160
  ## 8. 仕上げチェック
186
161
 
187
- - 全体概要から一つのケース ID、ユースケース名、業務目的、二つ以上の参加グループを引き継いだ。
188
- - 開始イベントと終了条件を第三者が判定できる形で記述した。
189
- - 参加グループを正常系の順序で一節ずつ並べ、各節を説明文、三つの箇条書き、役割表の順で構成した。
190
- - 隣接グループ間へ `H-<nn>` を付け、情報、引き渡し条件、戻す条件を記述した。
191
- - 図の一つのプロセスノードが一つのプロセスグループを表し、内部プロセスを描いていない。
192
- - 図の開始から終了までをたどれ、引き渡し ID と情報名を表へ対応付けられる。
193
- - 「データストア」は全体概要と同じ名称・区分の部分集合で、各行を引き渡し ID と図の同名ノードへ対応させた。
194
- - 全引き渡しについて、条件不成立、戻り先、戻す情報、再開条件を確認した。
195
- - グループ内部の領域・プロセス・主要例外・操作手順を再掲していない。
196
- - 状態の定義、遷移表、状態遷移図を記載せず、必要な STSD を参照した。
197
- - 未決事項は共通ラベルで確定情報と区別し、ない場合は章を設けていない。
198
- - 個人情報、秘密情報、非公開の組織情報など、公開範囲に不適切な内容を含めていない。
162
+ - 全体概要のケース ID、業務名、目的、名称・領域 ID を引き継いだ。
163
+ - 目的は業務のための 1〜2 文、適用範囲は対象と対象外が 1 行ずつになっている。
164
+ - 各節が役割表だけで、区分と任意の PDCA 列を分けた。
165
+ - 表と図の参加単位、データストアが対応し、開始から終了まで縦に追える。
166
+ - イベントは一ノード一出来事で短く、入口の原文を保っている。
167
+ - 受け渡しは線のラベルにあり、引き渡し ID・条件イベント・旧来の引き渡し/戻り先の章がない。
168
+ - Orchestrator を詳細の図に置かず、全体概要の指示の図へ委ねた。
169
+ - 図の題は業務の言葉、説明は読み取れることの 1 文で、凡例は全体概要を参照している。
170
+ - 戻りの図は業務上重要な場合だけ追加し、条件表や内部の再試行手順を置いていない。
171
+ - `based_on` と本文に `deprecated` の参照先がなく、状態定義・遷移を複製していない。
172
+ - 未決事項がない場合は章を省略し、公開範囲に不適切な情報を含めていない。
@@ -115,7 +115,9 @@ exec の result の commit 前検査は markdownlint-cli が読む利用リポ
115
115
  `.markdownlintrc` を含む)を優先し、設定がなければ上記の6規則だけをコマンド引数で無効にします。
116
116
  フォールバック用ファイルは利用リポジトリに作りません。CLI2 専用設定はこの検査では読みません。
117
117
 
118
- `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
118
+ `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity は `orch:argon`(`gemini-4-argon-medium`)・`orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
119
+
120
+ agy 1.4.12 以降向けの通常導入は edit / review / report / orchestrator のセッション別プロファイルを配置し、ユーザー設定を書き換えません。非対話用 command template は `specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"`、対話型は `specdojo orchestrator launch --provider antigravity -- <agy 引数>` を使います。各入口が宣言済みルートの保護ルールを一つの `--settings` JSON として渡します。`agent launch` は runner の `SPECDOJO_REPO_*` に示された task worktree と cwd だけを追加し、任意の `--add-dir` や別 `--settings`、bypass、既存会話の再開を拒否します。review / report は全書き込み・command・MCP を拒否します。詳しい移行と実機確認は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。
119
121
 
120
122
  `antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
121
123
 
@@ -645,6 +647,8 @@ kata authoring は register 専用です。Schedule の task は対象成果物
645
647
  | `exec plan` | plan だけを生成する | `specdojo exec plan --project prj-0001 --task <task-id>` |
646
648
  | `exec archive` | 完了済み plan を `done/` へ移動する | `specdojo exec archive --project prj-0001 --task <task-id>` |
647
649
 
650
+ schedule の `exec resume --task <task-id> --resume-from executor` は、executor が `succeeded` で reporter が未完了の pipeline を、既存 worktree・変更・同じ run を引き継いで executor → reporter → 統合の順に再実行します。対象状態は reporter 段の `blocked` または中断した `doing` で、executor の試行回数を増やし、`blocked` からの状態遷移は `unblock` イベントへ記録します。統合段、executor 未成功、pipeline 以外、`executor` 以外の値は拒否します。`--task` は必須で、`--due` とは併用できません。worktree の `<execution_path>/exec/plans/<task-id>-plan.md` を編集してから再開すると、その plan を使います。変更理由と再開の経緯を報告の `handoff` へ記載するよう plan に指示し、再開後の result の申し送りを確認してください。手順は [[specdojo:exec-operation-guide|exec運用ガイド]] の「blockedタスクの復帰」を参照してください。
651
+
648
652
  `exec scaffold --project <project-id>` は、対象 project の `viewpoints_path` へ `extends: specdojo:pm-review-viewpoints` を持つ空の差分ファイルを生成します。共通正本は [[specdojo:pm-review-viewpoints|共通レビュー観点一覧]] であり、scaffold 時点の全量コピーは作りません。そのため、共通側の更新は次回の review plan 生成時に継承 project へ反映されます。既存ファイルは既定で保持し、`--force` の指定時だけ差分雛形で置き換えます。
649
653
 
650
654
  プロジェクト差分の upsert、無効化、独自ロールの宣言規則は [[specdojo:review-guide|レビューガイド]] を参照してください。provider 設定の推奨入口は `config scaffold --provider <name>` です。従来の `exec scaffold --provider <name>` も互換入口として同じ設定一式を生成します。
@@ -658,35 +662,36 @@ kata authoring は register 専用です。Schedule の task は対象成果物
658
662
 
659
663
  主要オプション:
660
664
 
661
- | オプション | 用途 | 対象 |
662
- | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
663
- | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
664
- | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
665
- | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
666
- | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
667
- | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
668
- | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
669
- | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
670
- | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
671
- | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
672
- | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
673
- | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
674
- | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
675
- | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
676
- | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
677
- | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
678
- | `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
679
- | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
680
- | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
681
- | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
682
- | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
683
- | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
684
- | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
685
- | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
686
- | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
687
- | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
688
- | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
689
- | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
665
+ | オプション | 用途 | 対象 |
666
+ | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
667
+ | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
668
+ | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
669
+ | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
670
+ | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
671
+ | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
672
+ | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
673
+ | `--track <track>` | `--auto` の選択を 1 つの track に限定する。存在しない track は claim 前にエラー。省略時は全 track が対象 | `run --auto`(`--parallel` / `--loop` / `--dry-run` と併用可能) |
674
+ | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
675
+ | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
676
+ | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
677
+ | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
678
+ | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
679
+ | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
680
+ | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
681
+ | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
682
+ | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
683
+ | `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
684
+ | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
685
+ | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
686
+ | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用)、schedule の `resume --task`(`--due` と併用不可) |
687
+ | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
688
+ | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
689
+ | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
690
+ | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
691
+ | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
692
+ | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
693
+ | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
694
+ | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
690
695
 
691
696
  `--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
692
697
 
@@ -718,6 +723,9 @@ specdojo exec run --project prj-0001 --auto --parallel 5
718
723
  # Ready がなくなるまで連続実行する
719
724
  specdojo exec run --project prj-0001 --auto --loop --parallel 5
720
725
 
726
+ # 指定した track だけを連続実行する
727
+ specdojo exec run --project prj-0001 --auto --track data-flow-uc-rewrite --loop --parallel 3
728
+
721
729
  # 登録簿の項目を実行する(開始で in-progress、成功で review、失敗で waiting へ遷移)
722
730
  specdojo exec run --project prj-0001 --register PJR-0012
723
731
 
@@ -818,7 +826,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
818
826
 
819
827
  `--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
820
828
 
821
- `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`lint-mermaid`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
829
+ `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`lint-mermaid`、`lint-d2`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
822
830
 
823
831
  記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
824
832
 
@@ -1123,9 +1131,10 @@ schedule / register / job / routine の使い分けの基準は [exec運用ガ
1123
1131
 
1124
1132
  `agent` は、保存済みの plan を指定した1つの agent へ渡し、その標準出力を取得します。agent の選択は `.specdojo/agent-members.yaml` の nickname で一意に決まるため、実行のたびに担当が変わりません。決定論的な手順を shell script や CLI 側に置き、agent には判断だけを委ねるための最小の部品です。
1125
1133
 
1126
- | コマンド | 用途 |
1127
- | ----------- | ----------------------------------------------------------- |
1128
- | `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
1134
+ | コマンド | 用途 |
1135
+ | -------------- | ----------------------------------------------------------------------- |
1136
+ | `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
1137
+ | `agent launch` | agy を役割別セッション設定と runner の宣言済み task worktree で起動する |
1129
1138
 
1130
1139
  ```bash
1131
1140
  specdojo agent run --plan <plan.md> --by <nickname> --out <response.txt>
@@ -1169,9 +1178,10 @@ specdojo orchestrator night --project prj-0001 \
1169
1178
 
1170
1179
  `devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
1171
1180
 
1172
- | コマンド | 用途 |
1173
- | ----------------------- | ------------------------------------------- |
1174
- | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
1181
+ | コマンド | 用途 |
1182
+ | -------------------------- | ----------------------------------------------------------------------- |
1183
+ | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
1184
+ | `devcontainer host-script` | ホストから tmux へ接続するスクリプト本体を `.specdojo/host/` に書き出す |
1175
1185
 
1176
1186
  `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
1177
1187
 
@@ -1255,6 +1265,28 @@ post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/e
1255
1265
 
1256
1266
  Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
1257
1267
 
1268
+ ### 16.1. devcontainer host-script
1269
+
1270
+ `devcontainer host-script` は、常時稼働ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体(`.specdojo/host/devcontainer-tmux.sh`)をワークスペースへ書き出します。
1271
+
1272
+ ```bash
1273
+ npx specdojo devcontainer host-script
1274
+ ```
1275
+
1276
+ 主要オプション:
1277
+
1278
+ | オプション | 用途 |
1279
+ | ----------- | -------------------------------------------------------- |
1280
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
1281
+
1282
+ 本体スクリプトの対応 OS は macOS、Linux、Windows の WSL2 です。ホスト側のスクリプト(`~/bin/specdojo-tmux.sh` など)はワークスペースのパスを渡してこの本体スクリプトを呼び出す数行のみとなり、ホスト側スクリプトの保守負担を抑えられます。
1283
+
1284
+ - ラベル `devcontainer.local_folder` が一致する稼働中のコンテナがあれば、そのまま tmux へ入ります。
1285
+ - 停止中のコンテナがあれば `docker start` で起動してから入ります。この場合ホスト側に Node.js は不要です。
1286
+ - コンテナが存在しないときだけ `devcontainer up` を動かします。環境変数 `SPECDOJO_NODE_BIN` があればそこを `PATH` に足し、なければ利用者のログインシェル(`"$SHELL" -lic`)経由で起動します。mise を利用している場合は shims のディレクトリ(例: `~/.local/share/mise/shims`)を指定してください。
1287
+ - コンテナ内の作業ディレクトリはマウント情報から、実行ユーザーは `devcontainer.json` の `remoteUser` から求めます。求められないときは原因を stderr に出力して終了します。
1288
+ - スクリプトは実行権限(`0o755`)付きで書き出され、同じ版で複数回実行しても内容は変わりません。
1289
+
1258
1290
  ## 17. 関連ガイド
1259
1291
 
1260
1292
  | 詳細 | 参照先 |