specdojo 0.7.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 +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- 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/scaffold.js +18 -0
- 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/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 +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -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 +55 -56
- 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 +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -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 +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -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 +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 +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 +43 -9
- 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 +142 -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/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -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 +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- 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 +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- 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 +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 +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/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-uc-recipe.md +36 -24
- 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 +79 -64
- 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-uc-rulebook.md +56 -35
- 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-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- 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-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- 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 +53 -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/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- 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/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cxd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cxd-rulebook
|
|
7
|
+
sample: specdojo:cxd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# C4コンテキスト図 作成レシピ
|
|
11
|
+
|
|
12
|
+
C4 Context Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
利用目的から対象システムの責務を選び、人・外部システムとの境界を説明するための作成手順です。境界の根拠が弱い箇所を見つけ、接続先の数や実装の細かさで全体像を埋めないようにします。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 利用者の課題と期待する成果を入力とし、対象システムが引き受ける責務と外へ委ねる責務を対にして書き出します。
|
|
19
|
+
- 図にする前に、直接の利用者、外部システム、やり取りの目的を短い表へ置きます。内部の分割や詳細な連携構文は下位設計へ渡します。
|
|
20
|
+
- 図と定義表を要素名・関係 ID で対応付け、境界の判断から根拠・未決事項をたどれるようにします。最後に外部依存が使えない場合をたどって、説明の抜けを探します。
|
|
21
|
+
|
|
22
|
+
## 2. 作成前に集める情報
|
|
23
|
+
|
|
24
|
+
| 項目 | 集める情報・問い |
|
|
25
|
+
| ------------ | -------------------------------------------------------------------- |
|
|
26
|
+
| 利用目的 | 誰の何の課題を解き、どの成果を対象システムが支えるか |
|
|
27
|
+
| 対象範囲 | 一つのシステムとして何を引き受け、何を人間・別システムへ委ねるか |
|
|
28
|
+
| 利用者候補 | 直接操作する人と、判断・確認だけに関わる人は誰か |
|
|
29
|
+
| 外部依存候補 | どの情報・処理を外部へ依頼するか。必須か、特定機能を選んだときだけか |
|
|
30
|
+
| 関係の根拠 | 呼び出し元、相手、情報の要点を確認できる許可された文書は何か |
|
|
31
|
+
| 詳細の更新先 | 操作、連携契約、内部構成、技術の詳細をどこへ渡すか |
|
|
32
|
+
| 未確定事項 | 根拠不足の接続経路、失敗時の保持範囲、解消する担当と条件は何か |
|
|
33
|
+
|
|
34
|
+
## 3. 全体の作成手順
|
|
35
|
+
|
|
36
|
+
1. 利用目的と本図の対象外を「概要」へ書き、読む人が何を確認するかを整理します。
|
|
37
|
+
2. 「要素と境界の定義」で中核責務と委譲先を対にします。実装モジュール名を隠しても責務を説明できるか確かめます。
|
|
38
|
+
3. 直接の利用者と外部システムを選び、関係ごとに起点・終点・目的・情報の要点を記入します。利用者全員をプロジェクトの役職へ機械的に置き換えません。
|
|
39
|
+
4. 関係を短いラベルにして「C4コンテキスト図(Mermaid)」へ描きます。利用目的から選んだ対象を中心に、責務の分担を使って人・外部システムを配置します。矢印を利用・依頼の向きに読んでもらい、応答の省略や依存をまとめた表示で解釈が割れる箇所に注記を添えます。
|
|
40
|
+
5. 「技術前提・制約と検証観点」で、まず境界が成立する条件を整理し、次に各条件が崩れたときの確認事項を作ります。関係 ID または対象境界を使い、確認する結果と主確認ロールを対応付けます。
|
|
41
|
+
6. 不確かな論点を「メモ / 将来課題」へ分け、担当・解消条件・引き継ぎ先を添えます。値や構文の詳細はその更新先へ渡します。
|
|
42
|
+
|
|
43
|
+
## 4. 各章の書き方
|
|
44
|
+
|
|
45
|
+
### 4.1. 概要
|
|
46
|
+
|
|
47
|
+
- 誰がどの結果を得るためのシステムですか。
|
|
48
|
+
- 読み手は何を合意し、内部構造や操作の詳細はどこへ委ねますか。
|
|
49
|
+
- 関心を持つ人と直接操作する人を区別できていますか。
|
|
50
|
+
|
|
51
|
+
良い例は「店番担当が現金販売を記録する CLI と、商品・売上管理、印刷の境界を示す」です。「販売を便利にする全体像」では、対象と責務を選べません。
|
|
52
|
+
|
|
53
|
+
### 4.2. C4コンテキスト図(Mermaid)
|
|
54
|
+
|
|
55
|
+
- 図の中心が対象システム一つとして読めますか。
|
|
56
|
+
- 各矢印の向きを、利用・依頼・送信のどれとして説明できますか。
|
|
57
|
+
- 同じ端末にある外部ツールを、対象システムの内部部品として扱っていませんか。
|
|
58
|
+
- 人または外部システムの候補がない場合、利用・運用の接点を見落としていませんか。該当しないと判断した理由を説明できますか。
|
|
59
|
+
|
|
60
|
+
良い例は「CLI → 印刷基盤: 印字依頼・結果取得」です。「CLI → 印刷基盤: 連携」では目的を判断できません。呼び出しが未確認なら、既知の関係に見える線を増やす前に論点を分離します。
|
|
61
|
+
|
|
62
|
+
### 4.3. 要素と境界の定義
|
|
63
|
+
|
|
64
|
+
まず対象システムの責務を整理し、Person、External Software System、Relationship の順に具体化します。図の名称を照合の手掛かりにし、各表では図だけで判断できない責任分界や利用条件を掘り下げます。
|
|
65
|
+
|
|
66
|
+
#### 4.3.1. 対象システムとシステム境界
|
|
67
|
+
|
|
68
|
+
- 対象システムの名前から、概要で選んだ利用目的と範囲を特定できますか。
|
|
69
|
+
- 利用者が期待する結果のうち、対象システムが直接管理するものは何ですか。
|
|
70
|
+
- 自システムで引き受けない責務は、人間と別システムのどちらへ委ねますか。
|
|
71
|
+
|
|
72
|
+
良い例は「CLI はレシート控えを保持し、印刷基盤が物理印字を担う」です。「両方で印刷を管理する」では、失敗時に何を確認するかが曖昧です。
|
|
73
|
+
|
|
74
|
+
#### 4.3.2. Person(人・ロール)
|
|
75
|
+
|
|
76
|
+
- 各候補は、操作・運用・管理のどの接点で対象システムを直接利用しますか。
|
|
77
|
+
- その接点から何を入力し、どの結果を確認して次の判断へ進みますか。
|
|
78
|
+
- 概要で挙げた関係者のうち、直接利用せず設計・承認だけに関わる人は誰ですか。
|
|
79
|
+
|
|
80
|
+
良い例は「店番担当が会計・印字状態を確認し、結果不明の取引を店舗責任者へ渡す」です。「開発体制にいるので全員を利用者とする」では、製品との接点を説明できません。
|
|
81
|
+
|
|
82
|
+
#### 4.3.3. External Software System(外部システム)
|
|
83
|
+
|
|
84
|
+
- 外部へ依頼する処理と、その結果を対象システムが管理する範囲はどこで分かれますか。
|
|
85
|
+
- 相手が必要になるのは常時ですか、特定の機能や利用条件を選んだときですか。
|
|
86
|
+
- 未導入・障害・応答欠落で影響を受ける結果は何ですか。保持されると説明する情報には根拠がありますか。
|
|
87
|
+
|
|
88
|
+
良い例は「印刷基盤は会計確定後に使い、時間切れ時は控えと紙面を確認して印字結果を判断する」です。「外部基盤が落ちたら全機能を停止する」では、依存する範囲を切り分けられません。
|
|
89
|
+
|
|
90
|
+
#### 4.3.4. Relationship(関係・連携契約)
|
|
91
|
+
|
|
92
|
+
- 起点・終点・ラベルを図と照らし、各関係が支える利用目的を説明できますか。
|
|
93
|
+
- 渡す情報・制御の要点と、ローカル実行か外部通信かを確認できる根拠は何ですか。
|
|
94
|
+
- 関係 ID から操作・連携の詳細を更新する文書へたどれますか。未作成なら何の契約を引き継ぎますか。
|
|
95
|
+
|
|
96
|
+
良い例は「`REL-04`: CLI から印刷基盤へ控えを渡して結果を受け取り、引数は外部コマンド連携仕様で管理する」です。「印刷基盤と連携する」だけでは、方向・情報・詳細の更新先を特定できません。
|
|
97
|
+
|
|
98
|
+
### 4.4. 技術前提・制約と検証観点
|
|
99
|
+
|
|
100
|
+
- 「技術前提・制約」では、ローカル実行・外部通信・人間の承認のうち、どの条件が境界を成立させていますか。外部へ渡す情報と認証を管理する主体は誰ですか。
|
|
101
|
+
- 「システム境界・外部依存の検証観点」では、外部依存の失敗時に、誰が何を見れば結果不明と失敗確定を区別できますか。関係 ID または対象境界に結び付けて整理します。
|
|
102
|
+
- これから確かめる検証対象と、契約・実装で確認済みの保証を混ぜていませんか。
|
|
103
|
+
|
|
104
|
+
良い例は「印字が時間切れになった際、会計結果と控えを確認する」です。「障害でも問題なく動く」では期待結果を選べません。再試行や復旧の詳細は連携・運用の契約へ渡します。
|
|
105
|
+
|
|
106
|
+
### 4.5. メモ / 将来課題
|
|
107
|
+
|
|
108
|
+
- 本文の仮定と未決事項のどこに影響しますか。
|
|
109
|
+
- 誰がどの情報を得れば解消できますか。
|
|
110
|
+
- 未作成の詳細文書を既存のようにリンクしていませんか。
|
|
111
|
+
|
|
112
|
+
良い例は「売上応答欠落時の照合は契約未整備。ARC / DEV が受付照会の契約を整え、QE が期待結果を確認する」です。「後で検討する」では作業を引き継げません。
|
|
113
|
+
|
|
114
|
+
## 5. 深掘り手順
|
|
115
|
+
|
|
116
|
+
1. 線を一本選び、利用者が得たい結果へ逆向きにたどります。目的につながらない依存は本図へ入れる必要を見直します。
|
|
117
|
+
2. 相手が使えない場合を置き、失われる結果と保持できる情報を分けます。確認できない保持保証は仮定・論点へ戻します。
|
|
118
|
+
3. 外部ツールを内部に置いた場合、誰が変更・運用するのかを問い直します。同じホスト上という理由だけで境界を決めません。
|
|
119
|
+
4. 複数の外部基盤を一つにまとめた場合、利用条件や障害の影響が異ならないかを比較し、別要素にするか注記します。
|
|
120
|
+
|
|
121
|
+
## 6. 良い例 / 悪い例
|
|
122
|
+
|
|
123
|
+
| 観点 | 良い例 | 悪い例 |
|
|
124
|
+
| ------------ | -------------------------------------------------------- | ------------------------------------------ |
|
|
125
|
+
| 利用者の選択 | 店番担当を直接利用者、店舗責任者を判断主体として説明する | 開発体制の全ロールを無条件に Person にする |
|
|
126
|
+
| 依存の粒度 | ローカル版管理とリモート共有の責務・利用条件を分ける | リモート障害で全操作が停止すると断定する |
|
|
127
|
+
| 確定度 | 根拠がない復旧方式は担当と解消条件を付けて残す | 自動再送・ロールバックを推測で保証する |
|
|
128
|
+
| 詳細への委譲 | 印字依頼の目的を残し、引数は外部コマンド仕様へ渡す | 全オプションと電文を CXD に転載する |
|
|
129
|
+
|
|
130
|
+
## 7. レビュー観点
|
|
131
|
+
|
|
132
|
+
| 観点 | 確認する問い | 主な確認者 |
|
|
133
|
+
| ------------ | ----------------------------------------------------------- | ---------- |
|
|
134
|
+
| 価値と利用者 | 各利用関係が解決する課題と結果を説明できるか | BA |
|
|
135
|
+
| 境界と判断 | 対象範囲と委譲先、人間が判断する範囲を確認できるか | PO / ARC |
|
|
136
|
+
| 外部依存 | 依頼と結果の管理主体、必須・任意、未確定の条件が分かるか | ARC |
|
|
137
|
+
| 検証入力 | 不在・失敗・結果不明のときに確かめる情報を特定できるか | QE |
|
|
138
|
+
| 追跡 | 図の線から関係 ID、責任分界、詳細の更新先と論点をたどれるか | ARC / QE |
|
|
139
|
+
|
|
140
|
+
## 8. 仕上げチェック
|
|
141
|
+
|
|
142
|
+
- 各利用・連携に固有の目的があり、概要の課題と対象範囲へつながっている。
|
|
143
|
+
- 図と定義表の名前・関係ラベルが対応し、表は責任分界や利用条件など図にない判断情報を補っている。
|
|
144
|
+
- 詳細な値・構文・構造を各正本へ委ね、境界判断に必要な要点を残している。
|
|
145
|
+
- 未確認の挙動を保証せず、仮定・未決事項に担当と解消条件がある。
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:ifd-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:ifd-mermaid-rulebook
|
|
7
|
+
sample: specdojo:ifd-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# インフラ構成図 作成レシピ
|
|
11
|
+
|
|
12
|
+
Infrastructure Flow Diagram Writing Recipe
|
|
13
|
+
|
|
14
|
+
上位の責務を実行場所と通信境界へ変換し、境界設計と障害切り分けに使える構成図を作る。配置を描くだけで終わらず、外部へ渡る情報と依存が使えない場合の影響を具体化する。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 上位構成図とプロジェクト文脈から、何を継続して利用・引き継ぎたいか、守る情報は何かを確認する。背景全文を転載せず、配置判断に影響する条件を選ぶ。
|
|
19
|
+
- 「作成前に集める情報」を短いメモにし、「全体の作成手順」で環境・経路・前提を組み立てる。製品名や枠の数から設計を始めない。
|
|
20
|
+
- 「各章の書き方」で境界と通信条件を掘り下げ、最後に情報の受け渡しと障害影響を確かめる。業務判断・公開可否は人間の判断へ渡す。
|
|
21
|
+
- 継続利用の目的を、必要な配置・到達条件と対応付ける。経路 ID で情報・利用条件・検証対象・未決事項を結び、値・構文・設定・復旧操作は担当の詳細文書へ委ねる。
|
|
22
|
+
|
|
23
|
+
## 2. 作成前に集める情報
|
|
24
|
+
|
|
25
|
+
秘密値は収集せず、管理主体と確認先を控える。
|
|
26
|
+
|
|
27
|
+
| 項目 | 集める情報・問い |
|
|
28
|
+
| ------------ | ------------------------------------------------------------------------------------ |
|
|
29
|
+
| 利用目的 | 誰が何の記録・処理を継続し、どの障害を切り分けたいか |
|
|
30
|
+
| 上位の要素 | 処理・データ・外部依存の責務。物理配置の根拠と論理要素を区別する |
|
|
31
|
+
| 実行場所 | ホスト、実行用コンテナ、別端末、外部基盤のどこで動くか。代替配置なら何を置き換えるか |
|
|
32
|
+
| 正本とコピー | 何をどこに保持し、閲覧物・共有物・復元用コピーをどう区別するか |
|
|
33
|
+
| 接続条件 | 誰が起動し、いつ外部接続が必要か。送る情報は何か |
|
|
34
|
+
| 管理・判断 | 接続・保管・公開の管理者と、人間が判断すべき範囲 |
|
|
35
|
+
| 制約と依存 | 通信、費用、担当負荷、接続先不在が利用目的へ与える影響 |
|
|
36
|
+
| 詳細の委譲先 | 技術構成、連携、運用の正本。未作成なら必要な契約と担当 |
|
|
37
|
+
| 確認の根拠 | 配置・接続条件の確認元と未検証の仮定。検証予定と実施済みの証跡を区別できるか |
|
|
38
|
+
|
|
39
|
+
## 3. 全体の作成手順
|
|
40
|
+
|
|
41
|
+
1. 「概要」で対象環境と図で判断することを絞り、上位入力と詳細へ委ねる範囲を示す。
|
|
42
|
+
2. 上位の処理・データを実行場所へ仮置きする。同じホストにあることと、同じ管理主体であることを分けて考える。
|
|
43
|
+
3. 「配置と境界の定義」へ、環境・要素、上位との対応、管理主体、保持情報と到達条件を記入する。上位要素の対象外と理由、代替配置の適用条件を整理し、配置不明のものは仮定として残す。
|
|
44
|
+
4. 「通信経路と情報の境界」で、起点・終点・目的・送受信情報・利用条件を経路 ID へ結ぶ。ローカル操作と外部への持ち出しを分ける。
|
|
45
|
+
5. 「インフラ構成図(Mermaid)」へ、配置と経路を描く。矢印は主たる依頼・参照・転送の向きにし、応答の省略と仮定を注記する。ネットワークの中継を省略する場合も、到達条件が変わる点を本文に残す。
|
|
46
|
+
6. 「技術前提・制約と検証観点」を、前提・制約と、境界・障害の検証対象に分けて整理する。境界が成立する条件から、依存が使えないときの影響・観測対象・主確認ロールを選び、検証予定と実施済みの証跡を区別する。
|
|
47
|
+
7. 「メモ / 将来課題」に、仮定と不足情報の影響、担当、解消条件・引き継ぎ先を集める。未決事項がなければ章を省略する。
|
|
48
|
+
8. 表と図の名前・経路 ID・起点・終点を照合し、詳細設定の転載と、図をなぞるだけの説明を整理する。改訂なら変更した境界・経路から追従先と確認者を洗い出す。
|
|
49
|
+
|
|
50
|
+
## 4. 各章の書き方
|
|
51
|
+
|
|
52
|
+
### 4.1. 概要
|
|
53
|
+
|
|
54
|
+
- この図を使う人は、配置、接続、障害影響のどれを判断しますか。
|
|
55
|
+
- 上位の責務のうち、今回配置するものと対象外は何ですか。
|
|
56
|
+
- 費用や担当負荷を変える前提が、採用済みの事実として紛れ込んでいませんか。
|
|
57
|
+
|
|
58
|
+
良い例は「店頭から記録サービスまでの通信依存を判断する」。避けたい例は「クラウドを使う」で、達成したい利用結果が分かりません。
|
|
59
|
+
|
|
60
|
+
### 4.2. インフラ構成図(Mermaid)
|
|
61
|
+
|
|
62
|
+
- 各枠を越えると、実行場所・到達条件・管理主体の何が変わりますか。
|
|
63
|
+
- 一本の矢印を依頼・参照・転送のいずれとして説明できますか。
|
|
64
|
+
- 中継を省略した線が、実際には許可していない直接接続に見えませんか。
|
|
65
|
+
|
|
66
|
+
良い例は「記録要求の線に、入口の中継を省略した論理経路と注記する」。避けたい例は「入口経由の内部サービスに端末から直接つなぎ、説明しない」で、許可する到達範囲を誤読させます。
|
|
67
|
+
|
|
68
|
+
### 4.3. 配置と境界の定義
|
|
69
|
+
|
|
70
|
+
- 上位要素をどこに配置し、どの役割を複数の工程へ展開しましたか。
|
|
71
|
+
- 正本、閲覧物、共有先、復元用コピーを区別できますか。
|
|
72
|
+
- 枠名だけで認証・隔離が成立したと説明していませんか。
|
|
73
|
+
- 代替配置へ切り替えると何が置き換わり、保持範囲・書込範囲・到達性のどこを確かめ直しますか。
|
|
74
|
+
|
|
75
|
+
良い例は「ホスト実行へ置き換えても処理の責務は維持し、書込範囲は再確認する」。避けたい例は「コンテナとホストに同じ処理を描き、選択条件を示さない」です。表には図にない管理責務や到達条件を足します。
|
|
76
|
+
|
|
77
|
+
### 4.4. 通信経路と情報の境界
|
|
78
|
+
|
|
79
|
+
- 外部へ出る情報と、選択した機能でだけ必要になる経路は何ですか。
|
|
80
|
+
- 相手を変える場合、情報の持ち出し先と承認条件も変わりませんか。
|
|
81
|
+
- 接続方式を確認した根拠はありますか。詳細契約の更新先へたどれますか。
|
|
82
|
+
|
|
83
|
+
良い例は「共有時だけ変更履歴を送り、ローカル保存とは結果を分ける」。避けたい例は「全操作でリモート共有必須」と根拠なく決めることです。
|
|
84
|
+
|
|
85
|
+
### 4.5. 技術前提・制約と検証観点
|
|
86
|
+
|
|
87
|
+
- 外部サービス・通信・保存先を一つずつ使えなくした場合、どの利用結果に影響しますか。
|
|
88
|
+
- 到達、認証、処理結果、保存結果を別々に観測し、許可していない接続元からの到達も確かめられますか。
|
|
89
|
+
- 必要な監視対象を示し、閾値・通知先・回復操作は詳細設計へ渡せていますか。
|
|
90
|
+
- 誰がこれから確かめる条件と、既に確認した証跡を区別できますか。
|
|
91
|
+
|
|
92
|
+
良い例は「到達性、サービス応答、保存結果を QE / OPS が別々に確認する予定」。避けたい例は「トンネル接続済みなので保存も検証済み」です。確認できない保証は論点へ戻します。
|
|
93
|
+
|
|
94
|
+
### 4.6. メモ / 将来課題
|
|
95
|
+
|
|
96
|
+
- 仮定・不足情報がどの経路の判断や検証を止めますか。
|
|
97
|
+
- 誰が何を確認または判断すれば解消できますか。
|
|
98
|
+
- 未作成の正本を実在する仕様として扱っていませんか。
|
|
99
|
+
|
|
100
|
+
良い例は「閲覧範囲を PO が判断後、OPS が配信境界へ反映」。避けたい例は「後日確認」です。
|
|
101
|
+
|
|
102
|
+
## 5. 深掘り手順
|
|
103
|
+
|
|
104
|
+
1. 外部へ出る線を一本選び、その情報を渡さなくても利用目的を満たせるかを問う。不要な持ち出しは減らし、必要なら理由と条件を残す。
|
|
105
|
+
2. 同じ枠の二要素について、管理者、保持情報、到達許可が同じか比べる。異なるなら別境界または明示的な注記にする。
|
|
106
|
+
3. 依存を停止した場面を置き、ローカルの作業結果、相手側の受付、利用者が確認できる結果を分ける。結果不明を未実行と推測しない。
|
|
107
|
+
4. 別配置・別 provider へ切り替える案があれば、置き換える要素を選び、保持範囲、送信範囲、認証、費用、担当負荷の判断を確かめ直す。上位の責務や利用目的との対応が失われる案は見直す。
|
|
108
|
+
|
|
109
|
+
## 6. 良い例 / 悪い例
|
|
110
|
+
|
|
111
|
+
| 観点 | 良い例 | 悪い例 |
|
|
112
|
+
| ------ | ---------------------------------------- | -------------------------------------------- |
|
|
113
|
+
| 境界 | 同じホストでも別管理のサービスを区別する | 同じネットワークにあるので同じ信頼範囲とする |
|
|
114
|
+
| 情報 | 共有時の変更履歴と推論時の文脈を分ける | 外部接続をすべて同期と呼ぶ |
|
|
115
|
+
| 確定度 | 接続経路は仮定とし、到達性の確認者を残す | 製品名から構成済みの認証方式を推測する |
|
|
116
|
+
| 継続性 | サービス停止で失う結果と残る記録を分ける | 外部障害時も問題なく動くと断定する |
|
|
117
|
+
|
|
118
|
+
## 7. レビュー観点
|
|
119
|
+
|
|
120
|
+
| 観点 | 確認する問い | 主な確認者 |
|
|
121
|
+
| -------- | ------------------------------------------------------------------------------------ | ------------------- |
|
|
122
|
+
| 利用目的 | 配置案が守る利用結果と通信・費用・負荷の条件を説明できるか | BA / PO |
|
|
123
|
+
| 配置境界 | 上位要素と実行場所、正本、管理主体が対応するか | ARC |
|
|
124
|
+
| 持ち出し | 情報、送信先、利用条件、人間の判断範囲が明らかか | ARC / PO |
|
|
125
|
+
| 検証入力 | 経路ごとの失敗・結果不明と、観測する情報を識別できるか | QE |
|
|
126
|
+
| 運用入力 | 監視・復旧の設計対象と詳細の更新先を選べるか | OPS |
|
|
127
|
+
| 改訂影響 | 変更した境界・経路から上位構成・連携・検証・運用・公開判断の追従先と確認者を選べるか | ARC / QE / OPS / PO |
|
|
128
|
+
|
|
129
|
+
## 8. 仕上げチェック
|
|
130
|
+
|
|
131
|
+
- 図の要素から、実行場所・管理主体・保持情報へたどれる。
|
|
132
|
+
- 経路 ID から、利用目的・情報・利用条件・検証対象を対応付けられる。
|
|
133
|
+
- 仮定と未決事項に影響・担当・解消条件があり、未確認の隔離や復旧を保証していない。
|
|
134
|
+
- 値・構文・構造の詳細を各正本へ委ね、図をなぞるだけの本文を残していない。
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:ifx-cmd-recipe
|
|
4
4
|
type: recipe
|
|
5
|
-
status:
|
|
5
|
+
status: ready
|
|
6
6
|
rulebook: specdojo:ifx-cmd-rulebook
|
|
7
7
|
sample: specdojo:ifx-cmd-sample
|
|
8
8
|
---
|
|
@@ -11,138 +11,187 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
External Command Interface Specification Writing Recipe
|
|
13
13
|
|
|
14
|
-
外部 CLI
|
|
14
|
+
外部 CLI とのプロセス境界を、実装の二重記述を避けて正本を参照し、入出力の約束(渡すもの・受け取るもの・終了コードの意味・作るファイル・副作用・失敗の扱い)に絞って合意・検証できる契約に仕上げるための作り方を示します。
|
|
15
15
|
|
|
16
16
|
## 1. このレシピの使い方
|
|
17
17
|
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
18
|
+
- ESIL(外部システム I/F 一覧)の連携目的を出発点に、呼び出し元が成功後に得る状態を決める。共通の背景は上位から引き継ぎ、この仕様ではプロセス境界の契約を具体化する。
|
|
19
|
+
- 「作成前に集める情報」を短いメモにし、「全体の作成手順」の順で正本、入出力、終了判定、回復条件を決める。判断が止まった項目だけ「深掘り手順」で調べ直す。
|
|
20
|
+
- 起動方法や設定値は設定・リファレンスへ、値・構文・構造の詳細は `docs/specdojo/schemas/v1/ifx-cmd.schema.yaml` へ委ねる。ここでは呼び出し元が判断するための意味と参照先の選び方を扱う。
|
|
21
|
+
- 最後に ESIL の `spec_ref`、成功後の状態、観測信号、次の動作をたどる。実装が識別できない失敗や保証できない回復は、できることとして書かず、制約と確認先を残す。
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
| ストリーム
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
25
|
+
| 項目 | 集める入力 | 判断に使う問い |
|
|
26
|
+
| -------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
|
|
27
|
+
| 連携目的と範囲 | ESIL の対象行、呼び出し元・連携先、方向、タイミング、`spec_ref` | 成功後に何が残れば目的を満たすか。別契約として分ける操作はあるか |
|
|
28
|
+
| 正本と適用範囲 | 対象操作のリファレンス、起動設定のキー、対応バージョン、共通事項を持つ上位文書 | どの参照先が何を決めるか。複数 provider の差異もそこで解決できるか |
|
|
29
|
+
| 起動方式 | 実行ファイルの解決方法、サブコマンド、シェル利用の根拠、設定の管理境界 | 実際の起動方式は何か。シェルを使うなら展開値の検証先はどこか |
|
|
30
|
+
| ストリーム | stdin の要否と終端、stdout の受領範囲、stderr の用途、形式・文字コード | プロセス終了と業務完了を何で判定するか。進捗と構造化報告は混在するか |
|
|
31
|
+
| ファイル | 入出力のパス解決規則、内容の正本、作成・更新主体 | CLI が変更する成果物と呼び出し元が保存する記録を分けられるか |
|
|
32
|
+
| 終了状態 | 公開された終了コード、追加の検出信号と定義元、判定順、未分類時の扱い | 同じコードの失敗を区別できるか。識別できない原因は何か |
|
|
33
|
+
| 副作用と再実行 | 永続的変更、利用枠消費、重複排除の根拠、失敗後に残る状態 | 再実行してよい条件は何か。保証がなければ何を確認して再開するか |
|
|
34
|
+
| 認証と権限 | 認証方式、注入機構と参照名、必要権限、供給元、ログ保存境界 | 誰が認証状態を管理し、どの段階で何をマスクするか。秘密値自体は収集しない |
|
|
35
|
+
| 制約と回復 | 作業ディレクトリ、時間・並列数・ネットワークの制約、再試行方針 | 上限は固定か設定依存か未決定か。子プロセス・部分出力・既存変更をどう扱うか |
|
|
35
36
|
|
|
36
37
|
## 3. 全体の作成手順
|
|
37
38
|
|
|
38
|
-
1. ESIL
|
|
39
|
-
2.
|
|
40
|
-
3.
|
|
41
|
-
4.
|
|
42
|
-
5.
|
|
43
|
-
6.
|
|
44
|
-
7.
|
|
45
|
-
8.
|
|
46
|
-
9. 最小の成功ケース、入力不正、認証失敗、タイムアウトを想定し、実行側の分岐が一意になるかレビューする。
|
|
39
|
+
1. **連携単位とメタ情報**: ESIL の目的と成功後の状態を 1 文で対応させ、仕様 ID を `spec_ref` からたどれるようにする。目的・権限・出力契約が異なる操作は分け、複数 provider をまとめるなら共通契約の範囲を決める。
|
|
40
|
+
2. **`command`**: 対象操作の正本を選び、`reference` に文書・設定キー・適用範囲を示す。その根拠から実行ファイルの解決方法、起動方式、対応バージョンを記す。provider 一覧や引数表を別に作らない。
|
|
41
|
+
3. **`streams` と `files`**: 渡す内容、受け取る範囲、ファイルの解決規則と作成主体を整理する。成功を観測する信号と、後続処理が採用する内容を区別できたら次へ進む。
|
|
42
|
+
4. **`exit_codes`**: 正常・代表的失敗について、コードと追加信号からカテゴリへの判定順を組み立てる。区別できない原因には汎用失敗としての扱いを残す。
|
|
43
|
+
5. **`side_effects` と `execution.idempotency`**: 成功時と途中失敗時に残る変更・利用枠消費を確認し、重複排除の条件または保証できない理由と再開条件を記す。副作用の記述先は一つにまとめる。
|
|
44
|
+
6. **`authentication`**: 認証方式と渡し方、供給元、ログのマスク境界を整理する。参照名だけで利用対象を特定でき、秘密値を含まないことを確認する。
|
|
45
|
+
7. **`execution` と `error_handling`**: 制約の根拠を特定し、再試行の条件・上限・待機方式と、タイムアウト・出力解析失敗・認証失敗の処置を決める。未決定の制約は現在動作と必要な判断を分けて残す。
|
|
46
|
+
8. **分岐の照合**: 成功、同じコードの異なる失敗、出力欠落、途中失敗後の再実行を順に追う。各ケースの次の動作が一つに決まり、未確定項目の確認先を引き継げる状態で仕上げる。
|
|
47
47
|
|
|
48
|
-
## 4.
|
|
48
|
+
## 4. 各章の書き方
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
YAML の各要素を、以下の判断単位として組み立てる。キーの必須性や型の一覧を作り直さず、呼び出し元が必要とする説明を該当要素へ置く。
|
|
51
|
+
|
|
52
|
+
### 4.1. 連携単位とメタ情報
|
|
53
|
+
|
|
54
|
+
問い:
|
|
55
|
+
|
|
56
|
+
- ESIL のどの連携目的を受け、呼び出し元の何を完了させるか。
|
|
57
|
+
- 複数の操作や provider をまとめても、同じ成功条件で検証できるか。
|
|
58
|
+
- 契約の改版と CLI の対応バージョンを混同していないか。
|
|
59
|
+
|
|
60
|
+
書き方:
|
|
61
|
+
|
|
62
|
+
- タイトルと実行目的を、対象と成功後の状態から書く。上位の背景説明を複製する代わりに、ESIL の対象行と仕様 ID の対応を確認する。
|
|
63
|
+
- `based_on` は確認した直接の根拠から選び、カタログ管理下では依存関係の範囲内か調べる。起動方法の参照は `command.reference` に置き、根拠一覧へ機械的に転記しない。
|
|
64
|
+
|
|
65
|
+
### 4.2. コマンドと正本参照
|
|
66
|
+
|
|
67
|
+
問い:
|
|
68
|
+
|
|
69
|
+
- 起動方法と実行ファイルをどの文書・設定キーから解決するか。
|
|
70
|
+
- provider が増えたとき、目的・実行ファイル・コメントの列挙を直さずに済むか。
|
|
71
|
+
- 実際にシェルを使うか。使う理由、設定の管理者、展開値の検証・制限をどこで確認できるか。
|
|
72
|
+
|
|
73
|
+
書き方:
|
|
74
|
+
|
|
75
|
+
- SpecDojo 自身のコマンドはコマンドリファレンス、AI provider CLI は起動設定と [[specdojo:exec-config-guide|exec 設定ガイド]]、その他の外部 CLI は対象操作の公式資料から正本を選ぶ。
|
|
76
|
+
- `purpose` は成功後の状態に絞る。可変の実行ファイルは、たとえば `providers.<provider>.command_template` の先頭要素から解決する旨を `executable` に書き、provider 一覧は設定の鍵へ委ねる。認証対象の参照名など、別の判断に必要な情報まで削らない。
|
|
77
|
+
- 通常の起動では実行ファイルとサブコマンドを分ける。管理された設定がシェルを必要とする場合は、理由と管理・検証の参照先を示して実態に合わせる。起動テンプレート全文や展開処理は転載しない。
|
|
78
|
+
|
|
79
|
+
### 4.3. ストリーム
|
|
80
|
+
|
|
81
|
+
問い:
|
|
82
|
+
|
|
83
|
+
- stdin は何を渡し、どこで入力終了となるか。使わない場合はどう表すか。
|
|
84
|
+
- stdout 全体が構造化データか、それとも進捗と報告が混在するか。
|
|
85
|
+
- stderr は何に使い、完了判定に使う信号とはどう区別するか。
|
|
86
|
+
|
|
87
|
+
書き方:
|
|
88
|
+
|
|
89
|
+
- 形式を実際のストリーム全体に合わせ、構造化部分だけを採用するなら抽出範囲と役割を書く。報告の詳細構造は正本を参照し、呼び出し元の判断に必要な意味を残す。
|
|
90
|
+
- 終了コードが保証する範囲と、報告内容で確かめる完了条件を分ける。欠落・解析失敗時は「実行制約と失敗処置」につなげる。
|
|
91
|
+
|
|
92
|
+
### 4.4. ファイル
|
|
93
|
+
|
|
94
|
+
問い:
|
|
95
|
+
|
|
96
|
+
- 入力・出力のパスはどのディレクトリを基準に、何から解決するか。
|
|
97
|
+
- 各ファイルを作成・更新するのは CLI か、呼び出し元か、別段階の担当か。
|
|
98
|
+
- 内容の詳細構造を持つ schema・仕様はどこか。
|
|
99
|
+
|
|
100
|
+
書き方:
|
|
101
|
+
|
|
102
|
+
- `files.inputs` / `files.outputs` では、形式・文字コード・用途と可変パスの解決規則を組み合わせ、利用者が対象を特定できるようにする。
|
|
103
|
+
- CLI が編集する成果物と、呼び出し元が保存するログ・報告を分けて説明する。後者を CLI 自身の生成物として数えず、内容のフィールド一覧は正本へ委ねる。
|
|
104
|
+
|
|
105
|
+
### 4.5. 終了状態と識別条件
|
|
51
106
|
|
|
52
107
|
問い:
|
|
53
108
|
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
109
|
+
- 同じ終了コードを返す失敗は、どの追加信号で区別するか。
|
|
110
|
+
- 複数の信号が一致したときの判定順と、どれにも一致しないときの動作は何か。
|
|
111
|
+
- 認証失敗などを個別検出できない場合、誰が何を確認するか。
|
|
57
112
|
|
|
58
113
|
書き方:
|
|
59
114
|
|
|
60
|
-
- `
|
|
61
|
-
-
|
|
62
|
-
- バージョン範囲は、出力契約と終了コードを確認した範囲だけにする。
|
|
115
|
+
- コードと信号を組み合わせて `meaning` を書き、カテゴリと `retryable` を対応させる。利用制限や接続失敗の検出条件は定義元を参照し、パターン一覧を複製しない。
|
|
116
|
+
- 判断材料がない原因は断定しない。自動分類の範囲と手動確認の範囲を分け、exit 0 でも成果物の検証や業務完了には別条件があるか確かめる。
|
|
63
117
|
|
|
64
|
-
### 4.
|
|
118
|
+
### 4.6. 副作用と冪等性
|
|
65
119
|
|
|
66
120
|
問い:
|
|
67
121
|
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
122
|
+
- 成功時と途中失敗時に、外部状態・ローカルファイル・利用枠へ何が残るか。
|
|
123
|
+
- 同一入力の再実行で重複処理を防ぐ根拠はあるか。
|
|
124
|
+
- 保証できない処理を再開する前に、誰がどの状態を確認するか。
|
|
71
125
|
|
|
72
126
|
書き方:
|
|
73
127
|
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
- stdout と stderr は別々に記録し、進捗文言を成功値として解析しない。
|
|
128
|
+
- `side_effects` には変更範囲、利用枠消費、変更してはならない境界をまとめる。別の配置を使う場合も同じ説明を二重に持たない。
|
|
129
|
+
- `execution.idempotency` は保証の有無を先に判断し、保証するなら重複排除条件、しないなら理由と既存変更を引き継ぐ条件を書く。同名ファイルへの書き込みだけを保証の根拠にしない。
|
|
77
130
|
|
|
78
|
-
### 4.
|
|
131
|
+
### 4.7. 認証注入
|
|
79
132
|
|
|
80
133
|
問い:
|
|
81
134
|
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
135
|
+
- 認証の種類とプロセスへの渡し方はそれぞれ何か。既存ログイン状態を使うか。
|
|
136
|
+
- 参照名から対象の環境変数・プロファイルを特定できるか。認証不要ならその判断根拠は何か。
|
|
137
|
+
- 認証値の供給元と、引数・環境変数・stdout・stderr・保存ログの秘匿処理を誰が管理するか。
|
|
85
138
|
|
|
86
139
|
書き方:
|
|
87
140
|
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
- タイムアウト、出力解析失敗、認証失敗は別の処置とし、一律の再試行にしない。
|
|
141
|
+
- `method` と `injection` を実際の認証経路に合わせる。`names` は利用対象を識別するために残し、実行目的などへ同じ対象一覧を複製しない。
|
|
142
|
+
- `secret_source` に管理境界、`log_policy` にマスク対象と実施時点を書く。機構の参照名だけで説明し、秘密値や個人環境の認証パスは例にも使わない。
|
|
91
143
|
|
|
92
|
-
### 4.
|
|
144
|
+
### 4.8. 実行制約と失敗処置
|
|
93
145
|
|
|
94
146
|
問い:
|
|
95
147
|
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
148
|
+
- 作業ディレクトリ、時間、並列実行、ネットワークの制約を何から決めるか。
|
|
149
|
+
- 再試行する失敗、回数の数え方、待機・切替・停止の条件は何か。
|
|
150
|
+
- タイムアウト、出力解析失敗、認証失敗の後に、子プロセス・部分出力・既存変更をどう扱うか。
|
|
99
151
|
|
|
100
152
|
書き方:
|
|
101
153
|
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
154
|
+
- 確認した設定や公開契約から制約を記す。設定依存の値を固定値へ置き換えず、schema で表現できない場合は許容されるプレースホルダと共通ラベルで draft に残し、現在動作・必要な判断・次の確認先を記録する。
|
|
155
|
+
- `retryable` と `retry.on_categories` を突き合わせ、副作用の回復条件を満たす場合だけ再試行につなげる。利用制限では短時間の制限と利用枠枯渇を区別し、細かな待機・切替方針は正本へ委ねる。
|
|
156
|
+
- 三つの失敗処置は、停止する対象、保持・破棄するもの、次の確認者または再開条件から書く。上限や処置が未決定なら、現在の待機動作と決めるべき方針を混同しない。
|
|
105
157
|
|
|
106
158
|
## 5. 深掘り手順
|
|
107
159
|
|
|
108
|
-
1. ESIL
|
|
109
|
-
2.
|
|
110
|
-
3.
|
|
111
|
-
4.
|
|
112
|
-
5.
|
|
113
|
-
6. 呼び出し側が「成功」「再試行」「人の対応待ち」「入力修正」を仕様だけで分岐できるか確認する。
|
|
160
|
+
1. **目的に戻る**: 説明できない制約や処置を一つ選び、それが防ぐ失敗と ESIL の目的への影響を確認する。目的につながらない内部処理の説明は削るか委譲する。
|
|
161
|
+
2. **正本をたどる**: 主張の根拠となる文書・設定キー・適用範囲を確認する。provider の追加や設定変更で複数箇所の修正が要るなら、一覧を正本へ戻し、実行ファイルの解決規則と認証の参照名など独立した判断情報は残す。
|
|
162
|
+
3. **分岐を再現する**: 曖昧なケースについて、入力、コード、追加信号、採用する出力、次の動作を短く並べる。同じ観測結果に複数の動作が残るなら、判定順を補うか自動分類の限界を書く。
|
|
163
|
+
4. **途中状態から追う**: 出力欠落や途中失敗を起点に、子プロセス、ファイル、外部状態、利用枠を確認する。再開に必要な確認・重複防止が説明できるまで、自動再試行の範囲を広げない。
|
|
164
|
+
5. **未確定を切り分ける**: 調査不足は _TODO_:、意思決定待ちは _UNDECIDED_:、仮の前提は _ASSUMPTION_: で分ける。現在動作、根拠、不足する判断、確認先を実行記録へ残し、架空の値で埋めない。
|
|
114
165
|
|
|
115
166
|
## 6. 良い例 / 悪い例
|
|
116
167
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
168
|
+
| 判断単位 | 良い例 | 悪い例 |
|
|
169
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
|
|
170
|
+
| 連携単位とメタ情報 | 発注登録の成功を受付番号の受領とし、在庫照会とは別の仕様 ID へ対応させる | 登録と照会を一つにまとめ、何が終われば成功か区別できない |
|
|
171
|
+
| コマンドと正本 | `executable` は起動設定の先頭要素から解決し、provider 一覧は設定の鍵へ委ねる。`purpose` は成功後の状態を書く | 実行ファイル、目的、コメントに同じ provider 一覧を転載する |
|
|
172
|
+
| シェル利用 | stdin を起動引数へ変換するためのシェル利用と、管理された設定・展開値の検証先を示す | 実際はシェル起動なのに `shell: false` とする、または外部 CLI という理由だけで有効にする |
|
|
173
|
+
| ストリーム | stdout は進捗を含むテキストとし、末尾の構造化報告を抽出して完了状態を確認する | 構造化報告があるだけで stdout 全体を JSON とみなし、exit 0 だけで業務完了とする |
|
|
174
|
+
| ファイル | CLI の編集対象は作業ディレクトリから解決し、runner が保存するログとは作成主体を分ける | 呼び出し元が保存するログも CLI が作るファイルへ含める |
|
|
175
|
+
| 終了状態 | 非ゼロ終了と設定済み検出信号が一致した場合だけ利用制限とし、未一致は汎用失敗として停止する | exit 1 をすべて `transient_failure` にし、識別できない認証失敗まで自動再試行する |
|
|
176
|
+
| 副作用と冪等性 | 非決定的な編集は冪等性を保証せず、差分を保持して確認後に再開する条件を書く | 同じファイルへ書くので再実行も安全だと判断し、利用枠の追加消費を無視する |
|
|
177
|
+
| 認証注入 | ログインプロファイルの参照名と管理境界を残し、保存前のマスク対象を示す | 一覧の重複を削る際に認証対象まで不明にする、または秘密値・個人パスを例示する |
|
|
178
|
+
| 実行制約と回復 | 時間上限が未決定なら現在は終了まで待つ事実と必要な判断を分け、出力異常後の変更保持と確認者を示す | 検査を通すためだけに固定上限を作り、失敗処置を「リトライする」で済ませる |
|
|
127
179
|
|
|
128
180
|
## 7. レビュー観点
|
|
129
181
|
|
|
130
|
-
| 観点
|
|
131
|
-
|
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
182
|
+
| 観点 | 確認方法 |
|
|
183
|
+
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
184
|
+
| 目的と委譲境界 | 成功後の状態を ESIL の目的へたどり、API・ファイル・メッセージの詳細契約を重複して定義していないか確認する |
|
|
185
|
+
| 正本への追跡 | 対象操作と設定キーから起動方法を解決し、provider 追加時に仕様内の一覧を複数更新する必要がないか試す |
|
|
186
|
+
| 受領と生成の境界 | stdin から採用出力までを追い、進捗と報告、プロセス終了と業務完了、CLI の変更と呼び出し元の記録を区別する |
|
|
187
|
+
| 分岐の実現性 | 同じコードの失敗を追加信号と判定順で追い、検出できない原因が手動確認へ進むか確かめる |
|
|
188
|
+
| 回復の成立条件 | 途中失敗後の状態から再実行を追い、重複処理と利用枠消費を考慮した条件が再試行方針に反映されているか確かめる |
|
|
189
|
+
| 認証の管理境界 | 参照名から供給元とマスク実施点を追い、秘密値を収集・転載せずに認証経路を説明できるか確認する |
|
|
190
|
+
| 未確定事項の引き継ぎ | 固定値・設定依存・未決定を区別し、未決定項目から現在動作と次の確認先をたどれるか確認する |
|
|
139
191
|
|
|
140
192
|
## 8. 仕上げチェック
|
|
141
193
|
|
|
142
|
-
-
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
- 認証方式、注入機構、参照名、シークレット管理境界、ログのマスク方針が揃っている。
|
|
147
|
-
- タイムアウト、並列数、ネットワーク要否、冪等性、再試行条件、出力解析失敗時の処置を呼び出し側が実装できる。
|
|
148
|
-
- 認証情報、個人環境のパス、内部クラス名、プロセス起動ライブラリの実装詳細が残っていない。
|
|
194
|
+
- 「全体の作成手順」の分岐照合で曖昧さが解消されている。判断できない項目は現在動作・必要な判断・確認先を記録し、確定済みの記述へ混ぜていない。
|
|
195
|
+
- 「作成前に集める情報」の入力と完成した契約を照合し、根拠のない固定値や、実際の起動方式・生成主体と異なる宣言が残っていない。
|
|
196
|
+
- 本文・コメント・例を通して同じ一覧や説明を探し、判断を失わず正本参照へ置き換えられる重複を除いている。認証の参照名など独立した判断情報は残している。
|
|
197
|
+
- 公開する本文・例・実行記録に秘密値、秘密値入り URL、個人環境の認証パスがなく、内部実装の説明は契約の参照に置き換わっている。
|