specdojo 0.9.1 → 0.9.2
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 +7 -0
- package/CHANGELOG.md +23 -0
- package/README.md +4 -4
- package/dist/commands/agent.js +15 -24
- package/dist/commands/init.js +8 -5
- package/dist/commands/orchestrator.js +6 -11
- package/dist/dashboard/timeline.js +2 -2
- package/dist/devcontainer/command.js +1 -1
- package/dist/devcontainer/scaffold.js +6 -5
- package/dist/exec/agent-config.js +4 -0
- package/dist/exec/commands.js +54 -4
- package/dist/exec/executor-outcome-checks.js +104 -0
- package/dist/exec/migrate-records.js +3 -1
- package/dist/exec/parent-validation.js +66 -15
- package/dist/exec/pipeline-state.js +16 -0
- package/dist/exec/register.js +4 -0
- package/dist/exec/run/agent-pipeline.js +44 -3
- package/dist/exec/run/register-command.js +9 -0
- package/dist/exec/run/register-core.js +2 -1
- package/dist/exec/run/register-resume.js +19 -2
- package/dist/exec/run/register-worktree.js +2 -1
- package/dist/exec/run/resume-notes.js +50 -0
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/task-repos.js +6 -0
- package/dist/exec/validation-process-group.js +98 -0
- package/dist/grade/command-inspect.js +3 -1
- package/dist/grade/command-run.js +1 -0
- package/dist/grade/command-shared.js +10 -0
- package/dist/grade/run.js +58 -6
- package/dist/grade/targets.js +106 -0
- package/dist/register/create-commands.js +30 -3
- package/dist/register/events.js +1 -1
- package/dist/register/item.js +1 -0
- package/dist/register/maintenance-commands.js +3 -1
- package/dist/register/renumber.js +14 -1
- package/dist/register/section.js +114 -0
- package/dist/register/update.js +18 -0
- package/dist/shared/antigravity-block.js +24 -0
- package/dist/shared/plan-conventions.js +11 -0
- package/dist/shared/provider-scaffold.js +4 -0
- package/dist/shared/specdojo-config.js +5 -4
- package/dist/shared/where-alias.js +2 -2
- package/docs/ja/specdojo/guides/exec-config-guide.md +15 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +21 -7
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +5 -3
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/timeline-design-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +76 -51
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +10 -42
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +10 -50
- package/docs/ja/specdojo/samples/dec-sample.md +3 -30
- package/docs/ja/specdojo/samples/dss-sample.md +12 -12
- package/docs/ja/specdojo/samples/ntp-sample.md +3 -30
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +1 -0
- package/package.json +1 -1
- package/templates/antigravity/orchestrator.md +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +7 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -0
- package/templates/codex/orchestrator.md +7 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +7 -0
|
@@ -46,18 +46,18 @@ specdojo where exec --project prj-0001
|
|
|
46
46
|
specdojo where routine --project prj-0001
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
-
旧 `exec where`・`catalog where`・`schedule where`・`timeline where`・`job where`・`routine where`
|
|
49
|
+
旧 `exec where`・`catalog where`・`schedule where`・`timeline where`・`job where`・`routine where` は非推奨であり、次の版(0.10.0)で削除予定です。代わりの操作として `specdojo where <種類>` を使用してください。標準出力と終了コードは新コマンドと同じで、標準エラーへ移行先と削除予定の警告を出します。旧入口は通常のヘルプ一覧には表示しません。
|
|
50
50
|
|
|
51
51
|
## 2. init / config / project
|
|
52
52
|
|
|
53
|
-
| コマンド | 用途
|
|
54
|
-
| ------------------------ |
|
|
55
|
-
| `init` | project から agent 実行までを質問式で初期設定する
|
|
56
|
-
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する
|
|
57
|
-
| `config show` | 有効な `repos` と、ローカル設定に由来する値を表示する
|
|
58
|
-
| `config migrate-members` | agent
|
|
59
|
-
| `config scaffold` | provider、VS Code ワークスペース、Git hook、Slidev を個別に配置する
|
|
60
|
-
| `project list` | 登録済み project を表示する
|
|
53
|
+
| コマンド | 用途 | 例 |
|
|
54
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
55
|
+
| `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
|
|
56
|
+
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
|
|
57
|
+
| `config show` | 有効な `repos` と、ローカル設定に由来する値を表示する | `specdojo config show --project prj-0001` |
|
|
58
|
+
| `config migrate-members` | 非推奨(0.10.0 で削除予定): agent 定義を保護設定へ移す。以後は `.specdojo/agent-members.yaml` に直接記述 | `specdojo config migrate-members --dry-run` |
|
|
59
|
+
| `config scaffold` | provider、VS Code ワークスペース、Git hook、Slidev を個別に配置する | `specdojo config scaffold --slidev` |
|
|
60
|
+
| `project list` | 登録済み project を表示する | `specdojo project list` |
|
|
61
61
|
|
|
62
62
|
`init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
|
|
63
63
|
provider、exec、Dev Container、Git hook、Slidev の順に質問します。Dev Container を選んだ場合だけ、続けて `minimal` / `recommended` / `full` の preset を質問します(既定は `recommended`)。Git hook は既定では作りません。Slidev の質問は `full` を選んだ場合だけ既定が「はい」、それ以外は「いいえ」です。成果物カタログは対話では質問せず、`--catalog <size>` を
|
|
@@ -67,6 +67,8 @@ provider、exec、Dev Container、Git hook、Slidev の順に質問します。D
|
|
|
67
67
|
空の場合も、provider の質問だけをやり直します。非対話環境や `--yes` では再質問せず、従来どおり不正な
|
|
68
68
|
指定をエラーとして終了します。
|
|
69
69
|
|
|
70
|
+
0.9.2 から、SpecDojo は Antigravity CLI(`agy`)を起動しません。consumer plan では、他社の agent や application の中から agy を起動することを [Antigravity の FAQ](https://antigravity.google/docs/faq) が対象外とし、[Additional Terms](https://antigravity.google/terms) の Section 6 が契約違反としているためです。`exec`・`grade`・`trial` などの agent 実行と `agent launch`・`orchestrator launch` は、provider が `antigravity` の指定を agy の起動前に終了コード 1 で止めます。名前で指定した member は止め、自動選択と代わりの選択では agy の member を候補から外してほかの member へ進みます。`init`・`config scaffold`・`devcontainer scaffold` でも `antigravity` は選べず、対話の選択肢にも出ません。止めるのを外す設定や環境変数はありません。0.9.1 の `init` で antigravity を選んだ場合は、`.specdojo/agent-members.yaml` で agy の member に `disabled: true` を付けるか削除し、ほかの provider を使ってください。
|
|
71
|
+
|
|
70
72
|
非対話環境では質問せず、次の主要オプションと既定値を使います。
|
|
71
73
|
|
|
72
74
|
| オプション | 用途 | 既定値 |
|
|
@@ -112,7 +114,7 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
|
|
|
112
114
|
追記した行と飛ばした行を表示し、追記があった場合は管理済みの `node_modules/` や生成物を
|
|
113
115
|
`git rm -r --cached` で外す手順を案内します。`config init --dry-run` は設定と `.gitignore` を
|
|
114
116
|
書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
|
|
115
|
-
`
|
|
117
|
+
`claude`、`codex`、`copilot`、`opencode` を指定でき(`antigravity` は 0.9.2 からエラーになります)、`--dry-run` と `--force` も利用できます。
|
|
116
118
|
|
|
117
119
|
`config show` は、`specdojo.config.json` とローカル設定 `.specdojo/specdojo.local.config.json` のパス、ローカルで上書きした項目、project ごとの `repos` を表示します。各リポジトリには `shared`(共有の設定)、`local; shared: <path>`(パスの差し替え)、`local; added`(ローカルで追加)のいずれかを付けます。`--project <id>` で対象を絞れます。ローカル設定の許可キーと優先順位は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] の「ローカル設定」を参照してください。
|
|
118
120
|
|
|
@@ -130,9 +132,9 @@ exec の result の commit 前検査は markdownlint-cli が読む利用リポ
|
|
|
130
132
|
`.markdownlintrc` を含む)を優先し、設定がなければ上記の6規則だけをコマンド引数で無効にします。
|
|
131
133
|
フォールバック用ファイルは利用リポジトリに作りません。CLI2 専用設定はこの検査では読みません。
|
|
132
134
|
|
|
133
|
-
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、
|
|
135
|
+
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
|
|
134
136
|
|
|
135
|
-
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 エージェント設定]] を参照してください。
|
|
137
|
+
次の 2 段落の agy の設定は 0.9.2 から使えません(理由は `init` の説明を参照)。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 エージェント設定]] を参照してください。
|
|
136
138
|
|
|
137
139
|
`antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
|
|
138
140
|
|
|
@@ -473,13 +475,13 @@ specdojo schedule strategy generate \
|
|
|
473
475
|
|
|
474
476
|
## 5. timeline(非推奨)
|
|
475
477
|
|
|
476
|
-
`tml-index.yaml`・`timeline build`・`timeline_path`
|
|
478
|
+
`tml-index.yaml`・`timeline build`・`timeline_path`(および `timeline where`)は非推奨であり、次の版(0.10.0)で削除予定です。全体計画は epic で管理し、`dashboard build` で `execution/generated/` に表とガント、未作成カタログを生成します。保存先確認には `specdojo where timeline` を使用します。epic のない track は全体計画に出しません。期間と範囲の扱いは [[specdojo:register-operation-guide|登録簿運用ガイド]]、移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
|
|
477
479
|
|
|
478
|
-
| コマンド | 用途
|
|
479
|
-
| ------------------------ |
|
|
480
|
-
| `build --only dashboard` | epic に基づく全体計画を含む dashboard を生成する
|
|
481
|
-
| `timeline build` |
|
|
482
|
-
| `where timeline` | 互換用 timeline の関連パスを表示する
|
|
480
|
+
| コマンド | 用途 | 例 |
|
|
481
|
+
| ------------------------ | ----------------------------------------------------------------------------------------- | ---------------------------------------------------- |
|
|
482
|
+
| `build --only dashboard` | epic に基づく全体計画を含む dashboard を生成する | `specdojo build --only dashboard --project prj-0001` |
|
|
483
|
+
| `timeline build` | 非推奨(0.10.0 で削除予定): 警告付きで旧形式の計画を生成する(`dashboard build` を使用) | `specdojo timeline build --project prj-0001` |
|
|
484
|
+
| `where timeline` | 互換用 timeline の関連パスを表示する | `specdojo where timeline --project prj-0001` |
|
|
483
485
|
|
|
484
486
|
旧 `timeline build` は `--dry-run` で書き込まずに検証できます。epic の順序と範囲を反映しつつ、既存の strategy と `timeline_path`(既定 `timeline`)の `tml-index.yaml` を互換用に読み、`timeline/generated/` に `timeline-order.md`・`catalog-scaffold.md`・`timeline.json` を出力します。track 重複、依存の未定義参照・循環、`order` との矛盾はエラーです。`catalog-planning` の todo から作成状況を導出し、手書きの状態との不一致は警告します。epic のない project の dashboard は旧 timeline 表示を維持します。
|
|
485
487
|
|
|
@@ -487,22 +489,22 @@ specdojo schedule strategy generate \
|
|
|
487
489
|
|
|
488
490
|
`register` は個票を正本とするプロジェクト登録簿と、その生成ビューを扱います。
|
|
489
491
|
|
|
490
|
-
| コマンド | 用途
|
|
491
|
-
| ----------------------- |
|
|
492
|
-
| `register scaffold` | 登録簿ディレクトリと生成ビューを初期化する
|
|
493
|
-
| `register add` | issue / todo / question などの項目を追加する
|
|
494
|
-
| `build --only register` | 個票から登録項目一覧と派生ビューを生成する
|
|
495
|
-
| `register update` | 登録項目を更新する
|
|
496
|
-
| `register start` | 項目を対応中へ変更する
|
|
497
|
-
| `register wait` | 項目を待ち状態へ変更する
|
|
498
|
-
| `register review` | 項目をレビュー状態へ変更する
|
|
499
|
-
| `register close` | 項目を完了にし、個票を `ready` へ昇格する
|
|
500
|
-
| `register reject` | 項目を却下にし、個票を `deprecated` にする
|
|
501
|
-
| `register defer` | 項目を延期にする
|
|
502
|
-
| `register reopen` | 終了済み項目を再オープンする
|
|
503
|
-
| `register renumber` | 重複・衝突した PJR-ID を未使用の ID へ移す
|
|
504
|
-
| `register history` | 追記型 event と旧 Git 履歴から変更を再構成する
|
|
505
|
-
| `register migrate` |
|
|
492
|
+
| コマンド | 用途 | 例 |
|
|
493
|
+
| ----------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
|
|
494
|
+
| `register scaffold` | 登録簿ディレクトリと生成ビューを初期化する | `specdojo register scaffold --project prj-0001` |
|
|
495
|
+
| `register add` | issue / todo / question などの項目を追加する | `specdojo register add --project prj-0001 --type issue --title "確認事項"` |
|
|
496
|
+
| `build --only register` | 個票から登録項目一覧と派生ビューを生成する | `specdojo build --only register --project prj-0001` |
|
|
497
|
+
| `register update` | 登録項目を更新する | `specdojo register update --project prj-0001 --id PJR-001 --owner PM` |
|
|
498
|
+
| `register start` | 項目を対応中へ変更する | `specdojo register start --project prj-0001 --id PJR-001` |
|
|
499
|
+
| `register wait` | 項目を待ち状態へ変更する | `specdojo register wait --project prj-0001 --id PJR-001` |
|
|
500
|
+
| `register review` | 項目をレビュー状態へ変更する | `specdojo register review --project prj-0001 --id PJR-001` |
|
|
501
|
+
| `register close` | 項目を完了にし、個票を `ready` へ昇格する | `specdojo register close --project prj-0001 --id PJR-001` |
|
|
502
|
+
| `register reject` | 項目を却下にし、個票を `deprecated` にする | `specdojo register reject --project prj-0001 --id PJR-001` |
|
|
503
|
+
| `register defer` | 項目を延期にする | `specdojo register defer --project prj-0001 --id PJR-001` |
|
|
504
|
+
| `register reopen` | 終了済み項目を再オープンする | `specdojo register reopen --project prj-0001 --id PJR-001` |
|
|
505
|
+
| `register renumber` | 重複・衝突した PJR-ID を未使用の ID へ移す | `specdojo register renumber --project prj-0001 --id PJR-0137 --to PJR-0140` |
|
|
506
|
+
| `register history` | 追記型 event と旧 Git 履歴から変更を再構成する | `specdojo register history --project prj-0001 --since 2026-08-01` |
|
|
507
|
+
| `register migrate` | 非推奨(0.10.0 で削除予定): 旧形式の登録簿データを現行形式へ移行する(個別個票と外部イベントが標準) | `specdojo register migrate --project prj-0001 --dry-run` |
|
|
506
508
|
|
|
507
509
|
`register add` は ID を省略すると自動採番し、現在の project では現在の作業ツリーに type 別の個票を作成します。別 project を `--project` で指定して `--commit` を付けると、対象 project の統合ブランチを開いている worktree、または CLI が作る一時 worktree で起票・再生成・commit を完了します。ID は乱数部分を持ち、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁(例: `PJR-4B7K`)です。個票 Frontmatter が分類、処理状態、優先度、担当、日付、結論の正本であり、`register build` は個票から一覧と派生ビューを生成します。`register` 系コマンドはすべて、成功時の通常出力を標準出力へ、エラーメッセージを標準エラー出力へ書きます。
|
|
508
510
|
|
|
@@ -529,6 +531,8 @@ specdojo schedule strategy generate \
|
|
|
529
531
|
| `--commit-type <type>` | Conventional Commits の type を指定(`update` は `-` で削除) | `add` / `update` |
|
|
530
532
|
| `--commit-scope <scope>` | Conventional Commits の scope を指定(`update` は `-` で削除) | `add` / `update` |
|
|
531
533
|
| `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
|
|
534
|
+
| `--section <name>` | 差し替える個票の章の名前(見出し番号を除いた名前) | `update` |
|
|
535
|
+
| `--section-file <path>` | 差し替え後の章の本文を含む Markdown ファイルのパス | `update` |
|
|
532
536
|
| `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
|
|
533
537
|
| `-m, --message <message>` | `--commit` のcommitメッセージを上書きする(繰り返し可) | `add` / `update` / `renumber` / 遷移 |
|
|
534
538
|
| `--dry-run` | 書き込みを行わず変更対象を表示する | `add` / `update` / `renumber` / 遷移 / `migrate` |
|
|
@@ -580,6 +584,18 @@ specdojo exec run --project prj-0001 --register <PJR-ID> --worktree
|
|
|
580
584
|
|
|
581
585
|
`register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
|
|
582
586
|
|
|
587
|
+
`register update --section <章の名前> --section-file <path>` は、個票の 1 つの章の本文を指定した Markdown ファイルの内容で差し替えます。章は見出しの番号を除いた名前(`完了条件`、`作業内容` など)で指定します。指定した章の見出し行(`## 3. 完了条件` など)はそのまま残し、次の同じ深さ(またはそれより浅い)見出しまでの本文だけを置き換えます。ほかの章や Frontmatter は変更しません。個票に存在しない章名、読み込めないファイル、または Markdown 見出しを含むファイルを指定した場合はエラーになり、個票は変更されません。変更は `action: update` の event に `field: section` として記録され、`--commit` と併用した場合は変更された個票とイベントファイルのみが commit されます。
|
|
588
|
+
|
|
589
|
+
```bash
|
|
590
|
+
# 完了条件の章本文をファイルから差し替える
|
|
591
|
+
specdojo register update --project prj-0001 --id PJR-AB12 \
|
|
592
|
+
--section 完了条件 --section-file tmp/new-criteria.md
|
|
593
|
+
|
|
594
|
+
# 作業内容の章本文を差し替えてコミットする
|
|
595
|
+
specdojo register update --project prj-0001 --id PJR-AB12 \
|
|
596
|
+
--section 作業内容 --section-file tmp/new-tasks.md --commit
|
|
597
|
+
```
|
|
598
|
+
|
|
583
599
|
`register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照、未設定の project、存在しない項目は書き込み前に拒否します。別 project の項目は、その project の `integration_branch`(省略時は `project/<project-id>/develop`)の Git tree を読んで存在を確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
|
|
584
600
|
|
|
585
601
|
`register add` / `update` の `--depends-on <ID>` は、起票の由来を示す `derived_from` と区別して、先行項目を `depends_on` に記録します。反復指定で一覧を設定・置換し、`--depends-on -` 単独で削除します。書式と別 project の存在確認は `--from` と同じです。存在しない ID、自己参照、project 間を含む循環を記帳前と `register build` で拒否し、変更を event に記録します。実行はすべての先行項目が `done` / `decided` の場合だけ許可し、`rejected` / `deferred` では進めません。直接の `exec run --register` は未完了の先行 ID と状態を表示して停止し、routine の sweep(`--register-filter`)と夜間 queue は対象を飛ばして理由を出力します。夜間の理由は朝報告にも残し、状態を自動で `waiting` に変えません。スキップは件数上限に数えません。先行完了後の再選択は次回の実行で行います。`generated/pjr-index.md` の `depends_on` 列と、逆引きビュー `generated/pjr-dependent-items.md` で関係を確認できます。
|
|
@@ -617,7 +633,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
617
633
|
|
|
618
634
|
一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
|
|
619
635
|
|
|
620
|
-
`register migrate`
|
|
636
|
+
`register migrate` は非推奨であり、次の版(0.10.0)で削除予定です。旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドとして提供されていましたが、現在は個別個票ファイル(`pjr-*.md`)および外部イベントファイル(`events/*.yaml`)が標準形式のため、新規の移行操作は不要です。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
|
|
621
637
|
|
|
622
638
|
`register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`sources`、`target_path`、`target_rulebook`、`derived_from`、`depends_on` です。
|
|
623
639
|
|
|
@@ -643,9 +659,9 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
643
659
|
| `exec unblock` | `blocked` を `doing` に戻す | `specdojo exec unblock --project prj-0001 --task <task-id> --by agent-1 --msg "resume"` |
|
|
644
660
|
| `exec release` | `doing` / `blocked` を `todo` に戻す | `specdojo exec release --project prj-0001 --task <task-id> --by agent-1` |
|
|
645
661
|
| `exec cancel` | `todo` を `cancelled` にする | `specdojo exec cancel --project prj-0001 --task <task-id> --by agent-1 --msg "scope removed"` |
|
|
646
|
-
| `exec note` |
|
|
647
|
-
| `exec link` |
|
|
648
|
-
| `exec estimate` |
|
|
662
|
+
| `exec note` | 非推奨(0.10.0 で削除予定): メモイベントを残す(個票の対応結果や実行記録に記録) | `specdojo exec note --project prj-0001 --task <task-id> --by agent-1 --msg "memo"` |
|
|
663
|
+
| `exec link` | 非推奨(0.10.0 で削除予定): 外部参照イベントを残す(個票の `depends_on` やカタログで管理) | `specdojo exec link --project prj-0001 --task <task-id> --by agent-1 --ref pr=https://example.com/pr/1` |
|
|
664
|
+
| `exec estimate` | 非推奨(0.10.0 で削除予定): 見積もりイベントを残す(個票の `difficulty` や `priority` で管理) | `specdojo exec estimate --project prj-0001 --task <task-id> --by agent-1 --meta duration_days=1` |
|
|
649
665
|
| `exec run` | plan を生成してエージェントを実行する | `specdojo exec run --project prj-0001 --task <task-id>` |
|
|
650
666
|
| `exec handoff` | block された保護設定の提案差分を確認し、統合先へ適用して commit する | `specdojo exec handoff apply --project prj-0001 --register PJR-0012` |
|
|
651
667
|
| `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する | `specdojo exec resume --project prj-0001 --due` |
|
|
@@ -666,7 +682,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
666
682
|
|
|
667
683
|
`exec validate` は、一部だけの run 記録を通常は `WARN:` で報告し、欠落だけなら終了コード 0 を返します。`--records-only` は同じ欠落を `ERROR:` と終了コード 1 にします。両モードとも、plan・result がそろい state・evidence のない evidence 導入前の run、state・evidence のみがあり同じ出どころ・項目の別 run に plan・result の対がある移行後の先行試行、旧 `exec/plans/`・`results/`・`evidence/` の記録はエラー・警告にしません。`execution/grade/generated/` と空の lock のディレクトリも配置の検査から外します。これら以外の配置違反、Git に無視されない lock、Git 確認失敗は通常時もエラーです。`--schedule-only` は従来どおり schedule・event だけを検査します。`--records-only --commit <rev>` は作業ツリーではなく `<rev>` の tree の記録を検査し、未 commit の run や空のディレクトリを対象にしません(pre-push の検査で使います)。
|
|
668
684
|
|
|
669
|
-
`exec migrate-records`
|
|
685
|
+
`exec migrate-records` は非推奨であり、次の版(0.10.0)で削除予定です。現在は新形式の実行記録配置(`execution/runs/`)が標準形式です。検査を通すためにも本コマンドの実行は不要です。移さない旧記録は、再開候補の自動探索、task ID からの plan・result の取得、dashboard の実行記録一覧・件数に含まれません。`register build` は旧記録を探索せず、個票の既存リンクを自動移行・補完しません。明示パスを読む経路などの条件と移行手順は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] の「既存記録の移行」を参照してください。
|
|
670
686
|
|
|
671
687
|
schedule の `exec resume --task <task-id> --resume-from executor` は、executor が `succeeded` で reporter が未完了、または統合段(commit・検査・merge)で止まった pipeline、あるいは approach の必須項目(`condense_records` など)を欠いた報告として runner が executor の段で止めた pipeline を、既存 worktree・変更・同じ run を引き継いで executor → reporter → 統合の順に再実行します。対象状態は reporter 段・統合段・executor 段の `blocked` または中断した `doing` で、executor の試行回数を増やし、`blocked` からの状態遷移は `unblock` イベントへ記録します。統合段から戻す場合は、executor を起動する前に統合先(project は root の現在ブランチ)を exec branch と worktree へ取り込みます。統合が成功済みの run、一部のリポジトリを統合済みの run、exec branch が merge 済みの run、worktree が merge の途中の run、executor 未成功、pipeline 以外、`executor` 以外の値は拒否します。`--task` は必須で、`--due` とは併用できません。worktree の `<execution_path>/runs/schedule/<task-id>/<run-id>/plan.md` を編集してから再開すると、その plan を使います。変更理由と再開の経緯を報告の `handoff` へ記載するよう plan に指示し、再開後の result の申し送りを確認してください。手順は [[specdojo:exec-operation-guide|exec運用ガイド]] の「blockedタスクの復帰」を参照してください。
|
|
672
688
|
|
|
@@ -706,6 +722,7 @@ schedule の `exec resume --task <task-id> --resume-from executor` は、executo
|
|
|
706
722
|
| `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
|
|
707
723
|
| `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
|
|
708
724
|
| `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用)、schedule の `resume --task`(`--due` と併用不可) |
|
|
725
|
+
| `--resume-note <text>` | executor から再開する前に、run の plan の共通規約の参照の前へ再開の指示を足す(繰り返し可) | `run --register <PJR-ID> --resume --resume-from executor`(ID は1件) |
|
|
709
726
|
| `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
|
|
710
727
|
| `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
|
|
711
728
|
| `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
|
|
@@ -787,6 +804,9 @@ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume
|
|
|
787
804
|
# 親検証の失敗を成果物側で直すため、既存 worktree の executor から再開する
|
|
788
805
|
specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --resume-from executor
|
|
789
806
|
|
|
807
|
+
# 再開の指示を plan へ足してから、既存 worktree の executor から再開する
|
|
808
|
+
specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --resume-from executor --resume-note "個票の完了条件 3 の文書を先に直す"
|
|
809
|
+
|
|
790
810
|
# Job Definitionから期間ごとのRunを生成して実行する
|
|
791
811
|
specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
|
|
792
812
|
```
|
|
@@ -805,6 +825,8 @@ specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026
|
|
|
805
825
|
|
|
806
826
|
`--resume` は register の worktree モードで使う pipeline 実行専用オプションで、途中で止まった run を止まった段から再開します。対象 run は既存 worktree に残る最新の `pipeline-state.json` から特定し、再開段も state から決まります。executor が `running` のまま残っていれば、同じ plan/result と未コミット成果を保持した worktree 上で executor を再実行します。executor が成功済みで reporter が未完了なら、保存済みの `evidence.json` を使って reporter だけを再開します。親検証の失敗を成果物側で直す必要がある場合は `--resume-from executor` を併用すると、reporter 段から再開可能な run を executor 段へ戻せます。直前の失敗した親検証の ID と要約、または executor の block 理由は prompt の申し送りに含まれます。統合段から executor へ戻す指定、`--resume` を伴わない指定、`executor` 以外の値は拒否します。
|
|
807
827
|
|
|
828
|
+
`--resume-note <text>` は、`--resume --resume-from executor` で executor へ戻すときに、再開の指示を run の plan へ足します。worktree の plan の共通規約の参照の行の前に、見出し `## 再開の指示(<日時>)` の節として指示を箇条書きで入れ、参照の行とその後ろは変えません。オプションを繰り返すと 1 つの節に並べます。足した指示と日時は `pipeline-state.json` の `resume_notes` に残り、次の再開にも引き継がれます。`--resume-from executor` を伴わない指定、`--register` の ID が 1 件でない指定、`--register-filter` との併用、空の文字列は、project の解決や register の状態変更より前にエラーで止めます。worktree の plan を手で直すと、executor から戻さない通常の再開では統合の前に範囲外の変更として止まるためです。
|
|
829
|
+
|
|
808
830
|
全再開段で、agent または親検証の起動前に統合先ブランチの最新を exec branch と worktree へ取り込みます(複数リポジトリの project ではプロダクトごとの統合先も取り込みます)。worktree の未コミット成果は未追跡ファイルを含めて一時退避し、取り込み後に index を復元せず戻すため、同一ファイルの非競合変更も両方保持できます。commit 済み変更または退避した成果の復元が競合する場合は同期 merge を巻き戻し、executor の成果を元の worktree へ戻してから、register の状態を変えずに再開を拒否します。親検証の記録が不足または失敗している場合は、現在の固定許可リストで親検証を更新してから reporter へ進みます。reporter も成功していて統合(commit → merge → worktree 撤去)だけが残っている場合は、agent を起動せずに統合段だけを再試行します。worktree や plan/result が無い、成功済み executor の evidence が欠損しているなど再開できない場合は、worktree を含め何も変更せずエラー終了します。再開可能な成果が残っている項目を `--resume` なしで再実行しようとした場合も、未統合の成果を守るために中断します。破棄して最初からやり直す場合は `--force-restart` を指定します。手順の使い分けは [exec運用ガイド](../guides/exec-operation-guide.md) を参照します。
|
|
809
831
|
|
|
810
832
|
`.specdojo/exec-defaults.yaml` の `pipeline.post_integration` を設定すると、worktree 実行(register・schedule・job)の統合の commit の後に、親 runner が exec のロックを持ったまま固定の処理を流します(PJR-8KXJ)。指定できる ID は `build-dist`(`npm run build`)だけで、各要素は `{ id, paths }` です。統合の commit の差分(削除と名前の変更の前後を含む)が `paths` の glob に当たるときだけ実行します。失敗しても統合は戻さず、`dist/.specdojo-build-failed` を置いて次の `exec` を dist-freshness の判定で止めます。成功すると印を消します。結果(`passed` / `failed` / `skipped`)は run の記録の `post-integration.log`(JSON Lines)と標準出力の `[post-integration]` 行に残り、統合段の再開では記録済みの処理を繰り返しません。設定の書き方は [exec設定ガイド](../guides/exec-config-guide.md) を参照します。
|
|
@@ -927,11 +949,11 @@ runner は自分が起動した子プロセスの終了を待ってから次の
|
|
|
927
949
|
|
|
928
950
|
`grade run` は npm package から利用でき、`list` と同じ対象選択、文書ごとの plan 生成、agent 実行、marker の機械変換と `apply` を単段で実行します。成果物を `--target deliverable` で評価するには、対象 project に `catalog_path` を設定する必要があります。`viewpoints_path` 未設定時は同梱の `specdojo:pm-review-viewpoints` を使います。
|
|
929
951
|
|
|
930
|
-
| コマンド | 用途
|
|
931
|
-
| --------------- |
|
|
932
|
-
| `grade list` | 選択した文書のパスを1行1件で出力し、plan は保存しない
|
|
933
|
-
| `grade run` | 文書ごとに評価と反映を実行し、同じ run を再開する
|
|
934
|
-
| `grade migrate` | インライン grade / finding
|
|
952
|
+
| コマンド | 用途 |
|
|
953
|
+
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
954
|
+
| `grade list` | 選択した文書のパスを1行1件で出力し、plan は保存しない |
|
|
955
|
+
| `grade run` | 文書ごとに評価と反映を実行し、同じ run を再開する |
|
|
956
|
+
| `grade migrate` | 非推奨(0.10.0 で削除予定): インライン grade / finding をサイドカーへ一括移行する(結果サイドカーが標準、新規は `grade run` を使用) |
|
|
935
957
|
|
|
936
958
|
`grade run` は、完了した文書と失敗した文書が混在すると終了コード 2、完了した文書がなく失敗した場合は 1 で終わります。agent が rate limit を返した場合は、その文書を未完了のまま残して直ちに終了コード 75 で止まり、同じ `--run-id` の再実行で再開します。`--target kata --reference-per-kind` は、各文書を同じ種別の `prj-overview-<種別>` 文書と比較します(`--reference` とは併用できません)。定期の job(`job-grade-kata`・`job-grade-deliverable`)はこの経路で評価します。
|
|
937
959
|
|
|
@@ -950,6 +972,8 @@ runner は自分が起動した子プロセスの終了を待ってから次の
|
|
|
950
972
|
```bash
|
|
951
973
|
specdojo grade run --target kata --kind rulebook --run-id quality-check --dry-run
|
|
952
974
|
specdojo grade run --target kata --path <document.md> --run-id quality-check --by <executor-nickname>
|
|
975
|
+
# 型の名前の一覧を指定し、rulebook と sample の組をまとめて順に評価する
|
|
976
|
+
specdojo grade run --target kata --kata pjr --kata sld --run-id kata-batch
|
|
953
977
|
# 同じコマンドを再実行すると完了済み文書を飛ばし、未完了文書から再開する
|
|
954
978
|
specdojo grade run --target deliverable --project prj-0001 --changed-only --run-id deliverable-check
|
|
955
979
|
specdojo grade plan --target kata --changed-only --project prj-0001
|
|
@@ -980,6 +1004,8 @@ specdojo grade validate --target kata --project prj-0001
|
|
|
980
1004
|
|
|
981
1005
|
宣言済み `project.repos` 配下の Markdown は、プロジェクトリポジトリから `../product/docs/document.md` のように指定できます。宣言外のリポジトリや symlink による範囲外への参照は拒否します。
|
|
982
1006
|
|
|
1007
|
+
`--kata <name>` は `--target kata` 専用で、繰り返し指定できます。指定した型の名前(`pjr`・`sld` などの接頭辞)ごとに、対応する rulebook と sample の組を 1 回の実行で順に評価します。存在しない型の名前は実行前にまとめてエラーにします。1 つの型の失敗や rate limit で残りの型をスキップせず、終了時に型ごとの結果(完了・失敗・未実行)を一覧表示します。完了と失敗が混在すると終了コード 2、rate limit に当たった場合は終了コード 75 を返します。`--path` とは併用できません。
|
|
1008
|
+
|
|
983
1009
|
`--target` は `kata` または `deliverable` です。`--path` は繰り返し指定でき、明示した Markdown 文書だけを対象にします。ただし、パス要素に `generated` を含む生成文書と `trash` を含む退避済み文書は自動探索から除外し、`--path` で明示した場合も入力エラーとして拒否します。`--changed-only` は grade result サイドカーの `content_hash` と現在の成果物ファイル全体の SHA-256 を比較します。`grade apply` はサイドカーだけを更新するため、評価結果の書き込み自体で成果物が変更扱いになることはありません。
|
|
984
1010
|
|
|
985
1011
|
`--changed-only` は、対象文書の本文が変わった文書に加えて、突き合わせ先が変わった文書も選びます。突き合わせ先は、対象文書に適用される継続評価の観点が `comparison_sources` で宣言したものです。`grade apply` は評価時点の突き合わせ先の SHA-256 をサイドカーの `source_hashes` へ記録し、`--changed-only` は記録と現在の値が 1 つでも異なる文書を選びます。宣言できる突き合わせ先と、`source_hashes` のキーは次のとおりです。
|
|
@@ -1267,10 +1293,10 @@ schedule / register / job / routine の使い分けの基準は [exec運用ガ
|
|
|
1267
1293
|
|
|
1268
1294
|
`agent` とその `run`・`launch` は、`grade run`・runner・exec-defaults の command template が部品として呼ぶ内部用のコマンドです。help の一覧には表示しませんが、呼び出しは従来どおり動きます。
|
|
1269
1295
|
|
|
1270
|
-
| コマンド | 用途
|
|
1271
|
-
| -------------- |
|
|
1272
|
-
| `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する
|
|
1273
|
-
| `agent launch` | agy
|
|
1296
|
+
| コマンド | 用途 |
|
|
1297
|
+
| -------------- | ----------------------------------------------------------------------------------------- |
|
|
1298
|
+
| `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
|
|
1299
|
+
| `agent launch` | 0.9.2 から agy を起動せず、常にエラーで終了する(0.9.1 の command template を止める入口) |
|
|
1274
1300
|
|
|
1275
1301
|
```bash
|
|
1276
1302
|
specdojo agent run --plan <plan.md> --by <nickname> --out <response.txt>
|
|
@@ -1298,7 +1324,7 @@ specdojo orchestrator launch --provider claude --project prj-0001 -- \
|
|
|
1298
1324
|
|
|
1299
1325
|
provider CLI の実行中、起動元は `SIGINT` と `SIGQUIT` を無視して子プロセスの終了を待ちます。端末での Ctrl-C は provider CLI に直接届くため、入力の取り消しとして扱う CLI が起動元だけを終了させることはありません。`SIGTERM` と `SIGHUP` は子プロセスへ転送し、子の終了後に同じ終了コードを返します。子がシグナルで終了した場合は `128 + シグナル番号` を返します。
|
|
1300
1326
|
|
|
1301
|
-
Claude Code、Codex、
|
|
1327
|
+
`--provider antigravity` は 0.9.2 から agy を起動する前にエラーで終了します(理由は「init / config / project」の説明を参照)。Claude Code、Codex、GitHub Copilot には exec と同じ追加ルート引数を渡します。OpenCode は、起動時の `OPENCODE_CONFIG_CONTENT` に選択 agent の `permission.external_directory` を注入し、全外部ディレクトリを拒否したうえで宣言済みのリポジトリだけを許可します。外部パスへ既存の `permission.edit` が一致しないため、同じ宣言済みルートの編集許可を起動場所からの相対パス(例: `../<repo>/**`)で注入します。既存の inline config の他項目は保持します。未宣言のリポジトリは、どの provider でも許可対象になりません。
|
|
1302
1328
|
|
|
1303
1329
|
`orchestrator night` は `autopilot: approved` の付いた `open` todo・issue だけを夜間 queue として実行します。
|
|
1304
1330
|
|
|
@@ -1321,7 +1347,7 @@ Job worktree 内から起動しても、子 run の worktree は主の作業ツ
|
|
|
1321
1347
|
| `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
|
|
1322
1348
|
| `devcontainer host-script` | ホストから tmux へ接続するスクリプト本体を `.specdojo/host/` に書き出す |
|
|
1323
1349
|
|
|
1324
|
-
`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 は `
|
|
1350
|
+
`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 は `claude`、`codex`、`opencode` を指定できます。`antigravity` は 0.9.2 からエラーになり、agy 用の設定を足しません。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
|
|
1325
1351
|
|
|
1326
1352
|
主要オプション:
|
|
1327
1353
|
|
|
@@ -1389,7 +1415,6 @@ Codex 自身の sandbox は引き続き使用し、`workspace-write` で許可
|
|
|
1389
1415
|
| Codex の設定・認証 | `/home/node/.codex` | `<repository>-specdojo-codex` | `codex` provider |
|
|
1390
1416
|
| OpenCode の設定 | `/home/node/.config/opencode` | `<repository>-specdojo-opencode` | `opencode` provider |
|
|
1391
1417
|
| OpenCode の認証・アプリデータ | `/home/node/.local/share/opencode` | `<repository>-specdojo-opencode-data` | `opencode` provider |
|
|
1392
|
-
| Antigravity の設定・認証 | `/home/node/.config/antigravity` | `<repository>-specdojo-antigravity` | `antigravity` provider |
|
|
1393
1418
|
|
|
1394
1419
|
OpenCode の API key は `/home/node/.local/share/opencode/auth.json` に入り、設定とは別の `opencode-data` volume に残ります。`post-create.sh` は mount 先をコンテナユーザーが読み書きできる所有者へ整えます。Git 設定は volume 内の global config から、Dev Containers がホストからコピーした `~/.gitconfig` を include しますが、ホスト上のファイル自体を mount しません。
|
|
1395
1420
|
|
|
@@ -3,53 +3,21 @@ specdojo:
|
|
|
3
3
|
id: specdojo:dec-rulebook
|
|
4
4
|
type: rulebook
|
|
5
5
|
deliverable_type: project
|
|
6
|
-
status:
|
|
6
|
+
status: deprecated
|
|
7
7
|
target_format: markdown
|
|
8
|
+
recipe: not-needed
|
|
8
9
|
sample: specdojo:dec-sample
|
|
10
|
+
template: not-needed
|
|
9
11
|
---
|
|
10
12
|
|
|
11
|
-
# 決定記録
|
|
13
|
+
# 決定記録 作成ルール(非推奨)
|
|
12
14
|
|
|
13
|
-
Decision Log Documentation Rulebook
|
|
15
|
+
Deprecated Decision Log Documentation Rulebook
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
この rulebook は非推奨です。決定の記録はプロジェクト登録簿の decision で管理するため、後継を登録簿の decision([[specdojo:pjr-rulebook|プロジェクト登録簿作成ルール]])としました。
|
|
16
18
|
|
|
17
|
-
## 1.
|
|
19
|
+
## 1. 移行方針
|
|
18
20
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
## 2. 位置づけ
|
|
24
|
-
|
|
25
|
-
- 決定記録はプロジェクト運営・設計判断の証跡であり、課題ログ、変更要求ログと相互参照する。
|
|
26
|
-
|
|
27
|
-
## 3. ファイル命名・ID規則
|
|
28
|
-
|
|
29
|
-
- ファイル名は `dec-<NNNN>-<topic>.md` とし、連番は4桁ゼロ埋めとする(例: `dec-0001-auth`)。
|
|
30
|
-
- 文書 ID は `<project-id>:dec-<NNNN>-<topic>` 形式とする(例: `prj-0001:dec-0001-auth`)。
|
|
31
|
-
|
|
32
|
-
## 4. 推奨 Frontmatter 項目
|
|
33
|
-
|
|
34
|
-
`specdojo.id` は `<project-id>:dec-<NNNN>-<topic>`、`specdojo.type` は `project` とし、その他の項目は共通の運用に従う。
|
|
35
|
-
|
|
36
|
-
## 5. 本文構成(標準テンプレ)
|
|
37
|
-
|
|
38
|
-
| 番号 | 見出し | 必須 |
|
|
39
|
-
| ---- | -------------- | ---- |
|
|
40
|
-
| 1 | 背景 | ○ |
|
|
41
|
-
| 2 | 検討した選択肢 | ○ |
|
|
42
|
-
| 3 | 決定内容 | ○ |
|
|
43
|
-
| 4 | 採択理由 | ○ |
|
|
44
|
-
| 5 | 影響範囲 | ○ |
|
|
45
|
-
|
|
46
|
-
## 6. 記述ガイド
|
|
47
|
-
|
|
48
|
-
- 選択肢は少なくとも2案以上を記載する。
|
|
49
|
-
- 採択理由は判断軸とともに記載する。
|
|
50
|
-
- 影響範囲は仕様・実装・運用の観点で示す。
|
|
51
|
-
|
|
52
|
-
## 7. 禁止事項
|
|
53
|
-
|
|
54
|
-
- 根拠なしで結論のみを記載しない。
|
|
55
|
-
- 実装断片の貼り付けで説明を代替しない。
|
|
21
|
+
- 新しい `dec-<NNNN>` は作成せず、決定事項はプロジェクト登録簿の decision(個票)で管理します。
|
|
22
|
+
- 既存の決定記録がある場合は、プロジェクト登録簿の decision 個票へ移行します。
|
|
23
|
+
- 参照元は dec 参照を削除または更新し、プロジェクト登録簿の decision を参照します。
|
|
@@ -3,60 +3,20 @@ specdojo:
|
|
|
3
3
|
id: specdojo:ntp-rulebook
|
|
4
4
|
type: rulebook
|
|
5
5
|
deliverable_type: test
|
|
6
|
-
status:
|
|
6
|
+
status: deprecated
|
|
7
|
+
recipe: not-needed
|
|
7
8
|
sample: specdojo:ntp-sample
|
|
9
|
+
template: not-needed
|
|
8
10
|
---
|
|
9
11
|
|
|
10
|
-
# 移行テスト計画(リハーサル計画)
|
|
12
|
+
# 移行テスト計画(リハーサル計画) 作成ルール(非推奨)
|
|
11
13
|
|
|
12
|
-
Migration Test Plan Documentation Rules
|
|
14
|
+
Deprecated Migration Test Plan Documentation Rules
|
|
13
15
|
|
|
14
|
-
|
|
16
|
+
この rulebook は非推奨です。移行テスト計画(リハーサル計画)の作成ルールは後継の [[specdojo:mtp-rulebook|移行テスト計画 作成ルール]] へ統合しました。
|
|
15
17
|
|
|
16
|
-
## 1.
|
|
18
|
+
## 1. 移行方針
|
|
17
19
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
|
|
22
|
-
## 2. 位置づけと用語定義(必要に応じて)
|
|
23
|
-
|
|
24
|
-
- 上位方針・関連成果物との責務境界を明確化する。
|
|
25
|
-
- 必要に応じて用語を定義し、命名ゆれを防ぐ。
|
|
26
|
-
|
|
27
|
-
## 3. ファイル命名・ID規則
|
|
28
|
-
|
|
29
|
-
- 推奨ファイル名: `ntp`
|
|
30
|
-
- ドキュメントID: `ntp-<term>` または用途に応じた識別子
|
|
31
|
-
|
|
32
|
-
## 4. 推奨 Frontmatter 項目
|
|
33
|
-
|
|
34
|
-
| 項目 | 値 | 必須 |
|
|
35
|
-
| -------- | -------------------------- | ---- |
|
|
36
|
-
| id | 一意なID | ○ |
|
|
37
|
-
| type | `test` 固定 | ○ |
|
|
38
|
-
| status | draft / ready / deprecated | ○ |
|
|
39
|
-
| rulebook | `ntp-rulebook` | 任意 |
|
|
40
|
-
|
|
41
|
-
## 5. 本文構成(標準テンプレ)
|
|
42
|
-
|
|
43
|
-
| 章 | 必須 | 内容 |
|
|
44
|
-
| ----------------- | ---- | ---------------------- |
|
|
45
|
-
| 1. 目的と適用範囲 | ○ | 対象、目的、適用境界 |
|
|
46
|
-
| 2. 入力情報 | ○ | 前提、参照元、制約 |
|
|
47
|
-
| 3. 記述内容 | ○ | 主要項目、構成、記述順 |
|
|
48
|
-
| 4. 検証観点 | ○ | 完了条件、確認観点 |
|
|
49
|
-
|
|
50
|
-
| 5. 未解決事項 | 任意 | 課題、決定期限、担当 |
|
|
51
|
-
|
|
52
|
-
## 6. 記述ガイド
|
|
53
|
-
|
|
54
|
-
- 事実と判断を分離し、根拠を併記する。
|
|
55
|
-
- 表は列見出しを固定し、欠損値の扱いを明示する。
|
|
56
|
-
- 章参照は章番号ではなく章タイトルで記述する。
|
|
57
|
-
|
|
58
|
-
## 7. 禁止事項
|
|
59
|
-
|
|
60
|
-
- 実装依存の詳細を記載しない。
|
|
61
|
-
- 判定不能な曖昧語を使わない。
|
|
62
|
-
- 参照元不明の値を断定しない。
|
|
20
|
+
- 新しい `ntp-<term>` は作成せず、`mtp-index` または `mtp-<term>` にリハーサル計画・検証設計を記載します。
|
|
21
|
+
- 既存の移行テスト計画がある場合は、後継の `mtp` へ移行します。
|
|
22
|
+
- 参照元は ntp 参照を削除または更新し、統合先の `mtp` を参照します。
|
|
@@ -2,37 +2,10 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:dec-sample
|
|
4
4
|
type: project
|
|
5
|
-
status:
|
|
5
|
+
status: deprecated
|
|
6
6
|
rulebook: specdojo:dec-rulebook
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
# 決定記録
|
|
9
|
+
# 決定記録 サンプル(非推奨)
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
- 管理画面の認証方式として、セッション認証を継続するかトークン認証へ切り替えるかを判断する必要がある。
|
|
14
|
-
- 既存運用では監査ログ要件が強く、失効制御と運用負荷の両立が課題になっている。
|
|
15
|
-
|
|
16
|
-
## 2. 検討した選択肢
|
|
17
|
-
|
|
18
|
-
| 選択肢 | 概要 | 利点 | 懸念 |
|
|
19
|
-
| ------ | --------------------------------------------- | ------------------------ | ------------------------ |
|
|
20
|
-
| A | 既存セッション認証を継続 | 変更コストが低い | 外部連携時の拡張性が低い |
|
|
21
|
-
| B | JWT ベースへ全面移行 | 拡張性が高い | 失効制御の運用が重い |
|
|
22
|
-
| C | 管理画面はセッション、外部公開 API はトークン | 境界に応じた最適化が可能 | 方式が 2 系統になる |
|
|
23
|
-
|
|
24
|
-
## 3. 決定内容
|
|
25
|
-
|
|
26
|
-
- 選択肢 C を採択する。
|
|
27
|
-
|
|
28
|
-
## 4. 採択理由
|
|
29
|
-
|
|
30
|
-
- 品質: 管理画面の監査性を維持しつつ、外部連携の拡張性を確保できる。
|
|
31
|
-
- コスト: 既存機能への影響を最小化し、段階的移行が可能である。
|
|
32
|
-
- 運用性: 失効制御の運用範囲を API 側に限定できる。
|
|
33
|
-
|
|
34
|
-
## 5. 影響範囲
|
|
35
|
-
|
|
36
|
-
- 仕様: 外部 IF 仕様書にトークン認証要件を追加する。
|
|
37
|
-
- 実装: API ゲートウェイに認証ミドルウェアを追加する。
|
|
38
|
-
- 運用: トークン失効手順と監査ログ確認手順を運用手順書へ追記する。
|
|
11
|
+
この sample は非推奨です。決定記録の完成例・管理はプロジェクト登録簿の decision([[specdojo:pjr-rulebook|プロジェクト登録簿作成ルール]])を参照してください。
|
|
@@ -143,24 +143,24 @@ primary・danger の文字リンクと枠は surface 上で用いる。ホバー
|
|
|
143
143
|
|
|
144
144
|
### 8.2. 検証の節目と基準版の採用
|
|
145
145
|
|
|
146
|
-
| 順序・節目 | 完了条件・証跡
|
|
147
|
-
| --------------- |
|
|
148
|
-
| 1. 試作確認 | DEV が作った試作に UIS の全操作と DSS の型を対応付け、ARC が対象幅・拡大時の表示結果と入力文書・試作の版を記録する
|
|
149
|
-
| 2. 規則検証 | QE が前節のトークン・部品・状態・アクセシビリティの適合結果を `stc-store-gui` に記録し、不適合の修正と再確認を終える
|
|
150
|
-
| 3. 利用者評価 | 店主代表・利用者代表が要件の条件で操作し、QE が測定結果、BA が受入条件との照合を `sac-usability` に記録する
|
|
151
|
-
| 4. 実装への採用 | PO が前の三段階の証跡、未解決事項・仮定、残余リスクを確認し、基準版の commit
|
|
146
|
+
| 順序・節目 | 完了条件・証跡 | 確認責任 |
|
|
147
|
+
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
|
|
148
|
+
| 1. 試作確認 | DEV が作った試作に UIS の全操作と DSS の型を対応付け、ARC が対象幅・拡大時の表示結果と入力文書・試作の版を記録する | ARC |
|
|
149
|
+
| 2. 規則検証 | QE が前節のトークン・部品・状態・アクセシビリティの適合結果を `stc-store-gui` に記録し、不適合の修正と再確認を終える | QE |
|
|
150
|
+
| 3. 利用者評価 | 店主代表・利用者代表が要件の条件で操作し、QE が測定結果、BA が受入条件との照合を `sac-usability` に記録する | QE・BA |
|
|
151
|
+
| 4. 実装への採用 | PO が前の三段階の証跡、未解決事項・仮定、残余リスクを確認し、基準版の commit と採否・理由を利用先のプロジェクト登録簿の decision(個票)に記録する。未達の必須条件があれば差し戻す | PO |
|
|
152
152
|
|
|
153
153
|
実装への採用は上記の順で判断する。試作用の実装は採用の承認を意味しない。PM は各節目の結果と未完了項目を利用先の登録簿・進捗記録へ関連付ける。
|
|
154
154
|
|
|
155
155
|
### 8.3. 変更・不適合・例外
|
|
156
156
|
|
|
157
|
-
| 区分 | 報告先・記録内容
|
|
158
|
-
| ---------- |
|
|
159
|
-
| 検証不適合 | 利用先のプロジェクト登録簿の issue に規則 ID、再現条件、試験結果を記録
|
|
160
|
-
| 規則変更 | 同登録簿の todo に対象トークン・規則、理由、影響する部品・画面・検証を記録
|
|
161
|
-
| 例外判断 |
|
|
157
|
+
| 区分 | 報告先・記録内容 | 責任と次の処理 |
|
|
158
|
+
| ---------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
|
|
159
|
+
| 検証不適合 | 利用先のプロジェクト登録簿の issue に規則 ID、再現条件、試験結果を記録 | QE が報告し、DEV が修正、QE が再確認する。PM が完了まで追跡する |
|
|
160
|
+
| 規則変更 | 同登録簿の todo に対象トークン・規則、理由、影響する部品・画面・検証を記録 | ARC が評価する。操作の意味や回復操作が変わる場合は BA が UIS も更新する。基準版の再採用は PO が判断する |
|
|
161
|
+
| 例外判断 | 同登録簿の decision に対象規則、理由、適用画面、影響、検証結果、期限を記録 | PO が採用前に承認または却下を判断し、PM が判断記録を維持する |
|
|
162
162
|
|
|
163
|
-
|
|
163
|
+
現在の例外はなし。基準版・例外の記録先は利用先のプロジェクト登録簿([[specdojo:pjr-rulebook|プロジェクト登録簿作成ルール]])の decision(個票)とする。PM は規則 ID から判断記録(個票)と元の登録項目へ相互参照を置き、承認・却下・失効の状態を追跡する。却下された案は適用せず、期限切れの例外は元の規則へ戻すか、期限前に再検証して PO の再判断を受ける。
|
|
164
164
|
|
|
165
165
|
### 8.4. 関連文書への導線
|
|
166
166
|
|
|
@@ -2,37 +2,10 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:ntp-sample
|
|
4
4
|
type: test
|
|
5
|
-
status:
|
|
5
|
+
status: deprecated
|
|
6
6
|
rulebook: specdojo:ntp-rulebook
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
# 移行テスト計画(リハーサル計画)
|
|
9
|
+
# 移行テスト計画(リハーサル計画) サンプル(非推奨)
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
本書は、移行リハーサルの実施計画を定義し、切替前に妥当性を検証するための最小サンプルである。
|
|
14
|
-
|
|
15
|
-
## 2. 入力情報
|
|
16
|
-
|
|
17
|
-
- 対象: 駄菓子屋の販売管理システム
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/ntp-rulebook.md`
|
|
20
|
-
|
|
21
|
-
## 3. 記述内容
|
|
22
|
-
|
|
23
|
-
- 主な内容: テスト範囲、シナリオ、環境、判定基準、是正計画
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
25
|
-
|
|
26
|
-
## 4. 最小記述例
|
|
27
|
-
|
|
28
|
-
| 項目 | 値 | 備考 |
|
|
29
|
-
| ------------ | ---------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | 移行テスト計画(リハーサル計画) | 最小サンプル |
|
|
31
|
-
| 目的 | 移行リハーサルの実施計画を定義し、切替前に妥当性を検証する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | テスト範囲、シナリオ、環境、判定基準、是正計画 | 要点のみ記載 |
|
|
33
|
-
|
|
34
|
-
## 5. 未解決事項
|
|
35
|
-
|
|
36
|
-
| 論点 | 処理方針 |
|
|
37
|
-
| -------------- | ------------------------ |
|
|
38
|
-
| 要件詳細の補強 | 実案件適用時に具体化する |
|
|
11
|
+
この sample は非推奨です。移行テスト計画(リハーサル計画)の完成例は [[specdojo:mtp-sample|移行テスト計画 サンプル]] を参照してください。
|