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.
- package/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +60 -0
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/init.js +1 -0
- package/dist/deliverable/deliverable.js +77 -4
- package/dist/exec/core.js +1 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/plans-core.js +46 -1
- package/dist/exec/plans-generation.js +39 -3
- package/dist/exec/plans-planning.js +1 -1
- package/dist/exec/plans-storage.js +1 -0
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register.js +6 -0
- package/dist/exec/repo-integration-sync.js +4 -2
- package/dist/exec/repo-integration.js +41 -4
- package/dist/exec/repo-trace.js +2 -0
- package/dist/exec/results.js +9 -5
- package/dist/exec/run/register-command.js +16 -0
- package/dist/exec/run/register-resume.js +11 -1
- package/dist/exec/run/register-worktree.js +29 -8
- package/dist/exec/run/schedule-prepare.js +7 -3
- package/dist/exec/strategy.js +2 -1
- package/dist/exec/task-repos.js +78 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree.js +3 -3
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +54 -2
- package/dist/register/deliverable-target.js +24 -17
- package/dist/register/event-merge.js +4 -0
- package/dist/register/events.js +6 -0
- package/dist/register/external-project.js +2 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +61 -0
- package/dist/register/register.js +2 -2
- package/dist/register/renumber.js +4 -0
- package/dist/register/update.js +6 -0
- package/dist/schedule/approach.js +9 -0
- package/dist/schedule/strategy-profiles.js +22 -2
- package/dist/shared/agent-types.js +4 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -0
- package/dist/shared/specdojo-config.js +35 -4
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
- package/docs/ja/specdojo/guides/exec-operation-guide.md +96 -2
- package/docs/ja/specdojo/guides/register-operation-guide.md +14 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
- package/docs/ja/specdojo/references/command-reference.md +44 -11
- package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
- package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -2
- package/package.json +3 -2
- package/templates/antigravity/orchestrator.md +2 -0
- package/templates/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -19,7 +19,7 @@ SpecDojo は道場のメタファーとして、進め方(`approach`)を「R
|
|
|
19
19
|
|
|
20
20
|
**この文書で分かること**
|
|
21
21
|
|
|
22
|
-
- `approach`
|
|
22
|
+
- `approach` の選び方と一覧、`draft` と `fully-guided` の使い分け、文脈の置き場所の使い分け、参照の共通原則、実践の型メンテナンスの進め方、review への適用
|
|
23
23
|
|
|
24
24
|
**次に読む文書**
|
|
25
25
|
|
|
@@ -42,17 +42,21 @@ SpecDojo は道場のメタファーとして、進め方(`approach`)を「R
|
|
|
42
42
|
|
|
43
43
|
### 1.1. approach の選び方
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
進め方は、まずタスクの目的で分かれ、文脈で任された範囲を調べて下書きする場合は `draft`、既存成果物を磨き込む場合は `fully-guided` を選びます。その他の成果物作成・更新では実践の型の整備状況でさらに分かれます。`fully-guided` / `recipe-guided` / `freeform` は実践の型をどこまで基準にするかを表します。`retrofit` は実装先行時の現在動作調査、`bootstrap` / `cross-deliverable-dedup`・各 `*-authoring`・各 `*-maintenance`・`finalize` 系は、それぞれの目的に応じて選ぶ進め方です。
|
|
46
46
|
|
|
47
47
|
```mermaid
|
|
48
48
|
flowchart TD
|
|
49
49
|
P{"タスクの目的"}
|
|
50
|
-
P -->|"
|
|
51
|
-
|
|
50
|
+
P -->|"任された文脈を調べて下書きする"| DR["draft"]
|
|
51
|
+
SC["雛形 → 人が文脈を記入"] --> DR
|
|
52
|
+
DR --> FG["fully-guided<br/>既存成果物を磨き込む"]
|
|
53
|
+
P -->|"既存成果物を磨き込む"| FG
|
|
54
|
+
P -->|"その他の成果物作成・更新"| M{"実践の型の整備状況"}
|
|
55
|
+
M -->|"必要な型が揃い信頼できる"| FG
|
|
52
56
|
M -->|"recipe のみ使える"| RG["recipe-guided"]
|
|
53
57
|
M -->|"実践の型に頼れない"| FF["freeform"]
|
|
54
|
-
FG -->
|
|
55
|
-
RG --> W
|
|
58
|
+
FG --> RV["レビュー → finalize(人が確定)"]
|
|
59
|
+
RG --> W["雛形から開始 → 内容を記述 → レビュー"]
|
|
56
60
|
FF --> W
|
|
57
61
|
P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
|
|
58
62
|
P -->|"成果物と実践の型を新規に一括整備"| BS["bootstrap"]
|
|
@@ -62,7 +66,7 @@ flowchart TD
|
|
|
62
66
|
P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
|
|
63
67
|
```
|
|
64
68
|
|
|
65
|
-
|
|
69
|
+
`draft` は文脈で任された調査・下書きのための段であり、型の件数からは自動選択しません。整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
|
|
66
70
|
|
|
67
71
|
### 1.2. approach 一覧
|
|
68
72
|
|
|
@@ -70,9 +74,9 @@ flowchart TD
|
|
|
70
74
|
|
|
71
75
|
#### 1.2.1. 成果物の作成・更新
|
|
72
76
|
|
|
73
|
-
|
|
77
|
+
`draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
|
|
74
78
|
|
|
75
|
-
|
|
79
|
+
`draft` を除く三つの流は、型との関係を表す守破離に対応します。「守」は型をそのまま守り、「破」は型を基準にしながら工夫し、「離」は型から離れて完了条件と根拠から組み立てます。守破離は品質の序列ではなく、タスクの目的と実践の型の整備状況に応じて進め方を選ぶための名前です。
|
|
76
80
|
|
|
77
81
|
```mermaid
|
|
78
82
|
flowchart LR
|
|
@@ -83,18 +87,103 @@ flowchart LR
|
|
|
83
87
|
CTX["類似成果物・<br/>プロジェクト文脈"]
|
|
84
88
|
D["成果物"]
|
|
85
89
|
|
|
86
|
-
RB -->|fully-guided| D
|
|
87
|
-
RC -->|fully-guided / recipe-guided| D
|
|
88
|
-
SP -->|fully-guided| D
|
|
89
|
-
TP -->|
|
|
90
|
+
RB -->|draft / fully-guided| D
|
|
91
|
+
RC -->|draft / fully-guided / recipe-guided| D
|
|
92
|
+
SP -->|draft / fully-guided| D
|
|
93
|
+
TP -->|draft| D
|
|
94
|
+
CTX -->|draft| D
|
|
95
|
+
EXT["外部の情報(出典つき)"] -->|draft:任された範囲| D
|
|
90
96
|
CTX -->|freeform| D
|
|
91
97
|
```
|
|
92
98
|
|
|
93
|
-
| `approach` | 流の名前 | 参照方針と進め方
|
|
94
|
-
| --------------- | -------- |
|
|
95
|
-
| `
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
99
|
+
| `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
|
|
100
|
+
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
101
|
+
| `draft` | 下書き | 文脈で任された範囲を調べて下書きする。型・依存成果物・`based_on`・`project_context`・個票の `入力`・カタログの `brief`・成果物内の文脈・出典つき外部情報を参照する。選定値を提案として示し、出典と選定理由を result に残す | `xep-draft-template.md`(edit) |
|
|
102
|
+
| `fully-guided` | 守 | 既存成果物の磨き込み専用。宣言された rulebook / recipe / sample、`depends_on`、`based_on`、`project_context`、個票の `入力`、カタログの `brief` だけを参照する。template は読み込まない | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
|
|
103
|
+
| `recipe-guided` | 破 | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
|
|
104
|
+
| `freeform` | 離 | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
|
|
105
|
+
|
|
106
|
+
##### draft と fully-guided の使い分け
|
|
107
|
+
|
|
108
|
+
`draft` と `fully-guided` は、未作成または下書き段階の成果物を段階的に仕上げるために組み合わせて使います。
|
|
109
|
+
|
|
110
|
+
| 観点 | `draft`(下書き) | `fully-guided`(磨き込み) |
|
|
111
|
+
| ----------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
|
|
112
|
+
| 目的 | 文脈で任された調査・技術選定を行い、下書きを作成する | 既存の草案を実践の型に適合させ、構造・用語・整合性を磨き込む |
|
|
113
|
+
| 根拠のない具体化 | **任された範囲に限り解除**。外部情報(Web や公式資料)を調べて値を決めてよい | **厳格に禁止**。宣言された文書で裏付けが取れる範囲のみ修正・補完する |
|
|
114
|
+
| 外部調査・選定 | 行う。選定した値は成果物内で「提案」として示し、出典と選定理由を result に残す | 行わない。新たな外部探索や独自選定はせず、既存記述を整理する |
|
|
115
|
+
| template の参照 | 参照する(雛形から章構成や初期記述を起こす) | 参照しない(既に草案があるため型のみ参照) |
|
|
116
|
+
| 文脈の目印 `_CONTEXT_:` | 指示を本文へ反映したら目印を削除し、元の指示と選定内容を result に写す | 反映・削除しない。残存している指示は未決論点(_TODO_)として result に残す |
|
|
117
|
+
| 主な適用タイミング | 成果物の新規作成時、技術スタックや方式の調査・選定を agent に委任する段 | `draft` による草案作成後、または既存成果物の改訂・品質向上を行う段 |
|
|
118
|
+
|
|
119
|
+
##### 文脈の置き場所の使い分け
|
|
120
|
+
|
|
121
|
+
文脈(前提・制約・調査委任の指示)を agent に渡す場所には、成果物内の `_CONTEXT_:`、個票の `入力`(`--input`)、カタログの `brief` の 3 つがあります。それぞれの特徴と適した用途に応じて使い分けます。
|
|
122
|
+
|
|
123
|
+
| 置き場所 | 指定方法 | 特徴と適した用途 | ライフサイクル・反映先 |
|
|
124
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
125
|
+
| 成果物内の `_CONTEXT_:` | 成果物の対象段落の先頭に `_CONTEXT_:` と記述(文書全体なら先頭章、特定項目なら該当見出し直下) | 特定の章や構成に局所化した指示、雛形を確認しながらその場で書き込みたい前提・調査指示 | `draft` が本文反映後に削除して result に記録。`finalize` 時や `status: ready` で残っていれば lint で error |
|
|
126
|
+
| 個票の `入力`(`--input`) | `register add` / `register update` の `--input <text>` で指定 | オーケストレーターや人との対話から得た前提、単発の制約、調査・選定の委任範囲。成果物ファイルを開かずに起票時に渡したい文脈 | 個票の「入力」節に記録され、register 経由の plan に前提として展開される |
|
|
127
|
+
| カタログの `brief` | カタログ(`dct-*.yaml`)の成果物定義に `brief: \|` で記述 | プロジェクトや成果物群全体で継続して渡したい共通前提(採用技術スタック、基盤条件など)。複数成果物で YAML アンカー(`&anchor` / `*anchor`)による共有が可能 | カタログに保持され、schedule と register の両経路の plan に一貫して前提として展開される |
|
|
128
|
+
|
|
129
|
+
##### 文脈を渡して作成する具体例(TSD の技術選定)
|
|
130
|
+
|
|
131
|
+
たとえば、技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して作成する場合、文脈の置き場所によって次のように渡します。
|
|
132
|
+
|
|
133
|
+
- **カタログの `brief` で渡す場合(プロジェクト共通の前提)**:
|
|
134
|
+
Web サイト構築プロジェクトで、サイト全体の技術方針として静的サイト構成を採用することがあらかじめ決まっている場合、カタログの成果物エントリに `brief` として定義します。
|
|
135
|
+
|
|
136
|
+
```yaml
|
|
137
|
+
specdojo:
|
|
138
|
+
id: prj-0001:cxd-specdojo
|
|
139
|
+
# ...
|
|
140
|
+
deliverables:
|
|
141
|
+
- id: tsd-frontend-site
|
|
142
|
+
name: "フロントエンド技術スタック詳細定義"
|
|
143
|
+
rulebook: specdojo:tsd-rulebook
|
|
144
|
+
brief: |
|
|
145
|
+
静的サイト構成を採用する。主流の技術スタック(Astro 等)を基本とし、ビルド性能と拡張性を重視する。
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
- **個票の `入力`(`--input`)で渡す場合(対話からの委任指示)**:
|
|
149
|
+
対話を通じて「静的サイトで主流の技術スタックを調べて下書きしてほしい」と決まった場合、成果物ファイルを開かずに起票コマンドで前提を渡します。
|
|
150
|
+
|
|
151
|
+
```bash
|
|
152
|
+
specdojo register add \
|
|
153
|
+
--project prj-0001 \
|
|
154
|
+
--type todo \
|
|
155
|
+
--title "フロントエンドTSDの下書き" \
|
|
156
|
+
--approach draft \
|
|
157
|
+
--target prj-0001:tsd-frontend-site \
|
|
158
|
+
--input "静的サイトで主流の技術スタック(Astro 等)を調査し、選定理由と構成を下書きする"
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
- **成果物内の `_CONTEXT_:` で渡す場合(章ごとの局所的な指示)**:
|
|
162
|
+
まず `deliverable scaffold` で成果物の雛形を作成します。カタログにある成果物は `--target` で 1 件だけ指定して作成でき、カタログにない成果物は `--target-path` と `--target-rulebook` を添えて作成します(template のない rulebook でも `deliverable_type` を引き継いだ最小雛形が生成されます)。
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
# カタログにある成果物を 1 件だけ指定して作成する場合
|
|
166
|
+
specdojo deliverable scaffold \
|
|
167
|
+
--project prj-0001 \
|
|
168
|
+
--target prj-0001:tsd-frontend-site
|
|
169
|
+
|
|
170
|
+
# カタログにない成果物を雛形にする場合
|
|
171
|
+
specdojo deliverable scaffold \
|
|
172
|
+
--project prj-0001 \
|
|
173
|
+
--target prj-0001:tsd-custom-tool \
|
|
174
|
+
--target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
|
|
175
|
+
--target-rulebook specdojo:tsd-rulebook
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
雛形を作成した後、特定の章(「採用技術・設定」章など)に直接指示を置きたい場合に記述します。
|
|
179
|
+
|
|
180
|
+
```markdown
|
|
181
|
+
## 4. 採用技術・設定
|
|
182
|
+
|
|
183
|
+
_CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、選定したフレームワークやライブラリの採用値・選定理由・反映方法を提案として表にまとめてください。
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
`draft` はこの指示を読んで外部情報を調査し、選定値を「提案」として記述した上で `_CONTEXT_:` を削除し、result に出典・選定理由と元の指示を記録します。続く `fully-guided` が、その草案を tsd の型に合わせて磨き込みます。
|
|
98
187
|
|
|
99
188
|
#### 1.2.2. 初期整備・実装反映・横断整理
|
|
100
189
|
|
|
@@ -198,16 +287,17 @@ flowchart LR
|
|
|
198
287
|
|
|
199
288
|
`approach` にかかわらず適用する原則です。
|
|
200
289
|
|
|
201
|
-
- 矛盾時の優先: `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
202
|
-
- 参照範囲: `fully-guided` / `recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
290
|
+
- 矛盾時の優先: `draft` / `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
|
|
291
|
+
- 参照範囲: `fully-guided` は宣言された文書だけを参照します。対象成果物、rulebook / 併せて適用する rulebook / recipe / sample、`depends_on` 成果物、対象成果物 frontmatter の `based_on`、`project_context`、個票の `入力`、カタログの `brief` を含み、未宣言の文書や外部の情報は探索しません。`入力` と `brief` は未指定なら plan に載りません。`draft` はこれらに template・成果物内の文脈・任された調査に必要な出典つき外部情報を加えます。`recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
|
|
203
292
|
- 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
|
|
204
|
-
- 根拠のない具体化の禁止: `freeform`
|
|
293
|
+
- 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
|
|
205
294
|
- 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
|
|
206
295
|
- 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
|
|
296
|
+
- 前提・概要・判定基準の使い分け: カタログの `overview`(成果物の目的を1文で表す概要)、`brief`(成果物の外から継続して渡す技術スタックや制約などの前提)、`done_criteria`(成果物が満たすべき検証可能な完了条件)を明確に区別します。`brief` は schedule / register 両経路の plan に前提として展開され、未指定なら plan に載りません。複数の成果物で前提を共有する場合は YAML アンカー(`&anchor` / `*anchor`)を活用できます。前提を完了条件に混同せず、検証可能な基準だけを `done_criteria` に記載します。
|
|
207
297
|
|
|
208
298
|
### 1.4. 成果物カタログなしで進める
|
|
209
299
|
|
|
210
|
-
register からの `fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
|
|
300
|
+
register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
|
|
211
301
|
|
|
212
302
|
カタログの `done_criteria` はないため、個票の完了条件と rulebook を完了基準にします。`fully-guided` には `not-needed` を除く kata 一式、`recipe-guided` には recipe が必要で、不足すると起票時に停止します。`retrofit` では調べる実装のパスを個票に明記します。
|
|
213
303
|
|
|
@@ -240,7 +330,8 @@ review でも「整備状況に応じた進め方(approach)」を使いま
|
|
|
240
330
|
|
|
241
331
|
通常の成果物編集では観点別の自己レビューを行わず、`done_criteria` を「完了の狙い」として扱います。多観点での品質評価と証跡は grade が担い、独立した review は grade 結果を事実としてタスクの完了可否を判断します。以下の `approach` ごとの参照方針は、編集時の記述と review の照合範囲に適用します。
|
|
242
332
|
|
|
243
|
-
- `
|
|
333
|
+
- `draft`: 文脈で任された範囲の下書き、提案の表示、出典と選定理由・元の指示の記録をタスクの完了条件と照合します。
|
|
334
|
+
- `fully-guided`: 宣言された参照と、edit plan に展開された既存成果物の磨き込み範囲を照合します。品質上の適合性は grade 結果を使い、review が新しい level や finding を付けません。
|
|
244
335
|
- `recipe-guided`: recipe と edit plan に限定して作業範囲を照合し、rulebook / sample / template を新たな判定基準として持ち込みません。
|
|
245
336
|
- `freeform`: カタログの `done_criteria`、対応 schema、edit plan が示した既存の類似成果物やプロジェクト文脈を、完了条件の照合資料として使います。
|
|
246
337
|
- `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance`: 「実践の型メンテナンスの進め方」に従い、対象の実践の型と edit plan の完了条件を照合します。実践の型そのものの品質評価は、review 前段の kata grade を使います。
|
|
@@ -358,21 +358,48 @@ phase や owner rule に書く `approach` は、タスクの目的と実践の
|
|
|
358
358
|
|
|
359
359
|
| 段階 | 正本・担当 | 出力 |
|
|
360
360
|
| -------- | -------------------------------------- | ------------------------------------------------------------ |
|
|
361
|
-
| 目的宣言 | strategy の `approach_rules` |
|
|
361
|
+
| 目的宣言 | strategy の `approach_rules` | 8 種の `intent` と必要な target / scope |
|
|
362
362
|
| 品質評価 | `specdojo grade` | grade result サイドカーの保存済み `verdict` |
|
|
363
363
|
| 事実収集 | コード | 実在、要否宣言、参照切れ、実装エビデンス |
|
|
364
364
|
| 規則適用 | コード(`schedule strategy generate`) | 成果物ごとの approach |
|
|
365
365
|
| 構造生成 | コード(`schedule strategy generate`) | scope・profile・owner・gate・依存・milestone を持つ strategy |
|
|
366
366
|
|
|
367
|
-
- `TaskIntent`
|
|
367
|
+
- `TaskIntent` 8 種は `author-deliverable`、`draft-with-context`、`bootstrap-kata-set`、`reflect-implementation`、`deduplicate-across-deliverables`、`improve-kata`、`confirm-deliverable`、`confirm-with-kata-set` です。同じ track や owner rule 内でも成果物ごとに別の rule へ分けられます。
|
|
368
368
|
- `author-deliverable` は grade が `pass` の Kata を利用可能とし、`fully-guided` / `recipe-guided` / `freeform` を導出します。他の intent は目的別の `bootstrap` / `retrofit` / 横断整理 / maintenance / finalize 系へ一意に写像します。
|
|
369
369
|
- `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
|
|
370
370
|
- intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
|
|
371
|
-
- 標準 profile は `bootstrap`、`retrofit`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
|
|
371
|
+
- 標準 profile は `bootstrap`、`retrofit`、`draft`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
|
|
372
372
|
- owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
|
|
373
373
|
- generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
|
|
374
374
|
|
|
375
|
-
コマンドの使い方は [CLIコマンドリファレンス]
|
|
375
|
+
コマンドの使い方は [[specdojo:command-reference|CLIコマンドリファレンス]] の `schedule strategy(決定論的な strategy 生成)`、`approach` ごとの進め方は [[specdojo:ryu-guide|実践の進め方ガイド]] を参照します。
|
|
376
|
+
|
|
377
|
+
### 3.6. 人の文脈から始める `draft` profile
|
|
378
|
+
|
|
379
|
+
人が前提や調査の委任範囲を雛形へ書いてから agent に下書きを任せたい場合は、`strategy-planning` の作業で対象成果物に `intent: draft-with-context` を宣言します。必要な Kata の保存済み grade がすべて `pass` なら `draft` profile を生成します。`not-needed` の型は不要として扱い、grade 不明・型の不足があれば生成を停止します。
|
|
380
|
+
|
|
381
|
+
```yaml
|
|
382
|
+
approach_rules:
|
|
383
|
+
- local_ids: [prj-overview]
|
|
384
|
+
intent: draft-with-context
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
| 段 | phase set | suffix | execution | mode | approach |
|
|
388
|
+
| ------------------ | --------------- | ------ | --------- | -------- | -------------- |
|
|
389
|
+
| 雛形作成・文脈記入 | `context-pass` | `010` | `human` | `edit` | `draft` |
|
|
390
|
+
| 下書き | `guided-pass` | `020` | `agent` | `edit` | `draft` |
|
|
391
|
+
| 磨き込み | `refine-pass` | `070` | `agent` | `edit` | `fully-guided` |
|
|
392
|
+
| 完成版レビュー | `review-pass` | `090` | `agent` | `review` | `fully-guided` |
|
|
393
|
+
| 確定 | `finalize-pass` | `140` | `human` | `edit` | `finalize` |
|
|
394
|
+
|
|
395
|
+
雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
|
|
396
|
+
|
|
397
|
+
1. `specdojo exec claim --project <project-id> --task <context-task-id> --by <human>` で着手します。既存の human タスクと同じく plan は生成せず、claim が作成した result に作業案内と記録欄を持ちます。
|
|
398
|
+
2. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成します。既存成果物は上書きせず、`--force` は指定しません。
|
|
399
|
+
3. 対象本文の `_CONTEXT_:` に固定前提・制約・調査や選定を任せる範囲を書きます。例: `_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。` 記法は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従います。
|
|
400
|
+
4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・review を行い、最後に人が finalize を claim / complete して確定します。
|
|
401
|
+
|
|
402
|
+
文脈の記入を待つ必要がない場合は従来の `author-deliverable` を使います。必要な型がそろった場合の `fully-guided` profile も、草案作成の `guided-pass` は `approach: draft` です。文脈や成果物が未作成でも template を骨組みにして根拠のある範囲を下書きします。文脈が無いことを調査・選定の委任とは解釈せず、未委任の判断は保留します。既存 strategy の段定義を更新するには `schedule strategy generate --force` の差分を確認して適用し、構造が変わる場合は `schedule build --force`、続いて `exec refresh` を実行します。
|
|
376
403
|
|
|
377
404
|
## 4. タスク設計の品質
|
|
378
405
|
|
|
@@ -52,6 +52,7 @@ Human Finalize Execution Recipe
|
|
|
52
52
|
### 4.2. 成果物の最終確認
|
|
53
53
|
|
|
54
54
|
- 各 `done_criteria` について、完成版のどの記述が満たすかを確認します。
|
|
55
|
+
- 確定対象の本文に未反映の `_CONTEXT_:` がないことを確認します。残っていれば承認せず、元の指示と対象箇所を備考に記録して `draft` へ差し戻します。
|
|
55
56
|
- 不足を直す場合は既存の責務と文脈を保ち、確定に必要な範囲だけを修正します。
|
|
56
57
|
- 修正後は対象形式に対応する検証を再実行し、エラーがない状態にします。
|
|
57
58
|
|
|
@@ -24,23 +24,31 @@ Technology Stack Detail Definition (TSD) Writing Recipe
|
|
|
24
24
|
|
|
25
25
|
秘密値を収集せず、次の問いに答える短いメモを作る。確認不足は _TODO_、意思決定待ちは _UNDECIDED_、仮の前提は _ASSUMPTION_ を付け、担当と確認・判断の時期を添える。
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
27
|
+
agent に作成を任せる場合は、集めた情報や前提をどこに渡すかを決める。成果物の外から継続して渡す共通前提はカタログの `brief`、起票時や対話で決まった前提・調査選定の委任は個票の `入力`(`--input`)、成果物の特定章に対する具体的な指示は雛形内の `_CONTEXT_:` に書く。
|
|
28
|
+
|
|
29
|
+
| 入力 | 答える問い・集める情報 | 主な文脈の置き場所 |
|
|
30
|
+
| ------------------ | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
|
|
31
|
+
| 利用目的と根拠 | 誰が何をできるようにするか。上位設計のどの責務・品質条件に応えるか | カタログの `brief` または個票の `--input` |
|
|
32
|
+
| 文書の境界 | 技術一覧、既存の基盤定義、接続設定、利用手順のどこに正本があるか | カタログの `brief` または第 1 章(概要・位置づけ)の `_CONTEXT_:` |
|
|
33
|
+
| 環境と権限 | OS、実行環境、ユーザー、権限、依存の版、必要な CPU・メモリ・ディスクは何か。特別な条件がない項目はどれか | カタログの `brief`(共通基盤条件)または第 2 章(対象環境・前提条件)の `_CONTEXT_:` |
|
|
34
|
+
| 配置と経路 | 接続元、ホスト、コンテナ、サービスはどこで動き、どの方向へ通信するか。公開範囲はどこまでか | 第 3 章(全体構成・接続経路)の `_CONTEXT_:` または個票の `--input` |
|
|
35
|
+
| 設定の事実 | 導入済みの版、有効な設定、保存先、優先順位、再起動の要否を何で確認できるか | 第 5 章(導入・初期設定)の `_CONTEXT_:` または個票の `--input` |
|
|
36
|
+
| 採用の判断 | 決定済みの値と推奨候補は何か。互換性、ライセンス、資源の制約と採否の根拠は何か | カタログの `brief`(決定方針)または第 4 章(採用技術・設定)の `_CONTEXT_:`・`--input` |
|
|
37
|
+
| 認証と公開範囲 | 認証方式、秘密情報の取得・保存・参照の仕組みは何か。固有の接続先や識別子を公開できるか | 第 6 章(接続設定と秘密情報の扱い)の `_CONTEXT_:` または個票の `--input` |
|
|
38
|
+
| 確認と証跡 | 最小の利用成功は何か。確認場所、期待結果、確認環境・版・日付、記録先は何か | カタログの `done_criteria`(完了条件)または第 7 章(動作確認)の `_CONTEXT_:` |
|
|
39
|
+
| 継続利用と変更影響 | 切断、再起動、再構築で何が残るか。旧方式との競合、切り戻し、撤去で失う状態は何か | 第 8 章(継続利用・運用)・第 10 章(更新・復旧・撤去)の `_CONTEXT_:` |
|
|
40
|
+
|
|
41
|
+
### 2.1. 文脈の置き場所の使い分けの目安
|
|
42
|
+
|
|
43
|
+
- **カタログの `brief`**: プロジェクトや成果物群で共通する技術スタック・基盤前提(例: 「静的サイト構成とし、主流の技術スタック(Astro 等)を採用する」)。YAML アンカーで複数成果物へ共有できる。
|
|
44
|
+
- **個票の `入力`(`--input`)**: 起票時や対話で決まった前提、または agent に技術スタックの調査や選定を任せる範囲(例: `--input "静的サイトで主流の技術スタックを調べて選定する"`)。
|
|
45
|
+
- **成果物内の `_CONTEXT_:`**: `deliverable scaffold --project <project-id> --target <doc-id>` で生成した雛形の各章見出し直下に書く局所的な指示(カタログにない成果物は `--target-path` と `--target-rulebook` を指定。例: 第 4 章で `_CONTEXT_: 主流のフレームワークを比較し、選定理由と採用値を提案してください`)。`draft` が本文へ反映後に削除する。
|
|
38
46
|
|
|
39
47
|
## 3. 全体の作成手順
|
|
40
48
|
|
|
41
49
|
1. 利用目的を一文にし、文書を読み始める人の状態と、読み終えて確認する到達状態を書き出す。独立した利用目的が混ざっていたら別文書へ分ける。
|
|
42
50
|
2. 初期構築・接続設定・日常利用の担当を決める。同じ読み手が同じ前提で一続きに作業し、設定を一か所で保守できるなら一冊にまとめる。構築済み基盤を複数のクライアントが利用する、または接続・再開だけを繰り返すなら分冊を選ぶ。分冊ごとに前提の文書と開始できる確認結果をメモする。
|
|
43
|
-
3. 対象が分かる `tsd-<term>.md` の名前と配置を決め、既存文書との重複を確かめる。各設定の正本を一つ決め、別冊側ではその完了条件と本書で変える差分を示す。
|
|
51
|
+
3. 対象が分かる `tsd-<term>.md` の名前と配置を決め、既存文書との重複を確かめる。各設定の正本を一つ決め、別冊側ではその完了条件と本書で変える差分を示す。CLI で雛形を作成する場合は `specdojo deliverable scaffold --project <project-id> --target <project-id>:tsd-<term>`(カタログにない成果物は `--target-path` と `--target-rulebook` を指定)を実行する。TSD の rulebook(`specdojo:tsd-rulebook`)は `template: not-needed` だが、`deliverable_type: architecture` を引き継いだ最小構成の雛形が生成される。
|
|
44
52
|
4. 章の下書きを「概要・位置づけ」「対象環境・前提条件」「全体構成・接続経路」「採用技術・設定」「導入・初期設定」「接続設定」「動作確認」「継続利用・運用」「制約・トラブルシュート」「更新・復旧・撤去」「参照情報」の流れで置く。対象に応じて章を統合・並べ替え、扱わない手順は対象外とする理由や委譲先を概要へ残す。
|
|
45
53
|
5. 接続元・ホスト・コンテナなどに呼び名を付け、配置と通信方向を図か表にする。各操作の実行場所、設定保存先、権限をこの呼び名へそろえる。
|
|
46
54
|
6. 採用設定を表にし、推奨候補や任意の選択肢と分ける。実測・決定・公式情報のどれを根拠にしたか確かめ、裏付けがない版や容量は決めた値として埋めない。
|
|
@@ -296,16 +296,19 @@ specdojo config scaffold --workspace --force
|
|
|
296
296
|
|
|
297
297
|
主要オプション:
|
|
298
298
|
|
|
299
|
-
| オプション
|
|
300
|
-
|
|
|
301
|
-
| `--size <size>`
|
|
302
|
-
| `--project-id <id>`
|
|
303
|
-
| `--domain <domain>`
|
|
304
|
-
| `--var <NAME=value>`
|
|
305
|
-
| `--plan`
|
|
306
|
-
| `--dry-run`
|
|
307
|
-
| `--dct <name>`
|
|
308
|
-
| `--
|
|
299
|
+
| オプション | 用途 |
|
|
300
|
+
| ------------------------------ | ---------------------------------------------------------------------------------- |
|
|
301
|
+
| `--size <size>` | `small` / `medium` / `large` の成果物セットを選ぶ |
|
|
302
|
+
| `--project-id <id>` | 生成ファイルに埋め込む project ID を上書きする |
|
|
303
|
+
| `--domain <domain>` | `catalog scaffold` の対象をtemplateの`domain`で絞る(反復・カンマ区切り) |
|
|
304
|
+
| `--var <NAME=value>` | `catalog scaffold` で`_NAME_` placeholderを置換する(反復可能) |
|
|
305
|
+
| `--plan` | 保存済みの `dct-plan-<domain>.yaml` から決定論的に生成する |
|
|
306
|
+
| `--dry-run` | `--plan` の生成結果と既存ファイルとの差分を、書き込まずに表示する |
|
|
307
|
+
| `--dct <name>` | `deliverable scaffold` の対象を特定の `dct-*.yaml` に絞る(後述) |
|
|
308
|
+
| `--target <doc-id>` | `deliverable scaffold` で特定の成果物 1 件だけを雛形にする(`--dct` との併用不可) |
|
|
309
|
+
| `--target-path <path>` | カタログにない成果物の配置パス(`--target` と `--target-rulebook` と併用) |
|
|
310
|
+
| `--target-rulebook <rulebook>` | カタログにない成果物の rulebook 文書 ID(`--target` と `--target-path` と併用) |
|
|
311
|
+
| `--force` | 既存ファイルを上書きする |
|
|
309
312
|
|
|
310
313
|
`catalog scaffold`は、`--domain`を省略すると従来どおりすべてのDCT templateを対象にします。指定した場合は、ファイル名ではなくtemplate内の`domain`が一致するものだけを生成します。存在しないdomainを指定した場合は、部分的な生成を行わずエラーで終了します。
|
|
311
314
|
|
|
@@ -330,6 +333,22 @@ specdojo deliverable scaffold --project prj-0001 --dct project-definition
|
|
|
330
333
|
specdojo deliverable scaffold --project prj-0001 --dct dct-project-definition.yaml,dct-project-management.yaml
|
|
331
334
|
```
|
|
332
335
|
|
|
336
|
+
`--target <doc-id>` で成果物を 1 件だけ指定して雛形を作成できます(`--dct` とは併用できません)。カタログに登録されている成果物は、カタログの配置・rulebook・template の情報から 1 件だけ雛形を生成します。
|
|
337
|
+
|
|
338
|
+
カタログにない成果物は `--target-path <path>` と `--target-rulebook <rulebook>` をあわせて指定することで雛形を作成できます。パスの検証(リポジトリの中か、ファイル名か、ほかの文書が使っていないか)は register の `--target-path` と同じ規則で行われます。
|
|
339
|
+
|
|
340
|
+
`--dry-run` を指定するとファイルへの書き込みを行わず、作成予定(`Would create: <path>`)のみを表示します。既存ファイルがある場合は、`--force` が指定されていない限りスキップされます。
|
|
341
|
+
|
|
342
|
+
```bash
|
|
343
|
+
# カタログにある成果物を 1 件だけ雛形にする
|
|
344
|
+
specdojo deliverable scaffold --project prj-0001 --target prj-charter
|
|
345
|
+
|
|
346
|
+
# カタログにない成果物を雛形にする
|
|
347
|
+
specdojo deliverable scaffold --project prj-0001 --target my-spec \
|
|
348
|
+
--target-path docs/ja/product/my-spec.md \
|
|
349
|
+
--target-rulebook specdojo:cdfd-rulebook
|
|
350
|
+
```
|
|
351
|
+
|
|
333
352
|
`deliverable scaffold` の生成方針と `specdojo build` に含めない理由は [遂行の技活用ガイド](../guides/waza-guide.md) の `deliverable scaffold の生成方針`、生成系動詞の使い分けは同ガイドの `生成系動詞の標準`、成果物カタログから Schedule への展開は [Schedule設計ガイド](../guides/schedule-design-guide.md) の `成果物カタログとの責務分担` を参照します。
|
|
334
353
|
|
|
335
354
|
### 3.1. catalog plan(成果物インスタンスの判定)
|
|
@@ -489,6 +508,7 @@ specdojo schedule strategy generate \
|
|
|
489
508
|
|
|
490
509
|
| オプション | 用途 | 対象 |
|
|
491
510
|
| ---------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ |
|
|
511
|
+
| `--input <text>` | 個票の前提を記録(繰り返し可、update は一覧置換、`-` 単独で全削除) | `add` / `update` |
|
|
492
512
|
| `--track <track>` | epic が担う track(epic で必須、update で置換、削除不可) | `add` / `update` |
|
|
493
513
|
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
|
|
494
514
|
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
|
|
@@ -502,6 +522,8 @@ specdojo schedule strategy generate \
|
|
|
502
522
|
| `--target-path <path>` | 成果物のリポジトリ相対パス(`update` は `-` で削除) | `add` / `update` |
|
|
503
523
|
| `--target-rulebook <doc-id>` | 成果物の rulebook ID(`update` は `-` で削除) | `add` / `update` |
|
|
504
524
|
| `--source <ref>` | kata authoring の手本を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
525
|
+
| `--commit-type <type>` | Conventional Commits の type を指定(`update` は `-` で削除) | `add` / `update` |
|
|
526
|
+
| `--commit-scope <scope>` | Conventional Commits の scope を指定(`update` は `-` で削除) | `add` / `update` |
|
|
505
527
|
| `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
|
|
506
528
|
| `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
|
|
507
529
|
| `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
|
|
@@ -517,6 +539,12 @@ specdojo schedule strategy generate \
|
|
|
517
539
|
|
|
518
540
|
`register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
|
|
519
541
|
|
|
542
|
+
`--input <text>` は、対話で得た前提・制約・委任範囲を個票本文の `入力` 節へ指定順に記録します。`update` で未指定なら保持し、指定すれば一覧を置換します。追記するときは既存分も含めて再指定し、`--input -` 単独で全削除します。add での `-`、空文字、削除と他の値の混在は拒否します。既存個票に節がなければ更新時に追加します。event の `input` は変更前後の JSON 配列を保持し、空は `-` で表します。register から生成する plan は approach の有無によらず、入力がある場合だけ完了条件とは別の「個票の入力(前提)」へ載せます。
|
|
543
|
+
|
|
544
|
+
`--commit-type <type>` と `--commit-scope <scope>` は、個票 Frontmatter の `commit_type` と `commit_scope` に Conventional Commits の type と scope を記録します。`update` では未指定なら保持し、`-` で削除します。`commit_type` に指定できる値は Conventional Commits の type(`feat`・`fix`・`docs`・`refactor`・`test`・`chore`・`perf`・`build`・`ci`・`style`・`revert`)です。`commit_scope` は英小文字・数字・ハイフン(`^[a-z0-9][a-z0-9-]*$`)を指定します。個票で `commit_type` を指定しなかった場合は、項目の type から既定の対応(`issue` は `fix`、`todo`・`change-request` は `feat`、`decision`・`note`・`question`・`risk` は `docs`、`epic` は `feat`、未知の type は `chore`)またはプロジェクト・リポジトリの設定により決定されます。
|
|
545
|
+
|
|
546
|
+
既定値は個票へ書き込まず、共通関数で利用時に解決します。優先順位と設定例は [[specdojo:specdojo-config-reference|設定リファレンス]] を参照してください。この段階では exec の commit メッセージやブランチ名には反映しません。
|
|
547
|
+
|
|
520
548
|
`--approach` を指定する場合、通常は `--target` が 1 件だけ必須です。成果物を作成・修正する approach の対象は、成果物カタログを優先して doc id を解決します。カタログがなくても、既存文書は文書索引と frontmatter から、新規文書は明示したパスと rulebook から解決できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。kata authoring は `--target` を新しい kata ID、`--source` を 0 件以上の読み取り専用の手本とします。互換性のため、2 個目以降の `--target` も `--source` と同じ手本として扱います。
|
|
521
549
|
|
|
522
550
|
`sample-maintenance` は `type` を見ず、対象 `id` の末尾が `-sample` かどうかで判定します。利用者の authority の sample も同じ規則です。recipe・template・rulebook の maintenance は従来どおり `type` の一致を検証します。sample の `type` の規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を参照してください。
|
|
@@ -647,6 +675,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
647
675
|
| `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
|
|
648
676
|
| `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
|
|
649
677
|
| `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
|
|
678
|
+
| `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
|
|
650
679
|
| `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
|
|
651
680
|
| `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
|
|
652
681
|
| `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
|
|
@@ -734,6 +763,10 @@ specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026
|
|
|
734
763
|
|
|
735
764
|
`--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`epic` / `decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
|
|
736
765
|
|
|
766
|
+
`--branch <repo>=<name>` は、register の worktree モードでプロダクトの作業ブランチ名を上書きします。たとえば `specdojo exec run --project prj-0001 --register PJR-0012 --worktree --branch app1=feature/login` と指定します。複数のリポジトリにはオプションを繰り返します。宣言にないリポジトリ、同じリポジトリの重複、空の値、不正な Git ブランチ名は拒否します。別項目のブランチと重なると start 前に停止するため、topic を変えるかこの指定で解消します。自動の連番は付けません。SpecDojo の記帳用のブランチには適用しません。`--resume` では記録済みの名前を使うため指定の繰り返しは不要で、別名への変更は拒否します。
|
|
767
|
+
|
|
768
|
+
作業ブランチ名の既定値は `exec/{project}-{id}` です。`repos[].branch_template` に git-flow の `feature/{topic}`、GitHub flow の `{type}/{topic}` などを設定できます。統合の形は `repos[].integration_strategy` の `merge`(既定)・`ff`・`branch-only` で選びます。`ff` は早送りできるときだけ統合し、分岐していれば停止します。自動の rebase や同期 merge は行いません。
|
|
769
|
+
|
|
737
770
|
`--integration-branch <repo>=<branch>` は、register の worktree モードで、その run に限ってプロダクトリポジトリ `<repo>` の統合先を上書きします。複数リポジトリにはオプションを繰り返します。`<repo>` は `repos[].name` に宣言済みで、`<branch>` はそのリポジトリに存在する有効なローカルブランチでなければならず、リモートブランチの取得やローカルブランチの作成は行いません。同じ `<repo>` の重複、宣言にないリポジトリ、空の値は register の状態を変える前に拒否します。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定しない run の挙動は従来と変わりません。
|
|
738
771
|
|
|
739
772
|
複数項目を `--parallel` で実行する場合、指定は選択された各 item run に同じように適用されます。中断した run を `--resume` するときは、開始時の指定を `pipeline-state.json` から再利用するため、オプションを繰り返す必要はありません。再開時に値を再指定する場合、その値は開始時の指定と一致する必要があり、run の途中で統合先を変更・追加する指定は拒否します。result の複数リポジトリ trace には、実際に使った統合先ブランチと統合後の commit snapshot が記録されます。
|
|
@@ -785,7 +818,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
|
|
|
785
818
|
|
|
786
819
|
`--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 を表します。
|
|
787
820
|
|
|
788
|
-
`pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`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 外で人が行う確認を確認してください。
|
|
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 外で人が行う確認を確認してください。
|
|
789
822
|
|
|
790
823
|
記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
|
|
791
824
|
|