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
|
@@ -225,7 +225,7 @@ flowchart
|
|
|
225
225
|
| [業務データ辞書 / 概念データストア定義](../rulebooks/cdsd-rulebook.md) | Conceptual Data Store Definition | `cdsd-<term>` | 概念データストア(情報の保管場所)を一覧で定義する | データストア名、対応プロセス、内容、更新タイミング、粒度、主な用途 など |
|
|
226
226
|
| [業務データ辞書 / 保管場所定義](../rulebooks/sld-rulebook.md) | Storage Location Definition | `sld-<term>` | 業務対象となる物の物理的な保管場所を一覧で定義する | 保管場所名、保管対象、内容・目的、関連プロセス、管理頻度 など |
|
|
227
227
|
| [業務データ辞書 / ステータス定義](../rulebooks/stsd-rulebook.md) | Status Definition | `stsd-<term>` | 業務上のエンティティが取り得る状態と状態間の遷移を一文書で定義する | 対象、状態名、通称、意味、成立条件、管理場所、状態遷移図、イベント、遷移条件など |
|
|
228
|
-
| [業務データ辞書 /
|
|
228
|
+
| [業務データ辞書 / 分類一覧](../rulebooks/cdt-rulebook.md) | Code Table | `cdt-<term>` | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | 分類定義名、種別、分類名、説明など |
|
|
229
229
|
| [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) | Conceptual Class Diagram | `ccd-<term>` | 業務上のエンティティ関係を図で定義する | 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など |
|
|
230
230
|
|
|
231
231
|
#### 2.1.3. 業務モデル
|
|
@@ -244,6 +244,7 @@ flowchart
|
|
|
244
244
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
245
245
|
| --- | --- | --- | --- | --- |
|
|
246
246
|
| [画面仕様](../rulebooks/uis-rulebook.md) | UI Specification | `uis-<term>` | 業務ユーザー視点の画面の利用目的や表示項目、操作を定義する | 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など |
|
|
247
|
+
| [CLI仕様](../rulebooks/clis-rulebook.md) | CLI Specification | `clis-<term>` | 利用者視点での CLI コマンド群の利用目的や操作の流れ、出力・エラーを定義する | 概要、利用目的、操作の流れ、操作とコマンド参照、出力・生成ファイルの要点、終了コードとエラー表示・利用者の次の手 など |
|
|
247
248
|
| [帳票仕様](../rulebooks/bds-rulebook.md) | Business Document Specification | `bds-<term>` | 業務ユーザー視点の帳票の利用目的や表示項目を定義する | 帳票概要、利用目的、表示項目、出力タイミング など |
|
|
248
249
|
|
|
249
250
|
#### 2.1.5. システム化機能
|
|
@@ -251,8 +252,8 @@ flowchart
|
|
|
251
252
|
<!-- prettier-ignore -->
|
|
252
253
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
253
254
|
| --- | --- | --- | --- | --- |
|
|
254
|
-
| [システム化機能一覧 / 全体構成](../rulebooks/sf-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
|
|
255
|
-
| [
|
|
255
|
+
| [システム化機能一覧 / 全体構成](../rulebooks/sf-index-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
|
|
256
|
+
| [システム化機能(個別)](../rulebooks/sf-rulebook.md) | System Function | `sf-<term>` | 個別のシステム化機能の目的、業務プロセス・画面との対応、処理要件を定義する | 機能目的・概要、業務プロセス・画面との対応、入出力・前提条件、処理要件、非機能制約、操作手順・コマンド参照、検証観点 |
|
|
256
257
|
|
|
257
258
|
#### 2.1.6. 用語集
|
|
258
259
|
|
|
@@ -272,7 +273,7 @@ flowchart
|
|
|
272
273
|
| [外部API仕様](../rulebooks/ifx-api-rulebook.md) | External API Specification | `ifx-api-<term>.yaml` | 外部システムとのAPI連携をOpenAPI形式(YAML)で定義する | エンドポイント、HTTPメソッド、リクエスト/レスポンス、ステータスコード |
|
|
273
274
|
| [外部ファイル連携仕様](../rulebooks/ifx-file-rulebook.md) | External File Exchange Specification | `ifx-file-<term>.yaml` | 外部システムとのファイル連携をYAMLで定義する | ファイル形式、伝送方法、スケジュール、ファイル項目一覧 |
|
|
274
275
|
| [外部メッセージ仕様](../rulebooks/ifx-msg-rulebook.md) | External Message Specification | `ifx-msg-<term>.yaml` | 他システムとのイベント/キューのメッセージ連携をAsyncAPI + CloudEvents(YAML)で定義する | チャネル名、メッセージ構造、エンドポイント、プロトコル |
|
|
275
|
-
| [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する |
|
|
276
|
+
| [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する | コマンド名、正本参照、入出力ストリーム、入出力ファイル、副作用、終了コード、エラー処理 |
|
|
276
277
|
|
|
277
278
|
### 2.3. アーキテクチャ
|
|
278
279
|
|
|
@@ -301,6 +302,7 @@ flowchart
|
|
|
301
302
|
- **System Design Index**:設計のSSOT(OpenAPI / AsyncAPI / migration / job定義 / config schema 等)への導線
|
|
302
303
|
- **System Design Critical Flows**:事故や仕様誤解の原因になりやすい“重要フロー”だけを少数(最大5件)定義
|
|
303
304
|
- **System Design Cross-cutting Policy**:エラー・冪等・リトライ・監査・トレーシング等の横断ルール(実装の共通前提)
|
|
305
|
+
- **Design System Specification**:画面をまたぐ GUI のデザインの決まり。既存のトークンや部品の正本は参照する
|
|
304
306
|
|
|
305
307
|
#### 2.4.1. ドキュメント一覧と概要(最小構成)
|
|
306
308
|
|
|
@@ -310,6 +312,9 @@ flowchart
|
|
|
310
312
|
| 全体構成(リンク集) | System Design Index | `sysd-index` | システム設計のSSOTへの導線を1箇所に集約し、設計情報を迷子にしない | 内部API定義(OpenAPI等)/イベント定義(AsyncAPI等)/DBスキーマ(migration等)/バッチ定義(workflow/cron等)/設定スキーマ(config schema等)/コード配置規約(モジュール境界) |
|
|
311
313
|
| 重要フロー | System Design Critical Flows | `sysd-critical-flows` | “読まないと事故る”フローだけを可視化し、実装・テスト・運用の共通理解を作る | 最大5フロー(冪等/補償/非同期/順序/整合性/外部I/F障害など)について、境界・永続化点・再実行性・失敗時挙動を図または箇条書きで定義 |
|
|
312
314
|
| 横断ルール | System Design Cross-cutting Policy | `sysd-cross-cutting-policy` | 実装全体に影響する共通ルールをSSOT化し、各所の実装ブレを防ぐ | エラー形式/例外分類、タイムアウト・リトライ、冪等キー、トランザクション境界、ログ/監査ログ、トレーシング、セキュリティ(認証・認可の実装原則)、バージョニング、設定の上書き階層 |
|
|
315
|
+
| [[specdojo:dss-rulebook\|デザインシステム]] | Design System Specification | `dss-<term>`(既定: `dss-common`) | GUI の見た目と操作時の表現を揃え、操作性目標を満たす設計の決まりを定める | デザイントークン、部品の使い方、レイアウトの型、状態表示、アクセシビリティ、正本への参照、検証方法 |
|
|
316
|
+
|
|
317
|
+
DSS の成果物は `docs/ja/product/040-system-design/` へ置きます。画面ごとの目的・項目・操作・遷移は UIS、測れる操作性目標は NFR が持ちます。ワイヤーフレームは文書として保守せず、UIS と DSS から試作を作ってプロダクトのリポジトリに置きます。
|
|
313
318
|
|
|
314
319
|
> 補足:従来の「実装データフロー図/実装クラス図/DB論理・物理/実装画面仕様/内部I/F/バッチ設計/設定一覧」は、
|
|
315
320
|
> **“SSOTをコード(定義ファイル)に寄せる”** 方針により、個別ドキュメントとしては作りません。
|
|
@@ -317,14 +322,23 @@ flowchart
|
|
|
317
322
|
|
|
318
323
|
カテゴリ別に何を SSOT とし、何を個別ドキュメントとして書かないかの判断基準は [システム設計-全体構成 作成ルール](../rulebooks/sysd-index-rulebook.md) の `カテゴリ別の書き分け方針` を正本とします。
|
|
319
324
|
|
|
320
|
-
### 2.5.
|
|
325
|
+
### 2.5. 実装
|
|
326
|
+
|
|
327
|
+
実装の段の型は、agent が実装の直前に読むコーディング規約の 1 種類だけとします。実装の設計書は置かず、モジュールの分け方やコンポーネントの境界はアーキテクチャとシステム設計で、使う言語・ライブラリは技術スタック一覧で決めます。
|
|
328
|
+
|
|
329
|
+
<!-- prettier-ignore -->
|
|
330
|
+
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
331
|
+
| --- | --- | --- | --- | --- |
|
|
332
|
+
| [[specdojo:cdr-rulebook\|コーディング規約(agent 向け instructions)]] | Coding Rules (Agent Instructions) | `.github/instructions/<言語>.instructions.md` | 言語・枠組みごとの書き方と検証を 1 つの正本に定め、環境別のラッパーから agent に読ませる | 基本方針、モジュールと import、型、エラー処理、命名、テストと検証のコマンド、禁止事項 |
|
|
333
|
+
|
|
334
|
+
### 2.6. 業務受入条件
|
|
321
335
|
|
|
322
336
|
<!-- prettier-ignore -->
|
|
323
337
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
324
338
|
| --- | --- | --- | --- | --- |
|
|
325
339
|
| [業務受入条件](../rulebooks/bac-rulebook.md) | Business Acceptance Criteria | `bac-<term>` | 業務として受け入れ可能であることを示す条件を定義する | 業務シナリオ、受入条件、前提、操作、期待結果 など |
|
|
326
340
|
|
|
327
|
-
### 2.
|
|
341
|
+
### 2.7. 非機能要件
|
|
328
342
|
|
|
329
343
|
<!-- prettier-ignore -->
|
|
330
344
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -339,25 +353,25 @@ flowchart
|
|
|
339
353
|
| [非機能要件 / 運用](../rulebooks/nfr-operations-rulebook.md) | Non-functional Requirements / Operations | `nfr-operations` | 監視・手順・継続運用を定義する | アラート検知率、復旧達成率、運用手順充実度 |
|
|
340
354
|
| [非機能要件 / 操作性](../rulebooks/nfr-usability-rulebook.md) | Non-functional Requirements / Usability | `nfr-usability` | 使いやすさと誤操作防止を定義する | タスク完了率、誤操作率、エラーメッセージ明確性 |
|
|
341
355
|
|
|
342
|
-
### 2.
|
|
356
|
+
### 2.8. システム受入条件
|
|
343
357
|
|
|
344
358
|
<!-- prettier-ignore -->
|
|
345
359
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
346
360
|
| --- | --- | --- | --- | --- |
|
|
347
361
|
| [システム受入条件](../rulebooks/sac-rulebook.md) | System Acceptance Criteria | `sac-<term>` | システム全体としての合格基準を定義する | 機能・非機能・障害・移行などの受け入れ条件 |
|
|
348
362
|
|
|
349
|
-
### 2.
|
|
363
|
+
### 2.9. テスト
|
|
350
364
|
|
|
351
365
|
※ 個別仕様のサフィックスは、対象ドキュメントの目的に合わせて「用語集」のtermから命名します。リンクされる可能性も鑑みなるべく固定できる名前を選びます。
|
|
352
366
|
|
|
353
|
-
#### 2.
|
|
367
|
+
#### 2.9.1. 共通
|
|
354
368
|
|
|
355
369
|
<!-- prettier-ignore -->
|
|
356
370
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
357
371
|
| --- | --- | --- | --- | --- |
|
|
358
372
|
| [テスト戦略・方針](../rulebooks/tsp-index-rulebook.md) | Test Strategy and Policy | `tsp-index` | 全体テストの考え方を示す(要件) | テストレベルと目的、対象/対象外(スコープ)、品質目標、体制/役割、環境、使用ツール、テストデータ方針、入口/出口条件、進め方・優先度、リスクと対策 |
|
|
359
373
|
|
|
360
|
-
#### 2.
|
|
374
|
+
#### 2.9.2. 単体テストカタログ
|
|
361
375
|
|
|
362
376
|
<!-- prettier-ignore -->
|
|
363
377
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -365,7 +379,7 @@ flowchart
|
|
|
365
379
|
| [単体テスト](../rulebooks/utc-index-rulebook.md) | Unit Test Catalog | `utc-index` | 単体テストとして確認する観点・条件と分配を定義する | 対象単位、テスト範囲と対象外、境界(モック/スタブ方針)、TPC の観点・条件の分配、合格基準とエビデンス(共通) |
|
|
366
380
|
| [単体テスト対象別](../rulebooks/utc-rulebook.md) | Unit Test Specification | `utc-<target>` | 単体テスト仕様を対象ごとに分割して定義する | 個別対象の範囲、観点、代表条件(状態レベル)、合格基準とエビデンス(参照) |
|
|
367
381
|
|
|
368
|
-
#### 2.
|
|
382
|
+
#### 2.9.3. 内部結合テストカタログ
|
|
369
383
|
|
|
370
384
|
<!-- prettier-ignore -->
|
|
371
385
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -373,7 +387,7 @@ flowchart
|
|
|
373
387
|
| [内部結合テスト](../rulebooks/itc-index-rulebook.md) | Internal Integration Test Catalog | `itc-index` | 内部コンポーネント間の連携を確認する観点・条件を定義する | 対象コンポーネントと結合範囲、インターフェース(API/イベント/DB)観点、主要フロー/例外フロー、トランザクション・整合性、エラー処理、ログ/監視観点、合格基準 |
|
|
374
388
|
| [内部結合テスト対象別](../rulebooks/itc-rulebook.md) | Internal Integration Test Specification | `itc-<target>` | 内部結合テスト仕様を対象(機能/連携)ごとに分割して定義する | 個別結合範囲、前提、テスト条件(シナリオ)一覧、合格基準、関連する仕様ID/機能ID |
|
|
375
389
|
|
|
376
|
-
#### 2.
|
|
390
|
+
#### 2.9.4. 外部結合テストカタログ
|
|
377
391
|
|
|
378
392
|
<!-- prettier-ignore -->
|
|
379
393
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -381,7 +395,7 @@ flowchart
|
|
|
381
395
|
| [外部結合テスト](../rulebooks/etc-index-rulebook.md) | External Integration Test Catalog | `etc-index` | 外部システム連携を含む結合観点・条件を定義する(仕様) | 対象I/F(API/ファイル/メッセージ)、契約(スキーマ/コード/制約)、正常/異常(タイムアウト・リトライ・冪等・順序)、セキュリティ(認証/認可)、性能/レート制限、監査ログ、合格基準 |
|
|
382
396
|
| [外部結合テスト対象別](../rulebooks/etc-rulebook.md) | External Integration Test Specification | `etc-<target>` | 外部結合テスト仕様を連携単位で分割して定義する(仕様) | I/Fごとのテスト条件一覧(入力/期待/エラー)、前提(接続先・認証・テストデータ)、合格基準、関連する外部I/F仕様ID |
|
|
383
397
|
|
|
384
|
-
#### 2.
|
|
398
|
+
#### 2.9.5. 総合結合テストカタログ
|
|
385
399
|
|
|
386
400
|
<!-- prettier-ignore -->
|
|
387
401
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -389,7 +403,7 @@ flowchart
|
|
|
389
403
|
| [総合テスト](../rulebooks/stc-index-rulebook.md) | System Test Catalog | `stc-index` | システム全体として業務シナリオが成立することを定義する(仕様) | エンドツーエンドの業務シナリオ、画面/API/バッチ/外部連携の通し観点、運用観点(ジョブ・監視・障害時)、非機能の観点(代表値)、合格基準 |
|
|
390
404
|
| [総合テスト対象別](../rulebooks/stc-rulebook.md) | System Test Specification | `stc-<scenario>` | 総合テスト仕様をシナリオ/業務単位で分割して定義する(仕様) | 個別シナリオの前提、データ準備、テスト条件、期待結果、合格基準、関連する業務仕様ID/受入条件ID/入条件ID |
|
|
391
405
|
|
|
392
|
-
#### 2.
|
|
406
|
+
#### 2.9.6. 受入結合テストカタログ
|
|
393
407
|
|
|
394
408
|
<!-- prettier-ignore -->
|
|
395
409
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
@@ -397,9 +411,9 @@ flowchart
|
|
|
397
411
|
| [受入テスト](../rulebooks/atc-index-rulebook.md) | Acceptance Test Catalog | `atc-index` | 業務として受け入れ可能であることを確認する観点・条件を定義する(仕様) | 業務受入シナリオ、受入条件(合格基準)、利用者視点の操作・期待結果、例外時の扱い、データ準備、役割分担、エビデンス要件、判定/承認フロー |
|
|
398
412
|
| [受入テスト対象別](../rulebooks/atc-rulebook.md) | Acceptance Test Specification | `atc-<scenario>` | 受入テスト仕様を業務シナリオ/受入条件単位で分割して定義する(仕様) | 個別受入シナリオの前提、テスト条件、期待結果、合格基準、関連する業務受入条件ID/システム受入条件ID |
|
|
399
413
|
|
|
400
|
-
### 2.
|
|
414
|
+
### 2.10. 運用
|
|
401
415
|
|
|
402
|
-
#### 2.
|
|
416
|
+
#### 2.10.1. ドキュメント一覧と概要
|
|
403
417
|
|
|
404
418
|
| ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
|
|
405
419
|
| ---------------------------------------------- | ---------------------------- | -------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
@@ -201,7 +201,7 @@ docs/
|
|
|
201
201
|
│ │ │ ├── cdsd-sales-management.md # 概念データストア定義(例:販売管理)
|
|
202
202
|
│ │ │ ├── sld-sales-management.md # 保管場所定義(例:倉庫・店舗)
|
|
203
203
|
│ │ │ ├── stsd-product-lifecycle.md # ステータス定義(状態一覧・状態遷移図の例:商品ライフサイクル)
|
|
204
|
-
│ │ │ ├──
|
|
204
|
+
│ │ │ ├── cdt-product-category.md # 分類一覧(コード表の例:商品カテゴリ)
|
|
205
205
|
│ │ │ └── ccd-sales-management.md # 概念クラス図(例:販売管理)
|
|
206
206
|
│ │ ├── 030-business-model/ # 業務モデル
|
|
207
207
|
│ │ │ ├── bps-sales-order-flow.md # 業務プロセス仕様(例:受注フロー)
|
|
@@ -235,7 +235,8 @@ docs/
|
|
|
235
235
|
│ ├── 040-system-design/ # システム設計
|
|
236
236
|
│ │ ├── sysd-index.md # 全体構成(リンク集)
|
|
237
237
|
│ │ ├── sysd-critical-flows.md # 重要フロー
|
|
238
|
-
│ │
|
|
238
|
+
│ │ ├── sysd-cross-cutting-policy.md # 横断ルール
|
|
239
|
+
│ │ └── dss-common.md # GUI デザインシステム
|
|
239
240
|
│ │
|
|
240
241
|
│ ├── 050-business-acceptance-criteria/ # 業務受入条件
|
|
241
242
|
│ │ └── bac-sales-order.md # 業務受入条件(例:受注)
|
|
@@ -14,6 +14,7 @@ SpecDojo Configuration Reference
|
|
|
14
14
|
**対象範囲**
|
|
15
15
|
|
|
16
16
|
- `.specdojo/specdojo.config.json` のトップレベル、project、`run`、`repos`、`external_projects` の設定キー
|
|
17
|
+
- `.specdojo/specdojo.local.config.json` で上書きできるキーと優先順位
|
|
17
18
|
|
|
18
19
|
**ここで引けるもの**
|
|
19
20
|
|
|
@@ -99,21 +100,23 @@ exec の result の commit 前検査にも、利用リポジトリに設定が
|
|
|
99
100
|
|
|
100
101
|
`projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
|
|
101
102
|
|
|
102
|
-
| キー | 既定値 | 主な役割
|
|
103
|
-
| ----------------------- | ---------------- |
|
|
104
|
-
| `base_path` | リポジトリルート | project 文書に共通するパス接頭辞
|
|
105
|
-
| `project_register_path` | なし | 個票、event、登録簿の配置先
|
|
106
|
-
| `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先
|
|
107
|
-
| `schedule_path` | `schedule` | strategy、track、Schedule の配置先
|
|
108
|
-
| `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先
|
|
109
|
-
| `timeline_path` | `timeline` |
|
|
110
|
-
| `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml`
|
|
111
|
-
| `roles_path` | なし | role 定義ファイルの配置先
|
|
112
|
-
| `viewpoints_path` | なし | review / grade 観点ファイルの配置先
|
|
113
|
-
| `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先
|
|
114
|
-
| `jobs_path` | なし | `job-*.yaml` の配置先
|
|
115
|
-
|
|
116
|
-
`schedule_path
|
|
103
|
+
| キー | 既定値 | 主な役割 | 必要とする主なコマンド |
|
|
104
|
+
| ----------------------- | ---------------- | -------------------------------------------------- | ------------------------------------------------------------ |
|
|
105
|
+
| `base_path` | リポジトリルート | project 文書に共通するパス接頭辞 | project に紐づく各コマンド |
|
|
106
|
+
| `project_register_path` | なし | 個票、event、登録簿の配置先 | `register *`、`exec plan/run --register` |
|
|
107
|
+
| `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先 | `catalog *`、`deliverable scaffold`、catalog を使う grade 等 |
|
|
108
|
+
| `schedule_path` | `schedule` | strategy、track、Schedule の配置先 | `schedule *`、schedule 対象の `exec *` |
|
|
109
|
+
| `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先 | `exec *`、`grade *`、`job *`、`dashboard build` |
|
|
110
|
+
| `timeline_path` | `timeline` | 非推奨。旧 timeline の互換読み込み・生成物の配置先 | 旧 `timeline *` と範囲解決の互換処理 |
|
|
111
|
+
| `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml` | actor 検証、owner 検証、合成名簿の project 側入力 |
|
|
112
|
+
| `roles_path` | なし | role 定義ファイルの配置先 | `schedule strategy generate`、owner を解決する `exec plan` |
|
|
113
|
+
| `viewpoints_path` | なし | review / grade 観点ファイルの配置先 | `grade *`、review plan、`exec scaffold --project` |
|
|
114
|
+
| `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先 | `routine *`、routine を集約する `dashboard build` |
|
|
115
|
+
| `jobs_path` | なし | `job-*.yaml` の配置先 | `job *`、`exec run --job` |
|
|
116
|
+
|
|
117
|
+
`schedule_path` と `execution_path` は解決時の既定値があります。ただし `schedule` コマンドや一括 `build` の対象判定ではキーの明示が必要なため、catalog から Schedule と exec へ進む構成では省略しないでください。
|
|
118
|
+
|
|
119
|
+
全体計画は `project_register_path` の epic を正本とし、`dashboard build` が `execution_path` 配下の `generated/` へ生成します。`timeline_path` の明示指定と旧 `tml-index.yaml` の読み込みは非推奨の警告を出します。未指定でも互換読み込み先は `timeline/` です。新規構成で `timeline_path` は不要です。移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
|
|
117
120
|
|
|
118
121
|
## 4. projectの非パスキー
|
|
119
122
|
|
|
@@ -330,7 +333,41 @@ exec worktree の中で設定を読む場合(agent が worktree で `specdojo`
|
|
|
330
333
|
|
|
331
334
|
設定の形は `docs/specdojo/schemas/v1/specdojo-config.schema.yaml` でも検証できます。リポジトリ名と project ID の重複と `path` の実在は schema で表せないため、CLI の読み込み時の検証が正本です。
|
|
332
335
|
|
|
333
|
-
## 7.
|
|
336
|
+
## 7. ローカル設定
|
|
337
|
+
|
|
338
|
+
`.specdojo/specdojo.local.config.json` は、git で管理しない環境ごとの設定です。`specdojo.config.json` を読んだ後に読み、許可したキーだけを上書きします。`config init` は `.gitignore` にこのファイルを足します。
|
|
339
|
+
|
|
340
|
+
| 許可するキー | 扱い |
|
|
341
|
+
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
342
|
+
| `version` | `1` 固定です。 |
|
|
343
|
+
| `projects.<project-id>.repos[]`(既存) | 共有の設定と同じ `name` の要素は、`path` だけを差し替えます。`name`・`path` 以外のキーはエラーです。 |
|
|
344
|
+
| `projects.<project-id>.repos[]`(追加) | 共有の設定に無い `name` の要素は、ローカルのリポジトリとして末尾に足します。キーは `repos` のキーと同じです。 |
|
|
345
|
+
|
|
346
|
+
上書きの後の `repos` は、共有の設定と同じ検証を受けます。共有の設定に無い project、許可していないキー、型の誤りは、ローカル設定のファイルとキーを示してエラーにします。ローカルで足したリポジトリも `repos` で宣言したリポジトリとして扱い、`<name>:<path>` の解決、プロダクト worktree の作成、commit の許可範囲の対象になります。
|
|
347
|
+
|
|
348
|
+
```json
|
|
349
|
+
{
|
|
350
|
+
"version": 1,
|
|
351
|
+
"projects": {
|
|
352
|
+
"prj-0001": {
|
|
353
|
+
"repos": [
|
|
354
|
+
{ "name": "app1", "path": "../app1-local" },
|
|
355
|
+
{ "name": "tools", "path": "../tools" }
|
|
356
|
+
]
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
読むファイルは次の順序で決めます。
|
|
363
|
+
|
|
364
|
+
1. 主の作業ツリーでは、そのリポジトリの `.specdojo/specdojo.local.config.json` を読みます。環境変数 `SPECDOJO_LOCAL_CONFIG` は使いません。
|
|
365
|
+
2. linked worktree では、環境変数 `SPECDOJO_LOCAL_CONFIG` があればその絶対パスを読みます。runner は worktree の中の子のプロセス(build・agent)へ主の作業ツリーのファイルのパスを渡します。
|
|
366
|
+
3. linked worktree で環境変数が無ければ、主の作業ツリーのファイルを読みます。worktree の中の同じ名前のファイルは読みません。
|
|
367
|
+
|
|
368
|
+
ローカル設定は worktree へコピーしません。agent の保護対象(`.specdojo/` 配下)に含まれ、executor が書き換えると統合の前に止まります。ローカル由来の値は `config show` と `where exec` に `local` と表示し、`exec run` の executor evidence の `local_config_overrides` に記録します。
|
|
369
|
+
|
|
370
|
+
## 8. catalog・schedule・execへ進む設定例
|
|
334
371
|
|
|
335
372
|
register の最小構成から成果物カタログと Schedule へ進む場合は、対象 project へ必要なキーを追加します。次は Quick Start の代表例です。
|
|
336
373
|
|
|
@@ -342,7 +379,6 @@ agent 実行を使う場合は、この project オブジェクトとは別に
|
|
|
342
379
|
"catalog_path": "010-deliverables-catalog",
|
|
343
380
|
"schedule_path": "schedule",
|
|
344
381
|
"execution_path": "execution",
|
|
345
|
-
"timeline_path": "timeline",
|
|
346
382
|
"members_path": "030-project-management/pm-members.yaml",
|
|
347
383
|
"roles_path": "030-project-management/pm-roles.yaml",
|
|
348
384
|
"viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
|
|
@@ -357,7 +393,7 @@ agent 実行を使う場合は、この project オブジェクトとは別に
|
|
|
357
393
|
|
|
358
394
|
routine / Job を使う段階で、同じ project 設定へ `routines_path` と `jobs_path` を追加します。未使用のキーまで最初から埋める必要はありません。
|
|
359
395
|
|
|
360
|
-
##
|
|
396
|
+
## 9. 設定不足時の確認順序
|
|
361
397
|
|
|
362
398
|
1. エラーに表示されたキーが対象 project にあるか確認します。
|
|
363
399
|
2. `base_path` と対象パスを連結した先が意図した配置か確認します。
|