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
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
$schema: "https://json-schema.org/draft/2020-12/schema"
|
|
2
|
+
title: External System Interface List Schema
|
|
3
|
+
type: object
|
|
4
|
+
additionalProperties: false
|
|
5
|
+
|
|
6
|
+
required:
|
|
7
|
+
- id
|
|
8
|
+
- type
|
|
9
|
+
- title
|
|
10
|
+
- status
|
|
11
|
+
- rulebook
|
|
12
|
+
- interfaces
|
|
13
|
+
|
|
14
|
+
$defs:
|
|
15
|
+
idRef:
|
|
16
|
+
type: string
|
|
17
|
+
pattern: "^[a-z0-9][a-z0-9-]*$"
|
|
18
|
+
description: "英小文字・数字・ハイフンのみ。先頭は英小文字または数字。"
|
|
19
|
+
idRefArray:
|
|
20
|
+
type: array
|
|
21
|
+
items:
|
|
22
|
+
$ref: "#/$defs/idRef"
|
|
23
|
+
uniqueItems: true
|
|
24
|
+
semver:
|
|
25
|
+
type: string
|
|
26
|
+
# SemVer 2.0.0(prerelease / build metadata も許容)
|
|
27
|
+
pattern: "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z-.]+)?(?:\\+[0-9A-Za-z-.]+)?$"
|
|
28
|
+
|
|
29
|
+
properties:
|
|
30
|
+
id:
|
|
31
|
+
type: string
|
|
32
|
+
pattern: "^(?:[a-z][a-z0-9-]*:)?ifx-index(?:-[a-z0-9-]+)?$"
|
|
33
|
+
description: "一意なID(ifx-index または ifx-index-...)。プロジェクトの修飾(例: prj-0001:ifx-index)を付けてよい"
|
|
34
|
+
type:
|
|
35
|
+
type: string
|
|
36
|
+
const: "api"
|
|
37
|
+
title:
|
|
38
|
+
type: string
|
|
39
|
+
minLength: 1
|
|
40
|
+
status:
|
|
41
|
+
type: string
|
|
42
|
+
enum: ["draft", "ready", "deprecated"]
|
|
43
|
+
rulebook:
|
|
44
|
+
type: string
|
|
45
|
+
pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
|
|
46
|
+
description: "準拠する rulebook の ID。該当がない場合は none。"
|
|
47
|
+
version:
|
|
48
|
+
$ref: "#/$defs/semver"
|
|
49
|
+
owners:
|
|
50
|
+
type: array
|
|
51
|
+
items:
|
|
52
|
+
type: string
|
|
53
|
+
pattern: "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
|
|
54
|
+
uniqueItems: true
|
|
55
|
+
|
|
56
|
+
tags:
|
|
57
|
+
type: array
|
|
58
|
+
items:
|
|
59
|
+
type: string
|
|
60
|
+
minLength: 1
|
|
61
|
+
uniqueItems: true
|
|
62
|
+
|
|
63
|
+
part_of:
|
|
64
|
+
$ref: "#/$defs/idRefArray"
|
|
65
|
+
default: []
|
|
66
|
+
based_on:
|
|
67
|
+
$ref: "#/$defs/idRefArray"
|
|
68
|
+
default: []
|
|
69
|
+
implements:
|
|
70
|
+
$ref: "#/$defs/idRefArray"
|
|
71
|
+
default: []
|
|
72
|
+
tests:
|
|
73
|
+
$ref: "#/$defs/idRefArray"
|
|
74
|
+
default: []
|
|
75
|
+
supersedes:
|
|
76
|
+
$ref: "#/$defs/idRefArray"
|
|
77
|
+
default: []
|
|
78
|
+
|
|
79
|
+
interfaces:
|
|
80
|
+
type: array
|
|
81
|
+
default: []
|
|
82
|
+
minItems: 1
|
|
83
|
+
items:
|
|
84
|
+
type: object
|
|
85
|
+
additionalProperties: false
|
|
86
|
+
required:
|
|
87
|
+
- name
|
|
88
|
+
- source
|
|
89
|
+
- target
|
|
90
|
+
- direction
|
|
91
|
+
- kind
|
|
92
|
+
- format
|
|
93
|
+
- timing
|
|
94
|
+
properties:
|
|
95
|
+
name:
|
|
96
|
+
type: string
|
|
97
|
+
minLength: 1
|
|
98
|
+
description: "連携名"
|
|
99
|
+
source:
|
|
100
|
+
type: string
|
|
101
|
+
minLength: 1
|
|
102
|
+
description: "連携元(システム/コンテナ/コンポーネントなど)"
|
|
103
|
+
target:
|
|
104
|
+
type: string
|
|
105
|
+
minLength: 1
|
|
106
|
+
description: "連携先(外部システム名など)"
|
|
107
|
+
direction:
|
|
108
|
+
type: string
|
|
109
|
+
enum:
|
|
110
|
+
- source_to_target
|
|
111
|
+
- target_to_source
|
|
112
|
+
- bidirectional
|
|
113
|
+
description: "方向(source/targetに基づく)"
|
|
114
|
+
kind:
|
|
115
|
+
type: string
|
|
116
|
+
enum:
|
|
117
|
+
- API
|
|
118
|
+
- ファイル
|
|
119
|
+
- メッセージ
|
|
120
|
+
- コマンド
|
|
121
|
+
description: "連携の種別"
|
|
122
|
+
format:
|
|
123
|
+
type: string
|
|
124
|
+
enum:
|
|
125
|
+
- CSV
|
|
126
|
+
- JSON
|
|
127
|
+
- XML
|
|
128
|
+
- その他
|
|
129
|
+
- TBD
|
|
130
|
+
description: "データ形式(限定列挙)"
|
|
131
|
+
timing:
|
|
132
|
+
type: string
|
|
133
|
+
minLength: 1
|
|
134
|
+
description: "連携タイミング"
|
|
135
|
+
error_handling:
|
|
136
|
+
type: string
|
|
137
|
+
description: "エラー処理・備考"
|
|
138
|
+
spec_ref:
|
|
139
|
+
type: string
|
|
140
|
+
pattern: "^(?:[a-z][a-z0-9-]*:)?(?:ifx-api|ifx-file|ifx-msg|ifx-cmd)-[a-z0-9-]+$|^TBD$"
|
|
141
|
+
description: >-
|
|
142
|
+
詳細仕様ドキュメントの id(ifx-api-/ifx-file-/ifx-msg-/ifx-cmd-...)または TBD
|
|
@@ -88,6 +88,29 @@ properties:
|
|
|
88
88
|
type: [integer, "null"]
|
|
89
89
|
reason:
|
|
90
90
|
type: string
|
|
91
|
+
steps:
|
|
92
|
+
type: array
|
|
93
|
+
items:
|
|
94
|
+
type: object
|
|
95
|
+
additionalProperties: false
|
|
96
|
+
required: [id, status]
|
|
97
|
+
properties:
|
|
98
|
+
id:
|
|
99
|
+
type: string
|
|
100
|
+
status:
|
|
101
|
+
enum: [running, succeeded, failed, deferred]
|
|
102
|
+
started_at:
|
|
103
|
+
type: string
|
|
104
|
+
format: date-time
|
|
105
|
+
completed_at:
|
|
106
|
+
type: string
|
|
107
|
+
format: date-time
|
|
108
|
+
exit_code:
|
|
109
|
+
type: [integer, "null"]
|
|
110
|
+
reason:
|
|
111
|
+
type: string
|
|
112
|
+
evidence_ref:
|
|
113
|
+
type: string
|
|
91
114
|
review:
|
|
92
115
|
type: object
|
|
93
116
|
additionalProperties: false
|
|
@@ -153,7 +153,7 @@ $defs:
|
|
|
153
153
|
type: string
|
|
154
154
|
minLength: 1
|
|
155
155
|
proficiency:
|
|
156
|
-
|
|
156
|
+
$ref: "./exec-common.schema.yaml#/$defs/Proficiency"
|
|
157
157
|
review:
|
|
158
158
|
$ref: "#/$defs/review"
|
|
159
159
|
review:
|
|
@@ -180,7 +180,18 @@ $defs:
|
|
|
180
180
|
commandTask:
|
|
181
181
|
type: object
|
|
182
182
|
additionalProperties: false
|
|
183
|
-
required: [mode
|
|
183
|
+
required: [mode]
|
|
184
|
+
oneOf:
|
|
185
|
+
- required: [command]
|
|
186
|
+
not:
|
|
187
|
+
anyOf:
|
|
188
|
+
- required: [steps]
|
|
189
|
+
- required: [lock_wait_seconds]
|
|
190
|
+
- required: [steps]
|
|
191
|
+
not:
|
|
192
|
+
anyOf:
|
|
193
|
+
- required: [command]
|
|
194
|
+
- required: [partial_exit_code]
|
|
184
195
|
properties:
|
|
185
196
|
mode:
|
|
186
197
|
const: command
|
|
@@ -190,6 +201,14 @@ $defs:
|
|
|
190
201
|
command:
|
|
191
202
|
type: string
|
|
192
203
|
minLength: 1
|
|
204
|
+
steps:
|
|
205
|
+
type: array
|
|
206
|
+
minItems: 1
|
|
207
|
+
items:
|
|
208
|
+
$ref: "#/$defs/commandStep"
|
|
209
|
+
lock_wait_seconds:
|
|
210
|
+
type: integer
|
|
211
|
+
minimum: 0
|
|
193
212
|
partial_exit_code:
|
|
194
213
|
description: >
|
|
195
214
|
Optional non-zero exit code that records a reviewable partial Job Run. Other non-zero
|
|
@@ -228,3 +247,45 @@ $defs:
|
|
|
228
247
|
$ref: "#/$defs/pathScope"
|
|
229
248
|
review:
|
|
230
249
|
$ref: "#/$defs/review"
|
|
250
|
+
commandStep:
|
|
251
|
+
type: object
|
|
252
|
+
additionalProperties: false
|
|
253
|
+
required: [id, command]
|
|
254
|
+
properties:
|
|
255
|
+
id:
|
|
256
|
+
type: string
|
|
257
|
+
pattern: "^[a-z][a-z0-9-]*$"
|
|
258
|
+
command:
|
|
259
|
+
type: string
|
|
260
|
+
minLength: 1
|
|
261
|
+
on_failure:
|
|
262
|
+
enum: [stop, continue]
|
|
263
|
+
timeout_seconds:
|
|
264
|
+
type: integer
|
|
265
|
+
minimum: 1
|
|
266
|
+
maximum: 2147483
|
|
267
|
+
completion:
|
|
268
|
+
type: object
|
|
269
|
+
additionalProperties: false
|
|
270
|
+
required: [path, field, succeeded]
|
|
271
|
+
properties:
|
|
272
|
+
path:
|
|
273
|
+
type: string
|
|
274
|
+
minLength: 1
|
|
275
|
+
field:
|
|
276
|
+
type: string
|
|
277
|
+
minLength: 1
|
|
278
|
+
succeeded:
|
|
279
|
+
type: array
|
|
280
|
+
minItems: 1
|
|
281
|
+
uniqueItems: true
|
|
282
|
+
items:
|
|
283
|
+
type: string
|
|
284
|
+
minLength: 1
|
|
285
|
+
deferred:
|
|
286
|
+
type: array
|
|
287
|
+
minItems: 1
|
|
288
|
+
uniqueItems: true
|
|
289
|
+
items:
|
|
290
|
+
type: string
|
|
291
|
+
minLength: 1
|
|
@@ -101,6 +101,7 @@ properties:
|
|
|
101
101
|
[
|
|
102
102
|
draft,
|
|
103
103
|
fully-guided,
|
|
104
|
+
condense,
|
|
104
105
|
recipe-guided,
|
|
105
106
|
freeform,
|
|
106
107
|
retrofit,
|
|
@@ -120,6 +121,8 @@ properties:
|
|
|
120
121
|
else:
|
|
121
122
|
properties:
|
|
122
123
|
track: false
|
|
124
|
+
domains: false
|
|
125
|
+
start_on: false
|
|
123
126
|
- type: object
|
|
124
127
|
required:
|
|
125
128
|
- rulebook
|
|
@@ -165,7 +168,15 @@ properties:
|
|
|
165
168
|
|
|
166
169
|
track:
|
|
167
170
|
$ref: "#/$defs/Track"
|
|
168
|
-
description: "Track governed by this epic
|
|
171
|
+
description: "Track governed exclusively by this epic."
|
|
172
|
+
|
|
173
|
+
domains:
|
|
174
|
+
type: array
|
|
175
|
+
items:
|
|
176
|
+
type: string
|
|
177
|
+
minLength: 1
|
|
178
|
+
uniqueItems: true
|
|
179
|
+
description: "Catalog domains governed by this epic. Omission permits legacy fallback."
|
|
169
180
|
|
|
170
181
|
item_status:
|
|
171
182
|
$ref: "#/$defs/ItemStatus"
|
|
@@ -196,6 +207,10 @@ properties:
|
|
|
196
207
|
register timezone. Omit the key only when the registration time of a
|
|
197
208
|
legacy item is unknown; newly added items always record it.
|
|
198
209
|
|
|
210
|
+
start_on:
|
|
211
|
+
$ref: "#/$defs/Date"
|
|
212
|
+
description: "Planned start calendar date for an epic. Omit while undecided."
|
|
213
|
+
|
|
199
214
|
due_on:
|
|
200
215
|
oneOf:
|
|
201
216
|
- $ref: "#/$defs/Date"
|
|
@@ -383,6 +398,7 @@ $defs:
|
|
|
383
398
|
enum:
|
|
384
399
|
- draft
|
|
385
400
|
- fully-guided
|
|
401
|
+
- condense
|
|
386
402
|
- recipe-guided
|
|
387
403
|
- freeform
|
|
388
404
|
- bootstrap
|
|
@@ -692,7 +692,7 @@ $defs:
|
|
|
692
692
|
$ref: "./exec-common.schema.yaml#/$defs/Proficiency"
|
|
693
693
|
description: >
|
|
694
694
|
Required agent proficiency for execution: agent phases.
|
|
695
|
-
Omit to accept
|
|
695
|
+
Omit to accept any proficiency except frontier. Frontier requires an explicit request.
|
|
696
696
|
Can be overridden per-deliverable via owner_rules[].phase_overrides.
|
|
697
697
|
agent:
|
|
698
698
|
$ref: "./sch-common.schema.yaml#/$defs/AgentAssignment"
|
|
@@ -762,7 +762,7 @@ $defs:
|
|
|
762
762
|
proficiency:
|
|
763
763
|
$ref: "./exec-common.schema.yaml#/$defs/Proficiency"
|
|
764
764
|
description: >
|
|
765
|
-
Agent proficiency required for this stage. Omit to accept any proficiency
|
|
765
|
+
Agent proficiency required for this stage. Omit to accept any proficiency except frontier.
|
|
766
766
|
|
|
767
767
|
Capabilities:
|
|
768
768
|
type: array
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "naoji3x",
|
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
"docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
|
|
94
94
|
"docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
|
|
95
95
|
"docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
|
|
96
|
-
"docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
|
|
96
|
+
"docs:build": "npm run docs:generate && NODE_OPTIONS=--max-old-space-size=8192 npm --prefix packages/docs-site run docs:build",
|
|
97
97
|
"lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
|
|
98
98
|
"lint:mermaid": "node tools/lint-mermaid.mjs",
|
|
99
99
|
"lint:d2": "node tools/lint-d2.mjs",
|
|
@@ -119,7 +119,7 @@
|
|
|
119
119
|
"validate:schema:yaml": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --modeline"
|
|
120
120
|
},
|
|
121
121
|
"engines": {
|
|
122
|
-
"node": ">=22.
|
|
122
|
+
"node": ">=22.17"
|
|
123
123
|
},
|
|
124
124
|
"dependencies": {
|
|
125
125
|
"ajv": "^8.20.0",
|
|
@@ -128,7 +128,6 @@
|
|
|
128
128
|
"js-yaml": "^5.4.3",
|
|
129
129
|
"prettier": "^3.8.4",
|
|
130
130
|
"remark-parse": "^11.0.0",
|
|
131
|
-
"tinyglobby": "^0.2.17",
|
|
132
131
|
"unified": "^11.0.5"
|
|
133
132
|
},
|
|
134
133
|
"devDependencies": {
|
|
@@ -137,13 +136,12 @@
|
|
|
137
136
|
"@types/node": "^25.9.2",
|
|
138
137
|
"@typescript-eslint/eslint-plugin": "^8.61.0",
|
|
139
138
|
"@typescript-eslint/parser": "^8.61.0",
|
|
140
|
-
"ajv-cli": "^5.0.0",
|
|
141
139
|
"ajv-formats": "^3.0.1",
|
|
142
140
|
"cloc": "^2.6.0-cloc",
|
|
143
141
|
"eslint-config-prettier": "^10.1.8",
|
|
144
142
|
"gray-matter": "^4.0.3",
|
|
145
143
|
"lefthook": "^2.1.9",
|
|
146
|
-
"markdownlint-cli": "^0.
|
|
144
|
+
"markdownlint-cli": "^0.50.0",
|
|
147
145
|
"remark": "^15.0.1",
|
|
148
146
|
"remark-cli": "^12.0.1",
|
|
149
147
|
"remark-frontmatter": "^5.0.0",
|
|
@@ -154,6 +152,11 @@
|
|
|
154
152
|
"tsx": "^4.22.4",
|
|
155
153
|
"typescript": "^6.0.3",
|
|
156
154
|
"typescript-eslint": "^8.61.0",
|
|
157
|
-
"vitest": "^4.1.
|
|
155
|
+
"vitest": "^4.1.12"
|
|
156
|
+
},
|
|
157
|
+
"overrides": {
|
|
158
|
+
"fast-uri": "^3.1.9",
|
|
159
|
+
"vite": "^8.3.8",
|
|
160
|
+
"source-map-js": "^1.2.2"
|
|
158
161
|
}
|
|
159
162
|
}
|
|
@@ -14,6 +14,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
14
14
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
15
15
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
16
16
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
17
|
+
- 書き込みを伴う git 操作(commit・merge・add・restore など)は `npx specdojo git --project <project-id> -- <git の引数>` で流し、runner の統合と同じロックに並べる。register の記帳は、これまでどおり `register ... --commit` を使う。
|
|
17
18
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
18
19
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
19
20
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
@@ -23,7 +24,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
23
24
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
24
25
|
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
25
26
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
26
|
-
- `specdojo.config.json` の project に `repos`
|
|
27
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリ(`.specdojo/specdojo.local.config.json` で追加・パスを差し替えたものを含む。`specdojo config show` で確かめる)は参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
27
28
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
28
29
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
29
30
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -60,6 +61,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
60
61
|
| 進捗の俯瞰 | `dashboard` | `dashboard build` |
|
|
61
62
|
| 品質評価 | `grade` | `grade list` / `plan` / `apply` |
|
|
62
63
|
| ドキュメントIDインデックス | `index` | `index build` |
|
|
64
|
+
| 保存先の確認 | `where` | `where <kind> --project <project-id>` |
|
|
63
65
|
| 全生成物の一括更新 | `build` | `build` |
|
|
64
66
|
|
|
65
67
|
正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
|
|
@@ -164,6 +166,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
164
166
|
|
|
165
167
|
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
166
168
|
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
169
|
+
- grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
|
|
167
170
|
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
168
171
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
169
172
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
@@ -178,6 +181,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
178
181
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
179
182
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
180
183
|
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
184
|
+
- 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
|
|
181
185
|
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
182
186
|
|
|
183
187
|
## 止まったときの対処
|
|
@@ -187,7 +191,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
187
191
|
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
188
192
|
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
189
193
|
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
190
|
-
|
|
|
194
|
+
| 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
191
195
|
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
192
196
|
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
193
197
|
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
@@ -196,7 +200,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
196
200
|
|
|
197
201
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
198
202
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
199
|
-
- CHANGELOG
|
|
203
|
+
- CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
|
|
200
204
|
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
201
205
|
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
202
206
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
@@ -21,6 +21,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
21
21
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
22
22
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
23
23
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
24
|
+
- 書き込みを伴う git 操作(commit・merge・add・restore など)は `npx specdojo git --project <project-id> -- <git の引数>` で流し、runner の統合と同じロックに並べる。register の記帳は、これまでどおり `register ... --commit` を使う。
|
|
24
25
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
25
26
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
26
27
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
@@ -30,7 +31,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
30
31
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
31
32
|
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
32
33
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
33
|
-
- `specdojo.config.json` の project に `repos`
|
|
34
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリ(`.specdojo/specdojo.local.config.json` で追加・パスを差し替えたものを含む。`specdojo config show` で確かめる)は参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
34
35
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
35
36
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
36
37
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -67,6 +68,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
67
68
|
| 進捗の俯瞰 | `dashboard` | `dashboard build` |
|
|
68
69
|
| 品質評価 | `grade` | `grade list` / `plan` / `apply` |
|
|
69
70
|
| ドキュメントIDインデックス | `index` | `index build` |
|
|
71
|
+
| 保存先の確認 | `where` | `where <kind> --project <project-id>` |
|
|
70
72
|
| 全生成物の一括更新 | `build` | `build` |
|
|
71
73
|
|
|
72
74
|
正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
|
|
@@ -171,6 +173,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
171
173
|
|
|
172
174
|
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
173
175
|
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
176
|
+
- grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
|
|
174
177
|
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
175
178
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
176
179
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
@@ -185,6 +188,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
185
188
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
186
189
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
187
190
|
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
191
|
+
- 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
|
|
188
192
|
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
189
193
|
|
|
190
194
|
## 止まったときの対処
|
|
@@ -194,7 +198,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
194
198
|
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
195
199
|
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
196
200
|
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
197
|
-
|
|
|
201
|
+
| 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
198
202
|
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
199
203
|
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
200
204
|
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
@@ -203,7 +207,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
203
207
|
|
|
204
208
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
205
209
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
206
|
-
- CHANGELOG
|
|
210
|
+
- CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
|
|
207
211
|
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
208
212
|
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
209
213
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
@@ -21,6 +21,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
21
21
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
22
22
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
23
23
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
24
|
+
- 書き込みを伴う git 操作(commit・merge・add・restore など)は `npx specdojo git --project <project-id> -- <git の引数>` で流し、runner の統合と同じロックに並べる。register の記帳は、これまでどおり `register ... --commit` を使う。
|
|
24
25
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
25
26
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
26
27
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
@@ -30,7 +31,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
30
31
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
31
32
|
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
32
33
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
33
|
-
- `specdojo.config.json` の project に `repos`
|
|
34
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリ(`.specdojo/specdojo.local.config.json` で追加・パスを差し替えたものを含む。`specdojo config show` で確かめる)は参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
34
35
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
35
36
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
36
37
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -67,6 +68,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
67
68
|
| 進捗の俯瞰 | `dashboard` | `dashboard build` |
|
|
68
69
|
| 品質評価 | `grade` | `grade list` / `plan` / `apply` |
|
|
69
70
|
| ドキュメントIDインデックス | `index` | `index build` |
|
|
71
|
+
| 保存先の確認 | `where` | `where <kind> --project <project-id>` |
|
|
70
72
|
| 全生成物の一括更新 | `build` | `build` |
|
|
71
73
|
|
|
72
74
|
正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
|
|
@@ -171,6 +173,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
171
173
|
|
|
172
174
|
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
173
175
|
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
176
|
+
- grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
|
|
174
177
|
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
175
178
|
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
176
179
|
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
@@ -185,6 +188,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
185
188
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
186
189
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
187
190
|
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
191
|
+
- 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
|
|
188
192
|
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
189
193
|
|
|
190
194
|
## 止まったときの対処
|
|
@@ -194,7 +198,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
194
198
|
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
195
199
|
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
196
200
|
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
197
|
-
|
|
|
201
|
+
| 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
198
202
|
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
199
203
|
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
200
204
|
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
@@ -203,7 +207,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
203
207
|
|
|
204
208
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
205
209
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
206
|
-
- CHANGELOG
|
|
210
|
+
- CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
|
|
207
211
|
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
208
212
|
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
209
213
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|