specdojo 0.4.2 → 0.4.4

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 (75) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +29 -0
  3. package/dist/catalog/build.js +15 -13
  4. package/dist/catalog/generate.js +27 -12
  5. package/dist/commands/init.js +10 -7
  6. package/dist/commands/orchestrator.js +9 -2
  7. package/dist/devcontainer/command.js +1 -1
  8. package/dist/devcontainer/scaffold.js +24 -9
  9. package/dist/docs/doc-index.js +11 -0
  10. package/dist/exec/core.js +4 -0
  11. package/dist/exec/plans-core.js +10 -1
  12. package/dist/exec/plans-generation.js +13 -0
  13. package/dist/exec/plans-storage.js +4 -0
  14. package/dist/exec/register.js +64 -6
  15. package/dist/exec/results.js +5 -1
  16. package/dist/exec/strategy.js +4 -0
  17. package/dist/kata/authoring.js +146 -0
  18. package/dist/kata/command.js +64 -2
  19. package/dist/kata/kata.js +69 -12
  20. package/dist/register/approach.js +29 -1
  21. package/dist/register/core.js +3 -3
  22. package/dist/register/create-commands.js +9 -0
  23. package/dist/register/cross-project.js +9 -2
  24. package/dist/register/external-project.js +136 -0
  25. package/dist/register/item.js +31 -5
  26. package/dist/schedule/strategy-profiles.js +3 -0
  27. package/dist/shared/agent-types.js +4 -0
  28. package/dist/shared/provider-scaffold.js +3 -3
  29. package/dist/shared/specdojo-config.js +109 -2
  30. package/dist/shared/text.js +3 -1
  31. package/docs/ja/specdojo/exec-templates/xep-recipe-authoring-template.md +45 -0
  32. package/docs/ja/specdojo/exec-templates/xep-rulebook-authoring-template.md +45 -0
  33. package/docs/ja/specdojo/exec-templates/xep-sample-authoring-template.md +45 -0
  34. package/docs/ja/specdojo/exec-templates/xep-template-authoring-template.md +45 -0
  35. package/docs/ja/specdojo/guides/docs-editing-guide.md +32 -0
  36. package/docs/ja/specdojo/guides/docs-structure-guide.md +1 -1
  37. package/docs/ja/specdojo/guides/exec-config-guide.md +13 -6
  38. package/docs/ja/specdojo/guides/kata-guide.md +6 -0
  39. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +4 -0
  40. package/docs/ja/specdojo/guides/quick-start-guide.md +352 -68
  41. package/docs/ja/specdojo/guides/register-operation-guide.md +18 -0
  42. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -2
  43. package/docs/ja/specdojo/guides/ryu-guide.md +18 -4
  44. package/docs/ja/specdojo/guides/use-case-guide.md +2 -2
  45. package/docs/ja/specdojo/references/command-reference.md +39 -20
  46. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  47. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +2 -1
  48. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +4 -0
  49. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +10 -10
  50. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +13 -13
  51. package/docs/ja/specdojo/standards/sample-authoring-standard.md +4 -4
  52. package/docs/ja/specdojo/standards/template-authoring-standard.md +4 -4
  53. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +6 -0
  54. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +6 -6
  55. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -4
  56. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +29 -0
  57. package/package.json +10 -10
  58. package/templates/antigravity/README.md +1 -1
  59. package/templates/antigravity/orchestrator.md +2 -0
  60. package/templates/antigravity/settings.global.json +5 -0
  61. package/templates/claude/README.md +11 -8
  62. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  63. package/templates/claude/settings.edit.json +10 -1
  64. package/templates/claude/settings.orchestrator.json +90 -0
  65. package/templates/claude/settings.report.json +14 -1
  66. package/templates/claude/settings.review.json +13 -1
  67. package/templates/codex/README.md +7 -5
  68. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  69. package/templates/codex/orchestrator.md +2 -0
  70. package/templates/codex/rules/specdojo.rules +48 -0
  71. package/templates/devcontainer/devcontainer.json +1 -4
  72. package/templates/opencode/README.md +2 -1
  73. package/templates/opencode/agents/opencode-executor.md +2 -0
  74. package/templates/opencode/agents/opencode-review-executor.md +2 -0
  75. package/templates/opencode/agents/specdojo-orchestrator.md +61 -5
@@ -42,7 +42,7 @@ SpecDojo は道場のメタファーとして、進め方(`approach`)を「R
42
42
 
43
43
  ### 1.1. approach の選び方
44
44
 
45
- 進め方は、まずタスクの目的で分かれ、通常の成果物作成・更新では実践の型の整備状況でさらに分かれます。`fully-guided` / `recipe-guided` / `freeform` は実践の型をどこまで基準にするかを表します。`retrofit` は実装先行時の現在動作調査、`bootstrap` / `cross-deliverable-dedup`・各 `*-maintenance`・`finalize` 系は、それぞれの目的に応じて選ぶ進め方です。
45
+ 進め方は、まずタスクの目的で分かれ、通常の成果物作成・更新では実践の型の整備状況でさらに分かれます。`fully-guided` / `recipe-guided` / `freeform` は実践の型をどこまで基準にするかを表します。`retrofit` は実装先行時の現在動作調査、`bootstrap` / `cross-deliverable-dedup`・各 `*-authoring`・各 `*-maintenance`・`finalize` 系は、それぞれの目的に応じて選ぶ進め方です。
46
46
 
