specdojo 0.4.4 → 0.4.6
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 +4 -4
- package/CHANGELOG.md +31 -0
- package/dist/commands/init.js +33 -7
- package/dist/devcontainer/scaffold.js +5 -1
- package/dist/exec/evidence.js +35 -3
- package/dist/exec/pipeline-state.js +1 -0
- package/dist/exec/plans-core.js +18 -2
- package/dist/exec/plans-generation.js +1 -1
- package/dist/exec/register-resume.js +8 -4
- package/dist/exec/register.js +47 -14
- package/dist/exec/reporter.js +8 -1
- package/dist/exec/results.js +1 -1
- package/dist/exec/run/agent-pipeline.js +7 -5
- package/dist/exec/run/agent.js +14 -1
- package/dist/exec/run/in-place.js +7 -4
- package/dist/exec/run/register-core.js +10 -2
- package/dist/exec/run/register-resume.js +1 -0
- package/dist/exec/run/register-worktree.js +7 -1
- package/dist/exec/task-repos.js +11 -0
- package/dist/exec/worktree-ops-lifecycle.js +4 -2
- package/dist/kata/command.js +54 -9
- package/dist/register/approach.js +13 -12
- package/dist/register/authoring-sources.js +132 -0
- package/dist/register/core.js +1 -0
- package/dist/register/create-commands.js +84 -15
- package/dist/register/events.js +2 -0
- package/dist/register/external-project.js +29 -8
- package/dist/register/item.js +6 -0
- package/dist/register/renumber.js +3 -3
- package/dist/register/views.js +3 -0
- package/dist/shared/git.js +3 -2
- package/dist/shared/lefthook-scaffold.js +5 -22
- package/dist/shared/markdownlint-scaffold.js +67 -0
- package/dist/shared/provider-scaffold.js +2 -2
- package/dist/shared/slidev-scaffold.js +102 -0
- package/dist/shared/specdojo-config.js +9 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-authoring-template.md +7 -7
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +5 -4
- package/docs/ja/specdojo/exec-templates/xep-rulebook-authoring-template.md +7 -7
- package/docs/ja/specdojo/exec-templates/xep-sample-authoring-template.md +7 -7
- package/docs/ja/specdojo/exec-templates/xep-template-authoring-template.md +7 -7
- package/docs/ja/specdojo/guides/exec-config-guide.md +46 -16
- package/docs/ja/specdojo/guides/kata-guide.md +111 -2
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -6
- package/docs/ja/specdojo/guides/quick-start-guide.md +4 -2
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
- package/docs/ja/specdojo/references/command-reference.md +155 -59
- package/docs/ja/specdojo/references/specdojo-config-reference.md +2 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +4 -3
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +3 -3
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +31 -3
- package/package.json +8 -7
- package/templates/antigravity/orchestrator.md +4 -4
- package/templates/claude/README.md +2 -0
- package/templates/claude/agents/specdojo-orchestrator.md +4 -4
- package/templates/codex/README.md +38 -9
- package/templates/codex/agents/codex-executor.toml +1 -1
- package/templates/codex/agents/codex-expert-executor.toml +1 -1
- package/templates/codex/agents/codex-expert-review-executor.toml +1 -1
- package/templates/codex/agents/codex-review-executor.toml +1 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +5 -5
- package/templates/codex/orchestrator.md +4 -4
- package/templates/init-agent-members.yaml +85 -13
- package/templates/opencode/agents/specdojo-orchestrator.md +4 -4
|
@@ -38,16 +38,16 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
|
|
|
38
38
|
|
|
39
39
|
## 2. init / config / project
|
|
40
40
|
|
|
41
|
-
| コマンド | 用途
|
|
42
|
-
| ------------------------ |
|
|
43
|
-
| `init` | project から agent 実行までを質問式で初期設定する
|
|
44
|
-
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する
|
|
45
|
-
| `config migrate-members` | agent 定義を保護設定へ移す
|
|
46
|
-
| `config scaffold` | provider、VS Code ワークスペース、Git hook を個別に配置する | `specdojo config scaffold --
|
|
47
|
-
| `project list` | 登録済み project を表示する
|
|
41
|
+
| コマンド | 用途 | 例 |
|
|
42
|
+
| ------------------------ | ------------------------------------------------------------------- | ------------------------------------------- |
|
|
43
|
+
| `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
|
|
44
|
+
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
|
|
45
|
+
| `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
|
|
46
|
+
| `config scaffold` | provider、VS Code ワークスペース、Git hook、Slidev を個別に配置する | `specdojo config scaffold --slidev` |
|
|
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 を選んだ場合だけ、続けて `minimal` / `recommended` / `full` の preset を質問します(既定は `recommended`)。Git hook
|
|
50
|
+
provider、exec、Dev Container、Git hook、Slidev の順に質問します。Dev Container を選んだ場合だけ、続けて `minimal` / `recommended` / `full` の preset を質問します(既定は `recommended`)。Git hook は既定では作りません。Slidev の質問は `full` を選んだ場合だけ既定が「はい」、それ以外は「いいえ」です。成果物カタログは対話では質問せず、`--catalog <size>` を
|
|
51
51
|
明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
|
|
52
52
|
予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
|
|
53
53
|
表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
|
|
@@ -56,24 +56,30 @@ provider、exec、Dev Container、Git hook の順に質問します。Dev Contai
|
|
|
56
56
|
|
|
57
57
|
非対話環境では質問せず、次の主要オプションと既定値を使います。
|
|
58
58
|
|
|
59
|
-
| オプション | 用途 | 既定値
|
|
60
|
-
| ------------------------------ | ------------------------------------------------------------------------- |
|
|
61
|
-
| `--yes` | 質問せず既定値と指定済みオプションで実行する | -
|
|
62
|
-
| `--project <id>` | project ID | `prj-0001`
|
|
63
|
-
| `--name <name>` | project の表示名 | `My Project`
|
|
64
|
-
| `--no-register` | register を作らない | register を作る
|
|
65
|
-
| `--nickname <nickname>` | 人の名簿に書く nickname | `owner`
|
|
66
|
-
| `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner`
|
|
67
|
-
| `--provider <names>` | provider をカンマ区切りで指定する | `codex`
|
|
68
|
-
| `--exec` | executor / reporter の名簿と起動設定を作る | 作らない
|
|
69
|
-
| `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない
|
|
70
|
-
| `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない
|
|
71
|
-
| `--lefthook` | commit 前の文書・SpecDojo 検査を行う Git hook を作る | 作らない
|
|
72
|
-
| `--
|
|
73
|
-
| `--
|
|
74
|
-
| `--
|
|
59
|
+
| オプション | 用途 | 既定値 |
|
|
60
|
+
| ------------------------------ | ------------------------------------------------------------------------- | --------------------- |
|
|
61
|
+
| `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
|
|
62
|
+
| `--project <id>` | project ID | `prj-0001` |
|
|
63
|
+
| `--name <name>` | project の表示名 | `My Project` |
|
|
64
|
+
| `--no-register` | register を作らない | register を作る |
|
|
65
|
+
| `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
|
|
66
|
+
| `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
|
|
67
|
+
| `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
|
|
68
|
+
| `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
|
|
69
|
+
| `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
|
|
70
|
+
| `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
|
|
71
|
+
| `--lefthook` | commit 前の文書・SpecDojo 検査を行う Git hook を作る | 作らない |
|
|
72
|
+
| `--slidev` | Slidev 本体と kata 用の整形・検査設定を追加する | `full` の場合だけ追加 |
|
|
73
|
+
| `--no-slidev` | `full` を選んだ場合も Slidev の追加を解除する | - |
|
|
74
|
+
| `--devcontainer-preset <name>` | Dev Container の preset(`minimal` / `recommended` / `full`)を選ぶ | `recommended` |
|
|
75
|
+
| `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
|
|
76
|
+
| `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
|
|
75
77
|
|
|
76
78
|
`--devcontainer-preset none` は後方互換のため受け付け、`minimal` と同じ構成として扱います。
|
|
79
|
+
`init --yes --devcontainer --devcontainer-preset full` は Slidev も追加します。Dev Container の
|
|
80
|
+
`full` は VS Code 拡張 `antfu.slidev` も含み、`minimal` / `recommended` は含みません。
|
|
81
|
+
拡張の選択とリポジトリの npm・整形設定は独立しているため、`--no-slidev` は拡張を外しません。
|
|
82
|
+
`devcontainer scaffold --preset full` 単体では npm・整形設定を変更しません。
|
|
77
83
|
|
|
78
84
|
`init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
|
|
79
85
|
provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
|
|
@@ -95,7 +101,7 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
|
|
|
95
101
|
書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
|
|
96
102
|
`antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
|
|
97
103
|
|
|
98
|
-
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-
|
|
104
|
+
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
|
|
99
105
|
|
|
100
106
|
`antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
|
|
101
107
|
|
|
@@ -106,8 +112,65 @@ specdojo config scaffold --provider antigravity --global
|
|
|
106
112
|
|
|
107
113
|
`--force` はリポジトリ内の scaffold ファイルだけを上書きし、グローバル設定の既存項目は上書きしません。従来の `exec scaffold --provider antigravity` でも同じ `--global` / `--dry-run` の挙動を利用できます。
|
|
108
114
|
|
|
109
|
-
`config scaffold --
|
|
110
|
-
|
|
115
|
+
`config scaffold --slidev` は、`@slidev/cli`・`prettier-plugin-slidev`・`prettier` の不足する
|
|
116
|
+
devDependencies を表示してから `package.json` へ追加し、未作成なら `.prettierrc` と
|
|
117
|
+
`.markdownlintignore`、基本設定の `.markdownlintrc`、VS Code 向けの `.markdownlint-cli2.yaml` を作ります。
|
|
118
|
+
既存の dependencies / devDependencies の同名項目は維持し、
|
|
119
|
+
`package.json` がない場合は追加例だけを表示します。依存のインストールは利用者が `npm install` で行います。
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
specdojo init --yes --slidev
|
|
123
|
+
# 初期設定済みのリポジトリに追加する場合
|
|
124
|
+
specdojo config scaffold --slidev --dry-run
|
|
125
|
+
specdojo config scaffold --slidev
|
|
126
|
+
npm install
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
既定で整形・検査設定の対象にするのは、次の Slidev 用命名の kata だけです。
|
|
130
|
+
|
|
131
|
+
- `docs/ja/specdojo/samples/**/*-slidev-sample.md`
|
|
132
|
+
- `docs/ja/specdojo/templates/**/*-slidev-template.md`
|
|
133
|
+
|
|
134
|
+
Prettier の overrides 内で `parser: slidev` と plugin を指定します。同じパスを
|
|
135
|
+
`.markdownlint-cli2.yaml` の `overrides` では Slidev 用の規則で検査し、`.markdownlintignore` では
|
|
136
|
+
markdownlint-cli の対象外にします。通常の Markdown には基本設定を当てます。
|
|
137
|
+
既存の `lsd-sample.md` など別名のスライドは、実際のパスを Prettier の `files`、CLI2 の `filter`、
|
|
138
|
+
ignore の 3 か所にそろえて追加してください。
|
|
139
|
+
markdownlint-cli2 は最初に一致した override だけを使うため Slidev 用を先頭に、Prettier は後の一致が
|
|
140
|
+
優先されるため Slidev 用を末尾に置きます。CLI2 の追加例は次の形です。
|
|
141
|
+
|
|
142
|
+
```yaml
|
|
143
|
+
config:
|
|
144
|
+
extends: .markdownlintrc
|
|
145
|
+
overrides:
|
|
146
|
+
- filter:
|
|
147
|
+
- docs/ja/specdojo/samples/**/*-slidev-sample.md
|
|
148
|
+
- docs/ja/specdojo/templates/**/*-slidev-template.md
|
|
149
|
+
combine: merge
|
|
150
|
+
config:
|
|
151
|
+
MD001: false
|
|
152
|
+
MD022: false
|
|
153
|
+
MD025: false
|
|
154
|
+
MD031: false
|
|
155
|
+
MD032: false
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
スライドごとの見出しレベル・H1 と、ページ区切りやページごとの frontmatter に隣接する見出し・
|
|
159
|
+
コード・リストを許すため、この 5 規則を外します。ほかの規則は基本設定を引き継ぎます。
|
|
160
|
+
`.prettierrc`(別拡張子や `prettier.config.*`、`package.json` の `prettier` 設定を含む)と
|
|
161
|
+
`.markdownlintignore`、既存の `.markdownlint.*`・`.markdownlintrc`・`.markdownlint-cli2.*` は
|
|
162
|
+
`--force` を付けても保持し、手で統合する設定例を表示します。既存の設定と競合する場合は新規設定も
|
|
163
|
+
自動作成せず、不足する設定と移行方法を表示します。
|
|
164
|
+
`--lefthook --slidev` の同時指定では、新規の ignore に agent 定義とスライドの両方の除外を含めます。
|
|
165
|
+
`--dry-run` は内容を表示するだけで書き込みません。指定しなければ Slidev の依存・設定は追加しません。
|
|
166
|
+
|
|
167
|
+
テーマと活動固有のコンポーネント・素材は利用者が用意します。kata の sample を
|
|
168
|
+
`./node_modules/.bin/slidev build <sample.md> --out "$PWD/tmp/slidev-dist"` で検証する手順と、
|
|
169
|
+
テーマ・部品の配置方法は [[specdojo:kata-guide|実践の型活用ガイド]] の「Slidev の kata を検証する」を参照してください。
|
|
170
|
+
|
|
171
|
+
`config scaffold --lefthook`(`init --lefthook` も同様)は、利用リポジトリに `lefthook.yml`、
|
|
172
|
+
`.markdownlintrc`、`.markdownlint-cli2.yaml`、`.markdownlintignore`、
|
|
173
|
+
依存なしで起動できる `tools/install-lefthook.mjs` と
|
|
111
174
|
`tools/specdojo-pre-commit.mjs` を生成します。pre-commit では staged の Markdown と YAML だけを
|
|
112
175
|
Prettier で整形し、staged の Markdown だけを markdownlint で検査します。
|
|
113
176
|
また、`.specdojo/specdojo.config.json` の `project_register_path` 配下に staged の変更がある project では
|
|
@@ -132,6 +195,30 @@ devDependencies は `--force` を指定しても保持します。`package.json`
|
|
|
132
195
|
`node tools/install-lefthook.mjs` を実行してください。hook 内から Git を呼ぶ入口は `GIT_DIR` などの
|
|
133
196
|
repository-local 環境変数を除いてから staged files を調べます。
|
|
134
197
|
|
|
198
|
+
生成する設定と道具の対応は次のとおりです。CLI2 本体は開発依存に追加しません。
|
|
199
|
+
|
|
200
|
+
| 設定 | 読む道具と役割 |
|
|
201
|
+
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
202
|
+
| `.markdownlintrc` | markdownlint-cli(commit hook と exec run の result 検査)が読む基本設定。`MD013: false` などを指定した、先頭が `{` の JSON |
|
|
203
|
+
| `.markdownlint-cli2.yaml` | VS Code の markdownlint 拡張と markdownlint-cli2 用。`config.extends` で `.markdownlintrc` を読み、`overrides` でファイル別に調整 |
|
|
204
|
+
| `.markdownlintignore` | markdownlint-cli 用。agent 定義や Slidev の kata を hook・result 検査の対象外にする。CLI2 と VS Code の拡張は読まない |
|
|
205
|
+
|
|
206
|
+
以前の scaffold が生成した `.markdownlint.jsonc` などが残っていると、VS Code で CLI2 の
|
|
207
|
+
`overrides` が効きません。既存リポジトリは次の手順で移行してください。
|
|
208
|
+
|
|
209
|
+
1. `.markdownlint.jsonc` / `.json` / `.yaml` / `.yml` の既存規則を `.markdownlintrc` に移します。
|
|
210
|
+
YAML は JSON に変換し、コメントを除いて、ファイルの先頭を `{` にします。
|
|
211
|
+
既存の `.markdownlintrc` があれば規則を統合します。
|
|
212
|
+
2. 移した旧 `.markdownlint.*` を取り除きます。対象ファイルの親ディレクトリにある設定も確認してください。
|
|
213
|
+
3. 既存の `.markdownlint-cli2.*` があればそのファイルへ、なければ `.markdownlint-cli2.yaml` へ、
|
|
214
|
+
上例の `config.extends: .markdownlintrc` を設定します。相対パスは CLI2 設定ファイルからの位置に合わせます。
|
|
215
|
+
`--slidev` が表示した override は先頭に統合します。
|
|
216
|
+
4. Prettier の Slidev override は末尾へ置き、`.markdownlintignore` と CLI2 の `filter` を同じ glob にそろえます。
|
|
217
|
+
VS Code でスライドと通常の文書を開き、hook と result 検査でも基本設定が効くことを確認してください。
|
|
218
|
+
|
|
219
|
+
scaffold は `--force` でもこの移行を自動実行しません。Slidev のビルド・表示の検証手順は
|
|
220
|
+
[[specdojo:kata-guide|実践の型活用ガイド]] を参照してください。
|
|
221
|
+
|
|
135
222
|
`config scaffold --workspace` は、`.specdojo/specdojo.config.json` の `repos` 宣言から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)をリポジトリルートに生成します。`folders` にはプロジェクトリポジトリ(`.`)と各プロダクトリポジトリ(`repos[].path`)を宣言順に並べ、別リポジトリ構成でも 1 つの VS Code ウィンドウでプロジェクトとプロダクトを同時に開けます。`--project <id>` で対象 project を指定でき、省略時は `current_project` を使います。既存のファイルは `--force` を指定しない限り上書きしません。`repos` が宣言されていない project ではエラーになります。`--dry-run` は書き込まず予定の内容だけを表示します。
|
|
136
223
|
|
|
137
224
|
```bash
|
|
@@ -148,13 +235,13 @@ specdojo config scaffold --workspace --force
|
|
|
148
235
|
|
|
149
236
|
`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 があれば新配置を優先します。
|
|
150
237
|
|
|
151
|
-
| コマンド | 用途
|
|
152
|
-
| ---------------- |
|
|
153
|
-
| `kata list` | kata を解決元と eject 可否つきで一覧表示
|
|
154
|
-
| `kata show <id>` | 解決順序に従って kata の内容を表示
|
|
155
|
-
| `kata status` | 参照中 / eject 済みと package 原本との差分を表示
|
|
156
|
-
| `kata eject` | package の
|
|
157
|
-
| `kata install` | eject 可能な全種別を利用リポジトリへコピー
|
|
238
|
+
| コマンド | 用途 | 例 |
|
|
239
|
+
| ---------------- | ------------------------------------------------ | ------------------------------------------------ |
|
|
240
|
+
| `kata list` | kata を解決元と eject 可否つきで一覧表示 | `specdojo kata list --all` |
|
|
241
|
+
| `kata show <id>` | 解決順序に従って kata の内容を表示 | `specdojo kata show specdojo:pjr-rulebook` |
|
|
242
|
+
| `kata status` | 参照中 / eject 済みと package 原本との差分を表示 | `specdojo kata status --kind template` |
|
|
243
|
+
| `kata eject` | package の kata と付属ファイルを正準パスへコピー | `specdojo kata eject --id specdojo:pjr-rulebook` |
|
|
244
|
+
| `kata install` | eject 可能な全種別を利用リポジトリへコピー | `specdojo kata install --all --dry-run` |
|
|
158
245
|
|
|
159
246
|
主要オプション:
|
|
160
247
|
|
|
@@ -171,6 +258,10 @@ specdojo config scaffold --workspace --force
|
|
|
171
258
|
|
|
172
259
|
`eject` と `install --all` は既存ファイルを `--force` なしで上書きせず、`skip` として表示します。CLI と同じバージョンで使う必要がある `exec-templates` と `schemas` は個別 eject の対象外で、指定すると参照固定である旨を表示して終了コード 1 で終わります。`install --all` は docs サイト配信やオフライン運用向けの明示的な全量取得であり、通常のセットアップ導線では使用しません。
|
|
173
260
|
|
|
261
|
+
付属ファイルは一覧の kata に数えず、`eject`・`install --all` で本体と一緒にコピーします。
|
|
262
|
+
付属ファイルだけの差分も、eject 済みの親 kata の `modified` に含めます。対象形式と付属ファイルの
|
|
263
|
+
命名・配置・dry-run の詳細は [[specdojo:kata-guide|実践の型活用ガイド]] の「kata の付属ファイル」を参照してください。
|
|
264
|
+
|
|
174
265
|
## 3. catalog / deliverable
|
|
175
266
|
|
|
176
267
|
`catalog` は成果物カタログ(`dct-*.yaml`)を扱います。
|
|
@@ -382,33 +473,34 @@ specdojo schedule strategy generate \
|
|
|
382
473
|
|
|
383
474
|
主要オプション:
|
|
384
475
|
|
|
385
|
-
| オプション | 用途
|
|
386
|
-
| ------------------------- |
|
|
387
|
-
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する
|
|
388
|
-
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻
|
|
389
|
-
| `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻
|
|
390
|
-
| `--by <actor>` | 名簿または予約一覧の actor を追記型 event に記録する
|
|
391
|
-
| `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新)
|
|
392
|
-
| `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除)
|
|
393
|
-
| `--block-reason <text>` | `waiting` の理由を更新(`-` で削除)
|
|
394
|
-
| `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除)
|
|
395
|
-
| `--target <doc-id>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除)
|
|
396
|
-
| `--
|
|
397
|
-
| `--
|
|
398
|
-
|
|
|
399
|
-
| `--
|
|
400
|
-
| `--
|
|
401
|
-
| `--
|
|
402
|
-
| `--
|
|
403
|
-
| `--
|
|
404
|
-
| `--
|
|
405
|
-
| `--
|
|
476
|
+
| オプション | 用途 | 対象 |
|
|
477
|
+
| ------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ |
|
|
478
|
+
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
|
|
479
|
+
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
|
|
480
|
+
| `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
|
|
481
|
+
| `--by <actor>` | 名簿または予約一覧の actor を追記型 event に記録する | `add` / 更新 / 遷移コマンド |
|
|
482
|
+
| `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
|
|
483
|
+
| `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
|
|
484
|
+
| `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
|
|
485
|
+
| `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除) | `add` / `update` |
|
|
486
|
+
| `--target <doc-id>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
487
|
+
| `--source <ref>` | kata authoring の手本を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
|
|
488
|
+
| `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
|
|
489
|
+
| `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
|
|
490
|
+
| `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
|
|
491
|
+
| `--dry-run` | 書き込みを行わず変更対象を表示する | `add` / `update` / `renumber` / 遷移 / `migrate` |
|
|
492
|
+
| `--since <date>` | 対象コミットの開始日(`YYYY-MM-DD`、当日を含む) | `history` |
|
|
493
|
+
| `--until <date>` | 対象コミットの終了日(`YYYY-MM-DD`、当日を含む) | `history` |
|
|
494
|
+
| `--id <PJR-ID...>` | 出力する項目を限定する(空白・カンマ区切りで複数可) | `history` |
|
|
495
|
+
| `--status-only` | 追加・削除・状態遷移だけを出力する | `history` |
|
|
496
|
+
| `--limit <count>` | 走査するコミット数の上限 | `history` |
|
|
497
|
+
| `--json` | イベントを JSON で出力する | `history` |
|
|
406
498
|
|
|
407
499
|
`register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
|
|
408
500
|
|
|
409
501
|
`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 を指定します。
|
|
410
502
|
|
|
411
|
-
`--approach` を指定する場合、通常は `--target` が 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。kata authoring
|
|
503
|
+
`--approach` を指定する場合、通常は `--target` が 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。kata authoring は `--target` を新しい kata ID、`--source` を 0 件以上の読み取り専用の手本とします。互換性のため、2 個目以降の `--target` も `--source` と同じ手本として扱います。
|
|
412
504
|
|
|
413
505
|
`item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
|
|
414
506
|
|
|
@@ -418,9 +510,13 @@ specdojo schedule strategy generate \
|
|
|
418
510
|
|
|
419
511
|
`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 を起票するときも、この関係を追跡先として使います。
|
|
420
512
|
|
|
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
|
|
513
|
+
`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 が残ります。別 project への起票で `--source` を使う場合、相手の SpecDojo は 0.4.5 以上である必要があります。
|
|
514
|
+
|
|
515
|
+
`register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にし、対象は 1 件だけです。`rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` は `--target` に新しい kata ID、繰り返し可能な `--source` に手本を指定し、個票 Frontmatter の `sources` へ保存します。
|
|
516
|
+
|
|
517
|
+
`--source` は次の順で解釈します。コロンの前が対象 project の `repos[].name` と一致すれば `<repo>:<path>`、一致せず値に `/` または拡張子があればプロジェクトリポジトリのパス、残りは文書索引で解決する doc id です。パスはファイル、ディレクトリ、glob を受け付けます。ディレクトリと glob はファイルへ展開し、重複を除いた合計が 100 件を超えると停止します。この上限は広すぎるパターンによる読み取り範囲と plan の肥大化を防ぐためです。プロダクトリポジトリの手本は plan に `$SPECDOJO_REPO_<NAME>/<path>` として載ります。カタログは必須ではなく、いずれの形も見つからなければ起票時と実行時に理由を示して停止します。
|
|
422
518
|
|
|
423
|
-
|
|
519
|
+
新しい ID の authority、種類別の末尾、既存 ID との重複も起票時と実行時に検証します。既存 ID には対応する `*-maintenance` を使います。手本がカタログ成果物で、該当参照が `undecided` または未記入なら同じ実行で新 ID へ更新します。別 ID または `not-needed` なら上書きせず result へ申し送り、カタログ外とプロダクトリポジトリの手本は変更も参照更新もしません。互換性のため、新しい kata ID に続く 2 個目以降の `--target` も `--source` と同じ手本として受け付けます。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
|
|
424
520
|
|
|
425
521
|
kata authoring は register 専用です。Schedule の task は対象成果物を起点にするため、「新しい kata ID + 0 件以上の手本」という target 契約を損なわずに表現できません。strategy の phase に指定した場合は plan 生成時に停止します。
|
|
426
522
|
|
|
@@ -428,7 +524,7 @@ kata authoring は register 専用です。Schedule の task は対象成果物
|
|
|
428
524
|
|
|
429
525
|
別 project への `register add` は `--commit` が必須です。対象 project の登録簿に未 commit 変更がある場合、または統合ブランチがローカルに存在しない場合は、何も書き込まず終了コード 1 で停止します。元の worktree とブランチは変更しません。`close`、`reject` など別 project の状態遷移は受け付けず、対象 project の worktree での実行を案内します。
|
|
430
526
|
|
|
431
|
-
別リポジトリへの起票も `--commit`
|
|
527
|
+
別リポジトリへの起票も `--commit` が必須です。起動する CLI は相手の `node_modules/.bin/specdojo` を優先します。これがなく、相手の `package.json` の `name` が `specdojo` の場合は、呼び出し元と同じ Node.js で `node <相手>/dist/specdojo.js` を起動します。SpecDojo 自身の clone では、先に `npm install` と `npm run build` を実行してください。`dist/specdojo.js` がない場合は `npm run build` を案内して停止します。相手のリポジトリ、起動する CLI、0.4.2 以上の版のいずれかを確認できない場合は、相手を変更せず停止します。相手の起票が失敗した場合は相手の標準出力・標準エラー出力と終了コードをそのまま引き継ぎ、push は行いません。外部 project の `close` などの状態遷移は委譲しないため、案内された相手のリポジトリで実行してください。
|
|
432
528
|
|
|
433
529
|
一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
|
|
434
530
|
|
|
@@ -87,6 +87,8 @@ SpecDojo Configuration Reference
|
|
|
87
87
|
|
|
88
88
|
別名は `[a-z0-9-]+` とし、ローカルの `projects` の ID と重ねられません。`path` は存在するディレクトリでなければならず、絶対パスは使えません。起票時は相手の `node_modules/.bin/specdojo` を使うため、相手に SpecDojo 0.4.2 以上が必要です。`orchestrator launch` は `repos` に加えて、宣言したすべての外部リポジトリにも provider 別の編集許可を付けます。
|
|
89
89
|
|
|
90
|
+
相手に `node_modules/.bin/specdojo` がなく、相手の `package.json` の `name` が `specdojo` の場合は、呼び出し元と同じ Node.js で `node <相手>/dist/specdojo.js` を起動します。SpecDojo 自身のリポジトリを指定する場合は、相手で `npm install` と `npm run build` を実行してください。`dist/specdojo.js` がなければ `npm run build` を案内して停止します。CLI の版はこの起動方法でも 0.4.2 以上が必要です。
|
|
91
|
+
|
|
90
92
|
## 3. projectのパスキー
|
|
91
93
|
|
|
92
94
|
`projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
|
|
@@ -207,9 +207,25 @@ properties:
|
|
|
207
207
|
final_message:
|
|
208
208
|
type: string
|
|
209
209
|
maxLength: 4000
|
|
210
|
+
completion_status:
|
|
211
|
+
description: >
|
|
212
|
+
Executor-reported task completion, independent of process status. Omitted legacy reports
|
|
213
|
+
imply complete. Incomplete tasks must not proceed to integration.
|
|
214
|
+
type: string
|
|
215
|
+
enum: [complete, incomplete]
|
|
216
|
+
handoff:
|
|
217
|
+
description: >
|
|
218
|
+
Redacted, bounded executor notes preserved mechanically in the edit result handoff after
|
|
219
|
+
the reporter stage. Optional for compatibility with existing reports and evidence.
|
|
220
|
+
type: array
|
|
221
|
+
maxItems: 100
|
|
222
|
+
items:
|
|
223
|
+
type: string
|
|
224
|
+
minLength: 1
|
|
225
|
+
maxLength: 4000
|
|
210
226
|
block_reason:
|
|
211
227
|
description: >
|
|
212
|
-
Runner-derived failure or
|
|
228
|
+
Runner-derived failure, protection, or incomplete-work reason. Reporter prose never supplies this field.
|
|
213
229
|
type: string
|
|
214
230
|
minLength: 1
|
|
215
231
|
maxLength: 1000
|
|
@@ -113,9 +113,10 @@ properties:
|
|
|
113
113
|
Doc ids of the documents this task targets. Existing documents are resolvable via the
|
|
114
114
|
doc index. For deliverable work, the first entry is the target deliverable and subsequent
|
|
115
115
|
entries are reference materials the approach may modify or confirm. For *-authoring
|
|
116
|
-
register tasks, the
|
|
117
|
-
|
|
118
|
-
|
|
116
|
+
register tasks, the entry is an intentionally not-yet-existing kata id; read-only
|
|
117
|
+
exemplars are carried in the register item's sources and rendered as paths in the plan
|
|
118
|
+
body. Plans created before sources was introduced may retain exemplar doc ids after the
|
|
119
|
+
first target. Unresolvable reference materials are omitted.
|
|
119
120
|
|
|
120
121
|
paths:
|
|
121
122
|
type: array
|
|
@@ -139,6 +139,6 @@ properties:
|
|
|
139
139
|
minLength: 1
|
|
140
140
|
minItems: 1
|
|
141
141
|
description: >
|
|
142
|
-
Doc ids of the documents this task targets, carried with the same rules as the
|
|
143
|
-
|
|
144
|
-
|
|
142
|
+
Doc ids of the documents this task targets, carried with the same rules as the plan
|
|
143
|
+
frontmatter targets. Authoring results carry the new kata id; read-only exemplar sources
|
|
144
|
+
are described in the plan body instead of becoming change-coverage targets.
|
|
@@ -70,6 +70,21 @@ properties:
|
|
|
70
70
|
targets:
|
|
71
71
|
type: array
|
|
72
72
|
maxItems: 1
|
|
73
|
+
- if:
|
|
74
|
+
required:
|
|
75
|
+
- sources
|
|
76
|
+
properties:
|
|
77
|
+
sources: true
|
|
78
|
+
then:
|
|
79
|
+
required:
|
|
80
|
+
- approach
|
|
81
|
+
properties:
|
|
82
|
+
approach:
|
|
83
|
+
enum:
|
|
84
|
+
- rulebook-authoring
|
|
85
|
+
- recipe-authoring
|
|
86
|
+
- sample-authoring
|
|
87
|
+
- template-authoring
|
|
73
88
|
- type: object
|
|
74
89
|
required:
|
|
75
90
|
- rulebook
|
|
@@ -199,9 +214,9 @@ properties:
|
|
|
199
214
|
approach:
|
|
200
215
|
$ref: "#/$defs/Approach"
|
|
201
216
|
description: >
|
|
202
|
-
Execution approach. Authoring approaches use the
|
|
203
|
-
|
|
204
|
-
compatible document id.
|
|
217
|
+
Execution approach. Authoring approaches use the target as the new kata id and
|
|
218
|
+
sources as read-only exemplars. For compatibility, additional targets are also
|
|
219
|
+
accepted as exemplar sources. Other approaches require one compatible document id.
|
|
205
220
|
|
|
206
221
|
targets:
|
|
207
222
|
type: array
|
|
@@ -218,6 +233,19 @@ properties:
|
|
|
218
233
|
coverage validation works for register-originated plans. Omit the
|
|
219
234
|
key when the target documents are unknown or not applicable.
|
|
220
235
|
|
|
236
|
+
sources:
|
|
237
|
+
type: array
|
|
238
|
+
items:
|
|
239
|
+
type: string
|
|
240
|
+
minLength: 1
|
|
241
|
+
minItems: 1
|
|
242
|
+
uniqueItems: true
|
|
243
|
+
description: >
|
|
244
|
+
Read-only exemplars for a kata authoring approach. Each value is a document id, a
|
|
245
|
+
project-repository-relative path, or <repo>:<path> for a repository declared in
|
|
246
|
+
projects.<id>.repos. Paths may name files, directories, or glob patterns. Omit the
|
|
247
|
+
key when the authoring task has no exemplar.
|
|
248
|
+
|
|
221
249
|
$defs:
|
|
222
250
|
ItemType:
|
|
223
251
|
type: string
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.6",
|
|
4
4
|
"description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "naoji3x",
|
|
@@ -63,10 +63,10 @@
|
|
|
63
63
|
"orch:sonnet:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
|
|
64
64
|
"orch:opus": "tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
65
65
|
"orch:opus:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
66
|
-
"orch:
|
|
67
|
-
"orch:
|
|
68
|
-
"orch:sol": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-
|
|
69
|
-
"orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-
|
|
66
|
+
"orch:luna": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-6-luna \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
67
|
+
"orch:luna:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-6-luna \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
68
|
+
"orch:sol": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-6.1-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
69
|
+
"orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-6.1-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
70
70
|
"orch:copilot": "tsx src/specdojo.ts orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
71
71
|
"orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
72
72
|
"orch:flash": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
@@ -101,7 +101,8 @@
|
|
|
101
101
|
"validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
|
|
102
102
|
"validate:catalog": "tsx src/specdojo.ts catalog validate",
|
|
103
103
|
"validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
|
|
104
|
-
"check": "npm run typecheck && npm run lint:ts && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
104
|
+
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
105
|
+
"check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
|
|
105
106
|
"dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
|
|
106
107
|
"dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
|
|
107
108
|
"dc:bash": "bash -lc 'name=$(docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"); [ -n \"$name\" ] && docker exec -it --detach-keys=\"ctrl-]\" -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 -u node \"$name\" bash -lc \"cd /workspaces/specdojo-workspace/specdojo && exec bash\" || echo \"matching container not found\"'",
|
|
@@ -123,6 +124,7 @@
|
|
|
123
124
|
"js-yaml": "^5.4.3",
|
|
124
125
|
"prettier": "^3.8.4",
|
|
125
126
|
"remark-parse": "^11.0.0",
|
|
127
|
+
"tinyglobby": "^0.2.17",
|
|
126
128
|
"unified": "^11.0.5"
|
|
127
129
|
},
|
|
128
130
|
"devDependencies": {
|
|
@@ -145,7 +147,6 @@
|
|
|
145
147
|
"remark-lint": "^10.0.1",
|
|
146
148
|
"remark-mdx": "^3.1.1",
|
|
147
149
|
"remark-stringify": "^11.0.0",
|
|
148
|
-
"tinyglobby": "^0.2.17",
|
|
149
150
|
"tsx": "^4.22.4",
|
|
150
151
|
"typescript": "^6.0.3",
|
|
151
152
|
"typescript-eslint": "^8.61.0",
|
|
@@ -161,12 +161,12 @@ npx specdojo exec validate --project <project-id>
|
|
|
161
161
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
162
162
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
163
163
|
- 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
|
|
164
|
-
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor
|
|
164
|
+
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
|
|
165
165
|
- プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
|
|
166
166
|
|
|
167
167
|
## close の前の確かめ方
|
|
168
168
|
|
|
169
|
-
- 完了条件を 1 項目ずつ、差分(`git show
|
|
169
|
+
- 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
|
|
170
170
|
- agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
|
|
171
171
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
172
172
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
@@ -190,8 +190,8 @@ npx specdojo exec validate --project <project-id>
|
|
|
190
190
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
191
191
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
192
192
|
- CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
|
|
193
|
-
-
|
|
194
|
-
- 未決の点は `_UNDECIDED_` で残すか、executor
|
|
193
|
+
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
194
|
+
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
195
195
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
196
196
|
|
|
197
197
|
## agent の選び方
|
|
@@ -48,6 +48,8 @@ providers:
|
|
|
48
48
|
|
|
49
49
|
`.specdojo/agent-members.yaml` は実体と別名の 2 段で書く。実体は model の系統で名付け(`sonnet-executor`・`opus-executor` など)、`model` に `sonnet` / `opus` を持つ。従来の名前(`claude-executor`・`claude-expert-executor` など)は `aliases` で実体を指す別名にする。
|
|
50
50
|
|
|
51
|
+
`specdojo init --exec` は claude を 2 段で書く。normal の段は `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter`(別名 `claude-executor`・`claude-review-executor`・`claude-reporter`)、expert の段は `proficiency: expert` の `opus-executor`・`opus-review-executor`(別名 `claude-expert-executor`・`claude-expert-review-executor`)である。振り分けの表(`routing`)は hard を expert の別名、medium・easy と reporter を normal の別名にする。
|
|
52
|
+
|
|
51
53
|
```yaml
|
|
52
54
|
members:
|
|
53
55
|
- nickname: opus-executor
|
|
@@ -168,12 +168,12 @@ npx specdojo exec validate --project <project-id>
|
|
|
168
168
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
169
169
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
170
170
|
- 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
|
|
171
|
-
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor
|
|
171
|
+
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
|
|
172
172
|
- プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
|
|
173
173
|
|
|
174
174
|
## close の前の確かめ方
|
|
175
175
|
|
|
176
|
-
- 完了条件を 1 項目ずつ、差分(`git show
|
|
176
|
+
- 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
|
|
177
177
|
- agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
|
|
178
178
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
179
179
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
@@ -197,8 +197,8 @@ npx specdojo exec validate --project <project-id>
|
|
|
197
197
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
198
198
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
199
199
|
- CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
|
|
200
|
-
-
|
|
201
|
-
- 未決の点は `_UNDECIDED_` で残すか、executor
|
|
200
|
+
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
201
|
+
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
202
202
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
203
203
|
|
|
204
204
|
## agent の選び方
|