specdojo 0.4.7 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +14 -9
- package/CHANGELOG.md +46 -0
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/core.js +2 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +3 -2
- package/dist/exec/plans-generation.js +9 -5
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/register.js +16 -1
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +22 -0
- package/dist/exec/run/register-worktree.js +23 -0
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/grade/apply.js +6 -2
- package/dist/grade/markdown.js +7 -2
- package/dist/grade/plan.js +6 -4
- package/dist/register/approach.js +19 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +3 -0
- package/dist/register/create-commands.js +34 -4
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +10 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +42 -4
- package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +50 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +14 -9
|
@@ -27,7 +27,7 @@ SpecDojo CLI の初期設定から始め、register で課題と判断を整理
|
|
|
27
27
|
- register のtypeと状態遷移は [登録簿運用ガイド](register-operation-guide.md) を参照してください。
|
|
28
28
|
- Scheduleの自動・手動実行は [Schedule実行運用ガイド](schedule-operation-guide.md)、agent設定は [exec設定ガイド](exec-config-guide.md) を参照してください。
|
|
29
29
|
|
|
30
|
-
各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo`
|
|
30
|
+
各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo` サブコマンドへ変換し、状態を変える操作は実行前に内容を提示して承認を求めます。オーケストレーターはターミナル(`npm run orch:<provider>`)だけでなく、VS Code の各種拡張機能(Copilot Chat、Claude Code、Codex)からも利用できます。導入先での設定と起動方法は [オーケストレーター運用ガイド](orchestrator-operation-guide.md)(VS Code からの利用は [VS Code から使う](orchestrator-operation-guide.md#22-vs-code-から使う) 節)を参照してください。`<project-id>` などのプレースホルダは実際の値に読み替えてください。
|
|
31
31
|
|
|
32
32
|
## 1. 10分で体験する — 仕様の判断台帳
|
|
33
33
|
|
|
@@ -336,6 +336,15 @@ npx specdojo config init
|
|
|
336
336
|
|
|
337
337
|
`specdojo config init` は `.specdojo/specdojo.config.json` が存在しない場合に雛形を作成し、既存ファイルは上書きしません。雛形は register だけを使える最小構成であり、project パスはリポジトリルートを基準とし、`run.worktree_base` はディレクトリ名から作る `../<リポジトリ名>-worktrees` を指します。例えば `app1-specdojo/` では `../app1-specdojo-worktrees` です。作成された設定を開き、対象プロジェクトの ID と各パスを実際の名前に合わせてください。catalog、schedule、exec へ進むときに追加するキーと既定値は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] で確認できます。
|
|
338
338
|
|
|
339
|
+
通常の `init` と `config init` は、markdownlint の設定がなければリポジトリ直下に
|
|
340
|
+
`.markdownlint.yaml` も作ります。日本語の長い行などを許容するため、MD013・MD024・MD033・MD036・MD041・MD060
|
|
341
|
+
を無効にし、ほかの記法検査は維持します。既存の設定は上書きしません。既存の利用リポジトリでも
|
|
342
|
+
`npx specdojo config init --dry-run` で確認してから `npx specdojo config init` を再実行すると、
|
|
343
|
+
不足する設定を追加できます。設定がないままでも、exec の result の commit 前検査は同じ基本規則を使います。
|
|
344
|
+
既存設定で MD013 が有効ならその指定を優先するため、長い行を許容する場合は利用側の設定で
|
|
345
|
+
`MD013: false` を指定してください。CLI2 と hook の設定の関係は
|
|
346
|
+
[[specdojo:command-reference|CLIコマンドリファレンス]] を参照してください。
|
|
347
|
+
|
|
339
348
|
プロダクト文書は `app1/docs/ja/product/`、プロジェクト文書は `app1-specdojo/docs/ja/projects/` に置きます。同梱の SpecDojo の型(Kata)は `app1-specdojo/docs/ja/specdojo/<種類>s/`、このリポジトリで新しく作る kata はその下の `<kata_authority>/` から解決します。現行実装では1つの項目で両リポジトリを自動統合できないため、プロダクト文書や実装も変更する項目は分けるか、人が統合を管理します。詳細は [ドキュメント構成ガイド](docs-structure-guide.md) の `別リポジトリ構成` を参照してください。
|
|
340
349
|
|
|
341
350
|
成果物と実装を常に同じ変更・履歴として扱う場合に限り、**同一リポジトリ構成**としてプロダクトリポジトリのルートで同じ初期化手順を実行できます。CLI は構成を強制しません。
|
|
@@ -363,8 +372,11 @@ npm install
|
|
|
363
372
|
markdownlint で検査します。対象 project の `project_register_path` 配下を変更した場合は
|
|
364
373
|
`register build`、`catalog_path` 配下を変更した場合は `catalog validate` も実行します。
|
|
365
374
|
`catalog_path` がない構成には catalog の検査を生成せず、時間のかかるテストも pre-commit には
|
|
366
|
-
|
|
367
|
-
`.
|
|
375
|
+
含めません。設定がなければ、同じ基本規則の `.markdownlintrc` と VS Code 向けの
|
|
376
|
+
`.markdownlint-cli2.yaml`、provider の agent 定義を検査から外す `.markdownlintignore` も生成します。
|
|
377
|
+
`init --lefthook` / `--slidev` もこの配置を使います。既存の `.markdownlint.yaml` などの設定と ignore は
|
|
378
|
+
`--force` を付けても保持します。CLI2 の overrides を使う場合は
|
|
379
|
+
[[specdojo:command-reference|CLIコマンドリファレンス]] の手順で既存設定を `.markdownlintrc` に移してください。
|
|
368
380
|
`lefthook.yml` と `tools/` の既存ファイルは `--force` なしでは上書きしません。
|
|
369
381
|
必要な npm script と devDependencies は書き込み前に表示し、同名の既存項目は `--force` を付けても
|
|
370
382
|
保持します。linked worktree または `node_modules` がない環境では installer が安全に skip するため、
|
|
@@ -794,16 +806,17 @@ npx specdojo register add \
|
|
|
794
806
|
|
|
795
807
|
どちらも別 project への起票では `--commit` が必須です。別リポジトリでは、相手に SpecDojo 0.4.2 以上と対象 project の統合ブランチが必要です。push は行わず、close などの状態遷移は対象 project の作業ツリーで行います。
|
|
796
808
|
|
|
797
|
-
### 3.14. issueからdecision、
|
|
809
|
+
### 3.14. issueからdecision、epic、成果物カタログ・Scheduleへ進む
|
|
798
810
|
|
|
799
|
-
|
|
811
|
+
プロジェクト立ち上げ時に、問題、判断、実施作業がまだ混在している場合は、次の順で具体化します。register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。
|
|
800
812
|
|
|
801
813
|
```text
|
|
802
814
|
issue(何が問題か)
|
|
803
815
|
-> decision(何を対象とするか)
|
|
804
|
-
->
|
|
805
|
-
->
|
|
806
|
-
-> schedule
|
|
816
|
+
-> epic(track の仕事を起票する)
|
|
817
|
+
-> 子 todo(成果物カタログや strategy を作成する)
|
|
818
|
+
-> schedule(成果物タスクの実行と進捗)
|
|
819
|
+
-> epic を完了する(人が判断)
|
|
807
820
|
```
|
|
808
821
|
|
|
809
822
|
```bash
|
|
@@ -821,22 +834,32 @@ npx specdojo register add \
|
|
|
821
834
|
--title "初期スコープと対象成果物を決定する" \
|
|
822
835
|
--topic decide-initial-scope
|
|
823
836
|
|
|
824
|
-
#
|
|
837
|
+
# チャット:「launch トラックの epic を起票して」
|
|
838
|
+
npx specdojo register add \
|
|
839
|
+
--project <project-id> \
|
|
840
|
+
--type epic \
|
|
841
|
+
--track launch \
|
|
842
|
+
--title "プロジェクト定義の仕様整備" \
|
|
843
|
+
--topic project-definition
|
|
844
|
+
|
|
845
|
+
# チャット:「epic から子 todo『成果物カタログを作成する』を起票して」
|
|
825
846
|
npx specdojo register add \
|
|
826
847
|
--project <project-id> \
|
|
827
848
|
--type todo \
|
|
828
|
-
--
|
|
849
|
+
--from <epic-id> \
|
|
829
850
|
--title "プロジェクト定義の成果物カタログを作成する" \
|
|
830
|
-
--topic create-project-definition-catalog
|
|
851
|
+
--topic create-project-definition-catalog \
|
|
852
|
+
--approach catalog-planning \
|
|
853
|
+
--target domain:project-definition
|
|
831
854
|
```
|
|
832
855
|
|
|
833
|
-
issue の調査結果を decision の選択肢へ、decision の結論を todo
|
|
856
|
+
issue の調査結果を decision の選択肢へ、decision の結論を track の `epic` とその子 todo へ引き継ぎます。decision は人が確定します。issue や子 todo は provider 未設定でも `exec plan --project <project-id> --register <PJR-ID>` で計画を確認でき、agent 設定後は `exec run --project <project-id> --register <PJR-ID> --worktree` で実行できます(`epic` 自体は実行対象外です)。
|
|
834
857
|
|
|
835
|
-
すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml`
|
|
858
|
+
すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml` を作成・検証した後に完了させます。todo の完了により `catalog_status` が `primary` と導出され、strategy 作成と Schedule への展開(`schedule build --track launch`)が可能になります。成果物タスクの途中の進捗は schedule の依存グラフで管理し、登録簿に個々の成果物タスクを二重管理しません。トラック完了時に人が `epic` を close します。
|
|
836
859
|
|
|
837
860
|
## 4. 発展: 成果物カタログからscheduleへ展開する
|
|
838
861
|
|
|
839
|
-
|
|
862
|
+
この経路では、epic の子 todo から成果物カタログ(`dct-<domain>.yaml`)とトラック戦略(`sch-strategy-<track>.yaml`)を作成して Schedule を生成し、依存関係に従ってタスクを実行します。
|
|
840
863
|
|
|
841
864
|
### 4.1. 成果物カタログを作成する
|
|
842
865
|
|
|
@@ -35,8 +35,8 @@ Register Operation Guide
|
|
|
35
35
|
- 個票の Frontmatter は現在値、`events/pjr-XXXX.yaml` は変更履歴の正本です。Git は両者の保存・配布・レビューを担いますが、コミット粒度を業務イベントの粒度として扱いません。
|
|
36
36
|
- 文書 ID `<project-id>:pjr-index` の解決先は `project-register/generated/pjr-index.md` です。`controls/**/generated/` はdoc-indexの限定的な走査対象であり、一覧自身を `[[id]]` で参照できます。
|
|
37
37
|
- 一覧と、状態別・優先度別・担当者別などの派生ビューは `generated/` 配下に生成される派生物であり、直接編集しません。
|
|
38
|
-
- 立ち上げ時は、未整理の問題・判断を `issue` / `question` / `decision`
|
|
39
|
-
-
|
|
38
|
+
- 立ち上げ時は、未整理の問題・判断を `issue` / `question` / `decision` で記録し、track ごとの `epic` を起票して子 todo でカタログや strategy を作成できます。
|
|
39
|
+
- register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。成果物タスクの進捗は schedule の依存グラフで管理し、個々の成果物タスクを登録簿に二重管理しません。進行中に発生した計画外の単発対応・調査・判断は、引き続き登録簿で追跡します([exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け` を参照してください)。
|
|
40
40
|
|
|
41
41
|
関連ドキュメントの関係は次のとおりです。
|
|
42
42
|
|
|
@@ -72,8 +72,7 @@ specdojo register scaffold --project <project-id>
|
|
|
72
72
|
|
|
73
73
|
逆に、次の事項は登録しません。
|
|
74
74
|
|
|
75
|
-
-
|
|
76
|
-
- 成果物カタログへ定義し、Scheduleへ展開済みの作業(立ち上げ時の個票は結論を残して完了する)
|
|
75
|
+
- schedule に展開された個々の成果物タスク(途中の進み具合は schedule で管理し、登録簿には二重管理しない。track 全体の着手承認と完了判断は `epic` で管理する)
|
|
77
76
|
- その場で完了し、後から追跡する必要がないもの
|
|
78
77
|
|
|
79
78
|
登録は `register add` で行います。ID は省略すると自動採番されます。
|
|
@@ -127,20 +126,36 @@ SpecDojo 自身のリポジトリへ起票する場合も、同じように別
|
|
|
127
126
|
|
|
128
127
|
値の一覧と個票 frontmatter の定義は [プロジェクト登録簿 作成ルール](../rulebooks/pjr-rulebook.md) と `register-item-frontmatter.schema.yaml` を正本とします。各 type の意味と、迷ったときの判断基準は次のとおりです。
|
|
129
128
|
|
|
130
|
-
| type | 意味
|
|
131
|
-
| ---------------- |
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
134
|
-
| `
|
|
135
|
-
| `
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
138
|
-
| `
|
|
129
|
+
| type | 意味 | 迷ったとき |
|
|
130
|
+
| ---------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
131
|
+
| `epic` | track ごとの大きな仕事と着手・完了判断 | 具体的な作業は `--from` でつなぐ子 todo にする。epic 自体は実行しない |
|
|
132
|
+
| `todo` | 実施が決まっている作業 | 変更判断を伴うなら `change-request`、外部待ちは `todo`/`issue` に登録し `register wait` で `waiting` にする |
|
|
133
|
+
| `question` | 回答・確認が必要な事項 | 共有だけでよいなら `note`、選択肢を決める判断なら `decision` |
|
|
134
|
+
| `risk` | まだ顕在化していない懸念 | すでに発生している問題なら `issue` |
|
|
135
|
+
| `issue` | 顕在化している問題 | 未発生の懸念なら `risk` |
|
|
136
|
+
| `change-request` | 成果物・仕様・計画に対する変更の要望 | 実施が確定済みの作業なら `todo` |
|
|
137
|
+
| `decision` | 記録・追跡する意思決定 | 判断材料が足りず確認が先なら `question` |
|
|
138
|
+
| `note` | 共有・備忘のための記録 | 回答や結論が必要なら `question` |
|
|
139
139
|
|
|
140
140
|
外部の対応・提供物への依存(外部待ち)には専用 type を設けない。対応が必要なら `todo` / `issue` として登録し、外部待ちで止まっている状態は `register wait` の `waiting` ステータスで表す。計画上の前提・制約・依存関係は `prj-assumptions-constraints-dependencies` 成果物へ整理する。
|
|
141
141
|
|
|
142
142
|
type は派生ビューの生成と `exec run --register` の挙動(`agent実行・定期実行との連携` を参照)に影響するため、内容が変質した場合は `register update` で見直します。
|
|
143
143
|
|
|
144
|
+
### 1.4. track の仕事を epic と子 todo で管理する
|
|
145
|
+
|
|
146
|
+
epic は `track` を Frontmatter に持ち、子 todo と schedule の進捗を材料に、人が完了を判断します。`tml-index.yaml` がある場合は、定義済みの track だけを指定できます。timeline がない project でも track の識別子を保持できます。
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
specdojo register add --type epic --title "業務の仕様整備" --topic business-specs --track business
|
|
150
|
+
specdojo register add --type todo --title "カタログを作成する" --topic business-catalog --from PJR-AB12
|
|
151
|
+
specdojo register update --id PJR-AB12 --track business
|
|
152
|
+
specdojo register build
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
`PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。timeline の配置は project の `timeline_path` に従い、省略時は project 配下の `timeline/tml-index.yaml` を参照します。add・update・build で track を検証し、変更は event に記録します。
|
|
156
|
+
|
|
157
|
+
`register build` は `generated/pjr-epic-items.md` に、epic ごとの直接の子項目とその type・現在の状態を表示します。別 project の子も project 修飾 ID で表示し、子がない epic も残します。孫は再帰的に表示しません。子の状態から epic を自動 close せず、完了基準を満たしたことを人が確認して `register close --id <epic-id> --conclusion "判断の根拠"` で `done` にします。`reject` / `defer` / `reopen` も todo と同じように使用できます。
|
|
158
|
+
|
|
144
159
|
## 2. 登録項目のライフサイクル
|
|
145
160
|
|
|
146
161
|
登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
|
|
@@ -303,6 +318,20 @@ specdojo register update \
|
|
|
303
318
|
|
|
304
319
|
### 2.4. 派生ビューの扱い
|
|
305
320
|
|
|
321
|
+
起票の由来は `derived_from`、実行前に完了しているべき先行項目は `depends_on` に記録します。由来だけでは実行順序を制限しません。
|
|
322
|
+
|
|
323
|
+
```bash
|
|
324
|
+
specdojo register add --type todo --title "後続の作業" --depends-on PJR-AB12 --depends-on prj-0002:PJR-CD34
|
|
325
|
+
specdojo register update --id PJR-EF56 --depends-on PJR-AB12
|
|
326
|
+
specdojo register update --id PJR-EF56 --depends-on -
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
`--depends-on` は反復指定でき、update では一覧を置換します。`-` 単独で削除し、変更は event に残ります。参照の書式と project 間の存在確認は `derived_from` と同じで、別 project は設定とローカル統合ブランチを必要とします。記帳前と `register build` で存在しない ID、自己参照、循環(project 間も含む)を拒否します。
|
|
330
|
+
|
|
331
|
+
先行項目がすべて `done` / `decided` になるまで、直接の `exec run --register` は先行 ID と状態を表示して停止します。`rejected` / `deferred` でも進めません。routine の sweep(`--register-filter`)は理由を出力して飛ばし、夜間 orchestrator はスキップ理由を朝報告にも記録します。スキップは件数上限を消費せず、個票を自動で `waiting` へ変更しません。同じ queue 内の先行項目を待って自動再選択はしないため、先行の完了後に次の sweep / 夜間実行で後続を選びます。
|
|
332
|
+
|
|
333
|
+
一覧の `depends_on` 列で先行項目を確認でき、`generated/pjr-dependent-items.md` では先行項目から後続項目を逆引きできます。
|
|
334
|
+
|
|
306
335
|
登録項目一覧と派生ビューは、個票を入力として `register build` で生成します。
|
|
307
336
|
|
|
308
337
|
```bash
|
|
@@ -415,7 +444,7 @@ specdojo exec run --project <project-id> --register PJR-0012 --in-place
|
|
|
415
444
|
specdojo exec run --project <project-id> --register PJR-0012 PJR-0013 --worktree --parallel 2
|
|
416
445
|
```
|
|
417
446
|
|
|
418
|
-
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`decision` / `note` は実行対象外です。
|
|
447
|
+
- type が `todo` / `issue` / `change-request` の項目は成果物・実装を変更する対応、`question` / `risk` の項目は調査して結論案を result に記録する対応になります。`epic` / `decision` / `note` は実行対象外です。
|
|
419
448
|
- 状態は register の遷移(`in-progress` / `review` / `waiting`)で追跡され、agent は項目を終端化しません。成功後は人が内容を確認して `register close` します。
|
|
420
449
|
- todo 個票に `approach` と `targets` を指定した場合、成果物カタログの `done_criteria` や kata 参照を取り込んだ schedule と共通の plan が生成されます(詳細は [exec運用ガイド](exec-operation-guide.md) の「register の todo から approach で成果物・kata を作る・直す手順」を参照してください)。
|
|
421
450
|
- 個票 Frontmatter の `targets` に宣言した変更対象文書は、plan 生成時に直近の自動評価(grade)結果があれば `_GRADE_FINDINGS_` として plan に展開されます。`targets` がない場合は finding を展開しません。「関連ドキュメント」は根拠や参考への導線であり、そこに wikilink があるだけでは解消対象になりません。表示は最大10文書・各20件までに制限され、超過分はサイドカーを参照するよう促します。サイドカーがない場合は「finding なし」と表示されます。
|
|
@@ -449,7 +478,7 @@ specdojo register update --project <project-id> --id PJR-0012 \
|
|
|
449
478
|
--autopilot - --by <approver> --reason "夜間 queue から除外"
|
|
450
479
|
```
|
|
451
480
|
|
|
452
|
-
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
481
|
+
`autopilot: approved` は「現在の個票に書かれた完了条件」の承認です。夜間 orchestrator は印のある `open` の todo・issue だけを ID 順に選びます。epic、decision、印のない項目、`waiting` の項目は実行しません。完了条件を変更した場合は一度承認を取り消し、変更後の条件を再確認して承認します。
|
|
453
482
|
|
|
454
483
|
夜間実行は `specdojo orchestrator night` が担います。worktree 隔離、post-review、自動 close / `waiting` への復帰を必須とし、件数、並列数、連続失敗停止、rate limit 時の fallback をオプションで制限します。承認範囲外の操作が必要になった失敗は、元項目を `derived_from` に持つ issue として起票します。結果は `execution/reports/night-orchestrator/` の朝報告 1 文書へ集約します。
|
|
455
484
|
|
|
@@ -144,30 +144,30 @@ SpecDojo では、成果物と、それを作るための型(Kata)を分け
|
|
|
144
144
|
|
|
145
145
|
## 5. プロジェクトの基本的な流れ
|
|
146
146
|
|
|
147
|
-
プロジェクトでは、最初からすべての成果物を作るのではなく、未整理の課題と判断を register
|
|
147
|
+
プロジェクトでは、最初からすべての成果物を作るのではなく、未整理の課題と判断を register で記録し、目的とスコープを明らかにしてから、トラックごとの `epic` を起点として必要な成果物を実行可能な単位へ展開します。
|
|
148
148
|
|
|
149
149
|
```mermaid
|
|
150
150
|
flowchart LR
|
|
151
151
|
A["register<br/>issue・questionを記録"]
|
|
152
152
|
B["decision<br/>目的・スコープを決定"]
|
|
153
|
-
C["
|
|
154
|
-
D["
|
|
155
|
-
E["
|
|
156
|
-
F["
|
|
153
|
+
C["epicを起票<br/>trackごとの仕事を管理"]
|
|
154
|
+
D["子todoからカタログ・strategy作成"]
|
|
155
|
+
E["Scheduleへ展開・実行"]
|
|
156
|
+
F["レビュー・確定・epic完了"]
|
|
157
157
|
|
|
158
158
|
A --> B --> C --> D --> E --> F
|
|
159
|
-
|
|
159
|
+
E -->|修正・次の反復| E
|
|
160
160
|
```
|
|
161
161
|
|
|
162
162
|
代表的な進め方は次のとおりです。
|
|
163
163
|
|
|
164
164
|
1. 未整理の問題、確認事項、判断事項があれば register に `issue` / `question` / `decision` として記録します。
|
|
165
165
|
2. 調査と判断を行い、プロジェクトの背景、目的、スコープ、成功条件、対象成果物を明らかにします。
|
|
166
|
-
3.
|
|
167
|
-
4.
|
|
168
|
-
5.
|
|
166
|
+
3. 業務の起点として track ごとに `epic` を起票し、その子 todo(`catalog-planning`)で成果物カタログを作成・検証して完了します。
|
|
167
|
+
4. カタログ作成 todo の完了から `catalog_status` が導出され、後続の子 todo(`strategy-planning`)で strategy を作成して Schedule に展開します。
|
|
168
|
+
5. 人またはエージェントが schedule の依存グラフに従って成果物を作成・更新します。途中の進み具合は schedule が持ちます。
|
|
169
169
|
6. 機械検証に加え、grade で成果物の品質を評価します。review は grade の結果を事実として受け取り、変更内容・実行記録・完了条件を照合してタスクの完了可否を判断します。
|
|
170
|
-
7. human が review result
|
|
170
|
+
7. human が review result と成果物を確認して最終承認と `ready` への確定を行い、トラック全体の成果を確認して人が `epic` を close します。
|
|
171
171
|
|
|
172
172
|
トラックの構成と実行順序は
|
|
173
173
|
[トラック設計ガイド](track-design-guide.md)、
|
|
@@ -181,15 +181,15 @@ flowchart LR
|
|
|
181
181
|
|
|
182
182
|
`SpecDojoとは` で挙げた3つの要素のうち、成果物と型で「何を・どう作るか」を定めた後、それを計画・実行・追跡・機械検証して最後まで通すのが **技(Waza)** です。技は、横軸を PDCA、縦軸を回し方(register / schedule / routine + Job)とする次のマトリクスで整理できます。
|
|
183
183
|
|
|
184
|
-
| 回し方
|
|
185
|
-
|
|
|
186
|
-
| register
|
|
187
|
-
| schedule
|
|
188
|
-
| routine + Job
|
|
184
|
+
| 回し方 | P(記す・計画する) | D(形にする) | C(評価する) | A(確定して次へ) |
|
|
185
|
+
| ------------------------------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
186
|
+
| register(親: 起点・承認・完了) | 起票し、完了条件を書く。track ごとに epic を起票し子 todo でカタログ・strategy を計画する | `exec run --register` で executor が実行する | reporter が result を書いて review へ進め、人が確かめる | runner が commit・統合する。close するか、reopen・change-request で直す(epic は人が判断) |
|
|
187
|
+
| schedule(子: 途中の進捗・依存実行) | 成果物カタログから Schedule へ展開する | `exec run --track` / `--auto` で実行する | grade(評定)と review | 統合して `ready` へ確定する。直して次の反復へ |
|
|
188
|
+
| routine + Job | Job に「何を・誰が確かめるか(`task.review`)」を、routine に「いつ」を書く | `routine run --due` が Job Run を作り、worktree で実行して runner が commit する | Job で指名した review agent が review し、verdict を出す | verdict に従って統合し、成功したときだけ checkpoint を進める |
|
|
189
189
|
|
|
190
190
|
A 列はいずれも、runner が確定して commit し、次の周回の起点にする点でそろっています。C 列は、誰が確かめるかの違いとして読めます。どの行でも、タスクの流(`approach`)が型をどこまで基準にするかを決めます。
|
|
191
191
|
|
|
192
|
-
|
|
192
|
+
register が業務の起点・着手承認・完了判断を持ち、途中の進み具合は schedule が持ちます。両者は親子の階層関係として連携し、成果物カタログの成果物をトラック・実行フェーズ(またはパス)・タスクへ展開し、plan の生成、実行、result の記録という流れで作業状態と結果を記録します。成果物カタログ・Schedule・実行管理(dct/sch/exec)の詳細な関係と図解は [ドキュメント構成ガイド](docs-structure-guide.md) の `成果物カタログ・Schedule・実行管理の関係` を参照してください。
|
|
193
193
|
|
|
194
194
|
成果物カタログと Schedule の関係、タスク設計は
|
|
195
195
|
[Schedule設計ガイド](schedule-design-guide.md)、
|
|
@@ -75,35 +75,39 @@ flowchart LR
|
|
|
75
75
|
|
|
76
76
|
### 2.4. Schedule着手可能トラックの判定
|
|
77
77
|
|
|
78
|
-
`
|
|
78
|
+
`timeline build` は `project_register_path` がある場合、`catalog-planning` の todo を domain ごとに読み、`done` が 1 件でもあればその domain を `primary` と導出します(対象 todo がない domain は手書き値を保持)。対象ドメインがすべて `primary` に達したトラックを `schedule_ready_tracks` として `timeline.json` へ列挙します。これは Schedule 展開(`schedule build --track <track>`)を開始してよいトラックの一覧です。
|
|
79
79
|
|
|
80
80
|
## 3. 運用タイミング
|
|
81
81
|
|
|
82
|
-
`timeline build`
|
|
82
|
+
`timeline build` は一度だけ実行するコマンドではなく、トラックの定義や register の状態変化に合わせて再実行する運用コマンドです。register の `epic` 起票から、子 todo によるカタログ・strategy 作成、Schedule への展開、完了判断までの流れは次のとおりです。
|
|
83
83
|
|
|
84
84
|
```mermaid
|
|
85
85
|
flowchart TD
|
|
86
|
-
A["人間がtml-index.yaml
|
|
87
|
-
B --> C
|
|
88
|
-
C
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
86
|
+
A["人間がtml-index.yamlを定義<br/>(トラック順序・並行可否・依存関係)"] --> B["specdojo timeline build"]
|
|
87
|
+
B --> C["register で track の epic を起票<br/>(register add --type epic --track <track>)"]
|
|
88
|
+
C --> D["子 todo で成果物カタログを作成<br/>(approach: catalog-planning)"]
|
|
89
|
+
D --> E["カタログ完成後、子 todo を close<br/>(register close --id <todo-id>)"]
|
|
90
|
+
E --> F["specdojo timeline build<br/>(register から catalog_status を導出)"]
|
|
91
|
+
F --> G{"schedule_ready_tracks に<br/>該当トラックがあるか"}
|
|
92
|
+
G -->|"あり"| H["子 todo で strategy を作成<br/>(approach: strategy-planning)"]
|
|
93
|
+
H --> I["specdojo schedule build --track <track><br/>(sch-track 生成・Schedule へ展開)"]
|
|
94
|
+
I --> J["schedule でタスクを実行<br/>(exec run --track / --auto)"]
|
|
95
|
+
J --> K["トラック完了後、epic を close<br/>(人が完了を判断)"]
|
|
96
96
|
G -->|"なし"| A
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
代表的な更新契機は次のとおりです。
|
|
100
100
|
|
|
101
|
-
| 更新契機
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
101
|
+
| 更新契機 | 実施すること |
|
|
102
|
+
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
|
|
103
|
+
| トラックの追加・順序計画 | `tml-index.yaml` にトラックを追加・更新し `timeline build` を実行する |
|
|
104
|
+
| track の epic 起票 | `register add --type epic --track <track>` で業務の起点となる epic を起票する |
|
|
105
|
+
| 成果物カタログの計画・作成 | epic の子 todo(`--approach catalog-planning --target domain:<domain>`)で判定・生成を進め、検証後に `register close` する |
|
|
106
|
+
| `catalog_status` の反映と着手可能判定 | `timeline build` を再実行する(register の todo 完了から `primary` が自動導出され、`schedule_ready_tracks` に反映される) |
|
|
107
|
+
| トラック戦略・Schedule の生成 | epic の子 todo(`--approach strategy-planning --target track:<track>`)で strategy 生成と `schedule build --track` を行う |
|
|
108
|
+
| Schedule の実行と epic の完了 | schedule でタスクを実行し、途中の進み具合を確認したうえで人が epic を `register close` する |
|
|
109
|
+
|
|
110
|
+
`timeline build` は register の個票から `catalog-planning` の todo を集めて `catalog_status` を導出します。カタログ作成の todo が `done` なら `primary`、着手中(`in-progress` / `waiting` / `review`)なら `draft`、`open` だけなら `not_started` と判定します。人間が書く計画である `tml-index.yaml` の手書き値は書き換えずに保持し、手書きの値と食い違うときは警告します。
|
|
107
111
|
|
|
108
112
|
### 3.1. 既にSchedule展開済みのトラックの扱い
|
|
109
113
|
|
|
@@ -115,23 +119,23 @@ flowchart TD
|
|
|
115
119
|
|
|
116
120
|
`catalog-scaffold.md` が示すドメインは、テンプレートに何が必要かが決まっていても、そのドメインで実際に何件の成果物インスタンスが要るかまでは決まっていません。この判定を agent に任せ、結果を機械可読な `dct-plan-<domain>.yaml` として残します。責務は次のとおり分担します。
|
|
117
121
|
|
|
118
|
-
| 段階 | 担当 | 出力
|
|
119
|
-
| ------------ | ----------------------------------- |
|
|
120
|
-
| 着手対象提示 | Timeline(`timeline build`) | `catalog-scaffold.md`(未作成カタログのドメイン一覧)
|
|
121
|
-
| 意味判断 | agent(`catalog plan`) | `dct-plan-<domain>.yaml`(インスタンス・根拠・未確定事項)
|
|
122
|
-
| 構造生成 | コード(`catalog scaffold --plan`) | `dct-<domain>.yaml`
|
|
123
|
-
| 状態更新 |
|
|
122
|
+
| 段階 | 担当 | 出力 |
|
|
123
|
+
| ------------ | ----------------------------------- | --------------------------------------------------------------------------------- |
|
|
124
|
+
| 着手対象提示 | Timeline(`timeline build`) | `catalog-scaffold.md`(未作成カタログのドメイン一覧) |
|
|
125
|
+
| 意味判断 | agent(`catalog plan`) | `dct-plan-<domain>.yaml`(インスタンス・根拠・未確定事項) |
|
|
126
|
+
| 構造生成 | コード(`catalog scaffold --plan`) | `dct-<domain>.yaml` |
|
|
127
|
+
| 状態更新 | register の todo 完了 | `timeline build` が導出する `catalog_status`(`tml-index.yaml` の値は保持・警告) |
|
|
124
128
|
|
|
125
129
|
- agent は成果物インスタンスの要否、placeholder 値、採用しない候補、未確定事項の整理だけを担当します。ID・パス・`groups`・`done_criteria` の組み立てと schema 適合はコード側の責務です。
|
|
126
130
|
- 判定は Timeline が着手対象として示したドメインに限定し、入力は data-flow を中心とした上流成果物と、既存カタログがある場合はその基準線に限定します。
|
|
127
|
-
- 判定計画が保存されても `catalog_status`
|
|
131
|
+
- 判定計画が保存されても `catalog_status` は自動では変わりません。カタログ作成の todo(`catalog-planning`)を完了(`register close`)し、`timeline build` を再実行することで `catalog_status` が `primary` と導出されます。
|
|
128
132
|
- 再判定時は既存の判定計画を無条件に置き換えず、差分をレビューしてから `--force` で更新します。
|
|
129
133
|
- 判定後は `catalog scaffold --plan --dry-run --domain <domain>` で差分を確認し、問題がなければ `--plan` で生成します。物理分割 domain は同じ `domain` の全 template から分割 DCT をまとめて生成します。
|
|
130
|
-
-
|
|
134
|
+
- 生成成功後は生成 DCT を確認・検証した後にカタログ作成の todo を close し、`timeline build` を再実行して `primary` の導出を確定します。
|
|
131
135
|
|
|
132
136
|
### 3.3. Schedule strategy 生成への引き渡し
|
|
133
137
|
|
|
134
|
-
|
|
138
|
+
カタログ作成の todo を完了した後は、Timeline の track と `domains` が新規 strategy の scope 解決に使われます。epic の子 todo(`--approach strategy-planning --target track:<track>`)で strategy に scope と成果物別 `approach_rules` を宣言した後、`schedule strategy generate` が facts と grade から approach を導出して標準 profile へ展開し、`schedule build --track <track>` で Schedule を生成します。
|
|
135
139
|
|
|
136
140
|
```text
|
|
137
141
|
tml-index.yaml + dct-*.yaml
|
|
@@ -152,9 +156,9 @@ tml-index.yaml + dct-*.yaml
|
|
|
152
156
|
|
|
153
157
|
## 5. アンチパターン
|
|
154
158
|
|
|
155
|
-
| アンチパターン | 問題
|
|
156
|
-
| ----------------------------------------------------------------- |
|
|
157
|
-
|
|
|
158
|
-
| `parallel_group` を安易に共通ラベルへ寄せる | 実際には並行させてはいけないトラックまで並行候補に見えてしまう
|
|
159
|
-
| Timeline に実行実績(完了日・進捗率)を書き戻す | 計画と実績の区別がつかなくなり、`sch-milestones.yaml` と情報が二重化する
|
|
160
|
-
| `timeline build` の生成物(`timeline-order.md` 等)を直接編集する | 次回 `timeline build` 実行時に上書きされ、編集内容が失われる
|
|
159
|
+
| アンチパターン | 問題 | 対策 |
|
|
160
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
161
|
+
| カタログ作成の todo を close しないまま放置する | `timeline build` が `catalog_status` を `primary` と導出できず、着手可能判定が進まない | カタログ完成と検証後に `register close` で todo を完了させ、`timeline build` で最新状態を導出する |
|
|
162
|
+
| `parallel_group` を安易に共通ラベルへ寄せる | 実際には並行させてはいけないトラックまで並行候補に見えてしまう | 並行させてよい理由が同じトラックだけを同じ `parallel_group` にする([タイムライン作成ルール](../rulebooks/tml-rulebook.md) の `order` と `parallel_group`) |
|
|
163
|
+
| Timeline に実行実績(完了日・進捗率)を書き戻す | 計画と実績の区別がつかなくなり、`sch-milestones.yaml` と情報が二重化する | 実績は `sch-milestones.yaml` と `generated/` に任せ、Timeline は計画のみを保持する |
|
|
164
|
+
| `timeline build` の生成物(`timeline-order.md` 等)を直接編集する | 次回 `timeline build` 実行時に上書きされ、編集内容が失われる | 変更したい内容は `tml-index.yaml` に反映してから `timeline build` を再実行する |
|