47
47
  ```mermaid
48
48
  flowchart TD
@@ -56,6 +56,7 @@ flowchart TD
56
56
  FF --> W
57
57
  P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
58
58
  P -->|"成果物と実践の型を新規に一括整備"| BS["bootstrap"]
59
+ P -->|"既存成果物から実践の型だけを新規作成"| AU["各 authoring<br/>成果物 → 新しい実践の型"]
59
60
  P -->|"成果物群の重複を整理"| DD["cross-deliverable-dedup"]
60
61
  P -->|"実践の型を見直す"| MT["各 maintenance<br/>成果物 → 実践の型"]
61
62
  P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
@@ -65,7 +66,7 @@ flowchart TD
65
66
 
66
67
  ### 1.2. approach 一覧
67
68
 
68
- `approach` は、目的に応じて「成果物の作成・更新」「初期整備・実装反映・横断整理」「実践の型のメンテナンス」「human による確定」の4種に分けられます。以下の表にある edit / review は plan テンプレート、result は実行記録のテンプレートです。テンプレートには各 `approach` で行う具体的な手順が定義されています。mode や execution に対応する専用テンプレートがない場合のフォールバック規則は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照してください。
69
+ `approach` は、目的に応じて「成果物の作成・更新」「初期整備・実装反映・横断整理」「実践の型の新規作成」「実践の型のメンテナンス」「human による確定」の5種に分けられます。以下の表にある edit / review は plan テンプレート、result は実行記録のテンプレートです。テンプレートには各 `approach` で行う具体的な手順が定義されています。mode や execution に対応する専用テンプレートがない場合のフォールバック規則は [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) を参照してください。
69
70
 
70
71
  #### 1.2.1. 成果物の作成・更新
71
72
 
@@ -123,7 +124,20 @@ flowchart LR
123
124
 
124
125
  `retrofit` では、実装を現在動作(AS-IS)の根拠、既存成果物・決定記録・プロジェクトコンテキストを意図された仕様の根拠、`done_criteria` を成果物が満たすべき目的として扱います。三者が一致すれば成果物へ反映し、実装が意図された仕様と異なる場合は実装へ無条件に合わせず、乖離と修正対象候補を result に記録します。実装から確認できない目的・業務判断・将来方針は推測しません。
125
126
 
126
- #### 1.2.3. 実践の型のメンテナンス
127
+ #### 1.2.3. 実践の型の新規作成
128
+
129
+ 既存成果物を読み取り専用の手本として、指定した種類の kata だけを新規作成します。`--target` の先頭は新しい kata ID、後続は任意の手本成果物です。
130
+
131
+ | `approach` | 作る対象 | 対応テンプレート |
132
+ | -------------------- | -------- | ------------------------------------------------------------ |
133
+ | `rulebook-authoring` | rulebook | [edit](../exec-templates/xep-rulebook-authoring-template.md) |
134
+ | `recipe-authoring` | recipe | [edit](../exec-templates/xep-recipe-authoring-template.md) |
135
+ | `sample-authoring` | sample | [edit](../exec-templates/xep-sample-authoring-template.md) |
136
+ | `template-authoring` | template | [edit](../exec-templates/xep-template-authoring-template.md) |
137
+
138
+ authoring は register 専用です。Schedule の成果物単位の target では新しい kata ID と複数の手本を区別できないため、strategy profile は用意しません。
139
+
140
+ #### 1.2.4. 実践の型のメンテナンス
127
141
 
128
142
  通常の成果物作業とは参照の向きを逆にし、成果物や review result を根拠として対象の実践の型を見直します。
129
143
 
@@ -150,7 +164,7 @@ flowchart LR
150
164
 
151
165
  rulebook frontmatter で `not-needed` と宣言された型はメンテナンス対象ではなく、strategy へ対応する `*-maintenance` フェーズを生成しません。作成が必要になった場合は、先に要否判断の根拠と rulebook frontmatter の宣言を更新します。
152
166
 
153
- #### 1.2.4. human による確定
167
+ #### 1.2.5. human による確定
154
168
 
155
169
  `execution: human` と組み合わせ、確認対象の `status` を `ready` へ昇格する確定プロファイルです。`ready` への昇格は human のみが行えます。
156
170
 
@@ -76,7 +76,7 @@ flowchart TD
76
76
 
77
77
  - ゴール: 目的・スコープ・対象成果物が未確定な状態を、記録しながら決めていく。
78
78
  - 進め方: `issue` / `question` を登録し、調査のうえ `decision` で方針を確定し、`todo` で成果物カタログ作成につなげる。決定後は schedule 側で計画済み作業を管理する。
79
- - 主に使う文書: [登録簿運用ガイド](register-operation-guide.md)、[Quick Startガイド](quick-start-guide.md) の `registerで課題と判断を整理する`。
79
+ - 主に使う文書: [Quick Startガイド](quick-start-guide.md) の `registerをユースケース別に使う`、[登録簿運用ガイド](register-operation-guide.md)。
80
80
 
81
81
  ### 2.3. 既存プロダクト(文書なし)から着手する
82
82
 
@@ -96,7 +96,7 @@ flowchart TD
96
96
 
97
97
  - ゴール: agent の変更を task 単位で隔離し、成功時だけ統合する。
98
98
  - 進め方: 統合先ブランチにいることを確認し、`exec run --worktree`(または `--auto`)で実行する。段階ごとに確認する場合は分割コマンドを使う。
99
- - 主に使う文書: [Quick Startガイド](quick-start-guide.md) の `(発展)worktreeで1タスクを隔離実行する`、[exec worktree運用ガイド](exec-worktree-guide.md)、[ブランチワークフローガイド](branch-workflow-guide.md)。
99
+ - 主に使う文書: [Quick Startガイド](quick-start-guide.md) の `発展: worktreeで1タスクを隔離実行する`、[exec worktree運用ガイド](exec-worktree-guide.md)、[ブランチワークフローガイド](branch-workflow-guide.md)。
100
100
 
101
101
  ### 3.3. 対話(チャット)で運用する
102
102
 
@@ -47,7 +47,7 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
47
47
  | `project list` | 登録済み project を表示する | `specdojo project list` |
48
48
 
49
49
  `init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
50
- provider、exec、Dev Container、Git hook の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。Git hook は既定では作りません。成果物カタログは対話では質問せず、`--catalog <size>` を
50
+ provider、exec、Dev Container、Git hook の順に質問します。Dev Container を選んだ場合だけ、続けて `minimal` / `recommended` / `full` の preset を質問します(既定は `recommended`)。Git hook は既定では作りません。成果物カタログは対話では質問せず、`--catalog <size>` を
51
51
  明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
52
52
  予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
53
53
  表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
@@ -69,10 +69,12 @@ provider、exec、Dev Container、Git hook の順に質問します。Dev Contai
69
69
  | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
70
  | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
71
  | `--lefthook` | commit 前の文書・SpecDojo 検査を行う Git hook を作る | 作らない |
72
- | `--devcontainer-preset <name>` | Dev Container の preset(`recommended` / `none`)を選ぶ | `recommended` |
72
+ | `--devcontainer-preset <name>` | Dev Container の preset(`minimal` / `recommended` / `full`)を選ぶ | `recommended` |
73
73
  | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
74
74
  | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
75
75
 
