specdojo 0.3.1 → 0.4.1
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 +61 -2
- package/CHANGELOG.md +90 -0
- package/README.md +85 -25
- package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
- package/dist/catalog/build-render.js +32 -0
- package/dist/{catalog-build.js → catalog/build.js} +9 -9
- package/dist/{catalog.js → catalog/catalog.js} +10 -10
- package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
- package/dist/catalog/paths.js +1 -0
- package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
- package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
- package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
- package/dist/{agent.js → commands/agent.js} +11 -11
- package/dist/{build-command.js → commands/build.js} +2 -2
- package/dist/{init-command.js → commands/init.js} +168 -45
- package/dist/commands/night-orchestrator.js +287 -0
- package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
- package/dist/{watch.js → commands/watch.js} +3 -3
- package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
- package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
- package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
- package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
- package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
- package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
- package/dist/{timeline.js → dashboard/timeline.js} +1 -1
- package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
- package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
- package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
- package/dist/devcontainer/scaffold.js +418 -0
- package/dist/{doc-index.js → docs/doc-index.js} +1 -1
- package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
- package/dist/{index-command.js → docs/index-command.js} +1 -1
- package/dist/docs/template-resolution.js +1 -0
- package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
- package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
- package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
- package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
- package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
- package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
- package/dist/{exec-commands.js → exec/commands.js} +22 -18
- package/dist/{exec-core.js → exec/core.js} +11 -11
- package/dist/{exec-events.js → exec/events.js} +2 -2
- package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
- package/dist/exec/exec.js +2 -0
- package/dist/exec/format.js +1 -0
- package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
- package/dist/{exec-limit.js → exec/limit.js} +93 -12
- package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
- package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
- package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
- package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
- package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
- package/dist/{exec-plans.js → exec/plans.js} +3 -3
- package/dist/{exec-project.js → exec/project.js} +1 -1
- package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
- package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
- package/dist/{exec-register.js → exec/register.js} +114 -9
- package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
- package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
- package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
- package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
- package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
- package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
- package/dist/{exec-results.js → exec/results.js} +287 -31
- package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
- package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
- package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
- package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
- package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
- package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
- package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
- package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
- package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
- package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
- package/dist/exec/run/register-post-review.js +420 -0
- package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
- package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
- package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
- package/dist/{exec-run.js → exec/run/run.js} +11 -11
- package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
- package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
- package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
- package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
- package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
- package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
- package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
- package/dist/exec/schedule/gantt-chart.js +2 -0
- package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
- package/dist/exec/schedule/index.js +1 -0
- package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
- package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
- package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
- package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
- package/dist/exec/shared.js +63 -0
- package/dist/exec/slot-lock.js +1 -0
- package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
- package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
- package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
- package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
- package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
- package/dist/{exec-trial.js → exec/trial.js} +2 -2
- package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
- package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
- package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
- package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
- package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
- package/dist/exec/worktree.js +305 -0
- package/dist/{grade-apply.js → grade/apply.js} +9 -9
- package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
- package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
- package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
- package/dist/{grade-core.js → grade/core.js} +3 -3
- package/dist/grade/grade.js +19 -0
- package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
- package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
- package/dist/{grade-plan.js → grade/plan.js} +5 -5
- package/dist/{grade-result.js → grade/result.js} +5 -94
- package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
- package/dist/{grade-targets.js → grade/targets.js} +11 -8
- package/dist/{job-definition.js → job/definition.js} +25 -6
- package/dist/{job.js → job/job.js} +12 -11
- package/dist/{kata-command.js → kata/command.js} +3 -3
- package/dist/{kata.js → kata/kata.js} +5 -5
- package/dist/register/approach.js +134 -0
- package/dist/{register-core.js → register/core.js} +26 -8
- package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
- package/dist/{register-date.js → register/date.js} +1 -1
- package/dist/register/derivation.js +163 -0
- package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
- package/dist/{register-events.js → register/events.js} +13 -3
- package/dist/{register-history.js → register/history.js} +7 -6
- package/dist/{register-item.js → register/item.js} +32 -5
- package/dist/register/lifecycle-lock.js +5 -0
- package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
- package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
- package/dist/{register-migration.js → register/migration.js} +5 -4
- package/dist/{register.js → register/register.js} +32 -27
- package/dist/{register-renumber.js → register/renumber.js} +38 -11
- package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
- package/dist/{register-update.js → register/update.js} +5 -5
- package/dist/{register-views.js → register/views.js} +47 -7
- package/dist/{review-grade.js → review/grade.js} +2 -2
- package/dist/{review-plan.js → review/plan.js} +3 -3
- package/dist/{routine-definition.js → routine/definition.js} +2 -2
- package/dist/{routine.js → routine/routine.js} +49 -22
- package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
- package/dist/{schedule-build.js → schedule/build.js} +7 -4
- package/dist/{schedule.js → schedule/schedule.js} +6 -6
- package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
- package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
- package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
- package/dist/shared/agent-types.js +23 -0
- package/dist/shared/artifact-path.js +9 -0
- package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
- package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
- package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
- package/dist/shared/fs.js +30 -0
- package/dist/shared/git.js +346 -0
- package/dist/shared/grade-result.js +94 -0
- package/dist/{package-paths.js → shared/package-paths.js} +3 -3
- package/dist/shared/plan-templates.js +114 -0
- package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
- package/dist/shared/random.js +4 -0
- package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
- package/dist/shared/schedule-paths.js +9 -0
- package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
- package/dist/{exec-shared.js → shared/text.js} +4 -135
- package/dist/shared/time.js +28 -0
- package/dist/shared/workspace-scaffold.js +69 -0
- package/dist/specdojo.js +22 -22
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
- package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
- package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
- package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
- package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
- package/docs/ja/specdojo/guides/review-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
- package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
- package/docs/ja/specdojo/guides/waza-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +124 -55
- package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
- package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
- package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
- package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
- package/package.json +17 -17
- package/templates/antigravity/README.md +6 -2
- package/templates/antigravity/agent-members-snippet.yaml +108 -12
- package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
- package/templates/antigravity/orchestrator.md +61 -2
- package/templates/claude/README.md +27 -3
- package/templates/claude/agents/claude-executor.md +0 -1
- package/templates/claude/agents/claude-reporter.md +2 -1
- package/templates/claude/agents/claude-review-executor.md +0 -1
- package/templates/claude/agents/specdojo-orchestrator.md +61 -2
- package/templates/codex/README.md +40 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
- package/templates/codex/orchestrator.md +61 -2
- package/templates/devcontainer/devcontainer.json +5 -2
- package/templates/devcontainer/post-create.sh +15 -7
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
- package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
- package/templates/devcontainer/vim/vimrc +37 -0
- package/templates/init-agent-members.yaml +75 -25
- package/templates/init-exec-defaults.yaml +44 -9
- package/templates/opencode/README.md +17 -3
- package/templates/opencode/agents/opencode-executor.md +0 -1
- package/templates/opencode/agents/opencode-reporter.md +2 -1
- package/templates/opencode/agents/opencode-review-executor.md +0 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
- package/dist/devcontainer-scaffold.js +0 -165
- package/dist/exec-schedule-gantt-chart.js +0 -2
- package/dist/exec-worktree.js +0 -474
- package/dist/exec.js +0 -2
- package/dist/grade.js +0 -19
- package/templates/claude/agents/claude-expert-review-executor.md +0 -14
- /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
- /package/dist/{catalog-types.js → catalog/types.js} +0 -0
- /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
- /package/dist/{role-types.js → exec/role-types.js} +0 -0
- /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
- /package/dist/{exec-types.js → exec/types.js} +0 -0
- /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
- /package/dist/{register-command-types.js → register/command-types.js} +0 -0
- /package/dist/{review-types.js → review/types.js} +0 -0
- /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
- /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
- /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
- /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
- /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
- /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
- /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
- /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
- /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
- /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
- /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
- /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
- /package/dist/{yaml.js → shared/yaml.js} +0 -0
|
@@ -15,7 +15,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
15
15
|
## 基本方針
|
|
16
16
|
|
|
17
17
|
- 回答は原則として日本語で行う。
|
|
18
|
-
-
|
|
18
|
+
- 操作は「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、「承認の聞き方」に従って何をするかを日本語で示し、利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
19
19
|
- 破壊的変更や `git push` は行わない。
|
|
20
20
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
21
21
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
@@ -27,6 +27,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
27
27
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
28
28
|
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
29
29
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
30
|
+
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
30
31
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
31
32
|
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
32
33
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
@@ -37,10 +38,20 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
37
38
|
|
|
38
39
|
1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
|
|
39
40
|
2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
|
|
40
|
-
3.
|
|
41
|
+
3. 何をするか・中身・影響(生成・更新されるファイルと commit の先)を、「承認の聞き方」に従って日本語で示す。
|
|
41
42
|
4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
|
|
42
43
|
5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
|
|
43
44
|
|
|
45
|
+
## 承認の聞き方
|
|
46
|
+
|
|
47
|
+
状態やファイルを変える操作の承認を求めるときは、コマンドではなく、次の順で日本語で示して「よろしいですか?」と聞く。コマンドは既定では見せず、利用者が求めたときや、うまく動かなかったときの説明に使う。
|
|
48
|
+
|
|
49
|
+
1. 何をするか(例: 「todo を起票します」「この項目を close します」)を 1 文で。
|
|
50
|
+
2. 中身。起票なら種類・タイトル・優先度・担当・期限・説明の要点、close なら結論と確かめたこと、実行なら対象と使う agent。
|
|
51
|
+
3. 影響。変わるファイルと commit の先(例: 「develop に記帳を 1 件 commit します」)。
|
|
52
|
+
|
|
53
|
+
選択肢がある場合は、案ごとの利点と欠点を表にし、推奨とその理由を添える。CLI のツールが出す「このコマンドを実行してよいか」という権限の確認は、ツール側の仕組みでこの聞き方とは別である。
|
|
54
|
+
|
|
44
55
|
## specdojo コマンド地図
|
|
45
56
|
|
|
46
57
|
| 目的 | サブコマンド | 代表操作 |
|
|
@@ -148,6 +159,54 @@ npx specdojo exec validate --project <project-id>
|
|
|
148
159
|
|
|
149
160
|
失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
|
|
150
161
|
|
|
162
|
+
## 実行の運び方
|
|
163
|
+
|
|
164
|
+
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
165
|
+
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
166
|
+
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
167
|
+
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
168
|
+
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
169
|
+
- 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
|
|
170
|
+
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
|
|
171
|
+
- プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
|
|
172
|
+
|
|
173
|
+
## close の前の確かめ方
|
|
174
|
+
|
|
175
|
+
- 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
|
|
176
|
+
- agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
|
|
177
|
+
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
178
|
+
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
179
|
+
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
180
|
+
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
181
|
+
|
|
182
|
+
## 止まったときの対処
|
|
183
|
+
|
|
184
|
+
| 止まった理由 | 対処 |
|
|
185
|
+
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
186
|
+
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
187
|
+
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
188
|
+
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
189
|
+
| 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
190
|
+
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
191
|
+
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
192
|
+
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
193
|
+
|
|
194
|
+
## 完了条件の書き方
|
|
195
|
+
|
|
196
|
+
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
197
|
+
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
198
|
+
- CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
|
|
199
|
+
- 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
|
|
200
|
+
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
|
|
201
|
+
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
202
|
+
|
|
203
|
+
## agent の選び方
|
|
204
|
+
|
|
205
|
+
- 具体的な agent の名前は、プロジェクトの設定に従う。`exec-defaults.yaml` に難しさごとの振り分けの設定があれば、個票の `difficulty`(`hard`・`medium`・`easy`)に合わせてそれを使う。
|
|
206
|
+
- 振り分けの設定がなければ、難しい作業(設計の判断を伴う変更、runner のコード)は expert の executor、範囲がはっきりした中程度の作業は normal の executor を選ぶ。
|
|
207
|
+
- 小さなローカル LLM は、編集できる範囲が限られることがあり、確かめずに完了と報告しがちである。plan で直し方が決まった小さな作業に限り、結果は必ず実物で確かめる。
|
|
208
|
+
- rate limit の解除まで長くかかる agent(割り当てが日単位のものなど)は、待たずに代わりの agent を指定する。
|
|
209
|
+
|
|
151
210
|
## プロジェクトの解決順序
|
|
152
211
|
|
|
153
212
|
対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,96 @@
|
|
|
2
2
|
|
|
3
3
|
SpecDojo の利用者に影響する変更を記録します。
|
|
4
4
|
|
|
5
|
+
## [0.4.1] - 2026-10-21
|
|
6
|
+
|
|
7
|
+
### 追加機能
|
|
8
|
+
|
|
9
|
+
- `.specdojo/specdojo.config.json` の `projects.<id>.run.parent_validations` で、共有 `exec-defaults.yaml` の `pipeline.parent_validations` に project 固有の親検証を追加できるようにしました。`{ id, repo }` も指定でき、プロダクトリポジトリを持つ project だけに検証を加えても、同じ defaults を使うほかの project には影響しません(PJR-HE9R)。
|
|
10
|
+
- `specdojo config scaffold --workspace` で、`repos` の設定から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)を生成できるようにしました。プロジェクトリポジトリ自身と `repos` で宣言された各プロダクトリポジトリを `folders` に宣言順で並べ、別リポジトリ構成でも 1 つのウィンドウで開発できます。`--project` で対象 project を指定でき(省略時は `current_project`)、既存のワークスペースファイルは `--force` を指定しない限り上書きしません(PJR-87XS)。
|
|
11
|
+
- `exec run --register --worktree` に、プロダクトリポジトリの統合先を run ごとに上書きする繰り返し可能な `--integration-branch <repo>=<branch>` を追加しました。指定は `repos[].integration_branch` より優先し、指定がなければ従来どおり設定値または現在のブランチを使います。並列実行では各 item run に適用し、再開時は checkpoint に保存した値を再利用して途中変更を拒否します(PJR-XRAB)。
|
|
12
|
+
- register 個票に `difficulty`(`hard` / `medium` / `easy`)を追加し、`exec-defaults.yaml` の `routing` で難易度ごとの executor・reporter・rate limit 対応・fallback を選べるようにしました。`exec run --register` と夜間 orchestrator が同じ表を使い、CLI 指定は表より優先し、難易度または表がない既存個票は従来の `priority` 自動選択を維持します。`specdojo init --exec` も選択した provider に合う表を生成します(PJR-5HYP)。
|
|
13
|
+
|
|
14
|
+
- `devcontainer scaffold --preset recommended` を追加しました。端末版 Emacs と Vim、tmux、SpecDojo の文書作業向け VS Code 拡張・保存時整形・YAML schema 関連付けをまとめて設定し、同じ拡張を `.vscode/extensions.json` にも推薦します。個別の `--editor`・`--tmux` と併用でき、既存のエディタ設定は上書きしません。`specdojo init` では Dev Container を選んだ場合だけ推奨 preset の利用を質問し、`--yes --devcontainer` では利用します(PJR-EN6M)。
|
|
15
|
+
|
|
16
|
+
- 親 runner の検証(`pipeline.parent_validations`)の固定許可リストに `build`(`npm run build`)と `format-check`(`npm run format:check`)を追加しました。別リポジトリ構成などでプロダクトリポジトリのビルドと整形の検証を親 runner に委譲できます(PJR-NS8Y)。
|
|
17
|
+
- `exec run --register --post-review`(または `exec-defaults.yaml` の `register_post_review: true`)で、統合の後に review の agent が完了条件・result・差分・検証の結果を照らして判定するようにしました。`complete`・`complete-with-findings` なら todo と issue を close し、`incomplete` なら `waiting` に戻します。decision と question、SpecDojo 自身のコードを変えた項目は自動では close しません(PJR-T46Y)。
|
|
18
|
+
- `register update --autopilot approved` で夜間に流してよい個票に印を付け、`specdojo orchestrator night` が印のある `open` の todo と issue だけを、worktree・統合後の review・並行で流すようにしました。1 晩の件数・並行数・連続した失敗での停止・rate limit のときの切り替えを指定でき、close したもの・`waiting` に戻したもの・新しく起票した承認待ちを朝の報告にまとめます(PJR-6DHY)。
|
|
19
|
+
|
|
20
|
+
### 変更
|
|
21
|
+
|
|
22
|
+
- `specdojo init` と `config scaffold` が追加するオーケストレーター起動スクリプトをモデルの系統名へ揃えました。Codex は `orch:sol`(`gpt-5.6-sol`)と `orch:terra`(`gpt-5.6-terra`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)を追加し、旧 `orch:codex`・`orch:agy` は作りません。既存の `package.json` のスクリプトは上書き・削除しないため、scaffold の再実行後に新しい名前で起動を確認してから旧スクリプトを手動で削除してください。Claude Code と、利用環境ごとにモデルが異なる OpenCode の名前は変わりません(PJR-16S0)。
|
|
23
|
+
- 同梱のオーケストレーターの本文に、承認の聞き方(コマンドではなく、何をするか・中身・影響を日本語で示す)、実行の運び方、close の前の確かめ方、止まったときの対処の表、完了条件の書き方、agent の選び方を加えました(PJR-C50G)。
|
|
24
|
+
|
|
25
|
+
### 不具合修正
|
|
26
|
+
|
|
27
|
+
- `register` の `--by` を人・agent の名簿と予約 actor の一覧に照合し、agent alias は実体名へ解決して event に記録するようにしました。未知の名前や `PO` などの Role code は書き込み前に拒否し、省略時は予約 actor の `SpecDojo` を使います。対話型オーケストレーターの名前は `specdojo-orchestrator` に統一しました(PJR-3K1X)。
|
|
28
|
+
- exec の result へ executor / reporter の自由記述を描くとき、アスタリスクやアンダースコアを含む ASCII トークンをコードの書式にして、Markdown の強調と誤解釈されないようにしました。既にコードの書式で囲まれた部分は保持します。検証の適用外理由に `*.yaml` と `*.yml` を並べても markdownlint(MD037)で統合前に止まりません(PJR-A6PV)。
|
|
29
|
+
- ローカル LLM や provider API へ接続できず、`Cannot connect to API`・`ECONNREFUSED` などで指名した executor / reporter が失敗した場合に、`--fallback-executor-by` / `--fallback-reporter-by` で指定した agent へ切り替えるようにしました。接続不能の文言は provider ごとの `connection_error_detection` で設定し、`--on-rate-limit` の値とは独立して1回だけ fallback します。切替履歴は rate limit と同じく pipeline state・evidence・result に記録します(PJR-DKD8)。
|
|
30
|
+
- devcontainer の scaffold で生成する `post-create.sh` で、volume のマウント先の親(`~/.local`・`~/.local/share`・`~/.config`)の所有者をコンテナの利用者へ戻し、`~/.local/bin` を作成して `PATH` に加えるようにしました。Docker が親ディレクトリを root 所有で作成した環境でも Claude Code などのインストーラが失敗しないようにします。また、常時稼働ホスト接続サンプル `specdojo-tmux.sh.sample` の `docker exec` に `-u` で利用者(`devcontainer.json` の `remoteUser`、既定は `node`)を渡し、コンテナの既定の root で入らないようにしました(PJR-GHBP)。
|
|
31
|
+
- devcontainer の scaffold で生成する `devcontainer.json` に `remoteEnv` を設定し、`/home/<remoteUser>/.local/bin`(既定は `/home/node/.local/bin`)を `PATH` の先頭に追加するようにしました。コンテナ作成後に開く端末や VS Code のターミナルで `~/.local/bin` が `PATH` に入らず、Claude Code などの CLI が見つからない問題を解消します。常時稼働ホスト運用ガイドに既存環境の修正手順を追記しました(PJR-5JRJ)。
|
|
32
|
+
- 常時稼働ホスト接続サンプル `specdojo-tmux.sh.sample` で、`node_bin_dir` を設けて `/opt/homebrew/bin`・`/usr/local/bin` とともに既定で `PATH` の先頭へ追加し、冒頭コメントに `dirname "$(command -v devcontainer)"` による確かめ方と Homebrew・nvm・mise の例を記載しました。また、`devcontainer` と `docker` が見つからない際のエラー案内にその時点の `PATH` と置き場所の確かめ方を表示し、`ssh-config.sample` と常時稼働ホスト運用ガイドに `RemoteCommand` では端末の `PATH` 設定が読み込まれない注意と `ssh <host> 'command -v devcontainer'` による確認方法を記載しました(PJR-EJ4F)。
|
|
33
|
+
|
|
34
|
+
- `validate:schema:file`・Prettier・markdownlint の `not_applicable` を、script や依存 package の有無だけでなく executor が変更したファイルの種類も含めて判定するようにしました。対象種類の変更がない run は適用外として受理し、対象変更がある run の誤申告は従来どおり拒否します(PJR-8WBN)。
|
|
35
|
+
- executor が親検証と同じコマンドを `not_applicable` または `not_run` と報告しても、同じリポジトリで親 runner が実行した結果を正とするようにしました。親検証が成功している run が executor の重複報告によって `waiting` で止まる問題を解消し、親検証でない誤った `not_applicable` は従来どおり拒否します(PJR-7AW0)。
|
|
36
|
+
- exec の雛形を展開するときに、2 行以上続く空行を 1 行にまとめるようにしました。夜間の承認の印(autopilot)がない個票の register の plan では制約の段落が空に展開されて空行が重なり、plan を commit する hook の markdownlint(MD012)で `exec run --register` が止まっていました。agent の Job の plan や保守系の plan など、ほかの雛形で段落が空に展開される場合も同じくまとめます(PJR-283N)。
|
|
37
|
+
- runner の git の操作が `.git/index.lock` の取り合い(`Unable to create '...index.lock': File exists`、日本語のメッセージを含む)で失敗した場合のやり直しを、合計 0.75 秒ほどから 1.5 秒間隔で最大 10 回へ広げ、やり直すたびに警告を出すようにしました。並行の run の統合や記帳と重なっただけで統合が止まり run が `waiting` になる問題を減らします。上限に達した場合は従来どおり失敗として報告し、残っていたロックのファイルのパスをメッセージの先頭に含めます。ロックのファイルは消しません(PJR-G90K)。
|
|
38
|
+
- result(edit・review・post-review)で reporter が返した文を箇条書きに描くとき、文の先頭の `1.`・`1)`・`-` などのリスト記号を外すようにしました。review の agent が判断の根拠に自分で番号を付けると `- 1. ...` が入れ子の番号付きリストになり、post-review の記帳の commit が hook の markdownlint(MD029)で失敗して、close の記帳が作業ツリーに残っていました(PJR-0EFN)。
|
|
39
|
+
- commit の失敗を hook の出力から要約するとき、最初に出力された step ではなく、lefthook の summary で失敗の印が付いた step と、その出力のうち error を含む最初の行を報告するようにしました。post-review の記帳の commit が失敗したときは、失敗した hook の名前・最初のエラーの行・作業ツリーに残った記帳のファイル・hook の全出力のログ(`post-review-commit.log`)を runner のログに出します(PJR-0EFN)。
|
|
40
|
+
- `not_applicable` の判定で、プロダクトリポジトリを `$SPECDOJO_REPO_<NAME>`・`${SPECDOJO_REPO_<NAME>}` で指すコマンドを、そのリポジトリのコマンドとして扱うようにしました(PJR-E412)。
|
|
41
|
+
|
|
42
|
+
### 文書
|
|
43
|
+
|
|
44
|
+
- README・ドキュメントサイトのトップ・全体概要ガイド・遂行の技活用ガイドで、呼び方の表記を「Spec道(仕様道)の道場」に揃えました(PJR-EVAX)。
|
|
45
|
+
- Quick Start ガイドの導入手順で、Dev Container を作成し推奨 preset(tmux・Emacs・Vim・推奨の VS Code 拡張と設定・`.vscode/extensions.json`)を適用する対話例と、`devcontainer scaffold --preset recommended` の例に揃えました。コンテナを開く方法や、Dev Container を使わずに進める手順、`init --yes --devcontainer` で推奨 preset が入る説明も補記しました(PJR-SVHF)。
|
|
46
|
+
- README の「会話で操作する」の例で、オーケストレーターの発言をコマンドの提示から、何をするか・中身・影響を日本語で示して承認を求める形に改めました。コマンドは既定では見せず求めたときに見せる説明に合わせました(PJR-7P27)。
|
|
47
|
+
|
|
48
|
+
## [0.4.0] - 2026-10-18
|
|
49
|
+
|
|
50
|
+
同梱パッケージは `@specdojo/docs-lint` 0.2.1 を同時に公開します。docs-lint は 0.2.0 以降の変更(js-yaml の 5.4.3 への更新。引用符なしの日付と merge key は 4 系と同じ規則で読み込みます。PJR-RCVS)を含みます。`@specdojo/docs-site` は、この版では公開しません。
|
|
51
|
+
|
|
52
|
+
### 追加機能
|
|
53
|
+
|
|
54
|
+
- devcontainer の scaffold(`specdojo init --devcontainer` を含む)で、常時稼働ホスト接続用のサンプルスクリプト(`specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`ssh-config.sample`)を `.devcontainer/remote-host/` に生成するようにしました。`devcontainer.json` に設定された公開ポート(`appPort`・`forwardPorts`)に応じた `LocalForward` も含め、scaffold 完了時に置き場所とコピー先を案内します。`init --devcontainer` ではスクリプトの前提となるコンテナ内 tmux も自動で有効化します(PJR-CCXN)。
|
|
55
|
+
- agent 名簿の alias を `--by`・`--executor-by`・`--reporter-by`・fallback の指定、Schedule / Job / routine の指名で実体へ解決し、実体の `model` を provider の `command_template` の `{model}` へ渡すようにしました。event と result の actor には実体名を記録します(PJR-YK1C)。
|
|
56
|
+
- 登録項目の起票元を個票 Frontmatter の `derived_from` に記録できるようにし、`register add` / `update` の繰り返し指定可能な `--from`、元項目から派生先を辿る生成ビュー、`register history` の変更履歴に対応しました。decision から起票した todo の追跡にも同じ関係を使えます(PJR-7WME)。
|
|
57
|
+
- 指名した agent が rate limit になったとき、`--on-rate-limit wait|fallback|stop` と executor / reporter 別の fallback 指定で、同じ agent の再開待ちまたは代替 agent への切替を選べるようにしました。`exec-defaults.yaml` の `rate_limit_policy.pinned` でも既定を設定でき、従来互換の既定は `stop` です(PJR-BHMH)。
|
|
58
|
+
- `register add` / `update` に `--approach` と繰り返し指定できる `--target` を追加しました。個票で進め方と対象文書を宣言でき、成果物はカタログ、kata は文書索引で解決します。解決できない対象、成果物と kata の種別違い、`approach` と複数対象の組み合わせは書き込み前に拒否します(PJR-ZJXQ)。
|
|
59
|
+
- `exec run --register` は、個票に `approach` があれば、schedule のタスクと同じ plan の作り方(approach のテンプレート、kata の参照、DCT の `done_criteria`)を使うようにしました。個票の完了条件は追加の条件として plan に載り、owner には個票の `owner` を使います(PJR-H06F)。
|
|
60
|
+
- agent 名簿(`agent-members.yaml`)に、実体の `model`・`effort` と、実体を指す別名(`aliases`・`alias_of`)を書けるようにしました。別名の循環、存在しない実体や無効な実体を指す別名は、名簿の読み込み時にファイルと名前を示してエラーにします。今の 1 段の名簿もそのまま使えます(PJR-EANK)。
|
|
61
|
+
- Job Run で、Job 定義の `partial_exit_code` に一致する終了を部分成功(`partial`)として記録し、review の判定が `complete-with-findings` なら評価できた分を統合するようにしました。grade の Job は、一部の文書の評価が失敗したときに 2 で終わります。全件の失敗・上限・中断は従来どおり `waiting` で止まります。`routine list` にも `partial` が表示されます(PJR-VGNG)。
|
|
62
|
+
|
|
63
|
+
### 変更
|
|
64
|
+
|
|
65
|
+
- 対話式の `specdojo init` から成果物カタログの質問を除き、`--catalog <size>` を明示した場合にだけ作成するように変更しました。導入直後の混乱を防ぎ、成果物が定まってから `catalog scaffold` で追加できるようにします。初期化の最後の案内でも `catalog scaffold` と `catalog_path` の設定手順を示します(PJR-G5AB)。
|
|
66
|
+
- approach のない実行(register の todo・issue など)の result で、第 4 章の見出しを「4. 進め方」にし、記入の指示をどう進めたか・根拠にした文書や規約に改めました。approach のある実行(schedule のタスク、approach を持つ個票)は「4. 進め方と実践の型の適用」のままです(PJR-S9QF)。
|
|
67
|
+
- `specdojo init --exec` と `config scaffold` が配布する agent の名簿と定義を、実体と別名の 2 段構成に改めました。実体は model の系統と役割で名付け(`sonnet-executor`・`terra-executor`・`gemma-executor`・`flash-executor` など)、`model` を持ちます。従来の名前(`claude-executor`・`codex-executor`・`opencode-executor`・`agy-executor` など)は `aliases` の別名として残し、init は選んだ provider の別名だけを書きます。claude と opencode の agent の定義は役割ごとの 1 ファイルにまとめて `model` を外し、`command_template` は `--agent {agent} --model {model}` と `command_params.by_mode` で組み立てます(`claude-expert-review-executor.md` は配布しません)。codex と antigravity の `command_params` からも `model` を外しました(PJR-8TGQ)。
|
|
68
|
+
- 既存の 1 段の名簿と `--agent {nickname}` の `command_template` は変更しなくても動きます。init は既存の名簿を上書きせず、scaffold も `--force` なしでは既存の定義を上書きしません。`--force` で役割ごとの定義に置き換える場合は、exec 設定ガイドの「agent の名簿の 2 段構成と移行」の手順(実体の名前と `model` を加える、従来の名前を `aliases` へ移す、`command_params` の `model` を外す、`command_template` を改める、`--dry-run` で確かめる)で 2 段へ移してください(PJR-8TGQ)。
|
|
69
|
+
- exec の plan で、共通の規約(記法・成果物規約)の全文を本文に差し込むのをやめ、守らないと失敗に直結する要点だけを残すようにしました。詳細は plan に記したパス(npm で導入した場合は `node_modules/specdojo/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md`)を作業前に読むよう指示します。要点は同じファイルの `plan-essentials` マーカーの間から取り出します。既存の plan は書き換えません(PJR-2219)。要点には検査の扱い(`package.json` と hook の設定を読んで適用条件から実行する検査を決める、当てはまらない検査は `not_applicable` と理由を報告する、`not_run` は実行できたのに実行しなかった検査だけに使う)も含めます。npm script も Markdown の lint もない新しいリポジトリで、executor が詳細を読まずに `not_run` と報告し、最初の実行が止まる問題を防ぎます(PJR-Z104)。
|
|
70
|
+
|
|
71
|
+
### 不具合修正
|
|
72
|
+
|
|
73
|
+
- `devcontainer scaffold` が親ディレクトリを常に `/workspaces/specdojo-workspace` としていた問題を修正し、ホスト側の親名を反映するようにしました。`--workspace-name` で明示的に固定でき、`specdojo init --devcontainer` からも指定できます。既に生成済みの `.devcontainer/` は、`--force` で作り直すまで従来のままです(PJR-8GQ4)。
|
|
74
|
+
- 対話式の `specdojo init` で provider などの入力を誤ると、最初から入力し直しになっていた問題を修正しました。答えを質問ごとに確かめ、誤りがあればその質問だけを聞き直します。非対話(`--yes` や引数での指定)では、従来どおり誤りの理由を出して終えます。Claude Code を選んだときの最後の案内も、`npm run orch:opus` に揃えました(PJR-B3XQ)。
|
|
75
|
+
- exec の worktree を作るときに、git が一時的なエラー(dubious ownership など)を返しても実際には作成できていた場合、再試行が「branch がすでにある」で失敗していた問題を修正しました。再試行の前に目的の状態を確かめます(PJR-DT3Q)。
|
|
76
|
+
- exec の checkpoint の確認で git が失敗したときに、原因が記録されなかった問題を修正しました。終了コードと stderr を失敗のログとエラーのメッセージに含めます(PJR-CY80)。
|
|
77
|
+
- exec の result で、reporter が変更ファイルごとの説明を返さなかった場合に、定型文(「reporter の説明がないため、変更差分を参照。」)の代わりに Git の変更情報(追加・変更・削除・名前の変更、行数)を記録するようにしました。変更ファイルが 50 件を超える場合は、ディレクトリごとに集約して記録します(PJR-8TS6)。
|
|
78
|
+
- `register build` が生成する一覧(`pjr-index.md` と派生ビュー)で、個票のタイトル・説明・結論などのセルに含まれるパイプ文字(`|`)と改行をエスケープするようにしました。セル内のパイプ文字で表の列がずれ、markdownlint(MD056)で失敗する問題を解消します(PJR-FXPH)。
|
|
79
|
+
- register の plan テンプレート(`xep-register-template`・`xep-register-investigate-template`)の対象項目からサイズが大きくパスも古かった登録簿一覧(`pjr-index.md`)を外し、進め方の最初を個票のみを読む指示に改めました。文脈長の小さい agent が一覧を読んで文脈を消費し停止する問題を防ぎます(PJR-SJ0G)。
|
|
80
|
+
- `routine run` の実行中に、`routine list` などが前回の結果と理由をそのまま表示していた問題を修正しました。開始時に `last_result` を `running` にし、終了時に今回の結果で上書きします(PJR-2CQR)。
|
|
81
|
+
- `exec run --on-rate-limit wait` で、codex の usage limit(`try again at 11:17 PM`)の解除まで待たずに止まっていた問題を修正しました。agent の出力の全体(codex が表示した設定ファイルなどの内容を含む)から最初に見つかった時刻を使っていたため、設定ファイルの例の `resets 4:10am (UTC)` を解除の時刻と読んでいました。解除の時刻は出力の末尾の行から読みます。agy の `Resets in 4h36m50s` のような相対の形も読みます。待機を飛ばすときのログは、解除の時刻を読めない場合(元の出力の行を表示)、過ぎている場合、上限を超える場合で分けました(PJR-NJ6J)。
|
|
82
|
+
|
|
83
|
+
- `npm init` が `package.json` に入れる仮の `test` script(`echo "Error: no test specified" && exit 1`)があるリポジトリで、executor が `npm test` を `not_applicable` と報告しても runner が退け、最初の実行が `waiting` で止まっていた問題を修正しました。仮の `test` script(引用符や空白だけが違う変種を含む)は script がないものとみなし、共通の規約の検査の表にも同じ扱いを書きました。本物の test script がある場合は従来どおり退けます。`specdojo init` は利用者の `package.json` を書き換えません(PJR-6EF8)。
|
|
84
|
+
|
|
85
|
+
### 文書
|
|
86
|
+
|
|
87
|
+
- README の始め方を、ランディングページ(<https://specdojo.org/>)と同じ `npx specdojo init` の手順と `<アプリ>-workspace/<アプリ>-specdojo` の構成に揃え、specdojo.org へのリンクを加えました(PJR-Y79W)。
|
|
88
|
+
- exec 運用ガイドに、登録簿(register)の todo から approach を使って成果物や kata(実践の型)を作成・修正する手順を追加しました。個票での approach と target の指定方法、kata 保守の approach の選び方、plan 生成内容、組み合わせ検証、および `exec run --deliverable` との違いと推奨経路を記載しました(PJR-4Z6N)。
|
|
89
|
+
- オーケストレーター運用ガイドに、Claude Code などの plan モードの plan と register の使い分けと、plan の下書きを decision と todo へ書き写す流れを加えました(PJR-YFBW)。
|
|
90
|
+
|
|
91
|
+
### 内部の変更
|
|
92
|
+
|
|
93
|
+
- `src/` を機能ごとのサブディレクトリ(`exec/`・`register/`・`grade/`・`shared/` など)へ分け、機能の間の依存の向きを ESLint で検査するようにしました。CLI の動作と出力は変わりません(PJR-V23P・PJR-X8Y9 ほか)。
|
|
94
|
+
|
|
5
95
|
## [0.3.1] - 2026-10-16
|
|
6
96
|
|
|
7
97
|
同梱パッケージの `@specdojo/docs-lint` と `@specdojo/docs-site` は、この版では公開しません(docs-lint の js-yaml の更新は次の docs-lint の版で公開します)。
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SpecDojo
|
|
2
2
|
|
|
3
|
-
SpecDojo
|
|
3
|
+
SpecDojo は、Spec道(仕様道)の道場です。
|
|
4
4
|
仕様と設計を作り、運用まで保つための体系を整えます。判断を記帳し、型に沿って実戦で書き、評定で鍛え続け、講評で完了を判断します。人と生成 AI が同じ成果物を作成・検証・更新できるようにし、仕様駆動開発のツールに対しては、その上流で仕様と設計の体系を担います。
|
|
5
5
|
|
|
6
6
|
**記して、形にして、磨き続ける。**
|
|
@@ -40,7 +40,7 @@ SpecDojo は、仕様道(Spec-Dō)の道場です。
|
|
|
40
40
|
|
|
41
41
|
v0.3.0 の `grade` は試験的な機能です。npm package では `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、これらを通しで実行する SpecDojo 本体リポジトリの開発用スクリプト `tools/grade/run-per-document.sh` は package に含まれません。成果物を評価するには、project の `catalog_path` も設定してください。1 文書を部品で評価する手順は [CLI コマンドリファレンス](docs/ja/specdojo/references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
[specdojo.org](https://specdojo.org/) では、SpecDojo の考え方と始め方を紹介しています。日本語の詳細文書は [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
|
|
44
44
|
|
|
45
45
|
## この README の役割
|
|
46
46
|
|
|
@@ -55,6 +55,8 @@ v0.3.0 の `grade` は試験的な機能です。npm package では `grade list`
|
|
|
55
55
|
|
|
56
56
|
### npm で導入する
|
|
57
57
|
|
|
58
|
+
Node.js 22.13 以上と Git を用意します。オーケストレーターに Claude Code を使う場合は、Claude Code も導入してログインしておきます。ほかの provider も選べます。
|
|
59
|
+
|
|
58
60
|
既定では、SpecDojo の記録をプロダクトの Git 履歴に混ぜないため、次の **別リポジトリ構成**で始めます。
|
|
59
61
|
|
|
60
62
|
- **プロダクトリポジトリ** `app1/`: ソースコードと、仕様・設計などのプロダクトドキュメントを置きます。
|
|
@@ -68,41 +70,44 @@ app1-workspace/
|
|
|
68
70
|
└── app1-specdojo-worktrees/ # タスクごとの作業場所
|
|
69
71
|
```
|
|
70
72
|
|
|
71
|
-
`app1
|
|
73
|
+
既に開発している `app1/` と並べてプロジェクトリポジトリを作り、SpecDojo を導入します。
|
|
72
74
|
|
|
73
75
|
```sh
|
|
74
|
-
mkdir app1-
|
|
75
|
-
|
|
76
|
-
|
|
76
|
+
mkdir app1-workspace
|
|
77
|
+
mkdir app1-workspace/app1-specdojo
|
|
78
|
+
git -C app1-workspace/app1-specdojo init
|
|
79
|
+
cd app1-workspace/app1-specdojo
|
|
77
80
|
npm init -y
|
|
78
|
-
npm install --save-dev specdojo
|
|
79
|
-
npx specdojo
|
|
81
|
+
npm install --save-dev specdojo
|
|
82
|
+
npx specdojo init
|
|
80
83
|
```
|
|
81
84
|
|
|
82
85
|
SpecDojo は開発時に使う文書・実行管理ツールなので、`--save-dev` で導入します。kata は、成果物を書くための規則・手順・テンプレート・サンプルの総称です。kata もインストールした package から参照されるため、`package-lock.json` によって SpecDojo と同じ版へ固定されます。
|
|
83
86
|
|
|
84
|
-
`
|
|
87
|
+
`specdojo init` の質問に答えると、`prj-0001` の設定、登録簿、人と AI の名簿、AI に実行させる設定、オーケストレーターを起動する npm script がまとめて作られます。Claude Code で AI に作業を任せる例では、provider に `claude`、exec の質問に「はい」を選びます。既存ファイルは上書きせず、作成内容は `--dry-run` で先に確認できます。
|
|
85
88
|
|
|
86
|
-
あわせて、`
|
|
89
|
+
あわせて、`node_modules/` と SpecDojo の生成物(`docs/**/generated/*`、`.specdojo/doc-index.json` など)を Git の管理から外す行が `.gitignore` に用意されます。すでに `node_modules/` や生成物を Git で管理している場合は、表示される案内に従って管理から外し、コミットします。
|
|
87
90
|
|
|
88
|
-
|
|
91
|
+
`@specdojo/docs-lint` は必須ではありません。SpecDojo 文書向けの検査を使う場合だけ、[ドキュメント編集ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/docs-editing-guide.html)に従って追加します。
|
|
89
92
|
|
|
90
|
-
|
|
93
|
+
### オーケストレーターを起動する
|
|
94
|
+
|
|
95
|
+
SpecDojo は、会話を CLI 操作へ変換する対話型オーケストレーターを同梱しています。`init` で Claude Code を選んだ場合は、追加された npm script で起動します。
|
|
91
96
|
|
|
92
97
|
```sh
|
|
93
|
-
|
|
98
|
+
npm run orch:opus
|
|
94
99
|
```
|
|
95
100
|
|
|
96
|
-
|
|
101
|
+
`orch:sonnet` も追加されます。これらの script は `specdojo orchestrator launch --provider claude` を経由して Claude Code を起動します。provider ごとの詳しい設定は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
|
|
97
102
|
|
|
98
103
|
| provider | 配置先 | 起動(`package.json` がある場合) |
|
|
99
104
|
| ------------- | ------------------------------------------- | --------------------------------- |
|
|
100
105
|
| `claude` | `.claude/agents/specdojo-orchestrator.md` | `npm run orch:opus` ほか |
|
|
101
106
|
| `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `npm run orch:opencode` |
|
|
102
|
-
| `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:
|
|
103
|
-
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:
|
|
107
|
+
| `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:sol` ほか |
|
|
108
|
+
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:flash` |
|
|
104
109
|
|
|
105
|
-
|
|
110
|
+
各設定を個別に管理したい場合は、後述の「設定を個別に行う場合」にある `config init` と `config scaffold` を使います。
|
|
106
111
|
|
|
107
112
|
Antigravity CLI を無人実行する場合は、利用者のグローバル設定へ permission rule を追加します。この設定はすべてのリポジトリに効くため、必ず先に差分を確認してから適用してください。通常の scaffold はグローバル設定へ触れません。
|
|
108
113
|
|
|
@@ -130,13 +135,14 @@ npx specdojo devcontainer scaffold --provider claude
|
|
|
130
135
|
|
|
131
136
|
```text
|
|
132
137
|
あなた : このプロジェクトを始めたい。まず登録簿を用意して、最初の作業を起票して。
|
|
133
|
-
オーケストレーター :
|
|
134
|
-
|
|
135
|
-
|
|
138
|
+
オーケストレーター : 登録簿を用意し、todo を 1 件起票します。
|
|
139
|
+
・中身: 種類 todo、タイトル「最初のタスク」、優先度 high
|
|
140
|
+
・影響: 登録簿のファイルを作成し、develop へ commit します
|
|
141
|
+
よろしいですか?
|
|
136
142
|
あなた : お願いします。
|
|
137
143
|
```
|
|
138
144
|
|
|
139
|
-
|
|
145
|
+
コマンドは既定では見せず、求めたときに見せます。状態を変える操作は承認を得てから実行し、`git push` や破壊的操作は行いません。起票した項目の
|
|
140
146
|
実行、状況の確認、成果物の生成も同じ流れで進みます。
|
|
141
147
|
|
|
142
148
|
```text
|
|
@@ -149,10 +155,9 @@ kata の rulebook を確認したい
|
|
|
149
155
|
|
|
150
156
|
### CLI を直接使う
|
|
151
157
|
|
|
152
|
-
|
|
158
|
+
オーケストレーターを使わずに操作することもできます。`init` が作成した登録簿へ、実施する作業を表す `todo` を起票し、一覧を生成します。
|
|
153
159
|
|
|
154
160
|
```sh
|
|
155
|
-
npx specdojo register scaffold --project prj-0001
|
|
156
161
|
npx specdojo register add \
|
|
157
162
|
--project prj-0001 \
|
|
158
163
|
--type todo \
|
|
@@ -160,6 +165,54 @@ npx specdojo register add \
|
|
|
160
165
|
npx specdojo register build --project prj-0001
|
|
161
166
|
```
|
|
162
167
|
|
|
168
|
+
### プロダクトリポジトリをつないで実行する
|
|
169
|
+
|
|
170
|
+
AI にプロダクトを変更させる前に、`.specdojo/specdojo.config.json` の `projects.prj-0001` へ、同じ workspace にあるプロダクトリポジトリを追加します。
|
|
171
|
+
|
|
172
|
+
```json
|
|
173
|
+
"repos": [
|
|
174
|
+
{
|
|
175
|
+
"name": "app1",
|
|
176
|
+
"path": "../app1",
|
|
177
|
+
"integration_branch": "main"
|
|
178
|
+
}
|
|
179
|
+
]
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
個票へ完了条件を書き、Claude Code の executor と reporter を指定して実行します。
|
|
183
|
+
|
|
184
|
+
```sh
|
|
185
|
+
npx specdojo exec run \
|
|
186
|
+
--project prj-0001 \
|
|
187
|
+
--register PJR-XXXX \
|
|
188
|
+
--worktree \
|
|
189
|
+
--executor-by claude-executor \
|
|
190
|
+
--reporter-by claude-reporter
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
完了後は両方のリポジトリの commit とプロダクトの動作を確認します。
|
|
194
|
+
|
|
195
|
+
```sh
|
|
196
|
+
git -C ../app1 log --oneline -1
|
|
197
|
+
git log --oneline -1
|
|
198
|
+
npm --prefix ../app1 run dev
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
人が result と成果物を確認し、気づいた改善を次の `todo` や `issue` として残してから、元の登録項目を close します。
|
|
202
|
+
|
|
203
|
+
```sh
|
|
204
|
+
npx specdojo register add \
|
|
205
|
+
--project prj-0001 \
|
|
206
|
+
--type todo \
|
|
207
|
+
--title "次の改善" \
|
|
208
|
+
--commit
|
|
209
|
+
npx specdojo register close \
|
|
210
|
+
--project prj-0001 \
|
|
211
|
+
--id PJR-XXXX \
|
|
212
|
+
--conclusion "完了条件を満たした" \
|
|
213
|
+
--commit
|
|
214
|
+
```
|
|
215
|
+
|
|
163
216
|
`exec run` と並行して記帳し、その変更だけを commit まで完了させる場合は、`register add` / `update` / `renumber` または状態遷移コマンドへ `--commit` を付けます。同じ project の `register lifecycle` 枠が空くまで待ち、ほかの未 commit 変更を含めずに記帳・一覧再生成・commit を行います。対象の個票や event に既存差分がある場合は、混在を避けるため記帳前に停止します。
|
|
164
217
|
|
|
165
218
|
ここまでの手順は、利用側へ kata をコピーせずに実行できます。生成された `todo` の個票が編集対象、
|
|
@@ -188,9 +241,16 @@ AI による実行は数分から数十分かかり、定期処理として登
|
|
|
188
241
|
実行を続けたい場合は、常時稼働するホストへリモート接続する構成例を
|
|
189
242
|
[常時稼働ホスト運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/remote-host-development-guide.html) に示しています。
|
|
190
243
|
|
|
191
|
-
###
|
|
244
|
+
### 設定を個別に行う場合
|
|
245
|
+
|
|
246
|
+
対話式の `init` を使わず、各設定を個別に管理したい場合は、`config init` と provider の `config scaffold` を順に実行します。
|
|
247
|
+
|
|
248
|
+
```sh
|
|
249
|
+
npx specdojo config init
|
|
250
|
+
npx specdojo config scaffold --provider claude
|
|
251
|
+
```
|
|
192
252
|
|
|
193
|
-
`config init` が作る設定は、`prj-0001`
|
|
253
|
+
`config init` が作る設定は、`prj-0001` の登録簿から始める最小構成です。別のプロジェクト ID や配置を使う場合は、`.specdojo/specdojo.config.json` を変更します。
|
|
194
254
|
|
|
195
255
|
- `current_project`: `--project` を省略したときに使うプロジェクトです。
|
|
196
256
|
- `projects`: このプロジェクトリポジトリで扱うプロジェクトを定義します。複数登録できます。
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { existsSync, readdirSync, readFileSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { load } from "
|
|
4
|
-
import { resolveBasePath, resolveDeliverablePath } from "./
|
|
5
|
-
import { isDctCatalogFileName } from "./
|
|
6
|
-
import { readSpecdojoNamespace } from "
|
|
3
|
+
import { load } from "../shared/yaml.js";
|
|
4
|
+
import { resolveBasePath, resolveDeliverablePath } from "./paths.js";
|
|
5
|
+
import { isDctCatalogFileName } from "./types.js";
|
|
6
|
+
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
7
7
|
// Walk all deliverables, resolving each one's document path using the
|
|
8
8
|
// leading-slash base_path convention (same rules as renderSections / dct build).
|
|
9
9
|
export function collectResolvedDeliverables(sections, parentBase, out) {
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { resolveBasePath } from "./paths.js";
|
|
2
|
+
import { buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
|
|
3
|
+
import { isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, renderSections, } from "../shared/catalog-render.js";
|
|
4
|
+
export { isRecord, isDctTemplateCatalog, renderCatalogTemplateBody };
|
|
5
|
+
function buildFrontmatter(doc) {
|
|
6
|
+
const inner = [];
|
|
7
|
+
inner.push(`id: ${doc.id}`);
|
|
8
|
+
inner.push(`type: ${doc.type}`);
|
|
9
|
+
inner.push(`status: ${doc.status}`);
|
|
10
|
+
if (doc.part_of && doc.part_of.length > 0) {
|
|
11
|
+
inner.push("part_of:");
|
|
12
|
+
for (const p of doc.part_of) {
|
|
13
|
+
const val = p.includes(":") ? `'${p}'` : p;
|
|
14
|
+
inner.push(` - ${val}`);
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
inner.push("rulebook: specdojo:dct-rulebook");
|
|
18
|
+
return buildSpecdojoFrontmatter(inner).split("\n");
|
|
19
|
+
}
|
|
20
|
+
export function buildMarkdown(doc) {
|
|
21
|
+
const lines = [];
|
|
22
|
+
lines.push(...buildFrontmatter(doc));
|
|
23
|
+
lines.push("");
|
|
24
|
+
lines.push(`# 成果物カタログ: ${doc.domain}`);
|
|
25
|
+
lines.push("");
|
|
26
|
+
lines.push(`- project-id: \`${doc.project_id}\``);
|
|
27
|
+
lines.push(`- ドメイン: \`${doc.domain}\``);
|
|
28
|
+
const topBase = resolveBasePath("", doc.base_path);
|
|
29
|
+
lines.push(...renderSections(doc.groups, topBase, 1, []));
|
|
30
|
+
lines.push("");
|
|
31
|
+
return lines.join("\n");
|
|
32
|
+
}
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { load } from "
|
|
4
|
-
import { isDctCatalogFileName } from "./
|
|
5
|
-
import { declaredIncludes, declaredKata } from "
|
|
6
|
-
import { readSpecdojoNamespace } from "
|
|
7
|
-
import { flattenTemplateFrontmatter } from "
|
|
8
|
-
import { specdojoRootDir } from "
|
|
9
|
-
import { buildMarkdown, isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, } from "./
|
|
10
|
-
import { collectResolvedDeliverables, validateBasedOn } from "./
|
|
11
|
-
import { resolveSpecdojoPath, resolveSpecdojoPathIfExists, specdojoDirectoryPaths, specdojoResourceCandidates, } from "
|
|
3
|
+
import { load } from "../shared/yaml.js";
|
|
4
|
+
import { isDctCatalogFileName } from "./types.js";
|
|
5
|
+
import { declaredIncludes, declaredKata } from "../kata/kata.js";
|
|
6
|
+
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
7
|
+
import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
|
|
8
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
9
|
+
import { buildMarkdown, isRecord, isDctTemplateCatalog, renderCatalogTemplateBody, } from "./build-render.js";
|
|
10
|
+
import { collectResolvedDeliverables, validateBasedOn } from "./build-references.js";
|
|
11
|
+
import { resolveSpecdojoPath, resolveSpecdojoPathIfExists, specdojoDirectoryPaths, specdojoResourceCandidates, } from "../docs/template-resolution.js";
|
|
12
12
|
const CATALOG_RULEBOOK_ID_PATTERN = /^(?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook$/;
|
|
13
13
|
const CATALOG_KATA_DIRS = {
|
|
14
14
|
rulebook: "rulebooks",
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
import { join, relative, resolve } from "node:path";
|
|
2
2
|
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { dirname } from "node:path";
|
|
4
|
-
import { load } from "
|
|
5
|
-
import { getProjectCatalogPath, loadConfig, loadEnv, SPECDOJO_CONFIG_REFERENCE_URL, specdojoRootDir, } from "
|
|
6
|
-
import { buildCatalog, collectCatalogLocalIds, loadDctIndex, validateBasedOn, validateCatalogDomains, validateCatalogIndex, validateCatalogLocalIds, validateDctDoc, validateRulebookKata, } from "./
|
|
7
|
-
import { collectDocIndexEntries } from "
|
|
8
|
-
import { deriveProjectId, runScaffold } from "./
|
|
9
|
-
import { isDctCatalogFileName } from "./
|
|
10
|
-
import { buildPlanSkeleton, DCT_PLAN_SCHEMA_PATH, domainFromPlanFileName, listPlanFiles, loadPlan, loadTemplateForDomain, planFileName, resolvePlanInputs, resolvePlanPath, resolvePlansDir, validateDctPlan, validatePlanSchema, writePlan, } from "./
|
|
11
|
-
import { renderPlanPrompt } from "./
|
|
12
|
-
import { generateCatalogsFromPlan, writeGeneratedCatalogs } from "./
|
|
13
|
-
import { resolveSpecdojoReferencePathIfExists, resolveSpecdojoTemplatesDir, } from "
|
|
4
|
+
import { load } from "../shared/yaml.js";
|
|
5
|
+
import { getProjectCatalogPath, loadConfig, loadEnv, SPECDOJO_CONFIG_REFERENCE_URL, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
6
|
+
import { buildCatalog, collectCatalogLocalIds, loadDctIndex, validateBasedOn, validateCatalogDomains, validateCatalogIndex, validateCatalogLocalIds, validateDctDoc, validateRulebookKata, } from "./build.js";
|
|
7
|
+
import { collectDocIndexEntries } from "../docs/doc-index.js";
|
|
8
|
+
import { deriveProjectId, runScaffold } from "./scaffold.js";
|
|
9
|
+
import { isDctCatalogFileName } from "./types.js";
|
|
10
|
+
import { buildPlanSkeleton, DCT_PLAN_SCHEMA_PATH, domainFromPlanFileName, listPlanFiles, loadPlan, loadTemplateForDomain, planFileName, resolvePlanInputs, resolvePlanPath, resolvePlansDir, validateDctPlan, validatePlanSchema, writePlan, } from "./plan.js";
|
|
11
|
+
import { renderPlanPrompt } from "./plan-prompt.js";
|
|
12
|
+
import { generateCatalogsFromPlan, writeGeneratedCatalogs } from "./plan-generate.js";
|
|
13
|
+
import { resolveSpecdojoReferencePathIfExists, resolveSpecdojoTemplatesDir, } from "../docs/template-resolution.js";
|
|
14
14
|
function readSizeFromDeclaration(catalogPath) {
|
|
15
15
|
const size = loadDctIndex(catalogPath)?.size;
|
|
16
16
|
return size === "small" || size === "medium" || size === "large" ? size : null;
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { dirname, join } from "node:path";
|
|
3
|
-
import { dump, load } from "
|
|
4
|
-
import { collectResolvedDeliverables } from "./
|
|
5
|
-
import { resolveBasePath } from "./
|
|
6
|
-
import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "
|
|
7
|
-
import { practiceLocalId } from "
|
|
8
|
-
import { flattenTemplateFrontmatter } from "
|
|
9
|
-
import { isDctCatalogFileName } from "./
|
|
10
|
-
import { resolveSpecdojoPathIfExists, } from "
|
|
3
|
+
import { dump, load } from "../shared/yaml.js";
|
|
4
|
+
import { collectResolvedDeliverables } from "./build.js";
|
|
5
|
+
import { resolveBasePath } from "./paths.js";
|
|
6
|
+
import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
7
|
+
import { practiceLocalId } from "../shared/practice-id.js";
|
|
8
|
+
import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
|
|
9
|
+
import { isDctCatalogFileName } from "./types.js";
|
|
10
|
+
import { resolveSpecdojoPathIfExists, } from "../docs/template-resolution.js";
|
|
11
11
|
const PROJECT_ID_PLACEHOLDER = "_PROJECT_ID_";
|
|
12
12
|
const LOCAL_ID_PLACEHOLDER = "_LOCAL_ID_";
|
|
13
13
|
const DELIVERABLE_NAME_PLACEHOLDER = "_DELIVERABLE_NAME_";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { resolveBasePath, resolveDeliverablePath, isTrashedPath } from "../shared/catalog-paths.js";
|
|
@@ -6,10 +6,10 @@
|
|
|
6
6
|
// implementation exists.
|
|
7
7
|
import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
|
|
8
8
|
import { join } from "node:path";
|
|
9
|
-
import { load } from "
|
|
10
|
-
import { collectCatalogLocalIds, validateDctDoc } from "./
|
|
11
|
-
import { collectTemplateEntries, diffPlanText, loadTemplatesForDomain, validateDctPlan, } from "./
|
|
12
|
-
import { catalogFileNameFromTemplate, dumpDctDoc, scaffoldDoc, } from "./
|
|
9
|
+
import { load } from "../shared/yaml.js";
|
|
10
|
+
import { collectCatalogLocalIds, validateDctDoc } from "./build.js";
|
|
11
|
+
import { collectTemplateEntries, diffPlanText, loadTemplatesForDomain, validateDctPlan, } from "./plan.js";
|
|
12
|
+
import { catalogFileNameFromTemplate, dumpDctDoc, scaffoldDoc, } from "./scaffold.js";
|
|
13
13
|
function newOverlay() {
|
|
14
14
|
return {
|
|
15
15
|
instances: new Map(),
|
|
@@ -6,11 +6,11 @@
|
|
|
6
6
|
// base_path, done_criteria) stays in the DCT template and is never copied into a plan.
|
|
7
7
|
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
8
8
|
import { basename, join, resolve } from "node:path";
|
|
9
|
-
import { dump, load } from "
|
|
10
|
-
import { resolveSpecdojoPath, specdojoDirectoryPaths } from "
|
|
9
|
+
import { dump, load } from "../shared/yaml.js";
|
|
10
|
+
import { resolveSpecdojoPath, specdojoDirectoryPaths } from "../docs/template-resolution.js";
|
|
11
11
|
import Ajv2020Module from "ajv/dist/2020.js";
|
|
12
|
-
import { collectResolvedDeliverables, loadCatalogDocs } from "./
|
|
13
|
-
import { isTrashedPath, resolveBasePath } from "./
|
|
12
|
+
import { collectResolvedDeliverables, loadCatalogDocs } from "./build.js";
|
|
13
|
+
import { isTrashedPath, resolveBasePath } from "./paths.js";
|
|
14
14
|
export const DCT_PLAN_SCHEMA_VERSION = 1;
|
|
15
15
|
export const DCT_PLAN_SCHEMA_PATH = "docs/specdojo/schemas/v1/dct-plan.schema.yaml";
|
|
16
16
|
const PLACEHOLDER_RE = /_([A-Z][A-Z0-9_]*)_/g;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
|
-
import { dump, load } from "
|
|
4
|
-
import { practiceLocalId } from "
|
|
5
|
-
import { specdojoDirectoryPaths } from "
|
|
3
|
+
import { dump, load } from "../shared/yaml.js";
|
|
4
|
+
import { practiceLocalId } from "../shared/practice-id.js";
|
|
5
|
+
import { specdojoDirectoryPaths, } from "../docs/template-resolution.js";
|
|
6
6
|
const PLACEHOLDER_RE = /_([A-Z][A-Z0-9_]*)_/g;
|
|
7
7
|
// js-yaml serializes all non-empty arrays in block style.
|
|
8
8
|
// Restore flow style for the `roles` field to match template formatting.
|