specdojo 0.1.0 → 0.2.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/LICENSE +22 -0
- package/README.md +142 -35
- package/dist/agent-response.js +27 -0
- package/dist/agent.js +124 -0
- package/dist/build-command.js +149 -0
- package/dist/build-if-stale.js +35 -0
- package/dist/catalog-build.js +1079 -0
- package/dist/catalog-generate.js +226 -0
- package/dist/catalog-paths.js +31 -0
- package/dist/catalog-plan-generate.js +301 -0
- package/dist/catalog-plan-prompt.js +73 -0
- package/dist/catalog-plan.js +471 -0
- package/dist/catalog-scaffold.js +255 -0
- package/dist/catalog-types.js +4 -0
- package/dist/catalog.js +606 -0
- package/dist/dashboard.js +990 -0
- package/dist/deliverable-trash.js +148 -0
- package/dist/deliverable.js +97 -0
- package/dist/dist-freshness.js +150 -0
- package/dist/doc-index.js +424 -0
- package/dist/exec-agent-config.js +172 -0
- package/dist/exec-agent-git-state.js +136 -0
- package/dist/exec-agent-protected-config.js +276 -0
- package/dist/exec-events.js +250 -112
- package/dist/exec-evidence.js +317 -0
- package/dist/exec-format.js +54 -0
- package/dist/exec-limit.js +202 -0
- package/dist/exec-parent-validation.js +169 -0
- package/dist/exec-pipeline-state.js +160 -0
- package/dist/exec-plans.js +1016 -0
- package/dist/exec-project.js +25 -11
- package/dist/exec-protection-handoff.js +169 -0
- package/dist/exec-provider-scaffold.js +99 -0
- package/dist/exec-register-resume.js +196 -0
- package/dist/exec-register.js +281 -0
- package/dist/exec-reporter.js +329 -0
- package/dist/exec-results.js +510 -0
- package/dist/exec-run-lock.js +149 -0
- package/dist/exec-run.js +4953 -0
- package/dist/exec-schedule-calendar.js +86 -9
- package/dist/exec-schedule-cpm.js +30 -12
- package/dist/exec-schedule-gantt-chart-render.js +428 -0
- package/dist/exec-schedule-gantt-chart-scope.js +111 -0
- package/dist/exec-schedule-gantt-chart.js +2 -0
- package/dist/exec-schedule-hash.js +34 -25
- package/dist/exec-schedule-index.js +200 -67
- package/dist/exec-schedule-initial.js +100 -0
- package/dist/exec-schedule-progress.js +51 -26
- package/dist/exec-schedule-ready.js +71 -27
- package/dist/exec-schedule.js +171 -93
- package/dist/exec-shared.js +146 -25
- package/dist/exec-strategy.js +547 -0
- package/dist/exec-task-view.js +64 -0
- package/dist/exec-trial.js +895 -0
- package/dist/exec-worktree-command.js +426 -0
- package/dist/exec-worktree-ops.js +847 -0
- package/dist/exec-worktree.js +359 -0
- package/dist/exec.js +744 -192
- package/dist/frontmatter-namespace.js +48 -0
- package/dist/git-environment.js +23 -0
- package/dist/grade-result.js +137 -0
- package/dist/grade.js +2456 -0
- package/dist/index-command.js +103 -0
- package/dist/job.js +1081 -0
- package/dist/kata-command.js +303 -0
- package/dist/kata.js +187 -0
- package/dist/package-paths.js +33 -0
- package/dist/practice-id.js +24 -0
- package/dist/register-date.js +122 -0
- package/dist/register-events.js +363 -0
- package/dist/register-history.js +323 -0
- package/dist/register-item.js +455 -0
- package/dist/register-migrate-timestamps.js +176 -0
- package/dist/register.js +2199 -0
- package/dist/review-plan.js +199 -0
- package/dist/review-types.js +1 -0
- package/dist/role-types.js +1 -0
- package/dist/routine.js +814 -0
- package/dist/schedule-approach.js +252 -0
- package/dist/schedule-build.js +552 -0
- package/dist/schedule-phase-sets.js +73 -0
- package/dist/schedule-strategy-generate.js +812 -0
- package/dist/schedule-strategy-profiles.js +276 -0
- package/dist/schedule.js +420 -0
- package/dist/spawn-self.js +28 -0
- package/dist/specdojo-config.js +133 -39
- package/dist/specdojo.js +56 -7
- package/dist/template-frontmatter.js +89 -0
- package/dist/template-resolution.js +92 -0
- package/dist/timeline-build.js +334 -0
- package/dist/timeline.js +107 -0
- package/dist/watch.js +313 -0
- package/dist/yaml-pages-command.js +28 -0
- package/dist/yaml-pages.js +180 -0
- package/dist/yaml-schema-modeline.js +49 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
- package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
- package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
- package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
- package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
- package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
- package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
- package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
- package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
- package/docs/ja/specdojo/guides/kata-guide.md +89 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
- package/docs/ja/specdojo/guides/review-guide.md +428 -0
- package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
- package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
- package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
- package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
- package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
- package/docs/ja/specdojo/guides/waza-guide.md +224 -0
- package/docs/ja/specdojo/index.md +33 -0
- package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
- package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
- package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
- package/docs/ja/specdojo/references/command-reference.md +718 -0
- package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
- package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
- package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/atc-sample.md +41 -0
- package/docs/ja/specdojo/samples/bac-sample.md +38 -0
- package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
- package/docs/ja/specdojo/samples/bds-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-sample.md +38 -0
- package/docs/ja/specdojo/samples/bps-sample.md +38 -0
- package/docs/ja/specdojo/samples/br-sample.md +40 -0
- package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
- package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cld-sample.md +38 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-sample.md +38 -0
- package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
- package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
- package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
- package/docs/ja/specdojo/samples/dec-sample.md +39 -0
- package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
- package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
- package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/etc-sample.md +38 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
- package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
- package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
- package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
- package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/itc-sample.md +38 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/mm-sample.md +35 -0
- package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
- package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
- package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
- package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
- package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
- package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
- package/docs/ja/specdojo/samples/opd-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
- package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
- package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
- package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
- package/docs/ja/specdojo/samples/otp-sample.md +68 -0
- package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
- package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
- package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
- package/docs/ja/specdojo/samples/pr-sample.md +39 -0
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
- package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
- package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
- package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
- package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
- package/docs/ja/specdojo/samples/sac-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-sample.md +38 -0
- package/docs/ja/specdojo/samples/sld-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-sample.md +38 -0
- package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
- package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
- package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/uis-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-sample.md +38 -0
- package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
- package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
- package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
- package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
- package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
- package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
- package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
- package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
- package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
- package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
- package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
- package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
- package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
- package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
- package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
- package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
- package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
- package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
- package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
- package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
- package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
- package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
- package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
- package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
- package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
- package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
- package/docs/ja/specdojo/templates/opr-template.md +85 -0
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
- package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
- package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
- package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
- package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
- package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
- package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
- package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
- package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
- package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
- package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
- package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
- package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
- package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
- package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
- package/docs/ja/specdojo/templates/stsd-template.md +57 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
- package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
- package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
- package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
- package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
- package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
- package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
- package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
- package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
- package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
- package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
- package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
- package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
- package/package.json +121 -24
- package/templates/antigravity/README.md +35 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
- package/templates/antigravity/orchestrator.md +146 -0
- package/templates/antigravity/pm-members-snippet.yaml +55 -0
- package/templates/claude/README.md +46 -0
- package/templates/claude/agents/claude-expert-review-executor.md +14 -0
- package/templates/claude/agents/claude-review-executor.md +14 -0
- package/templates/claude/agents/specdojo-orchestrator.md +153 -0
- package/templates/claude/settings.edit.json +6 -0
- package/templates/claude/settings.report.json +6 -0
- package/templates/claude/settings.review.json +7 -0
- package/templates/codex/README.md +61 -0
- package/templates/codex/agents/codex-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
- package/templates/codex/agents/codex-review-executor.toml +10 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
- package/templates/codex/orchestrator.md +146 -0
- package/templates/copilot/README.md +41 -0
- package/templates/copilot/exec-defaults-snippet.yaml +28 -0
- package/templates/copilot/pm-members-snippet.yaml +44 -0
- package/templates/opencode/README.md +41 -0
- package/templates/opencode/agents/opencode-executor.md +59 -0
- package/templates/opencode/agents/opencode-reporter.md +26 -0
- package/templates/opencode/agents/opencode-review-executor.md +48 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:specdojo-overview-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: ready
|
|
6
|
+
based_on:
|
|
7
|
+
- specdojo:docs-structure-guide
|
|
8
|
+
- specdojo:track-design-guide
|
|
9
|
+
- specdojo:waza-guide
|
|
10
|
+
- specdojo:document-metadata-standard
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 全体概要ガイド
|
|
14
|
+
|
|
15
|
+
Overview Guide
|
|
16
|
+
|
|
17
|
+
SpecDojo の目的、成果物体系、プロジェクトの進め方、遂行体系による実行管理の関係を一つの流れとして説明します。
|
|
18
|
+
SpecDojo に関わるすべての読者の入口となる文書であり、個別の規約や操作の詳細は関連 guide、standard、rulebook に委ねます。
|
|
19
|
+
|
|
20
|
+
**対象読者**
|
|
21
|
+
|
|
22
|
+
- SpecDojo をこれから導入する人、全体像を把握したいプロジェクト関係者、開発者、エージェント
|
|
23
|
+
|
|
24
|
+
**この文書で分かること**
|
|
25
|
+
|
|
26
|
+
- SpecDojo の目的、基本となる考え方、成果物体系、プロジェクトの進め方、成果物から実行管理への展開の関係
|
|
27
|
+
|
|
28
|
+
**次に読む文書**
|
|
29
|
+
|
|
30
|
+
- 目的から guide と reference を探す場合は、本書の `目的別の次の読み物` を参照してください。SpecDojo の guide と reference を目的別にまとめた唯一の一覧です。
|
|
31
|
+
- 文書の分類から把握する場合は [ドキュメント構成ガイド](docs-structure-guide.md)、CLI の操作から始める場合は [遂行の技活用ガイド](waza-guide.md) を参照してください。
|
|
32
|
+
|
|
33
|
+
## 1. SpecDojoとは
|
|
34
|
+
|
|
35
|
+
SpecDojo は、仕様駆動開発のためのドキュメントフレームワークです。
|
|
36
|
+
|
|
37
|
+
プロダクトの構築・改修に必要な情報を、単発の説明資料ではなく、相互に参照できる構造化された成果物として管理します。
|
|
38
|
+
人が内容と判断理由を理解でき、AI とツールが成果物を作成・検証・更新できる状態を目指します。
|
|
39
|
+
|
|
40
|
+
SpecDojo が提供するものは、大きく次の三つです。
|
|
41
|
+
|
|
42
|
+
| 要素 | 役割 |
|
|
43
|
+
| ---------- | --------------------------------------------------------------------------------------- |
|
|
44
|
+
| 成果物体系 | プロジェクトとプロダクトに必要な成果物を整理する |
|
|
45
|
+
| 実践体系 | 成果物を作るための方針、規約、手順、具体例、雛形を提供する |
|
|
46
|
+
| 遂行体系 | register / schedule / routine と CLI で、成果物の計画、実行、状態管理、機械検証を進める |
|
|
47
|
+
|
|
48
|
+
SpecDojo は開発プロセスそのものを一律に固定するものではありません。
|
|
49
|
+
プロジェクトの目的や規模に応じて必要な成果物を選び、それらの根拠、依存関係、完了条件を明らかにするための枠組みです。
|
|
50
|
+
|
|
51
|
+
## 2. 基本方針
|
|
52
|
+
|
|
53
|
+
SpecDojo では、文書をプロジェクトを定義・実行・検証するための成果物として扱います。
|
|
54
|
+
基本方針は次の3つです。「コードと同じ規律で管理し、型に沿って作成し、人と AI の双方が読める」ドキュメンテーションを目指します。
|
|
55
|
+
|
|
56
|
+
| 基本方針 | 概要 |
|
|
57
|
+
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
58
|
+
| Docs as Code | 正本を Git に置き、構造化・単一正本・生成・機械検証・ID とトレーサビリティで、コードと同じ規律で管理する |
|
|
59
|
+
| Kata・Waza・Ryu(型・技・流) | 成果物の作り方を Kata(rulebook / recipe / sample / template)として整え、Waza(`specdojo` CLI)で遂行し、Ryu(`approach`)で型をどこまで基準にするかを選ぶ |
|
|
60
|
+
| Human & AI Readability | 人が判断理由を理解でき、AI とツールが解析・生成・検証できる構造にする |
|
|
61
|
+
|
|
62
|
+
SpecDojo の文書は、説明・判断・方針を記述する Markdown と、人が管理する構造化データを記述する YAML、ツール連携・実行記録・生成物を記述する JSON を使い分けます。
|
|
63
|
+
文書やデータを識別・管理できるように、形式に応じたメタデータを埋め込みます。
|
|
64
|
+
|
|
65
|
+
- Markdown はファイル先頭の YAML Frontmatter に `id`、`type`、`status` などを記述します。
|
|
66
|
+
- 独立した YAML データファイルは Frontmatter を持たず、ファイル先頭のトップレベル項目にメタデータを記述します。
|
|
67
|
+
- JSON は Frontmatter を持たず、用途別のスキーマが定めるトップレベルの構造化項目にメタデータを記述します。
|
|
68
|
+
|
|
69
|
+
具体的な項目、必須条件、配置、検証方法は
|
|
70
|
+
[ドキュメントメタ情報標準](../standards/document-metadata-standard.md)
|
|
71
|
+
と各形式のスキーマを正本とします。
|
|
72
|
+
|
|
73
|
+
これらの設計理由、規約と設定の責務分担、運用上の判断基準は
|
|
74
|
+
[SpecDojo の考え方](../philosophy/specdojo-philosophy.md)
|
|
75
|
+
を参照してください。
|
|
76
|
+
|
|
77
|
+
## 3. SpecDojo Unitと二種類の文書
|
|
78
|
+
|
|
79
|
+
SpecDojo は、一つのプロダクト文脈に属する文書群を **SpecDojo Unit** という論理的な管理境界として捉えます。
|
|
80
|
+
一つの SpecDojo Unit には、プロダクトの最新状態と、そのプロダクトを構築・改修する複数のプロジェクトを格納できます。
|
|
81
|
+
|
|
82
|
+
```mermaid
|
|
83
|
+
flowchart TB
|
|
84
|
+
U["SpecDojo Unit<br/>一つのプロダクト文脈"]
|
|
85
|
+
PD["プロダクトドキュメント<br/>プロダクトの現在の正"]
|
|
86
|
+
P1["プロジェクトドキュメント<br/>prj-0001"]
|
|
87
|
+
P2["プロジェクトドキュメント<br/>prj-0002"]
|
|
88
|
+
|
|
89
|
+
U --> PD
|
|
90
|
+
U --> P1
|
|
91
|
+
U --> P2
|
|
92
|
+
P1 -->|構築・改修結果を反映| PD
|
|
93
|
+
P2 -->|構築・改修結果を反映| PD
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
プロダクトドキュメントはプロダクトの現在像、プロジェクトドキュメントは個別の構築・改修における目的、変更、実行、判断を表します。
|
|
97
|
+
|
|
98
|
+
利用プロジェクトの既定は Detached Unit です。プロダクト文書は実装と同じ `app1/`、プロジェクト文書と SpecDojo の実践体系・実行記録は `app1-specdojo/` に置き、記帳 commit をプロダクトの履歴から分離します。成果物と実装が常に同じ変更として動く場合に限り、同一リポジトリの Attached Unit を選びます。
|
|
99
|
+
|
|
100
|
+
| 分類 | 表すもの | ライフサイクル |
|
|
101
|
+
| ------------------------ | -------------------------------------------- | -------------------------------------- |
|
|
102
|
+
| プロダクトドキュメント | 業務仕様、システム設計などプロダクトの現在像 | 改修のたびに更新し、継続して管理する |
|
|
103
|
+
| プロジェクトドキュメント | 目的、スコープ、変更内容、実行・判断の記録 | プロジェクトごとに作成し、完了後に残す |
|
|
104
|
+
|
|
105
|
+
文書の分類、ライフサイクル、命名、ディレクトリ配置は
|
|
106
|
+
[ドキュメント構成ガイド](docs-structure-guide.md)
|
|
107
|
+
を参照してください。
|
|
108
|
+
|
|
109
|
+
## 4. 実践体系の役割
|
|
110
|
+
|
|
111
|
+
SpecDojo では、成果物と、それを作るための実践体系を分けて管理します。
|
|
112
|
+
実践体系は、成果物の作り方を支える次の8種類の文書として具体化されます。
|
|
113
|
+
|
|
114
|
+
| 種別 | 答える問い | 使い方 |
|
|
115
|
+
| ---------- | ---------------------------------------- | ---------------------------------------------- |
|
|
116
|
+
| philosophy | なぜその規約なのか、何を基準に判断するか | 規約の前提となる方針・概念を理解 |
|
|
117
|
+
| standard | 共通して従う規約は何か | メタデータ、命名、文書種別などの共通規約を確認 |
|
|
118
|
+
| rulebook | この成果物には何を書くか | 成果物固有の章構成、項目、記述規則を確認 |
|
|
119
|
+
| recipe | どのような手順と判断で作成するか | 作成・更新の進め方を確認 |
|
|
120
|
+
| template | どの形から書き始めるか | 新しい成果物の雛形として使用 |
|
|
121
|
+
| sample | 完成した記述はどのようになるか | 具体的な記述例として参照 |
|
|
122
|
+
| guide | 全体像や操作をどう理解すればよいか | 複数の概念や一連の操作を理解 |
|
|
123
|
+
| reference | 特定の項目・コマンド・成果物は何か | 一覧・比較・値を参照する |
|
|
124
|
+
|
|
125
|
+
これらは同じ内容を再掲するものではなく、それぞれ異なる問いに答えます。
|
|
126
|
+
上表は概要です。各種別の役割、種別間の関係、成果物への紐付け方(rulebook フィールドや frontmatter による解決の仕組み)の正本は
|
|
127
|
+
[実践体系構成ガイド](practice-system-composition-guide.md)
|
|
128
|
+
です。
|
|
129
|
+
|
|
130
|
+
このうち exec plan が成果物の作成・レビュー時に参照するのは、rulebook / recipe / sample / template の4種です。この4種を **実践の型** と呼びます。philosophy / standard は全体に効く前提・共通規約として常に踏まえ、guide / reference は個別成果物に紐づかない横断文書として理解と参照に使います。実践の型を `approach` に応じてどこまで参照するかは
|
|
131
|
+
[実践の進め方ガイド](ryu-guide.md)
|
|
132
|
+
を参照してください。
|
|
133
|
+
|
|
134
|
+
ここでいう `reference` は文書種別です。実践の型として exec plan が参照する rulebook / recipe / sample / template とは別の役割として扱います。
|
|
135
|
+
|
|
136
|
+
## 5. プロジェクトの基本的な流れ
|
|
137
|
+
|
|
138
|
+
プロジェクトでは、最初からすべての成果物を作るのではなく、未整理の課題と判断を register で記録し、目的とスコープを明らかにしてから、必要な成果物を実行可能な単位へ展開します。目的・スコープ・対象成果物がすでに合意済みの場合は、register による立ち上げ整理を省略できます。
|
|
139
|
+
|
|
140
|
+
```mermaid
|
|
141
|
+
flowchart LR
|
|
142
|
+
A["register<br/>issue・questionを記録"]
|
|
143
|
+
B["decision<br/>目的・スコープを決定"]
|
|
144
|
+
C["todoから成果物カタログを作成"]
|
|
145
|
+
D["Scheduleへ展開"]
|
|
146
|
+
E["作成・更新"]
|
|
147
|
+
F["レビュー・確定"]
|
|
148
|
+
|
|
149
|
+
A --> B --> C --> D --> E --> F
|
|
150
|
+
F -->|修正・次の反復| E
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
代表的な進め方は次のとおりです。
|
|
154
|
+
|
|
155
|
+
1. 未整理の問題、確認事項、判断事項があれば register に `issue` / `question` / `decision` として記録します。
|
|
156
|
+
2. 調査と判断を行い、プロジェクトの背景、目的、スコープ、成功条件、対象成果物を明らかにします。
|
|
157
|
+
3. 決定した成果物カタログの作成を `todo` として追跡し、成果物の配置、依存関係、完了条件を `dct-<domain>.yaml` に定義します。
|
|
158
|
+
4. カタログ作成の `todo` を完了し、以後の計画済み作業を Schedule に展開します。
|
|
159
|
+
5. 人またはエージェントが成果物を作成・更新します。
|
|
160
|
+
6. 機械検証と内容レビューを行い、成果物を確定します。
|
|
161
|
+
|
|
162
|
+
トラックの構成と実行順序は
|
|
163
|
+
[トラック設計ガイド](track-design-guide.md)、
|
|
164
|
+
個々の成果物の目的は
|
|
165
|
+
[成果物リファレンス](../references/deliverables-reference.md)、
|
|
166
|
+
成果物を確定するレビューは
|
|
167
|
+
[レビューガイド](review-guide.md)
|
|
168
|
+
を参照してください。
|
|
169
|
+
|
|
170
|
+
## 6. 成果物から実行管理への展開
|
|
171
|
+
|
|
172
|
+
第1章で挙げた3つの体系のうち、成果物体系と実践体系で「何を・どう作るか」を定めた後、それを計画・実行・追跡・機械検証して最後まで通すのが **遂行体系** です。SpecDojo CLI は、成果物カタログの成果物をトラック・実行フェーズ(またはパス)・タスクへ展開し、plan の生成、実行、result の記録という流れで作業状態と結果を記録します。成果物カタログ・Schedule・実行管理(dct/sch/exec)の詳細な関係と図解は [ドキュメント構成ガイド](docs-structure-guide.md) の6章を参照してください。
|
|
173
|
+
|
|
174
|
+
成果物カタログと Schedule の関係、タスク設計は
|
|
175
|
+
[Schedule設計ガイド](schedule-design-guide.md)、
|
|
176
|
+
schedule実行の運用は
|
|
177
|
+
[Schedule実行運用ガイド](schedule-operation-guide.md)、
|
|
178
|
+
plan と result の管理は
|
|
179
|
+
[plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md)
|
|
180
|
+
を参照してください。
|
|
181
|
+
|
|
182
|
+
CLI の導入は
|
|
183
|
+
[遂行の技活用ガイド](waza-guide.md)、
|
|
184
|
+
実行と状態管理は
|
|
185
|
+
[exec運用ガイド](exec-operation-guide.md)
|
|
186
|
+
を参照してください。
|
|
187
|
+
|
|
188
|
+
## 7. 遂行を支える機能
|
|
189
|
+
|
|
190
|
+
主となる成果物作成フローのほかに、継続的なプロジェクト運営を支える機能があります。
|
|
191
|
+
|
|
192
|
+
| 機能 | 用途 | 参照先 |
|
|
193
|
+
| ------------------ | ------------------------------------------------------ | ------------------------------------------------ |
|
|
194
|
+
| プロジェクト登録簿 | 立ち上げ時の課題・判断と、進行中の計画外事項を管理する | [登録簿運用](register-operation-guide.md) |
|
|
195
|
+
| routine | 時刻条件のある定期作業を実行する | [routine運用](routine-operation-guide.md) |
|
|
196
|
+
| branch / worktree | プロジェクトやタスクの変更を分離して安全に統合する | [ブランチワークフロー](branch-workflow-guide.md) |
|
|
197
|
+
| exec設定 | エージェント、実行要件、権限、共通ポリシーを設定する | [exec設定](exec-config-guide.md) |
|
|
198
|
+
|
|
199
|
+
これらはすべてのプロジェクトで一度に導入する必要はありません。register は未整理事項がある立ち上げ時にも使用し、合意済みの計画作業へ移った後は、必要になった管理機能を段階的に利用します。
|
|
200
|
+
|
|
201
|
+
## 8. 目的別の次の読み物
|
|
202
|
+
|
|
203
|
+
本章は SpecDojo の philosophy、guide、reference を目的から引くための一覧です。文書が増えたときは本章を更新し、他の文書には同じ横断一覧を置きません。シナリオ(やりたいこと)から進め方の筋道を辿る場合は [ユースケース別ガイド](use-case-guide.md) を参照してください。本章はトピックから文書を引く索引、ユースケース別ガイドは状況ごとの進め方を示す筋道として役割を分けます。
|
|
204
|
+
|
|
205
|
+
### 8.1. SpecDojoの考え方を理解する
|
|
206
|
+
|
|
207
|
+
本節の philosophy 2件は、作業を始める前に通読する必要はありません。文書体系を設計・保守するときや、記述の粒度・責務の判断に迷ったときに読めば足ります。
|
|
208
|
+
|
|
209
|
+
| 目的 | 参照先 |
|
|
210
|
+
| ---------------------------------------------- | --------------------------------------------------------------------------------- |
|
|
211
|
+
| SpecDojoの基本方針と設計理由を知る | [SpecDojo の考え方](../philosophy/specdojo-philosophy.md) |
|
|
212
|
+
| 要求・要件・仕様・設計・実装の違いを知る | [要求から実装までの考え方](../philosophy/needs-to-implementation-philosophy.md) |
|
|
213
|
+
| 文書の分類、ライフサイクル、配置を理解する | [ドキュメント構成ガイド](docs-structure-guide.md) |
|
|
214
|
+
| ファイル単位のディレクトリ配置を引く | [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) |
|
|
215
|
+
| 実践体系の種別・役割・成果物との関係を理解する | [実践体系構成ガイド](practice-system-composition-guide.md) |
|
|
216
|
+
|
|
217
|
+
### 8.2. 作成する成果物を決める
|
|
218
|
+
|
|
219
|
+
| 目的 | 参照先 |
|
|
220
|
+
| -------------------------------------------------- | ------------------------------------------------------------- |
|
|
221
|
+
| 成果物の種類、目的、主な内容を調べる | [成果物リファレンス](../references/deliverables-reference.md) |
|
|
222
|
+
| トラックの構成と実行順序を設計する | [トラック設計ガイド](track-design-guide.md) |
|
|
223
|
+
| rulebook / recipe / sample / template を使い分ける | [実践の型活用ガイド](kata-guide.md) |
|
|
224
|
+
|
|
225
|
+
### 8.3. 成果物の作成を計画する
|
|
226
|
+
|
|
227
|
+
| 目的 | 参照先 |
|
|
228
|
+
| ------------------------------------------------------------------------------------------ | ---------------------------------------------- |
|
|
229
|
+
| 複数トラックの着手順序・並行可否を計画し、カタログ作成から Schedule 展開までを見通す | [Timeline設計ガイド](timeline-design-guide.md) |
|
|
230
|
+
| 成果物カタログから Schedule への流れを理解する、フェーズ・タスク・依存関係・反復を設計する | [Schedule設計ガイド](schedule-design-guide.md) |
|
|
231
|
+
|
|
232
|
+
### 8.4. プロジェクトを実行・管理する
|
|
233
|
+
|
|
234
|
+
| 目的 | 参照先 |
|
|
235
|
+
| ----------------------------------------------------------------------- | ----------------------------------------------------------------- |
|
|
236
|
+
| 最短手順で1タスクを動かしてみる | [Quick Startガイド](quick-start-guide.md) |
|
|
237
|
+
| CLIの役割、初期設定、代表フローを知る | [遂行の技活用ガイド](waza-guide.md) |
|
|
238
|
+
| コマンドとオプションを調べる | [CLIコマンドリファレンス](../references/command-reference.md) |
|
|
239
|
+
| 実行経路(schedule / register / routine)を使い分け、中断・再実行を扱う | [exec運用ガイド](exec-operation-guide.md) |
|
|
240
|
+
| scheduleタスクを自動・手動で実行する | [Schedule実行運用ガイド](schedule-operation-guide.md) |
|
|
241
|
+
| 定期実行する | [routine運用ガイド](routine-operation-guide.md) |
|
|
242
|
+
| 課題、リスク、変更要求、意思決定を管理する | [登録簿運用ガイド](register-operation-guide.md) |
|
|
243
|
+
| エージェント、権限、exec の共通設定を変更する | [exec設定ガイド](exec-config-guide.md) |
|
|
244
|
+
| planとresultの生成・保管・再実行を理解する | [plan/resultライフサイクルガイド](plan-result-lifecycle-guide.md) |
|
|
245
|
+
| projectとtaskのブランチを運用する | [ブランチワークフローガイド](branch-workflow-guide.md) |
|
|
246
|
+
| worktreeを使って手動で隔離実行する | [exec worktree運用ガイド](exec-worktree-guide.md) |
|
|
247
|
+
| 対話でCLI操作を進める | [オーケストレーター運用ガイド](orchestrator-operation-guide.md) |
|
|
248
|
+
|
|
249
|
+
### 8.5. 成果物を確定・編集する
|
|
250
|
+
|
|
251
|
+
| 目的 | 参照先 |
|
|
252
|
+
| -------------------------------------------------- | ----------------------------------------------- |
|
|
253
|
+
| 妥当性、整合性、トレーサビリティを確認して確定する | [レビューガイド](review-guide.md) |
|
|
254
|
+
| Markdownの見出し番号や表を編集する | [ドキュメント編集ガイド](docs-editing-guide.md) |
|
|
255
|
+
|
|
256
|
+
最初に全機能を理解する必要はありません。
|
|
257
|
+
導入時は「構成を理解する」「必要な成果物を選ぶ」「小さな Schedule で実行する」の順に進み、必要に応じて登録簿、レビュー、自動実行へ範囲を広げます。
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:timeline-design-guide
|
|
4
|
+
type: guide
|
|
5
|
+
status: draft
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Timeline設計ガイド
|
|
9
|
+
|
|
10
|
+
Timeline Design Guide
|
|
11
|
+
|
|
12
|
+
Timeline(`tml-index.yaml`)の役割、`specdojo timeline build` の生成フロー、成果物カタログ作成から Schedule への展開までの運用タイミングを説明します。記述規範は [タイムライン作成ルール](../rulebooks/tml-rulebook.md) を、トラックの標準構成と実行順序の考え方は [トラック設計ガイド](track-design-guide.md) を参照します。
|
|
13
|
+
|
|
14
|
+
**対象読者**
|
|
15
|
+
|
|
16
|
+
- 複数トラックの着手順序・並行可否を計画し、成果物カタログ作成から Schedule 展開までの進め方を判断するプロジェクト計画担当者
|
|
17
|
+
|
|
18
|
+
**この文書で分かること**
|
|
19
|
+
|
|
20
|
+
- Timeline の役割、`timeline build` が行う wave 算出・カタログ scaffold 対象判定・整合性検証、運用タイミング、既存資産(track-design-guide、Schedule、成果物カタログ)との関係
|
|
21
|
+
|
|
22
|
+
**次に読む文書**
|
|
23
|
+
|
|
24
|
+
- `tml-index.yaml` の記述規範は [タイムライン作成ルール](../rulebooks/tml-rulebook.md)、成果物カタログから Schedule への展開は [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
|
|
25
|
+
|
|
26
|
+
## 1. Timelineの役割
|
|
27
|
+
|
|
28
|
+
Timeline は「どのトラックを、どの順で、いつ着手するか」というトラック粒度のマクロな順序を、着手前に人間が決めて記録する計画層です。プロジェクトに `tml-index.yaml` を 1 ファイルだけ置き、成果物カタログ作成(`dct-<domain>.yaml`)から Schedule 展開(`sch-strategy-<track>.yaml` / `sch-track-<track>.yaml`)までの見通しを 1 箇所にまとめます。
|
|
29
|
+
|
|
30
|
+
| 定義する内容 | 担当ファイル |
|
|
31
|
+
| -------------------------------- | ------------------------------ |
|
|
32
|
+
| トラックの着手順序・並行可否 | Timeline(`tml-index.yaml`) |
|
|
33
|
+
| 成果物の論理定義・完了単位 | 成果物カタログ(`dct-*.yaml`) |
|
|
34
|
+
| タスク粒度の日付・依存関係・担当 | Schedule(`sch-*.yaml`) |
|
|
35
|
+
|
|
36
|
+
成果物カタログ・Schedule との責務分担の詳細は [Schedule設計ガイド](schedule-design-guide.md) の `成果物カタログとの責務分担` を、Timeline と Schedule 双方が扱う「節目」の役割分担(`tml-index.yaml` と `sch-milestones.yaml`)は [タイムライン作成ルール](../rulebooks/tml-rulebook.md) の `sch-milestones.yamlとの役割分担` を参照してください。
|
|
37
|
+
|
|
38
|
+
## 2. `timeline build` の生成フロー
|
|
39
|
+
|
|
40
|
+
`specdojo timeline build` は `tml-index.yaml` を入力に、後続コマンド(`catalog scaffold --plan` / `schedule strategy generate` / `schedule build`)への入力情報を `timeline/generated/` へ出力する一方通行の生成コマンドです。生成物から `tml-index.yaml` を逆生成しません。
|
|
41
|
+
|
|
42
|
+
```mermaid
|
|
43
|
+
flowchart LR
|
|
44
|
+
A["tml-index.yaml<br/>(人間が着手前に決める計画)"] -->|"timeline build"| B["timeline-order.md<br/>着手wave一覧"]
|
|
45
|
+
A -->|"timeline build"| C["catalog-scaffold.md<br/>未作成カタログと実行コマンド"]
|
|
46
|
+
A -->|"timeline build"| D["timeline.json<br/>機械可読サマリー"]
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 2.1. 整合性検証
|
|
50
|
+
|
|
51
|
+
`timeline build` は生成前に `tracks[]` の整合性を検証し、次のいずれかを検出するとエラーで停止します(`--dry-run` でも同様に検証されます)。
|
|
52
|
+
|
|
53
|
+
| 検出する不整合 | 内容 |
|
|
54
|
+
| ------------------------- | --------------------------------------------------------------------- |
|
|
55
|
+
| track id の重複 | 同じ `track` 値が `tracks[]` に複数存在する |
|
|
56
|
+
| `depends_on` の未定義参照 | `depends_on` に挙げた track id が `tracks[]` に定義されていない |
|
|
57
|
+
| `order` との矛盾 | `depends_on` に挙げたトラックの `order` が、自分の `order` 以上である |
|
|
58
|
+
| 循環参照 | `depends_on` を辿ると自分自身に戻る |
|
|
59
|
+
|
|
60
|
+
次の状態は警告(生成は継続)として扱われます。
|
|
61
|
+
|
|
62
|
+
| 検出する警告 | 内容 |
|
|
63
|
+
| ------------------------------------------------------------------------------------- | -------------------------------------------- |
|
|
64
|
+
| `catalog_status: primary` なのに前提トラックが `primary` 未到達 | 依存先の準備が整う前に着手可能と宣言している |
|
|
65
|
+
| `catalog_status: not_started` なのに対象ドメインの `dct-<domain>.yaml` が既に存在 | Timeline側の状態更新が遅れている |
|
|
66
|
+
| `catalog_status` が `draft` 以上なのに対象ドメインの `dct-<domain>.yaml` が存在しない | Timeline側の状態更新が実態より先行している |
|
|
67
|
+
|
|
68
|
+
### 2.2. wave算出
|
|
69
|
+
|
|
70
|
+
`timeline build` は `order` を主キーにトラックを畳み込み、同じ `order` を持つトラックを 1 つの wave(着手単位)にまとめます。wave 内のトラックは並行して着手できる候補です。`parallel_group` は同じ wave 内でどのトラック同士が実際に並行してよいかを示すラベルであり、wave 算出そのものには使いません。
|
|
71
|
+
|
|
72
|
+
### 2.3. カタログ scaffold 対象の判定
|
|
73
|
+
|
|
74
|
+
トラックが対象とする各ドメインについて、既存の `dct-<domain>.yaml`(`dct-<domain>-<part>.yaml` の物理分割を含む)をファイル名ではなく各カタログの `domain` 値で突き合わせます。該当ドメインの成果物カタログが存在しない場合、`catalog-scaffold.md` へ生成先パスと `specdojo catalog scaffold --domain <domain>` の実行コマンドを列挙します。
|
|
75
|
+
|
|
76
|
+
### 2.4. Schedule着手可能トラックの判定
|
|
77
|
+
|
|
78
|
+
`catalog_status: primary` のトラックを `schedule_ready_tracks` として `timeline.json` へ列挙します。これは Schedule 展開(`schedule build --track <track>`)を開始してよいトラックの一覧です。
|
|
79
|
+
|
|
80
|
+
## 3. 運用タイミング
|
|
81
|
+
|
|
82
|
+
`timeline build` は一度だけ実行するコマンドではなく、`tml-index.yaml` を更新するたびに再実行する運用コマンドです。
|
|
83
|
+
|
|
84
|
+
```mermaid
|
|
85
|
+
flowchart TD
|
|
86
|
+
A["人間がtml-index.yamlを更新<br/>(トラック追加・順序見直し・catalog_status変更)"] --> B["specdojo timeline build"]
|
|
87
|
+
B --> C{"catalog-scaffold.mdに<br/>対象があるか"}
|
|
88
|
+
C -->|"あり"| P["specdojo catalog plan prompt / scaffold --domain <domain><br/>(agent判定→dct-plan-<domain>.yaml)"]
|
|
89
|
+
P --> D["specdojo catalog scaffold --domain <domain>"]
|
|
90
|
+
D --> E["成果物カタログをdraft→primaryへ完成させる"]
|
|
91
|
+
C -->|"なし"| E
|
|
92
|
+
E --> F["tml-index.yamlのcatalog_statusをprimaryへ更新"]
|
|
93
|
+
F --> B
|
|
94
|
+
B --> G{"schedule_ready_tracksに<br/>該当トラックがあるか"}
|
|
95
|
+
G -->|"あり"| H["specdojo schedule build --track <track>"]
|
|
96
|
+
G -->|"なし"| A
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
代表的な更新契機は次のとおりです。
|
|
100
|
+
|
|
101
|
+
| 更新契機 | 実施すること |
|
|
102
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------- |
|
|
103
|
+
| 新しいトラックを追加する | `tml-index.yaml` にトラックを追加し `timeline build` を再実行する |
|
|
104
|
+
| 成果物カタログの `draft` → `primary` 完成に伴い着手順序を確定する | `tml-index.yaml` の `catalog_status` を更新し `timeline build` を再実行する |
|
|
105
|
+
| 着手順の見直し(並行化・順序入れ替え)が必要になる | `order` / `parallel_group` / `depends_on` を更新し `timeline build` を再実行する |
|
|
106
|
+
| トラックの Schedule 展開前の最終確認 | `timeline build` を実行し `schedule_ready_tracks` に対象が含まれることを確認する |
|
|
107
|
+
|
|
108
|
+
### 3.1. 既にSchedule展開済みのトラックの扱い
|
|
109
|
+
|
|
110
|
+
`tml-index.yaml` の導入前から `sch-strategy-<track>.yaml` が存在し実行が始まっているトラックは、`catalog_status: primary` と `depends_on` をその実績に合わせて追認的に記載します。Timeline は実行結果を書き戻す文書ではないため([タイムライン作成ルール](../rulebooks/tml-rulebook.md) の禁止事項を参照)、進捗率や実際の着手日は書かず、順序判断の根拠は `note` に残します。この場合、`timeline build` を実行しても当該トラックの `catalog-scaffold.md` 対象は 0 件になりますが、まだ着手していない後続トラックの wave 算出・整合性検証には引き続き意味があります。
|
|
111
|
+
|
|
112
|
+
計画成果物をカタログと Schedule で管理する場合は、専用の `planning` トラックを最初の wave に置き、他トラックから依存させます。これにより、成果物カタログ索引、Timeline、Schedule 共通設定、着手済みトラックの assessment と strategy を、個別成果物トラックより先に整備できます。planning strategy 自身の循環回避は [Schedule設計ガイド](schedule-design-guide.md) の `Scheduleファイル` に従います。
|
|
113
|
+
|
|
114
|
+
### 3.2. 成果物インスタンス判定(`dct-plan-<domain>.yaml`)の位置づけ
|
|
115
|
+
|
|
116
|
+
`catalog-scaffold.md` が示すドメインは、テンプレートに何が必要かが決まっていても、そのドメインで実際に何件の成果物インスタンスが要るかまでは決まっていません。この判定を agent に任せ、結果を機械可読な `dct-plan-<domain>.yaml` として残します。責務は次のとおり分担します。
|
|
117
|
+
|
|
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
|
+
| 状態更新 | 人間 | `tml-index.yaml` の `catalog_status` |
|
|
124
|
+
|
|
125
|
+
- agent は成果物インスタンスの要否、placeholder 値、採用しない候補、未確定事項の整理だけを担当します。ID・パス・`groups`・`done_criteria` の組み立てと schema 適合はコード側の責務です。
|
|
126
|
+
- 判定は Timeline が着手対象として示したドメインに限定し、入力は data-flow を中心とした上流成果物と、既存カタログがある場合はその基準線に限定します。
|
|
127
|
+
- 判定計画が保存されても `catalog_status` は自動では変わりません。`primary` への昇格は、生成された成果物カタログを人間が確認してから `tml-index.yaml` を更新します。
|
|
128
|
+
- 再判定時は既存の判定計画を無条件に置き換えず、差分をレビューしてから `--force` で更新します。
|
|
129
|
+
- 判定後は `catalog scaffold --plan --dry-run --domain <domain>` で差分を確認し、問題がなければ `--plan` で生成します。物理分割 domain は同じ `domain` の全 template から分割 DCT をまとめて生成します。
|
|
130
|
+
- 生成成功だけでは `catalog_status` を変更しません。生成 DCT を人間が確認した後に `primary` へ更新し、`timeline build` を再実行します。
|
|
131
|
+
|
|
132
|
+
### 3.3. Schedule strategy 生成への引き渡し
|
|
133
|
+
|
|
134
|
+
カタログを確認した後は、Timeline の track と `domains` が新規 strategy の scope 解決に使われます。strategy に scope と成果物別 `approach_rules` を宣言した後、`schedule strategy generate` が facts と grade から approach を導出して標準 profile へ展開します。
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
tml-index.yaml + dct-*.yaml
|
|
138
|
+
-> sch-strategy-<track>.yaml に scope / approach_rules を宣言
|
|
139
|
+
-> schedule strategy generate --dry-run
|
|
140
|
+
-> sch-strategy-<track>.yaml
|
|
141
|
+
-> schedule build --track <track>
|
|
142
|
+
-> exec refresh
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
既存 strategy がある場合は、その `scope.catalogs` を人間が意図的に限定した正本として優先します。Timeline から追加で解決できるカタログが既存 scope に無い場合は警告し、generator が自動的に scope を広げることはありません。
|
|
146
|
+
|
|
147
|
+
具体的なコマンドと検証内容は [CLIコマンドリファレンス](../references/command-reference.md) の `catalog plan(成果物インスタンスの判定)`、記述ルールは [成果物カタログ(ドメイン別)作成ルール](../rulebooks/dct-rulebook.md) の `成果物カタログ判定計画(dct-plan-<domain>.yaml)` を参照します。
|
|
148
|
+
|
|
149
|
+
## 4. `track-design-guide.md` との関係
|
|
150
|
+
|
|
151
|
+
[トラック設計ガイド](track-design-guide.md) の `トラックの標準的な実行順序` は、進め方(アジャイル/ウォーターフォール)別の標準的な着手順序をプローズ(文章・表)で示します。`tml-index.yaml` は、プロジェクト固有の事情(並行化の可否、優先順位の入れ替え、対象外ドメインの除外)を踏まえてこのプローズを機械可読な `order` / `parallel_group` / `depends_on` へ落とし込んだものです。標準順序をそのまま採用する場合も、`tml-index.yaml` への記載は省略せず、`note` に「標準順序どおり」である旨を残します。
|
|
152
|
+
|
|
153
|
+
## 5. アンチパターン
|
|
154
|
+
|
|
155
|
+
| アンチパターン | 問題 | 対策 |
|
|
156
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
157
|
+
| `catalog_status` を更新しないまま成果物カタログを完成させる | `timeline build` の `schedule_ready_tracks` が実態とずれ、着手可能判定に使えない | 成果物カタログを `primary` にした時点で `tml-index.yaml` も同時に更新する |
|
|
158
|
+
| `parallel_group` を安易に共通ラベルへ寄せる | 実際には並行させてはいけないトラックまで並行候補に見えてしまう | 並行させてよい理由が同じトラックだけを同じ `parallel_group` にする([タイムライン作成ルール](../rulebooks/tml-rulebook.md) の `order` と `parallel_group`) |
|
|
159
|
+
| Timeline に実行実績(完了日・進捗率)を書き戻す | 計画と実績の区別がつかなくなり、`sch-milestones.yaml` と情報が二重化する | 実績は `sch-milestones.yaml` と `generated/` に任せ、Timeline は計画のみを保持する |
|
|
160
|
+
| `timeline build` の生成物(`timeline-order.md` 等)を直接編集する | 次回 `timeline build` 実行時に上書きされ、編集内容が失われる | 変更したい内容は `tml-index.yaml` に反映してから `timeline build` を再実行する |
|