76
+ `--devcontainer-preset none` は後方互換のため受け付け、`minimal` と同じ構成として扱います。
77
+
76
78
  `init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
77
79
  provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
78
80
  ID だけを `pipeline.parent_validations` へ設定し、該当する script がなければこの設定を省略します。
@@ -144,7 +146,7 @@ specdojo config scaffold --workspace --force
144
146
 
145
147
  ### 2.1. kata
146
148
 
147
- `kata` は、利用リポジトリで上書きした型(Kata)と npm package から参照中の型を確認・取得します。対象種別は rulebook / standard / recipe / sample / template です。同じ正準パスにファイルがある場合は利用リポジトリ側を優先します。
149
+ `kata` は、利用リポジトリで作成・上書きした型(Kata)と npm package から参照中の型を確認・取得します。対象種別は rulebook / standard / recipe / sample / template です。同じ正準パスにファイルがある場合は利用リポジトリ側を優先します。`kata_authority` の kata は `docs/ja/specdojo/<種類>s/<kata_authority>/` から解決し、`kata list` と `kata show` にも表示します。0.4.4 のあいだは旧 `docs/ja/kata/<種類>s/` も読み、新配置への移動案内を標準エラーへ出します。新旧に同じ ID があれば新配置を優先します。
148
150
 
149
151
  | コマンド | 用途 | 例 |
150
152
  | ---------------- | ------------------------------------------------------- | ------------------------------------------------ |
@@ -406,7 +408,7 @@ specdojo schedule strategy generate \
406
408
 
407
409
  `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 を指定します。
408
410
 
409
- `--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
411
+ `--approach` を指定する場合、通常は `--target` が 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。kata authoring だけは、1 件目を新しい kata ID、2 件目以降を任意の手本成果物 ID とします。
410
412
 
411
413
  `item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
412
414
 
@@ -416,12 +418,18 @@ specdojo schedule strategy generate \
416
418
 
417
419
  `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 を起票するときも、この関係を追跡先として使います。
418
420
 
419
- `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
421
+ `external_projects` に宣言した別名を `register add --project <別名> --commit` へ渡すと、相手のリポジトリの `node_modules/.bin/specdojo` を起動し、宣言した実 project ID で起票します。相手の登録簿の形式、名簿、`integration_branch`、commit は相手の CLI に任せ、呼び出し元は相手のファイルを直接変更しません。`--from <別名>:PJR-XXXX` は相手へ `<実 project ID>:PJR-XXXX` として渡すため、相手の CLI が存在を検証し、`derived_from` にも実 project ID が残ります。
422
+
423
+ `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にし、対象は 1 件だけです。`rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` は、1 件目を新しい kata ID、2 件目以降を手本にするカタログ成果物 ID とします。新しい ID の authority、種類別の末尾、既存 ID との重複、手本の存在を起票時と実行時に検証します。既存 ID には対応する `*-maintenance` を使います。手本の該当参照が `undecided` または未記入なら同じ実行で新 ID へ更新し、別 ID または `not-needed` なら上書きせず result へ申し送ります。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
424
+
425
+ kata authoring は register 専用です。Schedule の task は対象成果物を起点にするため、「新しい kata ID + 0 件以上の手本」という target 契約を損なわずに表現できません。strategy の phase に指定した場合は plan 生成時に停止します。
420
426
 
421
427
  記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
422
428
 
423
429
  別 project への `register add` は `--commit` が必須です。対象 project の登録簿に未 commit 変更がある場合、または統合ブランチがローカルに存在しない場合は、何も書き込まず終了コード 1 で停止します。元の worktree とブランチは変更しません。`close`、`reject` など別 project の状態遷移は受け付けず、対象 project の worktree での実行を案内します。
424
430
 
431
+ 別リポジトリへの起票も `--commit` が必須です。相手のリポジトリ、`node_modules/.bin/specdojo`、0.4.2 以上の版のいずれかを確認できない場合は、相手を変更せず停止します。相手の起票が失敗した場合は相手の標準出力・標準エラー出力と終了コードをそのまま引き継ぎ、push は行いません。外部 project の `close` などの状態遷移は委譲しないため、案内された相手のリポジトリで実行してください。
432
+
425
433
  一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
426
434
 
427
435
  `register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
@@ -977,17 +985,25 @@ specdojo orchestrator night --project prj-0001 \
977
985
 
978
986
  主要オプション:
979
987
 
980
- | オプション | 用途 |
981
- | ------------------------- | ------------------------------------------------------------ |
982
- | `--preset recommended` | 推奨のエディタ・tmux・VS Code 拡張と設定をまとめて追加する。 |
983
- | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
984
- | `--editor <names>` | `emacs,vim` のようにエディタと初期設定を追加する。 |
985
- | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
986
- | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
987
- | `--tmux` | tmux をインストールする。 |
988
- | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
989
- | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
990
- | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
988
+ | オプション | 用途 |
989
+ | ------------------------- | ------------------------------------------------------------- |
990
+ | `--preset <name>` | `minimal` / `recommended` / `full` の構成をまとめて適用する。 |
991
+ | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
992
+ | `--editor <names>` | `emacs,vim` のようにエディタと初期設定を追加する。 |
993
+ | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
994
+ | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
995
+ | `--tmux` | tmux をインストールする。 |
996
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
997
+ | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
998
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
999
+
1000
+ preset の違いは次のとおりです。preset は provider とは別に選び、個別の `--ollama`・`--cron`・`--tmux`・`--editor` を追加指定できます。
1001
+
1002
+ | preset | 内容 |
1003
+ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
1004
+ | `minimal` | 選んだ provider の CLI と SpecDojo の動作に必要な最小構成。preset を省略した場合と同じ。 |
1005
+ | `recommended` | `minimal` に `gh`、Emacs、Vim、tmux、文書作業向けの VS Code 拡張・設定を追加する。 |
1006
+ | `full` | `recommended` に ripgrep、fd、fzf、yq、shellcheck、shfmt、Ollama 接続、cron を追加する。fd は `fd-find` package から `fd` コマンドとして利用できる。 |
991
1007
 
992
1008
  ```bash
993
1009
  # claude と codex 用の CLI を含む Dev Container を生成する
@@ -996,6 +1012,9 @@ npx specdojo devcontainer scaffold --provider claude,codex
996
1012
  # SpecDojo の文書作業向けの推奨設定をまとめて追加する
997
1013
  npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
998
1014
 
1015
+ # ローカル LLM や routine を含む開発用の構成を追加する
1016
+ npx specdojo devcontainer scaffold --provider claude,codex --preset full
1017
+
999
1018
  # 追加オプションを指定する
1000
1019
  npx specdojo devcontainer scaffold --provider claude --ollama --tmux
1001
1020
 
@@ -1006,7 +1025,7 @@ npx specdojo devcontainer scaffold --provider claude --editor emacs
1006
1025
  npx specdojo devcontainer scaffold --workspace-name app1-workspace
1007
1026
  ```
