specdojo 0.6.0 → 0.8.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 +3 -2
- package/CHANGELOG.md +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- 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 +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -25
- 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/register-resume.js +69 -42
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- 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 +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- 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 +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -32
- 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 +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- 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 +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- 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.js +149 -15
- package/dist/shared/grade-result.js +17 -1
- 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/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -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 +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- 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 +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -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 +471 -74
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +146 -99
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- 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 +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -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 +132 -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/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-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/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -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 +164 -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/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-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- 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 +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -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/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -16,133 +16,174 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
# 概念データフロー図(ユースケース別): _USE_CASE_NAME_
|
|
18
18
|
|
|
19
|
-
_TODO_: 全体概要のケース `_CASE_ID_`
|
|
19
|
+
_TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースまたは系統を一文で示す。
|
|
20
20
|
|
|
21
21
|
## 1. 目的
|
|
22
22
|
|
|
23
|
-
_TODO_:
|
|
24
|
-
|
|
25
|
-
- _ROLE_ は、_TODO_: グループの通過順と責任境界を承認する。
|
|
26
|
-
- _ROLE_ は、_TODO_: 引き渡す情報と条件を後続設計へ利用する。
|
|
27
|
-
- _ROLE_ は、_TODO_: 引き渡しと戻り経路の重複・欠落を確認する。
|
|
23
|
+
_TODO_: その業務が何のためにあるか、どの出来事からどの成果までを成立させるかを 1〜2 文で書く。読み手の承認・設計・確認作業は書かない。
|
|
28
24
|
|
|
29
25
|
## 2. 適用範囲
|
|
30
26
|
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
- 終了条件: _END_CONDITION_。_TODO_: 最後のグループが成果を利用可能と判断できる条件を書く。
|
|
34
|
-
- 横断するプロセスグループ: _PROCESS_GROUP_NAME_ → _PROCESS_GROUP_NAME_。_TODO_: 正常系の通過順で二つ以上を書く。
|
|
35
|
-
- 組織境界: _TODO_: 引き渡し可否、戻し、再開を判断するロールと、対象範囲外の主体を書く。
|
|
36
|
-
- システム境界: _TODO_: 横断条件の判定と情報・物の引き渡しまでを対象とし、画面・保存方式などの実装詳細を対象外とする旨を書く。
|
|
37
|
-
- 対象外: グループ内部の領域・プロセス・主要例外・補助操作は各 `cdfd-_GROUP_`、状態の定義と遷移は STSD を正本とし、本書では再掲しない。
|
|
38
|
-
- 責任分担: _TODO_: 人間と AI Agent の責任分担を定める既存文書への参照を書く。参照先がない場合は、承認と最終判断を人間が担う原則を書く。
|
|
39
|
-
|
|
40
|
-
## 3. プロセス領域
|
|
41
|
-
|
|
42
|
-
ケース `_CASE_ID_` は _GROUP_COUNT_ のプロセスグループを正常系の順序で横断する。グループ名、含む領域、業務目的は全体概要を正本とし、本章では各グループがこのユースケースで担う役割を定める。
|
|
27
|
+
- **対象**: ケース `_CASE_ID_`「_USE_CASE_NAME_」の _START_EVENT_ から _END_EVENT_ まで、_TODO_: 参加単位と必要な組織・システム境界を 1 行で書く。
|
|
28
|
+
- **対象外**: _TODO_: rulebook の「描き方の選択」に従う対象外、補助操作・実装詳細、状態定義・遷移を委ねる STSD を 1 行で示し、共通の責任分担は全体概要を参照する。
|
|
43
29
|
|
|
44
|
-
<!--
|
|
30
|
+
<!-- based_on と本文では、有効な全体概要や後継文書を参照し、deprecated の文書は参照しない。既存文書は project 修飾 doc id の wikilink、未作成文書は ID のインラインコードにする。 -->
|
|
45
31
|
|
|
46
|
-
|
|
32
|
+
## 3. プロセス領域
|
|
47
33
|
|
|
48
|
-
_TODO_:
|
|
34
|
+
_TODO_: ケース `_CASE_ID_` の正常系の順序を示す。名称・領域分割は全体概要、役割は本章の表、受け渡しは図を正本とする。
|
|
49
35
|
|
|
50
|
-
-
|
|
51
|
-
- **主要出力**: _TODO_: 次段または終了側へ渡す情報・物を名詞で列挙する。
|
|
52
|
-
- **データストア**: _TODO_: 引き渡す情報または条件判定に使う「データストア」の名称を列挙する。
|
|
36
|
+
<!-- rulebook の「描き方の選択」に従い、全体概要と同じグループ・区分ごとに節を置く。各節には役割表だけを置き、主要入力・主要出力の箇条書きは置かない。以下はグループ代表ノードの例。領域単位の場合は「含む領域」を「プロセス領域」にし、P-xx 領域名を書く。PDCA は必要な場合だけ独立した列で追加し、グループ・区分の列に入れない。 -->
|
|
53
37
|
|
|
54
|
-
|
|
55
|
-
| ---- | -------------------- | --------------- | ------------------------------ | -------------- |
|
|
56
|
-
| 1 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
|
|
38
|
+
<!-- 複数の系統が共通して通る領域の内部は、全体概要またはその領域の詳細文書の 1 か所だけで描く。ほかの詳細では 1 ノードと受け渡しの線だけにし、内部の正本を役割表の「参照先」に示す。領域のまとまりの場合も全体概要の名称と含む領域 ID を併記する。 -->
|
|
57
39
|
|
|
58
|
-
### 3.
|
|
40
|
+
### 3.1. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
|
|
59
41
|
|
|
60
|
-
|
|
42
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
43
|
+
| ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
|
|
44
|
+
| 1 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
|
|
61
45
|
|
|
62
|
-
|
|
63
|
-
- **主要出力**: _TODO_
|
|
64
|
-
- **データストア**: _TODO_
|
|
46
|
+
### 3.2. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
|
|
65
47
|
|
|
66
|
-
| 順序 |
|
|
67
|
-
| ---- |
|
|
68
|
-
| 2 |
|
|
48
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
49
|
+
| ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
|
|
50
|
+
| 2 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
|
|
69
51
|
|
|
70
52
|
## 4. データストア
|
|
71
53
|
|
|
72
|
-
|
|
54
|
+
全体概要から、このケースで参照・更新する正本だけを同じ名称・区分で示す。
|
|
73
55
|
|
|
74
56
|
### 4.1. マスタ・構成データ
|
|
75
57
|
|
|
76
|
-
| データストア
|
|
77
|
-
|
|
|
78
|
-
|
|
|
58
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
59
|
+
| ------------------- | ----------------------------- | ------------ |
|
|
60
|
+
| _MASTER_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
|
|
79
61
|
|
|
80
62
|
### 4.2. トランザクションデータ
|
|
81
63
|
|
|
82
|
-
| データストア
|
|
83
|
-
|
|
|
84
|
-
|
|
|
64
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
65
|
+
| ------------------------ | ----------------------------- | ------------ |
|
|
66
|
+
| _TRANSACTION_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
|
|
85
67
|
|
|
86
|
-
<!--
|
|
68
|
+
<!-- 該当する行がない区分は節ごと削除する。図のデータストアと対応させ、新しい名称・区分を本書だけへ追加しない。 -->
|
|
87
69
|
|
|
88
70
|
## 5. 概念データフロー
|
|
89
71
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
72
|
+
### 5.1. _BUSINESS_FLOW_TITLE_
|
|
73
|
+
|
|
74
|
+
_TODO_: 図から読み取れる流れや関係を 1 文で書く。題は「起票から完了記録まで」のような業務の言葉にする。
|
|
75
|
+
|
|
76
|
+
<!-- 開始から終了まで上から下へ配置する。イベントは一ノード一出来事の短い文にし、長ければ原文を保って改行する。系統の入口は全体概要の表と同じ文言にし、複数の出来事は分ける。引き渡し条件のイベント・引き渡し ID・Orchestrator は置かない。以下は D2 の例。実際の記法・色は全体概要の凡例に合わせる。 -->
|
|
77
|
+
|
|
78
|
+
<!-- 以下の例は絵文字なし。ノードの絵文字の有無・割り当ては全体概要の凡例に合わせ、正常系・戻りの全図と系統間でそろえる。凡例で付ける方針なら両図の全対象ノードへ反映し、同じ対象には同じ絵文字を使う。 -->
|
|
79
|
+
|
|
80
|
+
```d2
|
|
81
|
+
direction: down
|
|
82
|
+
|
|
83
|
+
classes: {
|
|
84
|
+
process: {
|
|
85
|
+
shape: rectangle
|
|
86
|
+
style: {
|
|
87
|
+
border-radius: 8
|
|
88
|
+
fill: "#e3f2fd"
|
|
89
|
+
stroke: "#1e88e5"
|
|
90
|
+
font-color: "#000000"
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
event: {
|
|
94
|
+
shape: hexagon
|
|
95
|
+
style: {
|
|
96
|
+
fill: "#fff3e0"
|
|
97
|
+
stroke: "#fb8c00"
|
|
98
|
+
font-color: "#000000"
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
store_master: {
|
|
102
|
+
shape: cylinder
|
|
103
|
+
style: {
|
|
104
|
+
fill: "#e8f5e9"
|
|
105
|
+
stroke: "#43a047"
|
|
106
|
+
font-color: "#000000"
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
store_transaction: {
|
|
110
|
+
shape: cylinder
|
|
111
|
+
style: {
|
|
112
|
+
fill: "#c8e6c9"
|
|
113
|
+
stroke: "#2e7d32"
|
|
114
|
+
font-color: "#000000"
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
physical_store: {
|
|
118
|
+
shape: rectangle
|
|
119
|
+
style: {
|
|
120
|
+
border-radius: 20
|
|
121
|
+
fill: "#c8e6c9"
|
|
122
|
+
stroke: "#2e7d32"
|
|
123
|
+
font-color: "#000000"
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
material_flow: {
|
|
127
|
+
style: {
|
|
128
|
+
stroke-width: 3
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
start: "_START_EVENT_" { class: event }
|
|
134
|
+
source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
|
|
135
|
+
target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
|
|
136
|
+
end: "_END_EVENT_" { class: event }
|
|
137
|
+
master_store: "_MASTER_STORE_NAME_" { class: store_master }
|
|
138
|
+
transaction_store: "_TRANSACTION_STORE_NAME_" { class: store_transaction }
|
|
139
|
+
|
|
140
|
+
start -> source: "起動条件"
|
|
141
|
+
master_store -> source: "_REFERENCE_INFORMATION_"
|
|
142
|
+
source -> target: "_TRANSFER_INFORMATION_"
|
|
143
|
+
target -> transaction_store: "_RESULT_INFORMATION_"
|
|
144
|
+
target -> end: "_COMPLETION_INFORMATION_"
|
|
118
145
|
```
|
|
119
146
|
|
|
120
|
-
_TODO_:
|
|
147
|
+
_TODO_: 全体概要の「凡例(本プロダクト共通)」を参照する短い注記と、使用線種・別図や内部の正本へ委ねる範囲・図を分ける場合の共有ノードを書く。
|
|
148
|
+
|
|
149
|
+
<!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class を使う。対象ケースで使わない雛形のノード・線・classes は削除する。rulebook の分割の目安(一図の線が 15 本超、または一ノードの入出力が合計 10 本以上)や読みにくさに応じて連続する業務の段ごとに分割し、必要な線を削らず、同じ名称・領域 ID の共有ノードで接続を追えるようにする。引き渡し ID は作らない。 -->
|
|
121
150
|
|
|
122
|
-
<!--
|
|
151
|
+
<!-- 対象範囲の例外時の戻りを重要度で絞らず、以下の節に漏れなく描く。戻りがない場合だけ節ごと削除する。共通して通る領域の内部は 1 か所の正本へ委ね、領域から外へ返す情報は描く。「引き渡し」「例外時の戻り先」の章や条件表は設けない。 -->
|
|
123
152
|
|
|
124
|
-
|
|
153
|
+
### 5.2. 例外時の戻り
|
|
125
154
|
|
|
126
|
-
|
|
127
|
-
| -------------- | -------------------- | -------------------- | --------------------- | ------------------- | ------------------ |
|
|
128
|
-
| `_HANDOFF_ID_` | _PROCESS_GROUP_NAME_ | _PROCESS_GROUP_NAME_ | _HANDOFF_INFORMATION_ | _HANDOFF_CONDITION_ | _RETURN_CONDITION_ |
|
|
155
|
+
_TODO_: 不足や不一致をどこへ返すか、図から読み取れることを 1 文で書く。
|
|
129
156
|
|
|
130
|
-
|
|
157
|
+
```d2
|
|
158
|
+
direction: down
|
|
131
159
|
|
|
132
|
-
|
|
160
|
+
classes: {
|
|
161
|
+
process: {
|
|
162
|
+
shape: rectangle
|
|
163
|
+
style: {
|
|
164
|
+
border-radius: 8
|
|
165
|
+
fill: "#e3f2fd"
|
|
166
|
+
stroke: "#1e88e5"
|
|
167
|
+
font-color: "#000000"
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
}
|
|
133
171
|
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
172
|
+
source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
|
|
173
|
+
target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
|
|
174
|
+
|
|
175
|
+
source <- target: "_RETURN_INFORMATION_"
|
|
176
|
+
source -> target: "_CORRECTED_INFORMATION_"
|
|
177
|
+
```
|
|
137
178
|
|
|
138
|
-
|
|
179
|
+
_TODO_: 全体概要の凡例を参照し、通常の図やほかの戻りの図と共有する参加単位、別図・内部の正本へ委ねる範囲を短く注記する。
|
|
139
180
|
|
|
140
|
-
<!--
|
|
181
|
+
<!-- 戻りは補完・再判断を担う参加単位へ向け、返す情報と再提示する情報を名詞の線のラベルにする。線が多い場合は rulebook の分割の目安に従い、戻り先や業務の段ごとに本節の図を分け、必要な戻りを削らない。各図に戻す対象が分かる題と説明 1 文を付け、共有ノードで接続を追えるようにする。条件イベントや内部の再試行手順は置かない。 -->
|
|
141
182
|
|
|
142
|
-
|
|
183
|
+
<!-- 未決事項がある場合だけ以下の章を使い、ない場合は章ごと削除する。 -->
|
|
143
184
|
|
|
144
|
-
|
|
145
|
-
| ------------------- | ------------------------ | --------------- | ----------------- |
|
|
146
|
-
| _UNDECIDED_: _TODO_ | `_CASE_ID_` / `_HANDOFF_ID_` | _DECISION_ROLE_ | _DECISION_TIMING_ |
|
|
185
|
+
## 6. 未決事項
|
|
147
186
|
|
|
148
|
-
|
|
187
|
+
| 論点 | 影響するケース・参加単位 | 決定者 | 決定時期 |
|
|
188
|
+
| ------------------- | ------------------------------------------- | --------------- | ----------------- |
|
|
189
|
+
| _UNDECIDED_: _TODO_ | `_CASE_ID_` / _PARTICIPANT_NAME_OR_AREA_ID_ | _DECISION_ROLE_ | _DECISION_TIMING_ |
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cnd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
rulebook: specdojo:cnd-rulebook
|
|
7
|
+
frontmatter_template:
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
rulebook: specdojo:cnd-rulebook
|
|
13
|
+
part_of: []
|
|
14
|
+
based_on: _BASED_ON_
|
|
15
|
+
supersedes: []
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# _DELIVERABLE_NAME_
|
|
19
|
+
|
|
20
|
+
## 1. 概要
|
|
21
|
+
|
|
22
|
+
_TODO_: 対象システム、上位コンテキスト図との対応、分割の目的、対象外を記入する。派生した提供経路を加える場合は範囲の違いを説明する。
|
|
23
|
+
|
|
24
|
+
_TODO_: 実行・配備の前提を示す。仮定は _ASSUMPTION_: とし、影響・確認先を「メモ / 将来課題」へ記入する。
|
|
25
|
+
|
|
26
|
+
_TODO_: 承認対象とする範囲・利用場面、作成担当・確認者・最終判断者の Role code を記入する。
|
|
27
|
+
|
|
28
|
+
## 2. C4コンテナ図(Mermaid)
|
|
29
|
+
|
|
30
|
+
<!-- 要素・関係は対象に応じて増減する。Person・外部システム・ストアが該当しない場合は理由を定義欄へ書く。骨組みの接続自体を確定構成として扱わない。 -->
|
|
31
|
+
|
|
32
|
+
```mermaid
|
|
33
|
+
flowchart LR
|
|
34
|
+
person["👤 _PERSON_NAME_"]
|
|
35
|
+
subgraph boundary["_SYSTEM_NAME_"]
|
|
36
|
+
app1("_CONTAINER_ONE_")
|
|
37
|
+
app2("_CONTAINER_TWO_")
|
|
38
|
+
store[("_STORE_NAME_")]
|
|
39
|
+
end
|
|
40
|
+
external["_EXTERNAL_NAME_"]
|
|
41
|
+
|
|
42
|
+
person -->|"_USE_LABEL_"| app1
|
|
43
|
+
app1 -->|"_INTERNAL_LABEL_"| app2
|
|
44
|
+
app2 -->|"_STORE_LABEL_"| store
|
|
45
|
+
app2 -->|"_EXTERNAL_LABEL_"| external
|
|
46
|
+
|
|
47
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
48
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
49
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
50
|
+
class person person;
|
|
51
|
+
class app1,app2,store system;
|
|
52
|
+
class external external;
|
|
53
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
_TODO_: 矢印の意味、応答の省略、構築時だけ成立する関係、任意依存を説明する。
|
|
57
|
+
|
|
58
|
+
_TODO_: 上位図の利用目的・外部依存について、担当コンテナと経路、描かない経路の対象外理由を記入する。
|
|
59
|
+
|
|
60
|
+
## 3. 要素と境界の定義
|
|
61
|
+
|
|
62
|
+
### 3.1. 対象システムとシステム境界
|
|
63
|
+
|
|
64
|
+
_TODO_: 境界内に含める責務と、境界外へ委ねる処理を対にして記入する。物理配置と責務の境界を区別する。
|
|
65
|
+
|
|
66
|
+
### 3.2. Person(人・ロール)
|
|
67
|
+
|
|
68
|
+
| Person(図中ラベル) | 利用目的・接点 | 判断・確認の責務 |
|
|
69
|
+
| -------------------- | --------------- | ----------------------- |
|
|
70
|
+
| `_PERSON_NAME_` | `_USE_PURPOSE_` | `_USER_RESPONSIBILITY_` |
|
|
71
|
+
|
|
72
|
+
### 3.3. Container(コンテナ)
|
|
73
|
+
|
|
74
|
+
| コンテナ(図中ラベル) | 責務 | 技術区分・実行配備の前提 |
|
|
75
|
+
| ---------------------- | ---------------------- | ------------------------ |
|
|
76
|
+
| `_CONTAINER_ONE_` | `_RESPONSIBILITY_ONE_` | `_EXECUTION_ONE_` |
|
|
77
|
+
| `_CONTAINER_TWO_` | `_RESPONSIBILITY_TWO_` | `_EXECUTION_TWO_` |
|
|
78
|
+
|
|
79
|
+
### 3.4. Data Store(データストア)
|
|
80
|
+
|
|
81
|
+
| ストア(図中ラベル) | 保持する情報・正本 | アクセスと生成物の境界 |
|
|
82
|
+
| -------------------- | ------------------------- | ----------------------------------- |
|
|
83
|
+
| `_STORE_NAME_` | `_PERSISTED_INFORMATION_` | `_READERS_WRITERS_AND_DERIVATIVES_` |
|
|
84
|
+
|
|
85
|
+
### 3.5. External Software System(外部システム)
|
|
86
|
+
|
|
87
|
+
| 外部システム(図中ラベル) | 利用条件・責任分界 | 不在・障害時の影響 |
|
|
88
|
+
| -------------------------- | ------------------------------------------- | ------------------ |
|
|
89
|
+
| `_EXTERNAL_NAME_` | `_DEPENDENCY_CONDITION_AND_RESPONSIBILITY_` | `_FAILURE_IMPACT_` |
|
|
90
|
+
|
|
91
|
+
### 3.6. Relationship(関係・連携契約)
|
|
92
|
+
|
|
93
|
+
<!-- 図の全関係に対応させ、端点・ラベルを一致させる。詳細の正本は実在する文書なら wikilink、未作成なら ID またはファイル名をインラインコードで記入する。構文・値・データ構造は参照先へ委ねる。 -->
|
|
94
|
+
|
|
95
|
+
| 関係 ID | 起点 → 終点 | 図中ラベル | 方式・条件と情報の要点 | 詳細の正本 |
|
|
96
|
+
| -------- | ------------------------------------- | ------------------ | ---------------------------------- | --------------------------- |
|
|
97
|
+
| `REL-01` | `_PERSON_NAME_` → `_CONTAINER_ONE_` | `_USE_LABEL_` | `_USER_CHANNEL_AND_INFORMATION_` | `_USER_SPEC_REFERENCE_` |
|
|
98
|
+
| `REL-02` | `_CONTAINER_ONE_` → `_CONTAINER_TWO_` | `_INTERNAL_LABEL_` | `_INTERNAL_CHANNEL_AND_TIMING_` | `_INTERNAL_SPEC_REFERENCE_` |
|
|
99
|
+
| `REL-03` | `_CONTAINER_TWO_` → `_STORE_NAME_` | `_STORE_LABEL_` | `_STORE_ACCESS_AND_TIMING_` | `_DATA_SPEC_REFERENCE_` |
|
|
100
|
+
| `REL-04` | `_CONTAINER_TWO_` → `_EXTERNAL_NAME_` | `_EXTERNAL_LABEL_` | `_EXTERNAL_CHANNEL_AND_CONDITION_` | `_EXTERNAL_SPEC_REFERENCE_` |
|
|
101
|
+
|
|
102
|
+
## 4. 技術前提・制約と検証観点
|
|
103
|
+
|
|
104
|
+
### 4.1. 技術前提・制約
|
|
105
|
+
|
|
106
|
+
- `_EXECUTION_AND_DEPLOYMENT_PRECONDITION_`
|
|
107
|
+
- `_BUILD_TIME_AND_RUNTIME_BOUNDARY_`
|
|
108
|
+
- `_LOCAL_REMOTE_AND_READ_WRITE_BOUNDARIES_`
|
|
109
|
+
- `_TRUST_AND_APPROVAL_CONSTRAINT_`
|
|
110
|
+
|
|
111
|
+
### 4.2. コンテナ間・外部依存の検証対象
|
|
112
|
+
|
|
113
|
+
<!-- 正常時は下流の結合検証へ渡す全経路に対応させる。保存先・外部依存では不在・失敗・結果不明時の状態も区別する。行は対象ごとに増減し、未確定の期待結果は「メモ / 将来課題」へ引き継ぐ。 -->
|
|
114
|
+
|
|
115
|
+
| 確認区分 | 対象関係・境界 | 観測する結果 | 主確認ロール |
|
|
116
|
+
| ------------ | ---------------------------------- | --------------------------------------- | --------------- |
|
|
117
|
+
| 正常時 | `_RELATIONSHIP_OR_BOUNDARY_` | `_NORMAL_RESULT_` | `_REVIEW_ROLE_` |
|
|
118
|
+
| 不在・失敗時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNAVAILABLE_OR_FAILED_RESULT_` | `_REVIEW_ROLE_` |
|
|
119
|
+
| 結果不明時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNKNOWN_RESULT_AND_RETAINED_RECORDS_` | `_REVIEW_ROLE_` |
|
|
120
|
+
|
|
121
|
+
### 4.3. 検証・承認前の確認
|
|
122
|
+
|
|
123
|
+
<!-- 確認内容・合格条件は rulebook の「検証・承認前の確認」に従う。 -->
|
|
124
|
+
|
|
125
|
+
- 文書検査・描画確認・内容レビューの記録: `_REVIEW_EVIDENCE_REFERENCE_`
|
|
126
|
+
- 未解決指摘と後続作業の制限: `_OPEN_FINDINGS_AND_RESTRICTIONS_`
|
|
127
|
+
- PO の承認・保留・差し戻しの記録: `_APPROVAL_RECORD_REFERENCE_`
|
|
128
|
+
- OPS による承認対象と公開対象の照合記録: `_PUBLICATION_SCOPE_CHECK_REFERENCE_`
|
|
129
|
+
- 改訂・廃止時の窓口と追従先・担当ロール: `_CHANGE_CONTACT_IMPACT_AND_ROLES_`
|
|
130
|
+
|
|
131
|
+
## 5. メモ / 将来課題
|
|
132
|
+
|
|
133
|
+
<!-- 仮定・未確定事項がない場合だけ章ごと削除する。最終列には解消条件、PJR 等の転送先レコード、判断者の Role code と判断期限または判断時点を記入する。 -->
|
|
134
|
+
|
|
135
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
136
|
+
| -------------- | ---------- | -------------- | ---------------------------------------- |
|
|
137
|
+
| `_OPEN_TOPIC_` | `_IMPACT_` | `_OWNER_ROLE_` | `_RESOLUTION_RECORD_DECIDER_AND_TIMING_` |
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cpd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cpd-rulebook
|
|
7
|
+
frontmatter_template:
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
owner: ARC
|
|
13
|
+
rulebook: specdojo:cpd-rulebook
|
|
14
|
+
part_of: []
|
|
15
|
+
based_on: _BASED_ON_
|
|
16
|
+
supersedes: []
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# _DELIVERABLE_NAME_
|
|
20
|
+
|
|
21
|
+
## 1. 概要
|
|
22
|
+
|
|
23
|
+
_TODO_: 上位コンテナ図の参照、対象コンテナ、分割の目的と設計入力としての用途、対象外を記入する。対象者の業務課題・放置時の影響・期待価値・成功基準は、上位の要求・目的の該当箇所を参照する。
|
|
24
|
+
|
|
25
|
+
_TODO_: 設計案と確認済みの実装構成を区別する。未確認の分割は _ASSUMPTION_: とし、影響と確認先を「メモ / 将来課題」に記入する。
|
|
26
|
+
|
|
27
|
+
_TODO_: 作成者、アーキテクチャ・実装・結合・業務の確認者と確認時点、最終合意者となる人間の PO を記入し、役割割当て・合意記録を参照する。公開する相手・媒体・範囲と、OPS の公開前確認の記録・PO の公開判断の参照先を記入する。
|
|
28
|
+
|
|
29
|
+
## 2. C4コンポーネント図(Mermaid)
|
|
30
|
+
|
|
31
|
+
<!-- 要素・関係は対象に合わせて増減する。下図の接続を確定設計として流用しない。ストアや外部システムの内外は上位図の境界に合わせる。 -->
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
flowchart LR
|
|
35
|
+
person["👤 _PERSON_ROLE_"]
|
|
36
|
+
subgraph boundary["_CONTAINER_NAME_"]
|
|
37
|
+
entry("_ENTRY_COMPONENT_")
|
|
38
|
+
domain("_DOMAIN_COMPONENT_")
|
|
39
|
+
adapter("_ADAPTER_COMPONENT_")
|
|
40
|
+
end
|
|
41
|
+
store[("_STORE_NAME_")]
|
|
42
|
+
external["_EXTERNAL_NAME_"]
|
|
43
|
+
|
|
44
|
+
person -->|"REL-01 _USE_LABEL_"| entry
|
|
45
|
+
entry -->|"REL-02 _REQUEST_LABEL_"| domain
|
|
46
|
+
domain -->|"REL-03 _DEPENDENCY_LABEL_"| adapter
|
|
47
|
+
domain -->|"REL-04 _STORE_LABEL_"| store
|
|
48
|
+
adapter -->|"REL-05 _EXTERNAL_LABEL_"| external
|
|
49
|
+
|
|
50
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
51
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
52
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
53
|
+
class person person;
|
|
54
|
+
class entry,domain,adapter system;
|
|
55
|
+
class store,external external;
|
|
56
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
_TODO_: 矢印の意味、応答の扱い、主要経路の選定理由と省略範囲を記入する。
|
|
60
|
+
|
|
61
|
+
## 3. 要素と境界の定義
|
|
62
|
+
|
|
63
|
+
### 3.1. 対象コンテナ境界と利用者
|
|
64
|
+
|
|
65
|
+
_TODO_: 境界に含む責務、境界外に残す別コンテナ・ストア・外部システム、上位図との対応を記入する。
|
|
66
|
+
|
|
67
|
+
| 上位図の Person | 本図の接点と確認する結果 |
|
|
68
|
+
| --------------- | ------------------------ |
|
|
69
|
+
| _PERSON_ROLE_ | _CONTACT_AND_RESULT_ |
|
|
70
|
+
|
|
71
|
+
<!-- Person が非該当なら表を削除し、その理由を書く。 -->
|
|
72
|
+
|
|
73
|
+
### 3.2. コンポーネントと論理配置
|
|
74
|
+
|
|
75
|
+
| コンポーネント | 固有の責務 | 主な入力 → 出力 | 論理配置・境界 |
|
|
76
|
+
| ---------------- | ---------------- | ------------------ | ------------------- |
|
|
77
|
+
| _COMPONENT_NAME_ | _RESPONSIBILITY_ | _INPUT_ → _OUTPUT_ | _LOGICAL_PLACEMENT_ |
|
|
78
|
+
|
|
79
|
+
_TODO_: 主要な分割・共通化・依存の採用理由を、上位の業務目的または技術制約に対応付けて記入する。実装配置への対応を示す場合は確認根拠を記入し、未確認の対応は「メモ / 将来課題」へ残す。
|
|
80
|
+
|
|
81
|
+
### 3.3. ストアと外部依存
|
|
82
|
+
|
|
83
|
+
| 要素・区分 | 保持内容または委ねる責務 | 利用条件・失敗の影響 |
|
|
84
|
+
| ----------------------- | ---------------------------- | ------------------------------ |
|
|
85
|
+
| _ELEMENT_NAME_AND_KIND_ | _CONTENTS_OR_RESPONSIBILITY_ | _CONDITION_AND_FAILURE_IMPACT_ |
|
|
86
|
+
|
|
87
|
+
<!-- ストア・外部依存のいずれかが非該当なら、その理由を書く。 -->
|
|
88
|
+
|
|
89
|
+
### 3.4. 関係と詳細の正本
|
|
90
|
+
|
|
91
|
+
| 関係 ID | 起点 → 終点 | 授受情報・条件 | 詳細の正本 |
|
|
92
|
+
| -------- | ---------------------------------------- | -------------------------------------- | ------------------------ |
|
|
93
|
+
| `REL-01` | _PERSON_ROLE_ → _ENTRY_COMPONENT_ | _USE_INFORMATION_AND_CONDITION_ | _USE_DETAIL_SOURCE_ |
|
|
94
|
+
| `REL-02` | _ENTRY_COMPONENT_ → _DOMAIN_COMPONENT_ | _REQUEST_INFORMATION_AND_CONDITION_ | _REQUEST_DETAIL_SOURCE_ |
|
|
95
|
+
| `REL-03` | _DOMAIN_COMPONENT_ → _ADAPTER_COMPONENT_ | _DEPENDENCY_INFORMATION_AND_CONDITION_ | _ADAPTER_DETAIL_SOURCE_ |
|
|
96
|
+
| `REL-04` | _DOMAIN_COMPONENT_ → _STORE_NAME_ | _STORE_INFORMATION_AND_CONDITION_ | _STORE_DETAIL_SOURCE_ |
|
|
97
|
+
| `REL-05` | _ADAPTER_COMPONENT_ → _EXTERNAL_NAME_ | _EXTERNAL_INFORMATION_AND_CONDITION_ | _EXTERNAL_DETAIL_SOURCE_ |
|
|
98
|
+
|
|
99
|
+
<!-- 図に合わせて行を増減し、全関係の ID・端点を対応付ける。値・構文・構造は詳細の正本へ委ね、既存なら文書 ID のリンク、未作成ならバッククォートの仮参照とする。 -->
|
|
100
|
+
|
|
101
|
+
## 4. 技術前提・制約と検証観点
|
|
102
|
+
|
|
103
|
+
### 4.1. 技術前提・制約
|
|
104
|
+
|
|
105
|
+
- _DEPENDENCY_CONSTRAINT_
|
|
106
|
+
- _PERSISTENCE_AND_DERIVED_DATA_BOUNDARY_
|
|
107
|
+
- _EXTERNAL_CALL_CONSTRAINT_
|
|
108
|
+
|
|
109
|
+
_TODO_: 保守・問い合わせ窓口と、変更時の影響確認記録を参照する。変更記録には影響する要素・関係 ID、後続成果物・実装・検証・Schedule の更新要否と理由・担当を残す。
|
|
110
|
+
|
|
111
|
+
### 4.2. コンポーネント間の検証対象
|
|
112
|
+
|
|
113
|
+
<!-- 通常時と失敗・応答欠落時の条件、合否を判断できる観測結果を関係 ID に対応付ける。実施結果は実行記録へ残す。 -->
|
|
114
|
+
|
|
115
|
+
| 対象関係 | 条件 | 観測する結果 |
|
|
116
|
+
| --------------- | ---------------------------- | ------------------- |
|
|
117
|
+
| `_RELATION_ID_` | _INPUT_OR_FAILURE_CONDITION_ | _OBSERVABLE_RESULT_ |
|
|
118
|
+
|
|
119
|
+
_TODO_: 文書検査・描画確認の証跡を参照する。
|
|
120
|
+
|
|
121
|
+
## 5. メモ / 将来課題
|
|
122
|
+
|
|
123
|
+
<!-- 仮定・未確認事項がない場合は章を省略する。論点は共通ラベルで確定事項と区別し、図・関係・制約の該当箇所と対応付ける。 -->
|
|
124
|
+
|
|
125
|
+
| 対象・区分 | 影響と後続成果物 | 担当 Role code・判断者 | 期限または判断タイミング | 次アクション・解消条件 | 承認への影響・引き継ぎ先 |
|
|
126
|
+
| -------------------- | ---------------------------- | ------------------------------- | ------------------------ | ---------------------------- | --------------------------------- |
|
|
127
|
+
| _TOPIC_AND_CATEGORY_ | _IMPACT_AND_DOWNSTREAM_DOCS_ | _OWNER_ROLE_AND_DECISION_MAKER_ | _DECISION_TIMING_ | _NEXT_ACTION_AND_RESOLUTION_ | _APPROVAL_IMPACT_AND_DESTINATION_ |
|
|
128
|
+
|
|
129
|
+
_TODO_: ARC から PM・人間の PO への報告先、継続追跡する論点の PJR 参照を記入する。未起票なら登録候補の理由・起票担当・判断時点を残し、後続作業の着手可否と Schedule の順序・期限への影響を対応付ける。
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cxd-template
|
|
4
|
+
type: template
|
|
5
|
+
status: ready
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
specdojo:
|
|
8
|
+
id: _LOCAL_ID_
|
|
9
|
+
type: architecture
|
|
10
|
+
status: draft
|
|
11
|
+
rulebook: specdojo:cxd-rulebook
|
|
12
|
+
part_of: []
|
|
13
|
+
based_on: _BASED_ON_
|
|
14
|
+
supersedes: []
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# _DELIVERABLE_NAME_
|
|
18
|
+
|
|
19
|
+
## 1. 概要
|
|
20
|
+
|
|
21
|
+
_TODO_: 対象システムの目的、提供価値、図の対象範囲を 1〜3 文で記入する。
|
|
22
|
+
|
|
23
|
+
| 対象者 | 課題・関心事 | 本図で確認する内容 |
|
|
24
|
+
| ------------- | ------------ | ------------------ |
|
|
25
|
+
| _STAKEHOLDER_ | _CONCERN_ | _CONFIRMATION_ |
|
|
26
|
+
|
|
27
|
+
_TODO_: 本図の対象外と、内部構成・操作・連携の詳細を委ねる先を示す。
|
|
28
|
+
|
|
29
|
+
## 2. C4コンテキスト図(Mermaid)
|
|
30
|
+
|
|
31
|
+
<!-- Person・外部システムと関係は対象に応じて増減し、表と対応させる。該当する主体がない場合は理由を本文に記入する。 -->
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
flowchart LR
|
|
35
|
+
person["👤 _PERSON_NAME_"]
|
|
36
|
+
subgraph boundary["対象システム"]
|
|
37
|
+
target("_SYSTEM_NAME_")
|
|
38
|
+
end
|
|
39
|
+
external["_EXTERNAL_SYSTEM_NAME_"]
|
|
40
|
+
|
|
41
|
+
person -->|"_USE_LABEL_"| target
|
|
42
|
+
target -->|"_DEPENDENCY_LABEL_"| external
|
|
43
|
+
|
|
44
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
45
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
46
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
47
|
+
class person person;
|
|
48
|
+
class target system;
|
|
49
|
+
class external external;
|
|
50
|
+
style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
_TODO_: 矢印の向き、応答の省略など読み取りに必要な注記を 1〜3 文で記入する。
|
|
54
|
+
|
|
55
|
+
## 3. 要素と境界の定義
|
|
56
|
+
|
|
57
|
+
### 3.1. 対象システムとシステム境界
|
|
58
|
+
|
|
59
|
+
| 項目 | 内容 |
|
|
60
|
+
| ------------------------------------ | --------------------------- |
|
|
61
|
+
| システム名 | _SYSTEM_NAME_ |
|
|
62
|
+
| 提供する中核責務 | _CORE_RESPONSIBILITY_ |
|
|
63
|
+
| 境界内に含める範囲 | _IN_SCOPE_ |
|
|
64
|
+
| 境界外へ委ねる範囲(対象外と委譲先) | _OUT_OF_SCOPE_AND_DELEGATE_ |
|
|
65
|
+
|
|
66
|
+
### 3.2. Person(人・ロール)
|
|
67
|
+
|
|
68
|
+
| Person(図中ラベル) | 対応ロール | 利用目的・主な関わり | 境界上の接点・確認責務 |
|
|
69
|
+
| -------------------- | -------------------- | -------------------- | ---------------------- |
|
|
70
|
+
| _PERSON_NAME_ | _ROLE_OR_USER_GROUP_ | _USE_PURPOSE_ | _USER_RESPONSIBILITY_ |
|
|
71
|
+
|
|
72
|
+
### 3.3. External Software System(外部システム)
|
|
73
|
+
|
|
74
|
+
| 外部システム(図中ラベル) | 区分・位置づけ | 対象システムとの責任分界 | 不在・障害時の影響と扱い |
|
|
75
|
+
| -------------------------- | ---------------------- | ------------------------- | ------------------------ |
|
|
76
|
+
| _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_CONDITION_ | _RESPONSIBILITY_BOUNDARY_ | _FAILURE_IMPACT_ |
|
|
77
|
+
|
|
78
|
+
### 3.4. Relationship(関係・連携契約)
|
|
79
|
+
|
|
80
|
+
| 関係ID | 起点 → 終点 | 図中ラベル | やり取りする情報・制御の要点 | 連携方式・境界 | 正本・関連仕様 |
|
|
81
|
+
| -------- | -------------------------------------- | ------------------ | ---------------------------- | --------------------- | -------------------------- |
|
|
82
|
+
| `REL-01` | _PERSON_NAME_ → _SYSTEM_NAME_ | _USE_LABEL_ | _USER_INPUT_OUTPUT_ | _USER_CHANNEL_ | _USER_SPEC_REFERENCE_ |
|
|
83
|
+
| `REL-02` | _SYSTEM_NAME_ → _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_LABEL_ | _EXTERNAL_INPUT_OUTPUT_ | _INTEGRATION_CHANNEL_ | _INTERFACE_SPEC_REFERENCE_ |
|
|
84
|
+
|
|
85
|
+
## 4. 技術前提・制約と検証観点
|
|
86
|
+
|
|
87
|
+
### 4.1. 技術前提・制約
|
|
88
|
+
|
|
89
|
+
- _EXECUTION_OR_COMMUNICATION_CONSTRAINT_
|
|
90
|
+
- _TRUST_OR_APPROVAL_CONSTRAINT_
|
|
91
|
+
- _EXTERNAL_DEPENDENCY_PRECONDITION_
|
|
92
|
+
|
|
93
|
+
### 4.2. システム境界・外部依存の検証観点
|
|
94
|
+
|
|
95
|
+
| 確認区分 | 対象関係・境界 | 検証観点 | 主確認ロール |
|
|
96
|
+
| ---------------- | -------------------------- | ------------------ | ------------- |
|
|
97
|
+
| _CHECK_CATEGORY_ | _RELATIONSHIP_OR_BOUNDARY_ | _OBSERVABLE_CHECK_ | _REVIEW_ROLE_ |
|
|
98
|
+
|
|
99
|
+
## 5. メモ / 将来課題
|
|
100
|
+
|
|
101
|
+
<!-- 未作成の参照先・未確定の境界・将来課題がなければ、この章を削除する。 -->
|
|
102
|
+
|
|
103
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
104
|
+
| ------------ | -------- | ------------ | ---------------------------- |
|
|
105
|
+
| _OPEN_TOPIC_ | _IMPACT_ | _OWNER_ROLE_ | _RESOLUTION_AND_DESTINATION_ |
|