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
|
@@ -103,11 +103,13 @@ provider に応じて `npm run orch:sonnet`、`npm run orch:sol`、`npm run orch
|
|
|
103
103
|
|
|
104
104
|
起動後、ターミナルでオーケストレーターとのセッションが始まります。
|
|
105
105
|
|
|
106
|
-
```
|
|
106
|
+
```chat
|
|
107
107
|
あなた: SpecDojo の導入ができました。このプロジェクトを進めたいです。
|
|
108
|
+
|
|
108
109
|
オーケストレーター: SpecDojo の初期化を確認しました。登録簿(controls/project-register/)と名簿設定(projects.prj-0001.members_path が指す docs/ja/projects/prj-0001/030-project-management/pm-members.yaml)が準備されています。
|
|
109
110
|
まずは隣にあるプロダクトリポジトリ(../landing-page)を管理対象リポジトリとして接続し、安全に開発を進めるための Git flow ブランチ運用ルールを設定することをお勧めします。
|
|
110
111
|
進めてよろしいですか?
|
|
112
|
+
|
|
111
113
|
あなた: はい、進めてください。
|
|
112
114
|
```
|
|
113
115
|
|
|
@@ -161,15 +163,18 @@ landing-page-specdojo/
|
|
|
161
163
|
|
|
162
164
|
オーケストレーターにプロダクトリポジトリの接続と Git flow ルールの設定を依頼します。オーケストレーターはブランチ名や統合方式の不足事項を確認し、利用者が選択した後に設定を適用します。
|
|
163
165
|
|
|
164
|
-
```
|
|
166
|
+
```chat
|
|
165
167
|
あなた: 隣にある ../landing-page を管理対象リポジトリに追加して、Git flow のブランチルールで運用したいです。
|
|
168
|
+
|
|
166
169
|
オーケストレーター: ../landing-page をプロダクトリポジトリ(repos)として接続し、Git flow のブランチ運用ルールを設定します。以下の運用設定について確認させてください:
|
|
167
170
|
1. 統合先ブランチ(integration_branch): develop でよろしいですか?(本番用の main と日々の開発統合用の develop を分ける Git flow 構成)
|
|
168
171
|
2. 作業ブランチ命名規則(branch_template): feature/{topic} でよろしいですか?(例: feature/add-faq-section)
|
|
169
172
|
3. 統合方式(integration_strategy): ff(Fast-Forward 早送り統合)にしますか、それとも merge(マージコミット作成)にしますか?(推奨は履歴が直線的になる ff です)
|
|
170
173
|
4. コミット件名規則(commit_subject_template): Conventional Commits 形式 {type}({scope}): {title} で統一しますか?
|
|
171
174
|
5. 依存解決(setup): 隔離作業ツリーで追跡済み package-lock.json ごとに npm ci を実行(install: true)しますか?
|
|
175
|
+
|
|
172
176
|
あなた: 統合先は develop、作業ブランチは feature/{topic}、統合方式は ff、コミット件名は提案どおりの Conventional Commits、依存解決は install: true でお願いします。
|
|
177
|
+
|
|
173
178
|
オーケストレーター: 承知しました。以下の設定を .specdojo/specdojo.config.json の projects.prj-0001.repos に追加します:
|
|
174
179
|
・リポジトリ名: landing-page
|
|
175
180
|
・パス: ../landing-page
|
|
@@ -179,10 +184,14 @@ landing-page-specdojo/
|
|
|
179
184
|
・コミット件名: {type}({scope}): {title}
|
|
180
185
|
・setup: { "install": true, "build": false }
|
|
181
186
|
この変更を適用してよろしいですか?
|
|
187
|
+
|
|
182
188
|
あなた: はい、適用してください。
|
|
189
|
+
|
|
183
190
|
オーケストレーター: 設定を更新しました。landing-page が管理対象として認識されました。
|
|
184
191
|
VS Code でプロジェクトリポジトリとプロダクトリポジトリを同時に開くマルチルートワークスペース(prj-0001.code-workspace)を生成できますが、作成しますか?
|
|
192
|
+
|
|
185
193
|
あなた: はい、作成してください。
|
|
194
|
+
|
|
186
195
|
オーケストレーター: prj-0001.code-workspace を生成しました。VS Code で「ファイル > ワークスペースを開く」から開くことで、両リポジトリを 1 つのウィンドウで操作できます。
|
|
187
196
|
```
|
|
188
197
|
|
|
@@ -263,8 +272,9 @@ register(登録簿)は、問題・判断・作業を個票として残し、
|
|
|
263
272
|
|
|
264
273
|
#### 具体的対話
|
|
265
274
|
|
|
266
|
-
```
|
|
275
|
+
```chat
|
|
267
276
|
あなた: LP によくある質問(FAQ)セクションを追加したいので、todo を起票してほしいです。
|
|
277
|
+
|
|
268
278
|
オーケストレーター: FAQ セクション追加の todo を起票します。登録項目について確認させてください:
|
|
269
279
|
・タイトル: 「よくある質問(FAQ)セクションを追加する」
|
|
270
280
|
・topic(個票ファイル名や作業ブランチ名に使われます): add-faq-section
|
|
@@ -272,7 +282,9 @@ register(登録簿)は、問題・判断・作業を個票として残し、
|
|
|
272
282
|
・完了期日(due_on): 目安の日付はありますか?(未定なら空欄にします)
|
|
273
283
|
・難しさ(difficulty): 既存のコンポーネント構成に沿った追加のため medium を推奨します。
|
|
274
284
|
・担当者(owner): 名簿から選べる nickname を割り当てますか?
|
|
285
|
+
|
|
275
286
|
あなた: 優先度は medium、担当は owner、期日は 2026-11-30、難しさは medium でお願いします。
|
|
287
|
+
|
|
276
288
|
オーケストレーター: 承知しました。以下の内容で todo を起票し、登録簿へコミットします:
|
|
277
289
|
・種別: todo
|
|
278
290
|
・タイトル: 「よくある質問(FAQ)セクションを追加する」
|
|
@@ -280,7 +292,9 @@ register(登録簿)は、問題・判断・作業を個票として残し、
|
|
|
280
292
|
・優先度: medium、担当: owner、期日: 2026-11-30、難しさ: medium
|
|
281
293
|
・入力: FAQ の質問項目と掲載方針は未確定。実装前に利用者へ確認する
|
|
282
294
|
起票を実行してよろしいですか?
|
|
295
|
+
|
|
283
296
|
あなた: はい、実行してください。
|
|
297
|
+
|
|
284
298
|
オーケストレーター: 個票 PJR-FA01(例)を作成し、登録簿へコミットしました。
|
|
285
299
|
個票ファイル docs/ja/projects/prj-0001/controls/project-register/pjr-fa01-add-faq-section.md を確認してください。
|
|
286
300
|
個票の「完了条件」に、掲載する質問項目、アコーディオン UI の動作、モバイル表示での検証条件などを記載しておくと、後の AI 実行がスムーズになります。
|
|
@@ -347,8 +361,9 @@ specdojo:
|
|
|
347
361
|
|
|
348
362
|
#### 具体的対話
|
|
349
363
|
|
|
350
|
-
```
|
|
364
|
+
```chat
|
|
351
365
|
あなた: スマホ表示でナビゲーションメニューを開いた後、リンクをタップしてもメニューが閉じない不具合があります。issue を起票して調査したいです。
|
|
366
|
+
|
|
352
367
|
オーケストレーター: ナビゲーションメニュー不具合の issue を起票します。以下の内容を確認させてください:
|
|
353
368
|
・タイトル: 「スマホ表示でナビゲーションメニューが閉じない不具合の調査と修正」
|
|
354
369
|
・topic: fix-mobile-nav-close
|
|
@@ -356,7 +371,9 @@ specdojo:
|
|
|
356
371
|
・担当者: owner でよろしいですか?
|
|
357
372
|
・難しさ(difficulty): 原因調査と修正が必要なため medium に設定しますか?
|
|
358
373
|
・再現条件: 現時点で分かっている再現手順や環境はありますか?
|
|
374
|
+
|
|
359
375
|
あなた: 優先度は high、担当は owner、難しさは medium でお願いします。再現条件は画面幅 768px 以下の環境で、メニュー内のアンカーリンクをクリックした際にオーバーレイの閉じる処理が発火していません。
|
|
376
|
+
|
|
360
377
|
オーケストレーター: 承知しました。以下の内容で issue を起票します:
|
|
361
378
|
・種別: issue
|
|
362
379
|
・タイトル: 「スマホ表示でナビゲーションメニューが閉じない不具合の調査と修正」
|
|
@@ -364,7 +381,9 @@ specdojo:
|
|
|
364
381
|
・優先度: high、担当: owner、難しさ: medium
|
|
365
382
|
・再現条件のメモを個票の「問題」セクションに記載します
|
|
366
383
|
起票を実行してよろしいですか?
|
|
384
|
+
|
|
367
385
|
あなた: はい、起票してください。
|
|
386
|
+
|
|
368
387
|
オーケストレーター: 個票 PJR-NV02(例)を作成しました。
|
|
369
388
|
課題ログ(docs/ja/projects/prj-0001/controls/generated/pm-issue-log.md)にも登録されました。
|
|
370
389
|
調査結果や修正方針が定まったら、個票の「原因」「影響」「対応結果」に記録します。
|
|
@@ -415,8 +434,9 @@ npx specdojo register add \
|
|
|
415
434
|
|
|
416
435
|
#### 具体的対話
|
|
417
436
|
|
|
418
|
-
```
|
|
437
|
+
```chat
|
|
419
438
|
あなた: 問い合わせフォームの実装方針をいくつか比較して決めたいので、decision を起票して相談したいです。
|
|
439
|
+
|
|
420
440
|
オーケストレーター: 問い合わせフォーム実装方針の decision を起票します。確認事項です:
|
|
421
441
|
・タイトル: 「問い合わせフォームの実装方針を比較・決定する」
|
|
422
442
|
・topic: contact-form-strategy
|
|
@@ -425,24 +445,32 @@ npx specdojo register add \
|
|
|
425
445
|
- 案 A: 外部フォームサービス(Formspree や Google Forms 等)の埋め込み連携
|
|
426
446
|
- 案 B: サーバーレス関数(API エンドポイント)による自前送信処理の実装
|
|
427
447
|
- 案 C: mailto リンクまたは問い合わせメールアドレスの掲示のみ
|
|
448
|
+
|
|
428
449
|
あなた: 担当は owner、選択肢はその 3 つで比較を作成してください。
|
|
450
|
+
|
|
429
451
|
オーケストレーター: 以下の内容で decision を起票します:
|
|
430
452
|
・種別: decision
|
|
431
453
|
・タイトル: 「問い合わせフォームの実装方針を比較・決定する」
|
|
432
454
|
・topic: contact-form-strategy
|
|
433
455
|
・担当: owner
|
|
434
456
|
起票を実行してよろしいですか?
|
|
457
|
+
|
|
435
458
|
あなた: お願いします。
|
|
459
|
+
|
|
436
460
|
オーケストレーター: 個票 PJR-CF03(例)を作成しました。各選択肢の長所・短所を個票に整理しました:
|
|
437
461
|
- 案 A: 導入が迅速でサーバー保守不要。外部サービスの利用規約や制限がトレードオフ。
|
|
438
462
|
- 案 B: デザインと挙動を完全制御できるが、スパム対策やバックエンド保守が必要。
|
|
439
463
|
- 案 C: 実装工数ゼロだが、メールクライアント起動の手間とアドレス収集スパムのリスク。
|
|
440
464
|
初期リリースとしてはどの方針を採用しますか?採択理由と合わせてご指示ください(オーケストレーターが勝手に採択案を決定することはありません)。
|
|
465
|
+
|
|
441
466
|
あなた: 保守負荷を抑えて最短で安全に開始したいため、案 A(外部フォームサービス連携)を採用します。
|
|
467
|
+
|
|
442
468
|
オーケストレーター: 承知しました。以下の内容で個票を更新し、decision を完了(decided)にしてよろしいですか?
|
|
443
469
|
・決定内容: 「案 A: 外部フォームサービスの埋め込み連携を採用」
|
|
444
470
|
・採択理由: 「保守工数の削減とスパム対策の両立」
|
|
471
|
+
|
|
445
472
|
あなた: はい、完了してください。
|
|
473
|
+
|
|
446
474
|
オーケストレーター: decision PJR-CF03 を完了(decided)としてクローズしました。
|
|
447
475
|
決定ログ(docs/ja/projects/prj-0001/controls/generated/pm-decision-log.md)に記録されました。
|
|
448
476
|
```
|
|
@@ -514,15 +542,18 @@ register には上記のほか、以下の種別があります。目的に応
|
|
|
514
542
|
|
|
515
543
|
オーケストレーターに起票済みタスクの隔離実行を依頼します。オーケストレーターは実行方式(worktree)、作業ブランチ名、統合先ブランチを提示して承認を得てから実行します。
|
|
516
544
|
|
|
517
|
-
```
|
|
545
|
+
```chat
|
|
518
546
|
あなた: 起票した FAQ 追加の todo(PJR-FA01)を AI に実行させたいです。安全に進めてください。
|
|
547
|
+
|
|
519
548
|
オーケストレーター: PJR-FA01 の AI 実行(exec run)を準備します。以下の計画を確認させてください:
|
|
520
549
|
・隔離実行: ../landing-page-specdojo-worktrees/<実際に割り当てられる task ID>/ に専用の作業環境を隔離作成します。
|
|
521
550
|
・Git flow 規則の適用: 設定済みのブランチ規則に従い、プロダクト側(../landing-page)に作業ブランチ feature/add-faq-section を作成します。
|
|
522
551
|
・実行 agent: 設定済み routing から選ばれる executor と reporter を割り当てます。
|
|
523
552
|
・統合方式: 設定された統合方式で処理します。exec 開始前に実際の統合先と統合手順を確認します。
|
|
524
553
|
この計画で AI 実行を開始してよろしいですか?
|
|
554
|
+
|
|
525
555
|
あなた: はい、実行を開始してください。
|
|
556
|
+
|
|
526
557
|
オーケストレーター: 実行を開始しました。
|
|
527
558
|
[1/4] worktree を準備し、プロダクト側に feature/add-faq-section を作成しました。
|
|
528
559
|
[2/4] executor が承認された完了条件に沿って実行し、適用された検証結果を記録しました。
|
|
@@ -530,19 +561,23 @@ register には上記のほか、以下の種別があります。目的に応
|
|
|
530
561
|
[4/4] 設定された方式で統合し、実行記録に統合結果を残しました。
|
|
531
562
|
個票 PJR-FA01 のステータスが review(人間の講評待ち)になりました。以下の確認をお願いします:
|
|
532
563
|
1. プロダクト側(../landing-page)のコミットログ(git log -1)と変更差分
|
|
533
|
-
2. 実行結果ファイル(docs/ja/projects/prj-0001/execution/
|
|
564
|
+
2. 実行結果ファイル(docs/ja/projects/prj-0001/execution/runs/register/PJR-FA01/.../result.md)
|
|
534
565
|
3. ローカル開発サーバーでの FAQ 表示とアコーディオン動作
|
|
535
566
|
確認後、問題がなければ完了(close)をご指示ください。
|
|
567
|
+
|
|
536
568
|
あなた: プロダクトのコミットとローカル表示を確認しました。FAQ が期待通り動作しています。完了してください。
|
|
569
|
+
|
|
537
570
|
オーケストレーター: 完了条件の達成を確認しました。PJR-FA01 を完了(done)としてクローズし、登録簿へコミットします。よろしいですか?
|
|
571
|
+
|
|
538
572
|
あなた: はい、クローズしてください。
|
|
573
|
+
|
|
539
574
|
オーケストレーター: PJR-FA01 を完了としてクローズしました。お疲れ様でした!
|
|
540
575
|
```
|
|
541
576
|
|
|
542
577
|
### 得られる結果と確認先
|
|
543
578
|
|
|
544
579
|
- 成功時は設定された統合先に変更が統合されます。コミット件名の scope は未指定なら空です。`feat(add-faq-section): ...` を使う場合は登録時に `--commit-scope add-faq-section` を指定します。
|
|
545
|
-
- `docs/ja/projects/prj-0001/execution/
|
|
580
|
+
- `docs/ja/projects/prj-0001/execution/runs/register/PJR-FA01/<run ID>/` に `result.md` が生成され、変更ファイル一覧や検証記録が保存されます。
|
|
546
581
|
- 個票 `PJR-FA01` のステータスが `review` から `done` に遷移します。
|
|
547
582
|
|
|
548
583
|
### 折りたたんだコマンドと設定差分
|
|
@@ -585,14 +620,17 @@ npx specdojo register close \
|
|
|
585
620
|
|
|
586
621
|
#### 具体的対話
|
|
587
622
|
|
|
588
|
-
```
|
|
623
|
+
```chat
|
|
589
624
|
あなた: LP の仕様書や設計ドキュメントを体系的に揃えたいです。成果物カタログを作って進めるにはどうすればよいですか?
|
|
625
|
+
|
|
590
626
|
オーケストレーター: 現在の設定を調べます。`catalog_path` が未設定のため、成果物カタログ(dct-*.yaml)の保存先 `010-deliverables-catalog` を提案します。Schedule / execution の出力先、名簿と role 対応、routine / Job の置き場所も次の段階に必要です。設定差分を確認してください。
|
|
591
627
|
以下のカタログ内容も確認させてください:
|
|
592
628
|
・規模(size): 最小限の基本構成が揃う small サイズで生成しますか?(後から成果物の追加や削除が可能です)
|
|
593
629
|
・配置場所: .specdojo/specdojo.config.json の catalog_path(010-deliverables-catalog)に配置します。
|
|
594
630
|
まず small サイズのカタログ雛形を生成し、構文を検証してよろしいですか?
|
|
631
|
+
|
|
595
632
|
あなた: まず `catalog_path` が未設定なら追加し、`roles_path`・`schedule_path`・`execution_path`・`routines_path`・`jobs_path` と名簿・役割ファイルを準備します。差分と初期生成物を確認してから、small サイズのカタログを生成してください。
|
|
633
|
+
|
|
596
634
|
オーケストレーター: 成果物カタログの生成、検証、および成果物雛形の生成を実行しました。
|
|
597
635
|
・dct-project-definition.yaml(プロジェクト定義カタログ)を作成しました。
|
|
598
636
|
・カタログが参照する成果物ファイル(docs/ja/projects/prj-0001/010-deliverables/ 配下)を生成しました。
|
|
@@ -637,7 +675,7 @@ npx specdojo catalog validate --project prj-0001
|
|
|
637
675
|
npx specdojo deliverable scaffold --project prj-0001
|
|
638
676
|
|
|
639
677
|
# カタログの Markdown 派生ビューをビルド
|
|
640
|
-
npx specdojo
|
|
678
|
+
npx specdojo build --only catalog --project prj-0001
|
|
641
679
|
```
|
|
642
680
|
|
|
643
681
|
</details>
|
|
@@ -651,14 +689,17 @@ npx specdojo catalog build --project prj-0001
|
|
|
651
689
|
|
|
652
690
|
#### 具体的対話
|
|
653
691
|
|
|
654
|
-
```
|
|
692
|
+
```chat
|
|
655
693
|
あなた: カタログの成果物を作成するためのスケジュール戦略を作りたいです。
|
|
694
|
+
|
|
656
695
|
オーケストレーター: トラック戦略(sch-strategy-launch.yaml)を生成します。確認事項です:
|
|
657
696
|
・トラック名: 立ち上げトラックの launch でよろしいですか?
|
|
658
697
|
・作成担当(default-owner): pm-roles.yaml の ROLE code BA を指定しますか?
|
|
659
698
|
・ゲート・マイルストーン担当: 同じく ROLE code BA に設定しますか?
|
|
660
699
|
・担当者: pm-members.yaml の nickname が owner の人の roles に BA が割り当てられていることを確認します。
|
|
700
|
+
|
|
661
701
|
あなた: トラックは launch、作成・ゲート・マイルストーン担当のロールは BA でお願いします。担当者は owner で、roles に BA を割り当て済みです。
|
|
702
|
+
|
|
662
703
|
オーケストレーター: sch-strategy-launch.yaml を生成しました。
|
|
663
704
|
生成したファイルとタスク定義を確認し、task ID・成果物パス・依存関係・owner・execution mode を実際の出力から読み取ります。
|
|
664
705
|
```
|
|
@@ -691,10 +732,13 @@ npx specdojo schedule strategy generate \
|
|
|
691
732
|
|
|
692
733
|
#### 具体的対話
|
|
693
734
|
|
|
694
|
-
```
|
|
735
|
+
```chat
|
|
695
736
|
あなた: スケジュールを生成して、今すぐ着手できるタスクを確認したいです。
|
|
696
|
-
|
|
737
|
+
|
|
738
|
+
オーケストレーター: track launch の内容と出力先(`schedule_path` の既定は docs/ja/projects/prj-0001/schedule)を確認しました。build --only schedule と exec refresh を実行してよろしいですか?
|
|
739
|
+
|
|
697
740
|
あなた: はい、実行してください。
|
|
741
|
+
|
|
698
742
|
オーケストレーター: スケジュール(sch-track-launch.yaml)を生成し、exec refresh を実行しました。
|
|
699
743
|
生成結果から Ready の task ID、成果物パス、owner、execution mode を読み上げます。例示 ID や固定パスを前提にせず、実際の生成内容を確認してください。
|
|
700
744
|
```
|
|
@@ -711,7 +755,7 @@ npx specdojo schedule strategy generate \
|
|
|
711
755
|
|
|
712
756
|
```bash
|
|
713
757
|
# スケジュールのビルド
|
|
714
|
-
npx specdojo
|
|
758
|
+
npx specdojo build --only schedule --project prj-0001 --track launch --force
|
|
715
759
|
|
|
716
760
|
# Ready タスクと CPM の更新
|
|
717
761
|
npx specdojo exec refresh --project prj-0001
|
|
@@ -727,20 +771,25 @@ npx specdojo exec refresh --project prj-0001
|
|
|
727
771
|
|
|
728
772
|
#### 具体的対話
|
|
729
773
|
|
|
730
|
-
```
|
|
774
|
+
```chat
|
|
731
775
|
あなた: 最初の Ready タスクを進めたいです。
|
|
776
|
+
|
|
732
777
|
オーケストレーター: Ready 一覧の task ID・成果物パス・owner・execution mode・入力要件を提示します。タスクの owner は ROLE code BA です。名簿で roles に BA を持つ人の nickname は owner と確認しました。内容を確認してください。
|
|
733
778
|
・このタスクを --by owner で claim しますか?
|
|
779
|
+
|
|
734
780
|
あなた: はい、提示された情報を確認したので claim してください。
|
|
781
|
+
|
|
735
782
|
オーケストレーター: claim を完了しました。表示された成果物ファイルと生成された result の場所を確認してください。
|
|
736
783
|
完了条件を満たしたら「完了にして」とお知らせください。
|
|
784
|
+
|
|
737
785
|
あなた: 成果物の編集が終わりました。完了にしてください。
|
|
786
|
+
|
|
738
787
|
オーケストレーター: 表示された task ID を完了として記録し、次の Ready タスクを更新しました。
|
|
739
788
|
```
|
|
740
789
|
|
|
741
790
|
#### 得られる結果と確認先
|
|
742
791
|
|
|
743
|
-
- 成果物ファイルおよび `<execution_path>/
|
|
792
|
+
- 成果物ファイルおよび `<execution_path>/runs/schedule/<task-id>/<run-id>/` の `result.md` が記録されます。
|
|
744
793
|
- `exec refresh` により後続のタスクが Ready に繰り上がります。
|
|
745
794
|
|
|
746
795
|
#### 折りたたんだコマンドと設定差分
|
|
@@ -779,8 +828,9 @@ npx specdojo exec refresh --project prj-0001
|
|
|
779
828
|
|
|
780
829
|
オーケストレーターに定期実行ルーチンの登録を相談します。オーケストレーターは実行頻度や対象条件を確認し、定義を作成して検証します。
|
|
781
830
|
|
|
782
|
-
```
|
|
831
|
+
```chat
|
|
783
832
|
あなた: オープンな高優先度 todo を毎日確認して処理する仕組み(routine)を作りたいです。
|
|
833
|
+
|
|
784
834
|
オーケストレーター: 定期実行ルーチン(routine)を設定します。以下の設定内容を確認させてください:
|
|
785
835
|
・ルーチン ID: rtn-daily-register-sweep(既存定義と重複しないことを確認)
|
|
786
836
|
・実行頻度(interval): 毎日 1 回の 1d でよろしいですか?
|
|
@@ -788,12 +838,18 @@ npx specdojo exec refresh --project prj-0001
|
|
|
788
838
|
・処理件数上限(limit): 安全のため 1 回あたり最大 3 件までに制限しますか?
|
|
789
839
|
・呼び出し Job: `jobs_path` に実在し入力仕様を確認した Job を選びます。Job がなければ、定義・権限・副作用を相談して別途準備し、存在を仮定しません。
|
|
790
840
|
実行頻度や抽出条件を Job が受け取れるか、入力 schema と副作用を確認します。routine 定義の保存先は `routines_path` の解決先です。この内容で作成してよろしいですか?
|
|
841
|
+
|
|
791
842
|
あなた: はい、その設定で作成してください。
|
|
843
|
+
|
|
792
844
|
オーケストレーター: 定義ファイルを作成しました。定義の構文検証と dry-run(試行実行)を行ってよろしいですか?
|
|
845
|
+
|
|
793
846
|
あなた: はい、検証と dry-run をお願いします。
|
|
847
|
+
|
|
794
848
|
オーケストレーター: routine validate に合格し、dry-run で対象の todo が正しく抽出されることを確認しました。
|
|
795
849
|
継続運用では、cron や CI(GitHub Actions の scheduled workflow 等)から定期的に実行コマンドを呼び出します。設定例を確認しますか?
|
|
850
|
+
|
|
796
851
|
あなた: cron の設定例を教えてください。
|
|
852
|
+
|
|
797
853
|
オーケストレーター: cron の設定例を提示します。平日の朝 9 時に due なルーチンを実行する例です:
|
|
798
854
|
0 9 * * 1-5 cd /path/to/landing-page-specdojo && npx specdojo routine run --project prj-0001 --due
|
|
799
855
|
```
|
|
@@ -156,19 +156,35 @@ type は派生ビューの生成と `exec run --register` の挙動(`agent実
|
|
|
156
156
|
|
|
157
157
|
### 1.4. track の仕事を epic と子 todo で管理する
|
|
158
158
|
|
|
159
|
-
epic は
|
|
159
|
+
epic は track ごとの全体計画の正本です。順序は epic 間の `depends_on`、範囲は `domains`、期間は予定開始日 `start_on`・着手・完了の記録と `due_on` で管理します。未着手の計画も `open` の epic として起票し、epic がない track は全体計画に出しません。子 todo と schedule の進捗を材料に、人が完了を判断します。
|
|
160
160
|
|
|
161
161
|
```bash
|
|
162
|
-
specdojo register add --type epic --title "業務の仕様整備" --topic business-specs
|
|
162
|
+
specdojo register add --type epic --title "業務の仕様整備" --topic business-specs \
|
|
163
|
+
--track business --domain business-model --start-on 2026-11-09 --due 2026-11-30
|
|
163
164
|
specdojo register add --type todo --title "カタログを作成する" --topic business-catalog --from PJR-AB12
|
|
164
|
-
specdojo register update --id PJR-AB12 --track business
|
|
165
|
+
specdojo register update --id PJR-AB12 --track business --domain business-model
|
|
165
166
|
specdojo register build
|
|
167
|
+
specdojo dashboard build
|
|
166
168
|
```
|
|
167
169
|
|
|
168
|
-
`PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。
|
|
170
|
+
`PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。track の重複は add・update・build で、epic 間の依存循環は build で拒否します。旧 timeline への track 登録は不要です。
|
|
171
|
+
|
|
172
|
+
`--domain` は epic にだけ繰り返し指定でき、`update` では一覧を置き換えます。`--domain -` 単独で削除できます。domain の一部だけを対象にする場合は個票の範囲の章に境界を書き、strategy の `scope.catalogs[].local_ids` で限定します。strategy と未作成カタログの範囲は既存 strategy の scope、epic の `domains`、互換用 timeline の順で解決し、空の scope や `domains: []` も明示指定として扱います。変更は event に記録します。
|
|
173
|
+
|
|
174
|
+
`--start-on` は epic にだけ指定できる予定開始日です。実在する暦日を `YYYY-MM-DD` で指定し、未定なら省略します。`update` では未指定なら保持し、`--start-on -` で削除します。ほかの type への指定と不正な日付は、個票・event を書く前に拒否します。
|
|
169
175
|
|
|
170
176
|
`register build` は `generated/pjr-epic-items.md` に、epic ごとの直接の子項目とその type・現在の状態を表示します。別 project の子も project 修飾 ID で表示し、子がない epic も残します。孫は再帰的に表示しません。子の状態から epic を自動 close せず、完了基準を満たしたことを人が確認して `register close --id <epic-id> --conclusion "判断の根拠"` で `done` にします。`reject` / `defer` / `reopen` も todo と同じように使用できます。
|
|
171
177
|
|
|
178
|
+
### 1.5. 全体計画を確認する
|
|
179
|
+
|
|
180
|
+
`dashboard build` は epic の依存順に全体計画の表とガントを `execution/generated/` へ出力します。カレンダーは `sch-defaults.yaml` を使います。
|
|
181
|
+
|
|
182
|
+
開始日は `start_on`、epic 自身の最初の着手 event、先行 epic の最も遅い終了日の翌稼働日の順に使います。どれも求められなければ未定です。子 todo の着手や起票日からは補いません。
|
|
183
|
+
|
|
184
|
+
終了日は完了した epic なら `completed_at`、未完了なら `due_on` を使います。開始日と終了日がそろえば稼働日数とガントの期間を表示します。期限のない未完了 epic の終了日は未定です。先行 epic の終了日が未定でも、後続自身の予定開始日や着手記録があれば開始日に使います。`start_on` が `due_on` より後なら `register build` が警告し、開始日が終了日より後になる場合も含めて期間は未定とし、後続への終了日の引き継ぎも止めます。`derived_from` は起票の由来であり、全体計画の順序には使いません。
|
|
185
|
+
|
|
186
|
+
`execution/generated/catalog-scaffold.md` には未作成の domain のカタログと作成コマンドを出力します。旧 timeline の移行は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
|
|
187
|
+
|
|
172
188
|
## 2. 登録項目のライフサイクル
|
|
173
189
|
|
|
174
190
|
登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
|
|
@@ -251,9 +267,9 @@ specdojo register close \
|
|
|
251
267
|
--commit
|
|
252
268
|
```
|
|
253
269
|
|
|
254
|
-
`--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>`
|
|
270
|
+
`--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>` で上書きできます。`-m` を繰り返すと、`git commit -m` と同じく 1 つ目を件名、2 つ目以降を本文の段落にします。commit に失敗した場合は、記帳済みで未 commit のファイルを示して終了コード 1 で終わります。`--dry-run` と同時に指定した場合は表示だけを行い、枠の取得と commit は行いません。
|
|
255
271
|
|
|
256
|
-
ほかのファイルがすでに stage されていても、初回 commit と hook 整形後の amend は対象パスだけを記録し、既存の staged
|
|
272
|
+
ほかのファイルがすでに stage されていても、初回 commit と hook 整形後の amend は対象パスだけを記録し、既存の staged 変更を保持します。実行中に別タスクの exec event が増えても対象へ取り込みません。stage 後の検査や commit・amend が失敗した場合、または `SIGINT`・`SIGTERM`・`SIGHUP` で中断された場合は、そのコマンドが stage した対象だけを unstage し、作業ツリーの本文を残します。Git の実行中に届いた中断は Git が戻ってから処理します。初回 commit 後の失敗・中断では commit が残るため、本文と HEAD の差分を確認してから再実行してください。
|
|
257
273
|
|
|
258
274
|
別 project への起票では、対象登録簿全体が clean であることを追加で確認します。元の作業ツリーのブランチと HEAD は変更しません。
|
|
259
275
|
|
|
@@ -497,6 +513,10 @@ specdojo register update --project <project-id> --id PJR-0012 \
|
|
|
497
513
|
|
|
498
514
|
夜間実行は `specdojo orchestrator night` が担います。worktree 隔離、post-review、自動 close / `waiting` への復帰を必須とし、件数、並列数、連続失敗停止、rate limit 時の fallback をオプションで制限します。承認範囲外の操作が必要になった失敗は、元項目を `derived_from` に持つ issue として起票します。結果は `execution/reports/night-orchestrator/` の朝報告 1 文書へ集約します。
|
|
499
515
|
|
|
516
|
+
朝報告は `type: project`・`status: draft`・`rulebook: none` の管理文書として生成し、番号付きの「1. 集計」「2. 実行結果」を記録します。Job の review 前に、通常の成果物と同じ frontmatter・Markdown 検査の対象になります。
|
|
517
|
+
|
|
518
|
+
merge に commit-msg hook を使うリポジトリでは、Git が hook に渡すメッセージファイルを検査してください。Lefthook の設定例は `run: npx commitlint --edit "{1}"` です。`$1` は Lefthook の引数置換ではないため、ファイル名が渡らず `COMMIT_EDITMSG` を検査する場合があります。merge で渡される `MERGE_MSG` と異なり、linked worktree では未作成、主の作業ツリーでは古い内容が残っていることがあります。検査を省略せず、両方の作業ツリーで有効な merge メッセージの受理と無効なメッセージの拒否を確かめてください。
|
|
519
|
+
|
|
500
520
|
定期起動は Job `job-night-approved-register` と routine `rtn-night-approved-register` を使います。サンプル routine は保護された運用設定を勝手に有効化しないため `enabled: false` です。人が 2 時(Asia/Tokyo)、一晩 10 件、並列 2、連続失敗 2 件、fallback executor を確認してから有効化してください。
|
|
501
521
|
|
|
502
522
|
## 4. 例外対応と特殊な運用
|
|
@@ -82,6 +82,8 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
|
|
|
82
82
|
|
|
83
83
|
生成される `.devcontainer/emacs/init.el` は、`~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけコピーされます。空の `~/.emacs.d` があればその中の `init.el` へ、なければ `~/.config/emacs/init.el` へ配置し、配置先を出力します。初回作成前の既定値は生成されたテンプレートで変更でき、作成後は出力されたコピー先を編集します。dotfiles が設定を配置していれば上書きされません。
|
|
84
84
|
|
|
85
|
+
tmux を含める構成(`--tmux`、または preset に `recommended` 以上を指定)では、マウス操作(`set -g mouse on`)、クリップボード(`set -g set-clipboard on`)、256 色(`set -g default-terminal "tmux-256color"` と `set -as terminal-overrides ',*:Tc'`)を設定した `.devcontainer/tmux.conf` を生成します。コンテナ作成時に `post-create.sh` がこのファイルを `~/.tmux.conf` へシンボリックリンク(`ln -sfn`)します。利用者が既に独自の `~/.tmux.conf`(シンボリックリンクでない通常ファイル)を持っている場合は上書きせず、既存の設定を保護します。また、tmux を含めない構成では `tmux.conf` もリンク処理も生成されません。
|
|
86
|
+
|
|
85
87
|
scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
|
|
86
88
|
|
|
87
89
|
- `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。workspace のパスを渡して、SpecDojo が配布する本体スクリプト(`.specdojo/host/devcontainer-tmux.sh`)を呼び出す数行のラッパーです。本体スクリプトは `npx specdojo devcontainer host-script` で workspace へ書き出せます。
|
|
@@ -50,15 +50,15 @@ grade と review は判定する対象が異なります。2 つは重複する
|
|
|
50
50
|
|
|
51
51
|
review では次を入力として扱います。確認に用いる文書は review plan に記載されたものに限ります。
|
|
52
52
|
|
|
53
|
-
| 入力 | 正本ファイル
|
|
54
|
-
| -------------- |
|
|
55
|
-
| 評価結果 | grade result サイドカー
|
|
56
|
-
| review plan | `
|
|
57
|
-
| 実行記録 | 先行する edit タスクの result
|
|
58
|
-
| 対象成果物 | -
|
|
59
|
-
| 成果物カタログ | `dct-*.yaml`
|
|
60
|
-
| 関連成果物 | -
|
|
61
|
-
| 登録簿 | `generated/pjr-index.md`
|
|
53
|
+
| 入力 | 正本ファイル | 役割 |
|
|
54
|
+
| -------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------ |
|
|
55
|
+
| 評価結果 | grade result サイドカー | grade の verdict・score・観点ごとの level・finding。review plan にも提示される |
|
|
56
|
+
| review plan | `execution/runs/schedule/<task-id>/<run-id>/plan.md` | 対象成果物、評価結果、完了条件、進め方を固定する |
|
|
57
|
+
| 実行記録 | 先行する edit タスクの result | 何を変更し、どの検証を実行したか |
|
|
58
|
+
| 対象成果物 | - | 変更内容を確かめる対象の Markdown / YAML / JSON など |
|
|
59
|
+
| 成果物カタログ | `dct-*.yaml` | 成果物、依存関係、`done_criteria`(text / roles / viewpoint)を定義する |
|
|
60
|
+
| 関連成果物 | - | `depends_on` 成果物とプロジェクトコンテキスト |
|
|
61
|
+
| 登録簿 | `generated/pjr-index.md` | 未解決事項、課題、リスク、変更要求、決定の転記先 |
|
|
62
62
|
|
|
63
63
|
### 1.3. grade・機械検証・review の分担
|
|
64
64
|
|
|
@@ -207,11 +207,11 @@ edit タスク(成果物を作る・直す)
|
|
|
207
207
|
↓
|
|
208
208
|
grade(成果物を評価する。評価結果が最新なら再実行しない)
|
|
209
209
|
↓
|
|
210
|
-
exec plan / exec run → review plan(
|
|
210
|
+
exec plan / exec run → review plan(execution/runs/schedule/<task-id>/<run-id>/plan.md。評価結果を提示する)
|
|
211
211
|
↓
|
|
212
212
|
human / agent review(タスクの完了可否を判断する)
|
|
213
213
|
↓
|
|
214
|
-
review result(
|
|
214
|
+
review result(execution/runs/schedule/<task-id>/<run-id>/result.md)
|
|
215
215
|
↓
|
|
216
216
|
完了 / 再評価 / 再計画
|
|
217
217
|
```
|
|
@@ -240,9 +240,12 @@ edit plan で観点別の自己レビューを行わないのは、各観点を
|
|
|
240
240
|
この自動 grade は同じ npm package の `grade run` を使います。開発用スクリプトの配置は不要です。選択した review agent の実体名と起動設定を引き継ぎ、対象 1 件の plan 生成・評価・サイドカー反映を実行します。成果物の grade には project の `catalog_path` が必要です。単独の実行や部品ごとの手順は [[specdojo:command-reference|CLI コマンドリファレンス]] を参照してください。
|
|
241
241
|
|
|
242
242
|
- 評価対象は成果物です。`approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、見直した実践の型そのものが評価対象になります(`--target kata`)。
|
|
243
|
+
- Schedule の intent が `improve-kata` / `bootstrap-kata-set` の場合は、review の `approach` にかかわらず、代表成果物に加えて rulebook と宣言済みの sample・recipe・template も順に grade します。複数の sample はすべて対象です。sample が `not-needed` なら除外し、未宣言・`undecided` や `bootstrap_scope` の未解決参照は完了を保留します。型すべての最新 grade が `pass` であることを追加完了条件とし、`needs-work` / `fail` は `incomplete`、未評価・古い結果・参照未解決は `grade-stale`、読取不能は `grade-unavailable` にします。`complete-with-findings` による迂回はできません。runner も result の完了判定をこの条件で制限します。
|
|
243
244
|
- 評価対象の `content_hash` が既存の評価結果サイドカーの `content_hash` と一致する場合は、grade を再実行せず既存の評価結果を使います。どちらの場合も評価は 1 回です。
|
|
244
245
|
- grade は `grade run --path <対象文書>` で評価対象 1 件に絞って実行します。評価対象を解決できない場合と `--dry-run` の場合は実行しません。
|
|
245
|
-
- grade
|
|
246
|
+
- grade が失敗した場合は、別の run ID で合計 3 回まで試します。それでも失敗した場合も review は止めず、実行の結果と評価結果の鮮度を review plan に示し、review が verdict(`grade-stale` / `grade-unavailable` など)として記録します。ただし runner はそのタスクを done にせず blocked にし、失敗の理由と次の操作を block の理由と result の `block_reason` に残します。
|
|
247
|
+
- schedule の review を再開するとき(reporter や executor からの再開)も、runner は review の agent より前に grade を確かめます。worktree の評価結果サイドカーが root の最新と違う場合は、exec branch へ取り込む commit を作ります。plan の評価結果の節は前回の実行の時点のままなので、再開の時点の評価結果を agent への指示に足します。取り込みがあった reporter からの再開では、古い grade で判定した executor の結果を使い回さず、executor から流し直します。
|
|
248
|
+
- 自動 grade は `--if-busy wait` で同一 project の実行終了を待ち、`--isolate-pipeline-state` で再試行状態を run 内へ分離します。同じ秒に複数の型を評価しても run ID が衝突しないよう、対象パスの識別子を含めます。
|
|
246
249
|
|
|
247
250
|
### 3.3. review plan の生成
|
|
248
251
|
|
|
@@ -266,12 +269,12 @@ review plan の `評価結果` 章には、評価結果を確定済みの事実
|
|
|
266
269
|
|
|
267
270
|
### 3.4. review plan の配置
|
|
268
271
|
|
|
269
|
-
review plan は `<execution_path>/
|
|
272
|
+
review plan は `<execution_path>/runs/schedule/<task-id>/<run-id>/plan.md` に生成します(register の post-review では `runs/register/<項目 ID>/<run ID>/plan.md`)。`<execution_path>` はプロジェクトの実行ディレクトリ(例: `execution`)を指します。
|
|
270
273
|
|
|
271
274
|
例
|
|
272
275
|
|
|
273
276
|
```text
|
|
274
|
-
|
|
277
|
+
execution/runs/schedule/T-LAUNCH-prj-overview-030/<run-id>/plan.md
|
|
275
278
|
```
|
|
276
279
|
|
|
277
280
|
### 3.5. review plan の構成
|
|
@@ -306,13 +309,13 @@ specdojo:
|
|
|
306
309
|
|
|
307
310
|
### 3.6. review execution
|
|
308
311
|
|
|
309
|
-
人または agent は review plan に従って review します。`<execution_path>/
|
|
312
|
+
人または agent は review plan に従って review します。`<execution_path>/runs/schedule/<task-id>/<run-id>/result.md`(register の post-review では `runs/register/<項目 ID>/<run ID>/result.md`)は `specdojo exec claim` の時点で scaffold される(手動 claim でも `exec run` 経由の claim でも同様)ため、agent または人はそこに結果を記入します。
|
|
310
313
|
|
|
311
314
|
agent に review を実行させる場合は、`exec run --plan` で executor と reporter を指定して 2 段で実行します。
|
|
312
315
|
|
|
313
316
|
```bash
|
|
314
317
|
# review を 2 段で実行する
|
|
315
|
-
npx specdojo exec run --project <project-id> --plan <execution_path>/
|
|
318
|
+
npx specdojo exec run --project <project-id> --plan <execution_path>/runs/schedule/<task-id>/<run-id>/plan.md \
|
|
316
319
|
--executor-by <executor-nickname> --reporter-by <reporter-nickname>
|
|
317
320
|
```
|
|
318
321
|
|
|
@@ -329,7 +332,7 @@ review で `approach` に応じて何を確かめるかは、plan の `進め方
|
|
|
329
332
|
|
|
330
333
|
### 3.7. review result の構成
|
|
331
334
|
|
|
332
|
-
review result は `<execution_path>/
|
|
335
|
+
review result は `<execution_path>/runs/schedule/<task-id>/<run-id>/result.md`(register の post-review では `runs/register/<項目 ID>/<run ID>/result.md`)に生成・更新します。
|
|
333
336
|
|
|
334
337
|
```yaml
|
|
335
338
|
specdojo:
|
|
@@ -339,7 +342,7 @@ specdojo:
|
|
|
339
342
|
mode: review
|
|
340
343
|
status: in_progress | complete | blocked
|
|
341
344
|
project_id: <project_id>
|
|
342
|
-
plan_ref:
|
|
345
|
+
plan_ref: runs/schedule/<task-id>/<run-id>/plan.md
|
|
343
346
|
started_at: <ISO8601>
|
|
344
347
|
completed_at: <ISO8601>
|
|
345
348
|
agent: <member nickname>
|
|
@@ -353,7 +356,7 @@ specdojo:
|
|
|
353
356
|
| approach に応じた確認 | `approach` に応じて確認した内容 |
|
|
354
357
|
| decision | `verdict`(タスク完了可否の 6 値。値の一覧は次のとおり) |
|
|
355
358
|
|
|
356
|
-
`verdict` は `complete` / `complete-with-findings` / `incomplete` / `grade-stale` / `grade-unavailable` / `changed-during-review` のいずれかです。`pm-review-viewpoints.yaml` の `verdict_definitions` も同じ 6 値を定義します。各値を選ぶ条件は共通規約の `review の判断手順` を正本とします。verdict が `complete` 以外でも、review result を記録できた場合は正常終了します。runner は verdict に応じて再評価または再計画へ進みます。
|
|
359
|
+
`verdict` は `complete` / `complete-with-findings` / `incomplete` / `grade-stale` / `grade-unavailable` / `changed-during-review` のいずれかです。`pm-review-viewpoints.yaml` の `verdict_definitions` も同じ 6 値を定義します。各値を選ぶ条件は共通規約の `review の判断手順` を正本とします。verdict が `complete` 以外でも、review result を記録できた場合は正常終了します。runner は verdict に応じて再評価または再計画へ進みます。schedule のタスクでは、`grade-stale` / `grade-unavailable` / `changed-during-review` の review を done にせず blocked にします。
|
|
357
360
|
|
|
358
361
|
### 3.8. grade の結果を review の入力にする規則
|
|
359
362
|
|