1008
1027
 
1009
- `.devcontainer/` が既に存在する場合は何も書き込まず、置き換える場合だけ `--force` を指定します。上書き前や初回生成前は `--dry-run` で対象ファイルを確認してください。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存してコンテナ再作成後も利用できるようにし、ホストの認証情報・秘密鍵・`.env` を直接マウントしません。認証は生成したコンテナ内で行います。
1028
+ `.devcontainer/` が既に存在する場合は何も書き込まず、置き換える場合だけ `--force` を指定します。上書き前や初回生成前は `--dry-run` で対象ファイルを確認してください。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存してコンテナ再作成後も利用できるようにし、ホストの認証情報・秘密鍵・`.env` を直接マウントしません。認証は生成したコンテナ内で利用者が必要なときに行い、自動ログインはしません。
1010
1029
 
1011
1030
  生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を、ホスト側の親ディレクトリ名に合わせた `/workspaces/<親名>` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。例えば `app1-workspace/app1-specdojo` で scaffold すると、作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
1012
1031
 
@@ -1020,12 +1039,12 @@ Codex 自身の sandbox は引き続き使用し、`workspace-write` で許可
1020
1039
 
1021
1040
  名前付きボリュームは `<repository>-specdojo-*` という名前で生成します。`<repository>` は scaffold の対象ディレクトリ名を Docker volume 名に使える小文字へ正規化した値です。本体リポジトリや別の利用リポジトリとは共有せず、同じリポジトリの Dev Container を作り直した場合だけ再利用します。固定名を共有すればログインを使い回せますが、プロジェクトごとのアカウントを分けられず、`safe.directory` などのコンテナ固有 Git 設定も混在するため、分離を既定とします。volume 名は scaffold を実行した時点のディレクトリ名から決まり、生成した `devcontainer.json` に固定されます。後でディレクトリ名を変えても volume は変わりません。一方、別の場所にある同じディレクトリ名のリポジトリ(例: 別組織の `app`)を scaffold すると同じ volume 名になり、認証情報を共有します。分離したい場合は、生成後に `devcontainer.json` の `mounts` の `source` を一意な名前へ書き換えてください。
1022
1041
 
1023
- 保存先は次のとおりです。表の「常時」は provider の指定にかかわらず mount します。GitHub CLI の設定は `gh` を利用者が導入して使う場合に保存され、未使用時は空の volume のままです。
1042
+ 保存先は次のとおりです。表の「常時」は provider の指定にかかわらず mount します。GitHub CLI の設定と認証は `recommended` / `full` preset のときだけ保存します。
1024
1043
 
1025
1044
  | 対象 | コンテナ内の保存先 | volume 名 | 条件 |
1026
1045
  | ----------------------------- | ---------------------------------- | ------------------------------------- | ---------------------- |
1027
1046
  | コンテナ固有の Git 設定 | `/home/node/.config/git` | `<repository>-specdojo-git` | 常時 |
1028
- | GitHub CLI の設定・認証 | `/home/node/.config/gh` | `<repository>-specdojo-gh` | 常時 |
1047
+ | GitHub CLI の設定・認証 | `/home/node/.config/gh` | `<repository>-specdojo-gh` | `recommended` / `full` |
1029
1048
  | Claude Code の設定・認証 | `/home/node/.claude` | `<repository>-specdojo-claude` | `claude` provider |
1030
1049
  | Codex の設定・認証 | `/home/node/.codex` | `<repository>-specdojo-codex` | `codex` provider |
1031
1050
  | OpenCode の設定 | `/home/node/.config/opencode` | `<repository>-specdojo-opencode` | `opencode` provider |
@@ -1040,7 +1059,7 @@ OpenCode の API key は `/home/node/.local/share/opencode/auth.json` に入り
1040
1059
 
1041
1060
  post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけ、生成したテンプレートを配置します。`~/.emacs.d` ディレクトリがあれば `~/.emacs.d/init.el` へ、なければ `~/.config/emacs/init.el` へコピーし、配置先を出力します。dotfiles が設定を先に配置した場合は上書きしません。初回のコンテナ作成前に既定値を変える場合は `.devcontainer/emacs/init.el` を編集してください。作成後は出力されたコピー先を編集します。コピー先を削除しない限り、再度 post-create を実行してもテンプレートの変更は反映されません。
1042
1061
 
1043
- `--preset recommended` は、`--editor emacs,vim --tmux` 相当のツールに加え、Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML の VS Code 拡張を追加します。選択した provider が Claude Code、Codex、GitHub Copilot の場合は、その provider の拡張だけも追加します。Markdown と YAML は保存時に Prettier で整形し、`docs/specdojo/schemas/v1/` の主要な schema を SpecDojo の YAML へ関連付けます。同じ拡張は `.vscode/extensions.json` の `recommendations` にも入り、既存の recommendation は保持されます。個別の `--editor`・`--tmux` と一緒に指定した場合は両方を重複なく適用します。
1062
+ `recommended` / `full` preset は、`gh` とその認証を保存する名前付き volume、`--editor emacs,vim --tmux` 相当のツールに加え、Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML の VS Code 拡張を追加します。選択した provider が Claude Code、Codex、GitHub Copilot の場合は、その provider の拡張だけも追加します。Markdown と YAML は保存時に Prettier で整形し、`docs/specdojo/schemas/v1/` の主要な schema を SpecDojo の YAML へ関連付けます。同じ拡張は `.vscode/extensions.json` の `recommendations` にも入り、既存の recommendation は保持されます。個別の `--editor`・`--tmux` と一緒に指定した場合は両方を重複なく適用します。`minimal` または preset を指定しない場合は `gh` と認証 volume を追加しません。
1044
1063
 
1045
1064
  Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
1046
1065
 
@@ -13,7 +13,7 @@ SpecDojo Configuration Reference
13
13
 
14
14
  **対象範囲**
15
15
 
16
- - `.specdojo/specdojo.config.json` のトップレベル、project、`run`、`repos` の設定キー
16
+ - `.specdojo/specdojo.config.json` のトップレベル、project、`run`、`repos`、`external_projects` の設定キー
17
17
 
18
18
  **ここで引けるもの**
19
19
 
