specdojo 0.7.0 → 0.9.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 +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -2,163 +2,46 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:timeline-design-guide
|
|
4
4
|
type: guide
|
|
5
|
-
status:
|
|
5
|
+
status: deprecated
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# Timeline
|
|
8
|
+
# Timeline から epic への移行ガイド
|
|
9
9
|
|
|
10
|
-
Timeline
|
|
10
|
+
Timeline to Epic Migration Guide
|
|
11
11
|
|
|
12
|
-
Timeline(`tml-index.yaml
|
|
12
|
+
Timeline(`tml-index.yaml`)は非推奨です。全体計画は epic を正本とし、`dashboard build` で生成します。
|
|
13
13
|
|
|
14
14
|
**対象読者**
|
|
15
15
|
|
|
16
|
-
-
|
|
16
|
+
- 旧 Timeline を運用しているプロジェクト管理者、担当者
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
-
|
|
20
|
+
- 全体計画を epic へ移す手順と旧形式の互換運用
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
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
|
-
`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
|
-
|
|
80
|
-
## 3. 運用タイミング
|
|
81
|
-
|
|
82
|
-
`timeline build` は一度だけ実行するコマンドではなく、トラックの定義や register の状態変化に合わせて再実行する運用コマンドです。register の `epic` 起票から、子 todo によるカタログ・strategy 作成、Schedule への展開、完了判断までの流れは次のとおりです。
|
|
83
|
-
|
|
84
|
-
```mermaid
|
|
85
|
-
flowchart TD
|
|
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
|
-
G -->|"なし"| A
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
代表的な更新契機は次のとおりです。
|
|
100
|
-
|
|
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` の手書き値は書き換えずに保持し、手書きの値と食い違うときは警告します。
|
|
111
|
-
|
|
112
|
-
### 3.1. 既にSchedule展開済みのトラックの扱い
|
|
113
|
-
|
|
114
|
-
`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 算出・整合性検証には引き続き意味があります。
|
|
115
|
-
|
|
116
|
-
計画成果物をカタログと Schedule で管理する場合は、専用の `planning` トラックを最初の wave に置き、他トラックから依存させます。これにより、成果物カタログ索引、Timeline、Schedule 共通設定、着手済みトラックの assessment と strategy を、個別成果物トラックより先に整備できます。planning strategy 自身の循環回避は [Schedule設計ガイド](schedule-design-guide.md) の `Scheduleファイル` に従います。
|
|
117
|
-
|
|
118
|
-
### 3.2. 成果物インスタンス判定(`dct-plan-<domain>.yaml`)の位置づけ
|
|
119
|
-
|
|
120
|
-
`catalog-scaffold.md` が示すドメインは、テンプレートに何が必要かが決まっていても、そのドメインで実際に何件の成果物インスタンスが要るかまでは決まっていません。この判定を agent に任せ、結果を機械可読な `dct-plan-<domain>.yaml` として残します。責務は次のとおり分担します。
|
|
121
|
-
|
|
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` の値は保持・警告) |
|
|
128
|
-
|
|
129
|
-
- agent は成果物インスタンスの要否、placeholder 値、採用しない候補、未確定事項の整理だけを担当します。ID・パス・`groups`・`done_criteria` の組み立てと schema 適合はコード側の責務です。
|
|
130
|
-
- 判定は Timeline が着手対象として示したドメインに限定し、入力は data-flow を中心とした上流成果物と、既存カタログがある場合はその基準線に限定します。
|
|
131
|
-
- 判定計画が保存されても `catalog_status` は自動では変わりません。カタログ作成の todo(`catalog-planning`)を完了(`register close`)し、`timeline build` を再実行することで `catalog_status` が `primary` と導出されます。
|
|
132
|
-
- 再判定時は既存の判定計画を無条件に置き換えず、差分をレビューしてから `--force` で更新します。
|
|
133
|
-
- 判定後は `catalog scaffold --plan --dry-run --domain <domain>` で差分を確認し、問題がなければ `--plan` で生成します。物理分割 domain は同じ `domain` の全 template から分割 DCT をまとめて生成します。
|
|
134
|
-
- 生成成功後は生成 DCT を確認・検証した後にカタログ作成の todo を close し、`timeline build` を再実行して `primary` の導出を確定します。
|
|
135
|
-
|
|
136
|
-
### 3.3. Schedule strategy 生成への引き渡し
|
|
137
|
-
|
|
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 を生成します。
|
|
139
|
-
|
|
140
|
-
```text
|
|
141
|
-
tml-index.yaml + dct-*.yaml
|
|
142
|
-
-> sch-strategy-<track>.yaml に scope / approach_rules を宣言
|
|
143
|
-
-> schedule strategy generate --dry-run
|
|
144
|
-
-> sch-strategy-<track>.yaml
|
|
145
|
-
-> schedule build --track <track>
|
|
146
|
-
-> exec refresh
|
|
24
|
+
- [[specdojo:register-operation-guide|登録簿運用ガイド]]
|
|
25
|
+
- [[specdojo:pjr-rulebook|プロジェクト登録簿ルール]]
|
|
26
|
+
|
|
27
|
+
## 1. 移行手順
|
|
28
|
+
|
|
29
|
+
1. 全体計画に載せる track ごとに epic を 1 件起票します。未着手の計画も `open` の epic にします。epic のない古い track は全体計画に出しません。
|
|
30
|
+
2. 旧 `tracks[].domains` を各 epic の `domains` へ移します。範囲の一部だけを扱う場合は個票の範囲の章で境界を記し、strategy の `scope.catalogs[].local_ids` で限定します。
|
|
31
|
+
3. 旧 track 間の `depends_on` を見直し、必要な順序を epic 間の `depends_on` に記録します。`order` と `parallel_group` は移しません。`derived_from` は由来なので依存へ自動転記しません。
|
|
32
|
+
4. 予定開始日を `start_on`、期限を `due_on` に記録します。`register add` / `update` の `--start-on <YYYY-MM-DD>` で設定できます。着手・完了は register の操作で記録します。旧 `planned_start_date` やカタログの見積りから実績を作らないでください。日付が分からない期間は未定のまま表示されます。
|
|
33
|
+
5. `register build` で epic の track 重複・依存循環を検査し、`dashboard build` で `execution/generated/` の全体計画と未作成カタログを確認します。
|
|
34
|
+
6. カタログから旧 `tml-index` のエントリと不要な依存を外します。外せない依存は理由と次の対応を記録して保留します。既存ファイルは互換用に保持でき、削除は利用者が判断します。
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
specdojo register add --type epic --title "データモデルの整備" --topic data-model \
|
|
38
|
+
--track data-model --domain data-model --due 2026-11-30
|
|
39
|
+
# PJR-AB12 を作成した epic の ID に置き換える
|
|
40
|
+
specdojo register update --id PJR-AB12 --domain data-model
|
|
41
|
+
specdojo register build
|
|
42
|
+
specdojo dashboard build
|
|
147
43
|
```
|
|
148
44
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
具体的なコマンドと検証内容は [CLIコマンドリファレンス](../references/command-reference.md) の `catalog plan(成果物インスタンスの判定)`、記述ルールは [成果物カタログ(ドメイン別)作成ルール](../rulebooks/dct-rulebook.md) の `成果物カタログ判定計画(dct-plan-<domain>.yaml)` を参照します。
|
|
152
|
-
|
|
153
|
-
## 4. `track-design-guide.md` との関係
|
|
154
|
-
|
|
155
|
-
[トラック設計ガイド](track-design-guide.md) の `トラックの標準的な実行順序` は、進め方(アジャイル/ウォーターフォール)別の標準的な着手順序をプローズ(文章・表)で示します。`tml-index.yaml` は、プロジェクト固有の事情(並行化の可否、優先順位の入れ替え、対象外ドメインの除外)を踏まえてこのプローズを機械可読な `order` / `parallel_group` / `depends_on` へ落とし込んだものです。標準順序をそのまま採用する場合も、`tml-index.yaml` への記載は省略せず、`note` に「標準順序どおり」である旨を残します。
|
|
156
|
-
|
|
157
|
-
## 5. アンチパターン
|
|
45
|
+
## 2. 互換運用
|
|
158
46
|
|
|
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` を再実行する |
|
|
47
|
+
`tml-index.yaml`・`timeline build`・`timeline_path` は警告付きで互換を維持します。epic がある project の全体計画は epic だけから作り、epic のない project は旧 timeline 表示を維持します。strategy の範囲解決は既存 strategy の scope、epic の `domains`、旧 timeline の順です。移行後も既存 scope が優先されるため、範囲が変わる場合は scope も確認してください。旧コマンドの仕様は [[specdojo:command-reference|コマンドリファレンス]] を参照してください。
|
|
@@ -45,7 +45,6 @@ Use Case Guide
|
|
|
45
45
|
- [LP を作る](#case-lp)
|
|
46
46
|
- [Next.js の Web サービスを作る](#case-nextjs)
|
|
47
47
|
- [Unity のゲームを作る](#case-unity)
|
|
48
|
-
- [共通運用と品質管理を確認する](#common-operations)
|
|
49
48
|
|
|
50
49
|
```mermaid
|
|
51
50
|
flowchart TD
|
|
@@ -53,19 +52,19 @@ flowchart TD
|
|
|
53
52
|
Q -->|ランディングページ| C1["ケース1: ランディングページ(LP)<br/>静的サイト・訴求・問い合わせ"]
|
|
54
53
|
Q -->|Webサービス・SaaS| C2["ケース2: Next.js Webサービス<br/>認証・API・DB連携フルスタック"]
|
|
55
54
|
Q -->|ゲーム開発| C3["ケース3: Unityゲーム<br/>2D/3D・C#ロジック・ステート管理"]
|
|
56
|
-
Q -->|共通の運用・品質管理| C4["共通運用と品質管理<br/>レビュー・隔離実行・ルーチン"]
|
|
57
55
|
|
|
58
56
|
C1 --> D1["1. 最初の相談と確認事項<br/>2. 成果物定義とカタログ<br/>3. register / schedule 進行<br/>4. プレビュー確認と運用"]
|
|
59
57
|
C2 --> D2["1. 要件・技術スタック確認<br/>2. データモデル・API仕様<br/>3. 文書の schedule と実装 todo<br/>4. テスト検証と運用"]
|
|
60
58
|
C3 --> D3["1. ゲームルール・役割分担<br/>2. システム・ステート設計<br/>3. C#スクリプト隔離実行<br/>4. Playモード確認と調整"]
|
|
61
|
-
C4 --> D4["・register(課題・判断・調査)<br/>・review(grade照合)と人の確定<br/>・worktree(安全な隔離実行)<br/>・routine(定期実行・日次巡回)"]
|
|
62
59
|
|
|
63
60
|
classDef caseNode fill:#e7f5ff,stroke:#1971c2,color:#000;
|
|
64
61
|
classDef detailNode fill:#f8f9fa,stroke:#adb5bd,color:#000;
|
|
65
|
-
class C1,C2,C3
|
|
66
|
-
class D1,D2,D3
|
|
62
|
+
class C1,C2,C3 caseNode;
|
|
63
|
+
class D1,D2,D3 detailNode;
|
|
67
64
|
```
|
|
68
65
|
|
|
66
|
+
どのケースでも、計画外の課題・判断の管理(register)、レビューと人の確定、worktree による隔離実行、routine による定期実行を使います。これらは「[プロダクト開発に共通する運用と品質管理](#common-operations)」にまとめています。
|
|
67
|
+
|
|
69
68
|
<a id="common-setup"></a>
|
|
70
69
|
|
|
71
70
|
### 1.1. 各ケースに共通する準備
|
|
@@ -150,42 +149,29 @@ human の確定タスクは [共通のレビュー手順](#review-and-finalize)
|
|
|
150
149
|
|
|
151
150
|
利用者がオーケストレーターに LP 作成の相談を開始します。オーケストレーターは必要な情報をヒアリングし、利用者の承認を得て進めます。
|
|
152
151
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
> 新サービスの告知用ランディングページを作りたいです。どんな構成で進めればよいでしょうか?
|
|
156
|
-
|
|
157
|
-
**オーケストレーター**:
|
|
158
|
-
|
|
159
|
-
> ランディングページの作成ですね。仕様を整理し、スムーズに AI へ実装を委譲できるように進めましょう。
|
|
160
|
-
>
|
|
161
|
-
> まず、以下の点についてご希望や前提を確認させてください:
|
|
162
|
-
>
|
|
163
|
-
> 1. **主なセクション**: Hero(トップ訴求)、特徴・強み、料金プラン、FAQ、問い合わせ/事前登録フォームなどを想定しますが、含めたい内容はありますか?
|
|
164
|
-
> 2. **技術スタック**: 高速な静的生成に向く Astro + Tailwind CSS、Next.js、シンプルな HTML/CSS などの選択肢があります。ご希望はありますか?
|
|
165
|
-
> 3. **公開先(ホスティング)**: Cloudflare Pages、GitHub Pages、Vercel などの候補があります。
|
|
166
|
-
> 4. **担当者と目標期限**: プロジェクト管理の記録(個票)に残す担当者ニックネームと目標期日をお知らせください。
|
|
167
|
-
>
|
|
168
|
-
> ご回答をもとに、技術選定の判断(decision)とプロジェクト定義(todo)の起票案を作成してご提示します。
|
|
169
|
-
|
|
170
|
-
**利用者**:
|
|
171
|
-
|
|
172
|
-
> 1. セクションは Hero、特徴3つ、料金プラン表、FAQ、問い合わせフォームでお願いします。
|
|
173
|
-
> 2. 技術は Astro + Tailwind CSS で進めたいです。
|
|
174
|
-
> 3. 公開先は Cloudflare Pages を想定しています。
|
|
175
|
-
> 4. 担当は alice、期限は 2026-12-15 でお願いします。
|
|
152
|
+
```chat
|
|
153
|
+
利用者: 新サービスの告知用ランディングページを作りたいです。どんな構成で進めればよいでしょうか?
|
|
176
154
|
|
|
177
|
-
|
|
155
|
+
オーケストレーター: ランディングページの作成ですね。仕様を整理し、スムーズに AI へ実装を委譲できるように進めましょう。
|
|
156
|
+
まず、以下の点についてご希望や前提を確認させてください:
|
|
157
|
+
1. **主なセクション**: Hero(トップ訴求)、特徴・強み、料金プラン、FAQ、問い合わせ/事前登録フォームなどを想定しますが、含めたい内容はありますか?
|
|
158
|
+
2. **技術スタック**: 高速な静的生成に向く Astro + Tailwind CSS、Next.js、シンプルな HTML/CSS などの選択肢があります。ご希望はありますか?
|
|
159
|
+
3. **公開先(ホスティング)**: Cloudflare Pages、GitHub Pages、Vercel などの候補があります。
|
|
160
|
+
4. **担当者と目標期限**: プロジェクト管理の記録(個票)に残す担当者ニックネームと目標期日をお知らせください。
|
|
161
|
+
ご回答をもとに、技術選定の判断(decision)とプロジェクト定義(todo)の起票案を作成してご提示します。
|
|
178
162
|
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
>
|
|
184
|
-
> 承認いただければ、起票コマンドを実行します。
|
|
163
|
+
利用者: 1. セクションは Hero、特徴3つ、料金プラン表、FAQ、問い合わせフォームでお願いします。
|
|
164
|
+
2. 技術は Astro + Tailwind CSS で進めたいです。
|
|
165
|
+
3. 公開先は Cloudflare Pages を想定しています。
|
|
166
|
+
4. 担当は alice、期限は 2026-12-15 でお願いします。
|
|
185
167
|
|
|
186
|
-
|
|
168
|
+
オーケストレーター: 承知しました。以下の内容で登録簿へ起票してよろしいでしょうか?
|
|
169
|
+
- **decision**: `Astro + Tailwind CSS と Cloudflare Pages による LP 構成の採択`(担当: alice, 期限: 2026-12-15)
|
|
170
|
+
- **todo**: `プロジェクト定義書と LP 画面仕様書の作成`(担当: alice, 期限: 2026-12-15)
|
|
171
|
+
承認いただければ、起票コマンドを実行します。
|
|
187
172
|
|
|
188
|
-
|
|
173
|
+
利用者: はい、承認します。実行してください。
|
|
174
|
+
```
|
|
189
175
|
|
|
190
176
|
### 2.3. 必要な成果物と作成順序
|
|
191
177
|
|
|
@@ -200,41 +186,31 @@ LP 作成で推奨される成果物と作成順序は次のとおりです。
|
|
|
200
186
|
|
|
201
187
|
[文書と実装の進行経路](#document-and-product-flow)に沿って、UI 仕様書等を register または文書の schedule で作成・レビューします。フォームは送信先、個人情報の扱い、成功・失敗時の表示を確認し、未決なら question / decision に残します。
|
|
202
188
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
> 画面仕様書を確定しました。コンポーネントの実装を進めてください。
|
|
206
|
-
|
|
207
|
-
**オーケストレーター**:
|
|
208
|
-
|
|
209
|
-
> 確定した仕様書と、接続済みの `lp-site` を確認します。まず Hero の文言と PC・スマホ表示を実装する todo を提案します。対象は Hero のコンポーネントと関連スタイル、完了条件は仕様どおりの表示と合意済みの検証の成功です。フォームは送信方式の決定後に別の todo にします。担当 alice、期限 2026-12-15 を引き継いでよいですか?
|
|
210
|
-
|
|
211
|
-
**利用者**:
|
|
189
|
+
```chat
|
|
190
|
+
利用者: 画面仕様書を確定しました。コンポーネントの実装を進めてください。
|
|
212
191
|
|
|
213
|
-
|
|
192
|
+
オーケストレーター: 確定した仕様書と、接続済みの `lp-site` を確認します。まず Hero の文言と PC・スマホ表示を実装する todo を提案します。対象は Hero のコンポーネントと関連スタイル、完了条件は仕様どおりの表示と合意済みの検証の成功です。フォームは送信方式の決定後に別の todo にします。担当 alice、期限 2026-12-15 を引き継いでよいですか?
|
|
214
193
|
|
|
215
|
-
|
|
194
|
+
利用者: はい。その範囲で起票し、worktree で実行してください。
|
|
216
195
|
|
|
217
|
-
|
|
196
|
+
オーケストレーター: 起票結果の PJR-ID を指定して実行します。executor が実装・検証結果を報告し、runner が設定済みの親検証と commit・統合を担当します。統合先は承認済み設定に従います。完了後に差分・検証記録とプレビューを確認していただきます。
|
|
197
|
+
```
|
|
218
198
|
|
|
219
199
|
#### 2.4.1. 実行後の確認対話
|
|
220
200
|
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
> Hero の差分と検証記録を提示します。PC・スマホ表示と文言を確認し、受け入れ可能か判断してください。フォームの送信確認は後続 todo の範囲です。
|
|
224
|
-
|
|
225
|
-
**利用者**:
|
|
201
|
+
```chat
|
|
202
|
+
オーケストレーター: Hero の差分と検証記録を提示します。PC・スマホ表示と文言を確認し、受け入れ可能か判断してください。フォームの送信確認は後続 todo の範囲です。
|
|
226
203
|
|
|
227
|
-
|
|
204
|
+
利用者: スマホでは見出しが長すぎます。文言を短くしてから、残りのセクションへ進めてください。
|
|
228
205
|
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
> 文言の修正案と対象仕様書への反映を提案し、合意した変更を記録して再検証します。受け入れ確認後に次の todo へ進みます。
|
|
206
|
+
オーケストレーター: 文言の修正案と対象仕様書への反映を提案し、合意した変更を記録して再検証します。受け入れ確認後に次の todo へ進みます。
|
|
207
|
+
```
|
|
232
208
|
|
|
233
209
|
### 2.5. 完成確認と変更・運用への流れ
|
|
234
210
|
|
|
235
211
|
- **手元での確認**: プロダクトで用意したプレビュー手順(`dev` script があれば `npm run dev`)で PC・スマートフォンの表示、フォームの入力検証・送信結果を確認します。公開は利用者が内容と公開先を確認してから行います。
|
|
236
212
|
- **変更の管理**: コピー文言の変更やデザイン調整の要望が出た場合は、勝手にコードを直さず `register add --type todo` で起票して履歴を残します。
|
|
237
|
-
- **運用の自動化**: デッドリンクの検査やライブラリのセキュリティ更新は、[[specdojo:routine-operation-guide|routine 運用ガイド]] に従って必要な検査ジョブと外部スケジューラを用意します。共通の変更管理・レビューは [
|
|
213
|
+
- **運用の自動化**: デッドリンクの検査やライブラリのセキュリティ更新は、[[specdojo:routine-operation-guide|routine 運用ガイド]] に従って必要な検査ジョブと外部スケジューラを用意します。共通の変更管理・レビューは 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
|
|
238
214
|
|
|
239
215
|
### 2.6. コマンドと設定差分(折りたたみ)
|
|
240
216
|
|
|
@@ -287,44 +263,30 @@ LP 向けの用途別ひな型を先に整備する方針です。本ガイド
|
|
|
287
263
|
|
|
288
264
|
### 3.2. 最初の相談と確認・判断事項
|
|
289
265
|
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
**オーケストレーター**:
|
|
315
|
-
|
|
316
|
-
> ありがとうございます。内容を整理しました。
|
|
317
|
-
>
|
|
318
|
-
> 以下の起票を行ってよろしいでしょうか?
|
|
319
|
-
>
|
|
320
|
-
> - **decision**: `NextAuth.js + Prisma (PostgreSQL) による認証・DB 基盤の採択`(担当: bob, 期限: 2026-12-31)
|
|
321
|
-
> - **todo**: `データモデル設計書(CCD/CDSD)と API インターフェース仕様書の作成`(担当: bob, 期限: 2026-12-31)
|
|
322
|
-
>
|
|
323
|
-
> 承認をいただければ起票します。
|
|
324
|
-
|
|
325
|
-
**利用者**:
|
|
326
|
-
|
|
327
|
-
> はい、承認します。
|
|
266
|
+
```chat
|
|
267
|
+
利用者: Next.js でユーザー認証とデータ管理機能がある Web サービスを開発したいです。仕様決めから実装までの流れを案内してください。
|
|
268
|
+
|
|
269
|
+
オーケストレーター: フルスタック Web サービスの構築ですね。セキュリティやデータ整合性が重要になりますので、段階を踏んで仕様を固めましょう。
|
|
270
|
+
以下の事項について、現時点の想定をお聞かせいただけますか?
|
|
271
|
+
1. **主要な機能要件**: ユーザー登録・ログイン、ダッシュボード表示、データの一覧・登録・編集・削除などを想定していますが、他に必要な機能はありますか?
|
|
272
|
+
2. **認証と DB の技術スタック**: NextAuth (Auth.js) / Supabase / Clerk などの認証方式や、Prisma / Drizzle などの ORM、DB(PostgreSQL / SQLite 等)のご希望はありますか?
|
|
273
|
+
3. **デプロイ先環境**: Vercel、Cloudflare(OpenNext)、AWS などの想定はありますか?
|
|
274
|
+
4. **担当者と期限**: プロジェクト管理上の担当者ニックネームと目標完了日をお知らせください。
|
|
275
|
+
ご提示いただいた条件をもとに、アーキテクチャ検討の decision と要件定義の todo を提案します。
|
|
276
|
+
|
|
277
|
+
利用者: 1. 機能はユーザー登録・ログイン、プロジェクト一覧と作成、アイテムの CRUD 管理です。
|
|
278
|
+
2. 認証は NextAuth.js、ORM は Prisma、DB は PostgreSQL を使いたいです。
|
|
279
|
+
3. デプロイ先は Vercel を予定しています。
|
|
280
|
+
4. 担当は bob、期限は 2026-12-31 でお願いします。
|
|
281
|
+
|
|
282
|
+
オーケストレーター: ありがとうございます。内容を整理しました。
|
|
283
|
+
以下の起票を行ってよろしいでしょうか?
|
|
284
|
+
- **decision**: `NextAuth.js + Prisma (PostgreSQL) による認証・DB 基盤の採択`(担当: bob, 期限: 2026-12-31)
|
|
285
|
+
- **todo**: `データモデル設計書(CCD/CDSD)と API インターフェース仕様書の作成`(担当: bob, 期限: 2026-12-31)
|
|
286
|
+
承認をいただければ起票します。
|
|
287
|
+
|
|
288
|
+
利用者: はい、承認します。
|
|
289
|
+
```
|
|
328
290
|
|
|
329
291
|
### 3.3. 必要な成果物と作成順序
|
|
330
292
|
|
|
@@ -344,27 +306,21 @@ Next.js アプリケーションでは、フロントエンドとバックエン
|
|
|
344
306
|
- **Phase 2(バックエンド・API 実装)**: データアクセス層、Server Actions / API ルートの実装、単体テスト。
|
|
345
307
|
- **Phase 3(フロントエンド実装)**: 画面コンポーネント、フォームバリデーション、データ取得フック。
|
|
346
308
|
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
> データモデルと API 仕様を確定しました。最初はプロジェクト一覧 API の実装をお願いします。
|
|
309
|
+
```chat
|
|
310
|
+
利用者: データモデルと API 仕様を確定しました。最初はプロジェクト一覧 API の実装をお願いします。
|
|
350
311
|
|
|
351
|
-
|
|
312
|
+
オーケストレーター: `saas-app` の接続、認証基盤と開発 DB の準備を確認します。今回の todo は一覧 API と権限検査、関連テストを対象にします。bob、2026-12-31 のまま進めてよいですか? 本番 DB の変更は別途判断します。
|
|
352
313
|
|
|
353
|
-
|
|
314
|
+
利用者: はい。その範囲で起票して実行してください。
|
|
354
315
|
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
> はい。その範囲で起票して実行してください。
|
|
358
|
-
|
|
359
|
-
**オーケストレーター**:
|
|
360
|
-
|
|
361
|
-
> 採番された todo を `exec run --register` の対象にし、worktree で実行します。`typecheck` やテストは、プロダクト側に script・依存関係・DB 等が用意され、実行設定に組み込まれているものを実行します。未準備の検証は完了扱いにせず、準備方法を記録します。
|
|
316
|
+
オーケストレーター: 採番された todo を `exec run --register` の対象にし、worktree で実行します。`typecheck` やテストは、プロダクト側に script・依存関係・DB 等が用意され、実行設定に組み込まれているものを実行します。未準備の検証は完了扱いにせず、準備方法を記録します。
|
|
317
|
+
```
|
|
362
318
|
|
|
363
319
|
### 3.5. 完成確認と変更・運用への流れ
|
|
364
320
|
|
|
365
321
|
- **結合テストと検証**: 合意した開発 DB とテストデータを用意し、ログイン、データ作成、他ユーザーのデータへのアクセス拒否、ログアウトを確認します。E2E テストが準備済みなら実行し、利用者が受け入れと公開可否を判断します。
|
|
366
322
|
- **セキュリティチェック**: 依存関係・静的解析・秘密情報の検査を候補に、公開先や契約条件に合う手段を選びます。CI やリポジトリ設定の変更案は利用者に提示し、承認された手段を準備します。
|
|
367
|
-
- **不具合や改善のトリアージ**: 開発中に発生した不具合は `register add --type issue` で起票し、AI に原因調査と修正を行わせます。詳細は [[specdojo:register-operation-guide|登録簿運用ガイド]] と [
|
|
323
|
+
- **不具合や改善のトリアージ**: 開発中に発生した不具合は `register add --type issue` で起票し、AI に原因調査と修正を行わせます。詳細は [[specdojo:register-operation-guide|登録簿運用ガイド]] と 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
|
|
368
324
|
|
|
369
325
|
### 3.6. コマンドと設定差分(折りたたみ)
|
|
370
326
|
|
|
@@ -419,42 +375,29 @@ npx specdojo exec run --project prj-0001 --register "<APIの起票結果のPJR-I
|
|
|
419
375
|
|
|
420
376
|
ゲーム開発では、アセットやバイナリの扱い、エディタでの手作業と AI が行うスクリプト実装の分担を最初に明確にする必要があります。
|
|
421
377
|
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
> Unity で 2D アクションゲームを制作したいです。仕様設計を行い、C# スクリプトの実装を AI に任せながら進めたいです。
|
|
378
|
+
```chat
|
|
379
|
+
利用者: Unity で 2D アクションゲームを制作したいです。仕様設計を行い、C# スクリプトの実装を AI に任せながら進めたいです。
|
|
425
380
|
|
|
426
|
-
|
|
381
|
+
オーケストレーター: Unity ゲームの開発ですね。エディタでの Scene/Prefab 構築と、AI が担当する C# スクリプトやデータ設計の役割分担を整理して進めましょう。
|
|
382
|
+
以下の事項について確認させてください:
|
|
383
|
+
1. **ゲームのコアルール**: ジャンル、基本アクション(移動・ジャンプ・攻撃等)、クリア・ゲームオーバー条件を教えてください。
|
|
384
|
+
2. **AI の担当範囲**: AI に任せるのは C# ロジック(プレイヤー操作、敵ステートマシン、スコア管理など)とパラメータ定義(ScriptableObject)でしょうか? Scene への Prefab 配置やスプライト描画は人間が担当する想定で合っていますか?
|
|
385
|
+
3. **バージョンとパッケージ**: Unity バージョン(例: 2022.3 LTS)や、新しい Input System パッケージの使用有無を教えてください。
|
|
386
|
+
4. **担当者と期限**: 記録に残す担当者ニックネームと目標マイルストーン期限をお知らせください。
|
|
387
|
+
ご確認いただければ、役割分担と基本アーキテクチャの decision、およびゲーム仕様設計の todo を起票します。
|
|
427
388
|
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
> 1. **ゲームのコアルール**: ジャンル、基本アクション(移動・ジャンプ・攻撃等)、クリア・ゲームオーバー条件を教えてください。
|
|
433
|
-
> 2. **AI の担当範囲**: AI に任せるのは C# ロジック(プレイヤー操作、敵ステートマシン、スコア管理など)とパラメータ定義(ScriptableObject)でしょうか? Scene への Prefab 配置やスプライト描画は人間が担当する想定で合っていますか?
|
|
434
|
-
> 3. **バージョンとパッケージ**: Unity バージョン(例: 2022.3 LTS)や、新しい Input System パッケージの使用有無を教えてください。
|
|
435
|
-
> 4. **担当者と期限**: 記録に残す担当者ニックネームと目標マイルストーン期限をお知らせください。
|
|
436
|
-
>
|
|
437
|
-
> ご確認いただければ、役割分担と基本アーキテクチャの decision、およびゲーム仕様設計の todo を起票します。
|
|
389
|
+
利用者: 1. 2D 横スクロールアクションで、移動・ジャンプと敵の踏みつけ、コイン収集でゴールを目指します。
|
|
390
|
+
2. はい、AI には C# スクリプトと ScriptableObject の作成を任せ、Scene 配置やアニメーション設定、Sprite の配置は私がエディタで行います。
|
|
391
|
+
3. Unity 2022.3 LTS で、Input System パッケージを使用します。
|
|
392
|
+
4. 担当は carol、プロトタイプ完成期限は 2027-01-31 でお願いします。
|
|
438
393
|
|
|
439
|
-
|
|
394
|
+
オーケストレーター: 方針を把握しました。エディタ作業と AI スクリプト生成の境界を明確にした上で、以下を起票してよろしいでしょうか?
|
|
395
|
+
- **decision**: `Input System 採用と AI・人間作業境界の合意`(担当: carol, 期限: 2027-01-31)
|
|
396
|
+
- **todo**: `ゲームシステム設計書(ステートマシン・パラメータ定義)の作成`(担当: carol, 期限: 2027-01-31)
|
|
397
|
+
承認いただければ実行します。
|
|
440
398
|
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
> 3. Unity 2022.3 LTS で、Input System パッケージを使用します。
|
|
444
|
-
> 4. 担当は carol、プロトタイプ完成期限は 2027-01-31 でお願いします。
|
|
445
|
-
|
|
446
|
-
**オーケストレーター**:
|
|
447
|
-
|
|
448
|
-
> 方針を把握しました。エディタ作業と AI スクリプト生成の境界を明確にした上で、以下を起票してよろしいでしょうか?
|
|
449
|
-
>
|
|
450
|
-
> - **decision**: `Input System 採用と AI・人間作業境界の合意`(担当: carol, 期限: 2027-01-31)
|
|
451
|
-
> - **todo**: `ゲームシステム設計書(ステートマシン・パラメータ定義)の作成`(担当: carol, 期限: 2027-01-31)
|
|
452
|
-
>
|
|
453
|
-
> 承認いただければ実行します。
|
|
454
|
-
|
|
455
|
-
**利用者**:
|
|
456
|
-
|
|
457
|
-
> 承認します。起票してください。
|
|
399
|
+
利用者: 承認します。起票してください。
|
|
400
|
+
```
|
|
458
401
|
|
|
459
402
|
### 4.3. 必要な成果物と作成順序
|
|
460
403
|
|
|
@@ -474,27 +417,21 @@ Unity 開発では、ロジックとエディタ設定が乖離しないよう
|
|
|
474
417
|
- **Enemy State Machine 実装**: 状態遷移パターンに基づき、検知範囲内のプレイヤーを追従するスクリプト。
|
|
475
418
|
- **Game Manager & UI 連動**: イベント駆動でコイン取得数やライフ残量を更新する仕組み。
|
|
476
419
|
|
|
477
|
-
|
|
420
|
+
```chat
|
|
421
|
+
利用者: 入力仕様とプレイヤーの状態遷移を確定しました。移動とジャンプから実装してください。
|
|
478
422
|
|
|
479
|
-
|
|
423
|
+
オーケストレーター: `unity-game` の Player Controller と関連テストを対象にした todo を提案します。Scene、Prefab、入力アセットとの接続は carol さんが行う合意とし、担当 carol、期限 2027-01-31 を引き継いでよいですか?
|
|
480
424
|
|
|
481
|
-
|
|
425
|
+
利用者: はい。スクリプトの実装を起票して実行してください。エディタで接続して確認します。
|
|
482
426
|
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
**利用者**:
|
|
486
|
-
|
|
487
|
-
> はい。スクリプトの実装を起票して実行してください。エディタで接続して確認します。
|
|
488
|
-
|
|
489
|
-
**オーケストレーター**:
|
|
490
|
-
|
|
491
|
-
> 採番された todo を指定して worktree で実行します。executor は C# と関連テストを編集し、用意された検証を実行します。Unity のライセンスやバッチ実行環境が必要な検査、Play モードの操作確認は実行可能な環境で行い、未確認の項目を結果に残します。runner が commit と承認済み設定に沿った統合を行います。
|
|
427
|
+
オーケストレーター: 採番された todo を指定して worktree で実行します。executor は C# と関連テストを編集し、用意された検証を実行します。Unity のライセンスやバッチ実行環境が必要な検査、Play モードの操作確認は実行可能な環境で行い、未確認の項目を結果に残します。runner が commit と承認済み設定に沿った統合を行います。
|
|
428
|
+
```
|
|
492
429
|
|
|
493
430
|
### 4.5. 完成確認と変更・運用への流れ
|
|
494
431
|
|
|
495
432
|
- **Unity エディタでの結合確認**: AI が作成した C# スクリプトを Prefab や GameObject にアタッチし、エディタの Play モードで操作感や当たり判定を確認します。
|
|
496
433
|
- **単体テストの実行**: ロジック部分(ステート遷移やダメージ計算)は、Unity Test Framework と実行環境を準備した上で EditMode / PlayMode テストを実行します。人が Play モードで操作感・クリア条件を確認し、受け入れと配布可否を判断します。
|
|
497
|
-
- **パラメータ調整とバグ報告**: ジャンプ力や移動速度の微調整は ScriptableObject 上で行います。挙動の不具合が見つかった場合は `register add --type issue` でログや期待値を添えて起票し、合意した範囲で修正と再確認を行います。共通の運用は [
|
|
434
|
+
- **パラメータ調整とバグ報告**: ジャンプ力や移動速度の微調整は ScriptableObject 上で行います。挙動の不具合が見つかった場合は `register add --type issue` でログや期待値を添えて起票し、合意した範囲で修正と再確認を行います。共通の運用は 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
|
|
498
435
|
|
|
499
436
|
### 4.6. コマンドと設定差分(折りたたみ)
|
|
500
437
|
|
|
@@ -41,6 +41,8 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
41
41
|
| 定期実行定義 | `rtn-*.yaml` | `routine` |
|
|
42
42
|
| ドキュメントIDインデックス | `.specdojo/doc-index.json` | `index` |
|
|
43
43
|
|
|
44
|
+
保存先を確認するときは `specdojo where <種類> --project <id>` を使います。種類は `exec`・`catalog`・`schedule`・`timeline`・`job`・`routine` です。たとえば `specdojo where exec --project prj-0001` で実行記録の保存先を確認できます。旧 `<種類> where` は1版の移行期間後に削除するため、新しい構文へ置き換えてください。
|
|
45
|
+
|
|
44
46
|
### 1.1. 技の名前
|
|
45
47
|
|
|
46
48
|
主要な CLI 機能には、Spec道(仕様道)の道場で使う技の名前を付けています。
|
|
@@ -58,15 +60,17 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
58
60
|
|
|
59
61
|
生成や実行を伴うコマンドは、出力の性質と副作用に応じて次の動詞を使います。
|
|
60
62
|
|
|
61
|
-
| 動詞 | 用途 | 再実行と上書きの原則 | 代表例
|
|
62
|
-
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
|
|
63
|
-
| `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold`
|
|
64
|
-
| `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `
|
|
65
|
-
| `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh`
|
|
66
|
-
| `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run`
|
|
63
|
+
| 動詞 | 用途 | 再実行と上書きの原則 | 代表例 |
|
|
64
|
+
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------- |
|
|
65
|
+
| `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold` |
|
|
66
|
+
| `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `build`、`build --only catalog`、`build --only schedule` |
|
|
67
|
+
| `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh` |
|
|
68
|
+
| `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run` |
|
|
67
69
|
|
|
68
70
|
`scaffold` と `build` の違いは、生成後のファイルを人が正本として編集するか、入力から再生成できる派生物かです。`refresh` は build 可能な一般成果物ではなく、イベントを反映して時点ごとに変わる実行状態に限定します。`run` はファイル生成そのものではなく、処理の遂行を表します。
|
|
69
71
|
|
|
72
|
+
区分を絞る場合は `build --only <区分>` を使います。対応する区分・オプションと内部互換用の旧入口は [[specdojo:command-reference|CLIコマンドリファレンス]] の「watch / build」を参照してください。
|
|
73
|
+
|
|
70
74
|
## 2. 標準ディレクトリ構成
|
|
71
75
|
|
|
72
76
|
プロジェクト文書は `docs/ja/projects/<project-id>/` 配下に置きます。代表的な構成は次のとおりです。
|
|
@@ -188,10 +192,10 @@ specdojo catalog validate --project prj-0001
|
|
|
188
192
|
|
|
189
193
|
# 3.1 カタログが指す成果物ファイル本体を一括生成する
|
|
190
194
|
specdojo deliverable scaffold --project prj-0001
|
|
191
|
-
specdojo
|
|
195
|
+
specdojo build --only catalog --project prj-0001
|
|
192
196
|
|
|
193
197
|
# 4. sch-strategy-launch.yaml を用意し、track schedule を生成する
|
|
194
|
-
specdojo
|
|
198
|
+
specdojo build --only schedule --project prj-0001 --track launch --force
|
|
195
199
|
|
|
196
200
|
# 5. 実行状態、Ready、CPMを生成する
|
|
197
201
|
specdojo exec refresh --project prj-0001
|