@@ -52,15 +52,41 @@ SpecDojo Configuration Reference
52
52
 
53
53
  ## 2. トップレベルのキー
54
54
 
55
- | キー | 必須 | 既定値 | 役割・利用箇所 |
56
- | -------------------- | ---- | -------------------------------------- | ----------------------------------------------------------------------------------------------- |
57
- | `version` | 必須 | なし。現行値は `1` | 設定形式のバージョンです。すべての config 利用コマンドが検証します。 |
58
- | `current_project` | 任意 | コマンドにより `projects` の先頭を使用 | `--project` と `SPECDOJO_PROJECT` を省略したときの対象 project です。 |
59
- | `agent_members_path` | 任意 | `.specdojo/agent-members.yaml` | 全 project が共有する保護済み agent 定義です。`.specdojo/` 配下の YAML だけを指定できます。 |
60
- | `projects` | 必須 | なし | project ID をキー、project 設定を値とするオブジェクトです。複数 project を1ファイルで扱えます。 |
55
+ | キー | 必須 | 既定値 | 役割・利用箇所 |
56
+ | -------------------- | ---- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
57
+ | `version` | 必須 | なし。現行値は `1` | 設定形式のバージョンです。すべての config 利用コマンドが検証します。 |
58
+ | `current_project` | 任意 | コマンドにより `projects` の先頭を使用 | `--project` と `SPECDOJO_PROJECT` を省略したときの対象 project です。 |
59
+ | `agent_members_path` | 任意 | `.specdojo/agent-members.yaml` | 全 project が共有する保護済み agent 定義です。`.specdojo/` 配下の YAML だけを指定できます。 |
60
+ | `kata_authority` | 任意 | リポジトリのディレクトリ名 | 利用者が新しく作る kata のリポジトリ単位の authority です。英小文字・数字・ハイフンで指定します。 |
61
+ | `projects` | 必須 | なし | project ID をキー、project 設定を値とするオブジェクトです。複数 project を1ファイルで扱えます。 |
62
+ | `external_projects` | 任意 | なし | 別リポジトリの project をローカルの別名で宣言します。`register add` と `orchestrator launch` が使用します。 |
61
63
 
62
64
  対象 project の一般的な解決順序は、`--project <id>`、`SPECDOJO_PROJECT`、`current_project`、`projects` の先頭です。一部のコマンドは `current_project` を参照せず `projects` の先頭へフォールバックするため、複数 project では `--project` を明示してください。
63
65
 
66
+ `kata_authority` は project ごとではなくリポジトリ全体で共有します。省略時は元リポジトリのディレクトリ名を小文字・ハイフン形式へ正規化した値です。worktree でも元リポジトリの名前を使います。利用者の kata は `docs/ja/specdojo/<種類>s/<kata_authority>/` 配下に置かれ、この authority の ID だけを利用者リポジトリから解決します。値は英小文字から始め、英小文字・数字・ハイフンだけを使います。project ID と区別するため `prj-` で始めず、SpecDojo 本体専用の `specdojo` も使いません。0.4.4 のあいだは旧 `docs/ja/kata/` も移行元として読みます。
67
+
68
+ ### 2.1. `external_projects`のキー
69
+
70
+ 別リポジトリの登録簿へ起票する場合は、トップレベルの `external_projects` に、呼び出し元だけで使う別名をキーとして、相手のリポジトリと project ID を宣言します。
71
+
72
+ ```json
73
+ {
74
+ "external_projects": {
75
+ "customer": {
76
+ "path": "../customer-specdojo",
77
+ "project_id": "prj-0002"
78
+ }
79
+ }
80
+ }
81
+ ```
82
+
83
+ | キー | 必須 | 役割 |
84
+ | ------------ | ---- | -------------------------------------------------------------------------- |
85
+ | `path` | 必須 | このリポジトリのルートから相手のリポジトリへの相対パスです。 |
86
+ | `project_id` | 必須 | 相手の `specdojo.config.json` の `projects` にある実際の project ID です。 |
87
+
88
+ 別名は `[a-z0-9-]+` とし、ローカルの `projects` の ID と重ねられません。`path` は存在するディレクトリでなければならず、絶対パスは使えません。起票時は相手の `node_modules/.bin/specdojo` を使うため、相手に SpecDojo 0.4.2 以上が必要です。`orchestrator launch` は `repos` に加えて、宣言したすべての外部リポジトリにも provider 別の編集許可を付けます。
89
+
64
90
  ## 3. projectのパスキー
65
91
 
66
92
  `projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
@@ -103,7 +103,7 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
103
103
 
104
104
  | `domain` | ○ | ドメイン識別子 |
105
105
  | `base_path` | 任意 | ドメインの既定ディレクトリ |
106
- | `groups` | ○ | グループ(章)の配列 |
106
+ | `groups` | ○ | グループ(章)の配列。`project` では成果物がまだない領域を空配列 `[]` で表せる |
107
107
 
108
108
  ### 5.2. `groups[]`(グループ)
109
109
 
@@ -154,6 +154,7 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
154
154
 
155
155
  ### 6.1. グループ構成
156
156
 
157
+ - `type: project` では、対象領域に成果物がまだない場合に限り、必須キーの `groups` を空配列 `[]` とする。`groups` 自体の省略や配列以外の値は認めない。テンプレートには少なくとも 1 つのグループを定義する。
157
158
  - サブドメインに分かれない場合は、単一の葉グループに `deliverables` を並べる(平坦型)。
158
159
  - サブドメインが2つ以上に分かれる場合は、親グループの `groups` 配下に子グループを並べ、各子グループに `name`・`base_path`・`deliverables` を記載する(章分割型)。
159
160
  - 親グループは `deliverables` を直接持たず、子 `groups` で表現する。
@@ -48,6 +48,8 @@ repo/apps/product-b/docs/
48
48
 
49
49
  npm package が所有する型(Kata)の文書は、利用プロジェクトの成果物と同じ Unit に展開しても所有元を識別できるよう、package ごとに定めた authority を ID の namespace として持つ。SpecDojo core の authority は `specdojo` とする。
50
50
 
51
+ Kata の配置は authority と対応させる。SpecDojo core は `docs/ja/specdojo/<種類>s/<local-id>.<拡張子>`、それ以外の authority は `docs/ja/specdojo/<種類>s/<authority>/<local-id>.<拡張子>` とする。authority はファイル名には含めず、利用者リポジトリと variant package でも同じ配置を使う。
52
+
51
53
  複数の SpecDojo Unit を横断して扱う場合は、必要に応じて Unit ID とドキュメントIDの組み合わせで識別する。
52
54
 
53
55
  ```text
@@ -144,6 +146,8 @@ specdojo:track-design-guide
144
146
 
145
147
  authority は論理的な所有元であり、ファイル名には含めない。SpecDojo core をローカルへコピーして明示的に override する場合も、同じ論理文書として同じ完全 ID を維持する。
146
148
 
149
+ `specdojo:` の文書は種類ディレクトリの直下へ置き、ほかの authority の文書は同じ種類ディレクトリの authority サブディレクトリへ置く。たとえば `customer:payment-rulebook` は `docs/ja/specdojo/rulebooks/customer/payment-rulebook.md` に置く。
150
+
147
151
  #### 3.1.4. local-id の形式
148
152
 
149
153
  `<local-id>` は次の形式を基本とする。
@@ -9,13 +9,13 @@ specdojo:
9
9
 
10
10
  Recipe Authoring Standard
11
11
 
12
- `docs/ja/specdojo/recipes/` 配下の各 `*-recipe.md` が従うべき章立て・記述ルール・禁止事項・運用ルールを定義します。成果物の構造・必須項目・禁止事項は対応する rulebook を正本とし、本書は「良い内容を書くための作り方」の記述方法を定義します。
12
+ `docs/ja/specdojo/recipes/` 直下と `docs/ja/specdojo/recipes/<authority>/` 配下の各 `*-recipe.md` が従うべき章立て・記述ルール・禁止事項・運用ルールを定義します。成果物の構造・必須項目・禁止事項は対応する rulebook を正本とし、本書は「良い内容を書くための作り方」の記述方法を定義します。
13
13
 
14
14
  ## 1. 適用範囲
15
15
 
16
- - 対象: `docs/ja/specdojo/recipes/` 配下のすべての `*-recipe.md`
16
+ - 対象: `docs/ja/specdojo/recipes/` 直下と `docs/ja/specdojo/recipes/<authority>/` 配下のすべての `*-recipe.md`
17
17
  - 目的: recipe の章構成・記述品質を統一し、書き手が良い内容を再現可能に作成できるようにする
18
- - 成果物構造の正本: 対応する `docs/ja/specdojo/rulebooks/<prefix>-rulebook.md`
18
+ - 成果物構造の正本: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
19
19
  - Frontmatter 共通原則: [document-metadata-standard.md](document-metadata-standard.md)
20
20
  - 成果物 Frontmatter の構築: template の `frontmatter_template` から構築する([document-metadata-standard.md](document-metadata-standard.md) の `生成物 Frontmatter 雛形`)。この手順を recipe 本文に複製しない。
21
21
  - 参照スキーマ: [recipe-frontmatter.schema.yaml](../../../specdojo/schemas/v1/recipe-frontmatter.schema.yaml)
@@ -36,13 +36,13 @@ Recipe Authoring Standard
36
36
  - `type` は `recipe` 固定とする。
37
37
  - 対応する成果物の根拠を示すため、`rulebook` と `sample`(存在する場合)を記載する。
38
38
 
39
- | 項目 | 必須 | 説明 |
40
- | -------- | ---- | ---------------------------------------- |
41
- | id | ○ | `specdojo:<prefix>-recipe` 形式の一意 ID |
42
- | type | ○ | `recipe` 固定 |
43
- | status | ○ | `draft` / `ready` / `deprecated` |
44
- | rulebook | ○ | 構造の正本となる rulebook の完全 ID |
45
- | sample | 任意 | 粒度・文体の参照となる sample の完全 ID |
39
+ | 項目 | 必須 | 説明 |
40
+ | -------- | ---- | ------------------------------------------------------------------------------------------------ |
41
+ | id | ○ | 同梱は `specdojo:<prefix>-recipe`、利用者作成は `<kata_authority>:<prefix>-recipe` 形式の一意 ID |
42
+ | type | ○ | `recipe` 固定 |
43
+ | status | ○ | `draft` / `ready` / `deprecated` |
44
+ | rulebook | ○ | 構造の正本となる rulebook の完全 ID |
45
+ | sample | 任意 | 粒度・文体の参照となる sample の完全 ID |
46
46
 
47
47
  ## 4. 標準章構成(`*-recipe.md`)
48
48
 
@@ -9,11 +9,11 @@ specdojo:
9
9
 
10
10
  Rulebook Authoring Standard
11
11
 
12
- `docs/ja/specdojo/rulebooks/` 配下の各 `*-rulebook.md` が従うべき章立て・記述ルール・Frontmatter 規約・禁止事項・運用ルールを定義します。Frontmatter の共通原則は [document-metadata-standard.md](document-metadata-standard.md) に従い、機械検証は参照スキーマに従います。
12
+ `docs/ja/specdojo/rulebooks/` 直下と `docs/ja/specdojo/rulebooks/<authority>/` 配下の各 `*-rulebook.md` が従うべき章立て・記述ルール・Frontmatter 規約・禁止事項・運用ルールを定義します。Frontmatter の共通原則は [document-metadata-standard.md](document-metadata-standard.md) に従い、機械検証は参照スキーマに従います。
13
13
 
14
14
  ## 1. 適用範囲
15
15
 
16
- - 対象: `docs/ja/specdojo/rulebooks/` 配下のすべての `*-rulebook.md`
16
+ - 対象: `docs/ja/specdojo/rulebooks/` 直下と `docs/ja/specdojo/rulebooks/<authority>/` 配下のすべての `*-rulebook.md`
17
17
  - 目的: 章構成・見出しレベル・記述品質・Frontmatter を統一し、参照・保守を容易にする
18
18
  - Frontmatter 共通原則: [document-metadata-standard.md](document-metadata-standard.md)
19
19
  - 参照スキーマ: [rulebook-frontmatter.schema.yaml](../../../specdojo/schemas/v1/rulebook-frontmatter.schema.yaml)
@@ -35,17 +35,17 @@ Rulebook Authoring Standard
35
35
  - `id` はauthority、英小文字・数字・ハイフンで構成し、一意にする(正確な制約は参照スキーマに従う)。
36
36
  - `status` は `draft` / `ready` / `deprecated` のいずれかとする。
37
37
 
38
- | 項目 | 必須 | 説明 |
39
- | ------------- | ---- | -------------------------------------------------------------- |
40
- | id | ○ | `specdojo:<prefix>-rulebook` 形式の一意 ID |
41
- | type | ○ | `rulebook` 固定 |
42
- | status | ○ | `draft` / `ready` / `deprecated` |
43
- | target_format | 任意 | 対象ドキュメントのフォーマット(`yaml` / `json` / `markdown`) |
44
- | recipe | 任意 | 対応する recipe の完全 ID、`undecided`、`not-needed` |
45
- | sample | 任意 | 対応する sample の完全 ID または ID 配列、上記2状態 |
46
- | template | 任意 | 対応する template の完全 ID、`undecided`、`not-needed` |
47
- | based_on | 任意 | 上位規約や根拠ドキュメント |
48
- | supersedes | 任意 | 置き換え関係 |
38
+ | 項目 | 必須 | 説明 |
39
+ | ------------- | ---- | ---------------------------------------------------------------------------------------------------- |
40
+ | id | ○ | 同梱は `specdojo:<prefix>-rulebook`、利用者作成は `<kata_authority>:<prefix>-rulebook` 形式の一意 ID |
41
+ | type | ○ | `rulebook` 固定 |
42
+ | status | ○ | `draft` / `ready` / `deprecated` |
43
+ | target_format | 任意 | 対象ドキュメントのフォーマット(`yaml` / `json` / `markdown`) |
44
+ | recipe | 任意 | 対応する recipe の完全 ID、`undecided`、`not-needed` |
45
+ | sample | 任意 | 対応する sample の完全 ID または ID 配列、上記2状態 |
46
+ | template | 任意 | 対応する template の完全 ID、`undecided`、`not-needed` |
47
+ | based_on | 任意 | 上位規約や根拠ドキュメント |
48
+ | supersedes | 任意 | 置き換え関係 |
49
49
 
50
50
  - `target_format` が未記載の場合は markdown を対象とみなす。
51
51
  - `recipe` / `sample` / `template` は要否と所在の正本であり、`undecided` は要否未判断、項目省略は必要だが未整備、完全 ID は必要かつ整備済み、`not-needed` は不要を表す。
@@ -9,13 +9,13 @@ specdojo:
9
9
 
10
10
  Sample Authoring Standard
11
11
 
12
- `docs/ja/specdojo/samples/` 配下の各 `*-sample.(md|yaml|json)` が従うべき構成・記述ルール・禁止事項・運用ルールを定義します。Frontmatter(メタ情報)の規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では扱いません。
12
+ `docs/ja/specdojo/samples/` 直下と `docs/ja/specdojo/samples/<authority>/` 配下の各 `*-sample.(md|yaml|json)` が従うべき構成・記述ルール・禁止事項・運用ルールを定義します。Frontmatter(メタ情報)の規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では扱いません。
13
13
 
14
14
  ## 1. 適用範囲
15
15
 
16
- - 対象: `docs/ja/specdojo/samples/` 配下のすべての `*-sample.(md|yaml|json)`
16
+ - 対象: `docs/ja/specdojo/samples/` 直下と `docs/ja/specdojo/samples/<authority>/` 配下のすべての `*-sample.(md|yaml|json)`
17
17
  - 目的: sample の構成・記述品質を統一し、粒度・文体・表の書き方を確認できる完成最小例を提供する
18
- - 一次根拠: 対応する `docs/ja/specdojo/rulebooks/<prefix>-rulebook.md`
18
+ - 一次根拠: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
19
19
  - Frontmatter 規約の正本: [document-metadata-standard.md](document-metadata-standard.md)
20
20
  - ファイル名・ID 規則: [docs-structure-guide.md](../guides/docs-structure-guide.md)
21
21
 
@@ -93,7 +93,7 @@ sample は実在プロジェクトの記録ではありません。記載値は
93
93
  | 金森鉄子 | 60 | 女 | 店舗運営アドバイザー | 店舗運用、引継ぎ、障害時対応、継続運用の観点から助言する | `operations-advisor` | 金森金物店の店主。しっかり者で面倒見がよく、算野家を支援する |
94
94
  | 春野さくら | 24 | 女 | 家族利用者代表 | 家族による店番や、子どもにも分かりやすい利用方法の観点を提供する | `family-user-representative` | 創太のいとこ。保育士で明るく優しい性格を持ち、子どもたちから親しまれている |
95
95
 
96
- 人物名はこの共通人物台帳と物語文書だけで管理し、`docs/ja/specdojo/samples/` 配下の sample には記載しません。各 sample では対象成果物に関係する人物だけを、次の識別方法で記述します。
96
+ 人物名はこの共通人物台帳と物語文書だけで管理し、`docs/ja/specdojo/samples/` 直下または `docs/ja/specdojo/samples/<authority>/` 配下の sample には記載しません。各 sample では対象成果物に関係する人物だけを、次の識別方法で記述します。
97
97
 
98
98
  - 本文、表の表示名、ステークホルダー名には「店主代表」「開発担当」「利用者代表」などの役割名を使用する。
99
99
  - Member や実行主体の安定識別子が必要な項目には、表に定義した役割ベースの `nickname` を使用する。
@@ -9,14 +9,14 @@ specdojo:
9
9
 
10
10
  Template Authoring Standard
11
11
 
12
- `docs/ja/specdojo/templates/` 配下の成果物テンプレートが従うべき構成・プレースホルダ規約・禁止事項・運用ルールを定義します。プレースホルダを埋めた結果が満たすべき Frontmatter 規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では雛形側の記述方法を定義します。
12
+ `docs/ja/specdojo/templates/` 直下と `docs/ja/specdojo/templates/<authority>/` 配下の成果物テンプレートが従うべき構成・プレースホルダ規約・禁止事項・運用ルールを定義します。プレースホルダを埋めた結果が満たすべき Frontmatter 規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では雛形側の記述方法を定義します。
13
13
 
14
14
  ## 1. 適用範囲
15
15
 
16
- - 対象: `docs/ja/specdojo/templates/` 配下のすべての成果物テンプレート `*-template.(md|yaml)`
16
+ - 対象: `docs/ja/specdojo/templates/` 直下と `docs/ja/specdojo/templates/<authority>/` 配下のすべての成果物テンプレート `*-template.(md|yaml)`
17
17
  - 対象外: `docs/ja/specdojo/exec-templates/` 配下の plan / result 生成用内部テンプレート。rulebook から宣言される実践の型ではなく、生成処理が消費する実行基盤の部品として [plan/result ライフサイクルガイド](../guides/plan-result-lifecycle-guide.md) に従う
18
18
  - 目的: テンプレートの構成・プレースホルダ記法を統一し、同じ rulebook 系統の成果物へ再利用できる雛形を提供する
19
- - 成果物の意味要件の正本: 対応する `docs/ja/specdojo/rulebooks/<prefix>-rulebook.md`
19
+ - 成果物の意味要件の正本: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
20
20
  - 見出し・キー・記入欄の骨組みの正本: rulebook frontmatter が文書 ID で宣言する template
21
21
  - 完成後の Frontmatter 規約の正本: [document-metadata-standard.md](document-metadata-standard.md)
22
22
  - ファイル名・ID 規則: [docs-structure-guide.md](../guides/docs-structure-guide.md)
@@ -26,7 +26,7 @@ Template Authoring Standard
26
26
  - ファイル名は `<prefix>-template.md` / `<prefix>-template.yaml` とし、対応 rulebook の `target_format` に合わせる。
27
27
  - Markdown テンプレートは、対応 rulebook の本文要件を満たす見出し構成を持つ。見出しの順序と記入欄は template を正本とし、rulebook 本文へ同じ骨組みを転載しない。
28
28
  - YAML テンプレートは、対象成果物のルートキー・必須キー・型を雛形として示す。
29
- - テンプレートファイル自身の Frontmatter も `specdojo:` 名前空間配下に実値で記述する(`specdojo.id: specdojo:<prefix>-template`、`specdojo.type: template`、`specdojo.status: draft`)。生成物の Frontmatter は自身 Frontmatter とは別に表現する。Markdown 成果物テンプレートは、[document-metadata-standard.md](document-metadata-standard.md) の `テンプレート自身のメタ情報と生成物 Frontmatter の分離` に従い、`specdojo:` 配下の `frontmatter_template` フィールドに `specdojo:` ラッパー込みの生成物 Frontmatter を記述する。
29
+ - テンプレートファイル自身の Frontmatter も `specdojo:` 名前空間配下に実値で記述する。`specdojo.id` は同梱なら `specdojo:<prefix>-template`、利用者作成なら `<kata_authority>:<prefix>-template` とし、`specdojo.type: template`、`specdojo.status: draft` を記述する。生成物の Frontmatter は自身 Frontmatter とは別に表現する。Markdown 成果物テンプレートは、[document-metadata-standard.md](document-metadata-standard.md) の `テンプレート自身のメタ情報と生成物 Frontmatter の分離` に従い、`specdojo:` 配下の `frontmatter_template` フィールドに `specdojo:` ラッパー込みの生成物 Frontmatter を記述する。
30
30
  - YAML テンプレートも自身のメタ情報(`id` / `type` / `status` / `title` / `rulebook`)をトップレベルに実値で記述する。YAML catalog(`dct-*`)を除き、生成物のメタ情報はトップレベルの `metadata_template` フィールドに記述する([document-metadata-standard.md](document-metadata-standard.md) の `生成物メタ情報雛形(metadata_template)`)。
31
31
 
32
32
  ## 3. プレースホルダ規約
@@ -52,6 +52,10 @@ $defs:
52
52
  "recipe-guided",
53
53
  "freeform",
54
54
  "bootstrap",
55
+ "rulebook-authoring",
56
+ "recipe-authoring",
57
+ "sample-authoring",
58
+ "template-authoring",
55
59
  "retrofit",
56
60
  "cross-deliverable-dedup",
57
61
  "rulebook-maintenance",
@@ -67,6 +71,8 @@ $defs:
67
71
  a deliverable. bootstrap authors the deliverable and its full reference set
68
72
  (rulebook/recipe/sample/template) together in one task as a mutually consistent whole;
69
73
  it is used to initially establish a deliverable and its reference materials.
74
+ The *-authoring values create one new kata from optional read-only exemplar deliverables;
75
+ they are register-only because their ordered target contract is not available to schedule.
70
76
  retrofit reads implementation evidence declared by the catalog and reflects the verified
71
77
  current behavior into an existing or newly created deliverable without treating the
72
78
  implementation as the unconditional source of intended behavior.
@@ -110,12 +110,12 @@ properties:
110
110
  minLength: 1
111
111
  minItems: 1
112
112
  description: >
113
- Doc ids of the documents this task targets, each resolvable via the doc index.
114
- The first entry is the target deliverable (project-qualified doc id,
115
- <project-id>:<local_id>). Subsequent entries are reference materials
116
- (rulebook/recipe/sample/template doc ids) the approach may modify or confirm
117
- (bootstrap, bootstrap-finalize, *-maintenance). Unresolvable reference
118
- materials are omitted.
113
+ Doc ids of the documents this task targets. Existing documents are resolvable via the
114
+ doc index. For deliverable work, the first entry is the target deliverable and subsequent
115
+ entries are reference materials the approach may modify or confirm. For *-authoring
116
+ register tasks, the first entry is an intentionally not-yet-existing kata id and
117
+ subsequent entries are read-only exemplar deliverables. Unresolvable reference materials
118
+ are omitted.
119
119
 
120
120
  paths:
121
121
  type: array
@@ -56,7 +56,20 @@ properties:
56
56
  targets:
57
57
  type: array
58
58
  minItems: 1
59
- maxItems: 1
59
+ allOf:
60
+ - if:
61
+ properties:
62
+ approach:
63
+ enum:
64
+ - rulebook-authoring
65
+ - recipe-authoring
66
+ - sample-authoring
67
+ - template-authoring
68
+ else:
69
+ properties:
70
+ targets:
71
+ type: array
72
+ maxItems: 1
60
73
  - type: object
61
74
  required:
62
75
  - rulebook
@@ -186,9 +199,9 @@ properties:
186
199
  approach:
187
200
  $ref: "#/$defs/Approach"
188
201
  description: >
189
- Execution approach for the single target. When present, targets must
190
- contain exactly one document id whose kind is compatible with the
191
- approach.
202
+ Execution approach. Authoring approaches use the first target as the new kata id
203
+ and any remaining targets as exemplar deliverables. Other approaches require one
204
+ compatible document id.
192
205
 
193
206
  targets:
194
207
  type: array
@@ -264,6 +277,10 @@ $defs:
264
277
  - recipe-guided
265
278
  - freeform
266
279
  - bootstrap
280
+ - rulebook-authoring
281
+ - recipe-authoring
282
+ - sample-authoring
283
+ - template-authoring
267
284
  - retrofit
268
285
  - cross-deliverable-dedup
269
286
  - rulebook-maintenance