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,130 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:ifx-index-recipe
|
|
4
|
+
type: recipe
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:ifx-index-rulebook
|
|
7
|
+
sample: specdojo:ifx-index-sample
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 外部システムI/F一覧 作成レシピ
|
|
11
|
+
|
|
12
|
+
External System Interface List Writing Recipe
|
|
13
|
+
|
|
14
|
+
外部連携の抜けと過剰な詳細化を避け、設計・実装・結合テストの担当が同じ連携対象を特定できる一覧へまとめるための手順を示す。
|
|
15
|
+
|
|
16
|
+
## 1. このレシピの使い方
|
|
17
|
+
|
|
18
|
+
- 上位の目的と対象範囲から、連携後に必要な結果を選ぶ。サービス名や採用ツールの列挙から始めない。
|
|
19
|
+
- 境界の両端と受け渡しを整理し、連携目的・方向・方式・発生条件を YAML の各要素へまとめる。接続・認証・回復の詳細は契約へ渡す。
|
|
20
|
+
- 連携名と `spec_ref` から後続の設計・結合テストへ追跡する。未整備の契約は、確認者・判断時点・保留する作業を整理して計画へつなぎ、人間の PO へ採否・公開の判断材料を渡す。
|
|
21
|
+
|
|
22
|
+
## 2. 作成前に集める情報
|
|
23
|
+
|
|
24
|
+
| 入力 | 集める内容 | 判断する問い |
|
|
25
|
+
| ---------- | ----------------------------------------------------------- | ------------------------------------------------ |
|
|
26
|
+
| 目的と範囲 | 対象業務・利用場面、連携が必要な結果、対象外 | 連携しなければ何が未完了になるか |
|
|
27
|
+
| 境界と両端 | 自システム、外部サービス、CLI、受け渡すデータ | どこまでが自分たちの管理責任か |
|
|
28
|
+
| 発生条件 | 人の操作、イベント、周期、前提状態 | 誰が何を確認した後に連携するか |
|
|
29
|
+
| 正本の所在 | 詳細契約、設定、構文・データ構造の参照先 | 実在して対象操作へ対応しているか |
|
|
30
|
+
| 失敗の影響 | 未完了・結果不明、外部変更、回復担当 | 再実行の前に何を照合する必要があるか |
|
|
31
|
+
| 確認と合意 | 一覧の管理担当、承認・公開判断者、IF ごとの確認者と外部窓口 | 誰に何を確認すると採否や公開範囲を判断できるか |
|
|
32
|
+
| 未完了作業 | 未決論点、担当 Role、判断時点、依存作業、Schedule・管理記録 | 何が決まらないとどの作業が進まず、誰へ報告するか |
|
|
33
|
+
|
|
34
|
+
秘密値や個人環境の認証ファイルは収集しない。認証設計に必要な管理主体と方式の確認先だけを控える。
|
|
35
|
+
|
|
36
|
+
## 3. 全体の作成手順
|
|
37
|
+
|
|
38
|
+
1. **対象範囲とメタ情報**: 対象システムと主要な対象外、管理担当と承認・公開判断者を冒頭コメントへ整理し、一覧を識別するタイトルと ID を決める。公開先と未合意の範囲を確認し、上位の背景は参照で引き継ぐ。
|
|
39
|
+
2. **連携単位**: 一つの利用場面を選び、境界を越える要求・データ・結果を追う。成功後の状態や失敗の影響を比べて分割を検討し、`interfaces` の各要素を結果が伝わる `name` で識別する。
|
|
40
|
+
3. **両端と方式**: `source` と `target` を固定してから `direction` を読む。自システムが API を直接呼ぶか、CLI やファイルを介するかを確かめ、`kind`・`format` と形式の内訳を記す。値域・構文は `docs/specdojo/schemas/v1/ifx-index.schema.yaml` を参照する。
|
|
41
|
+
4. **発生条件**: `timing` に起動イベントと前提状態を組み合わせる。「随時」を、利用者が判別できる条件へ置き換える。
|
|
42
|
+
5. **異常と参照**: `error_handling` に未完了・結果不明時の判断を残し、実在する詳細仕様と対象操作を照合して `spec_ref` へ接続する。未整備なら、解消する論点と影響する連携をコメントへ整理する。
|
|
43
|
+
6. **合意と計画**: IF ごとの確認者と合意対象、残作業と判断時点を整理する。連携名から Schedule の作業や PJR・決定記録へたどれるようにし、未登録なら PM への登録依頼と登録する時点をコメントへ残す。
|
|
44
|
+
7. **検証と引き継ぎ**: 一覧の schema・整形検査を実行した後、連携名から目的、契約、失敗時の確認先、保留範囲をたどる。検証結果と未解消事項を設計・実装・テスト担当へ渡し、採否・公開は人間の PO の判断へつなぐ。
|
|
45
|
+
|
|
46
|
+
## 4. 各章の書き方
|
|
47
|
+
|
|
48
|
+
YAML の記入領域ごとに、次の問いを使う。
|
|
49
|
+
|
|
50
|
+
### 4.1. メタ情報と対象範囲
|
|
51
|
+
|
|
52
|
+
- 何のシステム・利用場面の一覧か。将来案と現在の対象を区別できるか。
|
|
53
|
+
- 一覧を維持する Role は誰か。人間の PO はどの範囲の承認・保留・公開可否を判断するか。文書の成熟度と個々の連携の合意を混同していないか。
|
|
54
|
+
- 良い例は「店舗から本部への販売連携。仕入先連携は対象外」。避けたい例は「全外部システム」。範囲が読み取れる具体名を使う。
|
|
55
|
+
|
|
56
|
+
### 4.2. 連携単位と両端
|
|
57
|
+
|
|
58
|
+
- 相手が同じでも、照会と更新で完了条件・失敗影響は異ならないか。
|
|
59
|
+
- その行からどのデータ・結果を受け渡すか説明できるか。
|
|
60
|
+
- 良い例は「商品照会」と「売上登録」を分ける。避けたい例は「本部連携」一行に全操作を詰める。製品名より結果を手掛かりに分ける。
|
|
61
|
+
|
|
62
|
+
### 4.3. 方向・方式・形式
|
|
63
|
+
|
|
64
|
+
- `source` と `target` に対して、どちらへ何が流れるか。要求と応答を同じ契約で扱うか。
|
|
65
|
+
- 呼び出し境界は API、外部プロセス、ファイルのどれか。形式はストリーム全体を表すか。
|
|
66
|
+
- 良い例は「印刷 CLI の入力テキストと結果 JSON をコメントで区別」。避けたい例は「結果の一部だけを見て全体を JSON とする」。
|
|
67
|
+
|
|
68
|
+
### 4.4. 発生条件
|
|
69
|
+
|
|
70
|
+
- 人の操作またはイベントのどの時点か。起動してはいけない前提不足は何か。
|
|
71
|
+
- 再実行と初回実行で条件が変わるか。
|
|
72
|
+
- 良い例は「会計確定と控え保存の後に印字」。避けたい例は「適宜印字」。具体的な固定時刻を推測して埋めない。
|
|
73
|
+
|
|
74
|
+
### 4.5. 異常時の判断
|
|
75
|
+
|
|
76
|
+
- 応答がないとき、未処理か結果不明か。副作用を誰が照合するか。
|
|
77
|
+
- その間に止める操作と維持する結果は何か。確認担当が何を照合できれば再開判断へ進めるか。
|
|
78
|
+
- 良い例は「受付結果不明なら記録を保持し担当が照合」。避けたい例は「失敗なら即再送」。数値や引数表を増やさず、回復条件の正本を選ぶ。
|
|
79
|
+
|
|
80
|
+
### 4.6. 詳細参照と未決事項
|
|
81
|
+
|
|
82
|
+
- 詳細契約は実在し、この操作の成功・結果不明時の判断へ対応するか。参照先があっても残る未決事項は何か。
|
|
83
|
+
- 未整備なら、誰が何を確認・決定すれば接続できるか。解消条件と期限または判断するマイルストーンは何か。決まるまでどの業務・後続作業・公開範囲を保留するか。
|
|
84
|
+
- コメントを書く際は、作成・確認待ちを `_TODO_:`、意思決定待ちを `_UNDECIDED_:`、仮定を `_ASSUMPTION_:` で整理する。良い例は「`spec_ref: TBD` とし、ARC が DEV と結果照合方式を決め、外部結合テスト着手前に QE が期待結果を確認するまで当該連携の受入を保留」。避けたい例は「契約は後で作る」。論点から解消後の次アクションまでをつなぐ。
|
|
85
|
+
|
|
86
|
+
### 4.7. 合意・計画・課題への引き継ぎ
|
|
87
|
+
|
|
88
|
+
- BA に利用場面・業務影響、ARC・DEV に契約、QE に期待結果の何を確認してもらうか。外部側の確認が必要なら窓口は誰か。未特定なら誰がいつ特定するか。
|
|
89
|
+
- 詳細仕様の未着手・作成中・確認待ちのどこで止まっているか。担当 Role、完了条件、判断時点、依存作業は計画のどこから確認できるか。
|
|
90
|
+
- 未決論点や方式変更は、どの連携・後続仕様・Schedule に影響するか。PM へどの作業・課題の登録をいつ依頼し、PO へ何の判断と保留範囲を報告するか。
|
|
91
|
+
- 良い例は「売上登録の認証未合意を、PM が結合テスト計画確定前に PJR へ登録し、着手条件と PO の判断を追跡する」。避けたい例は「関係者確認済み」。合意対象と残作業をコメントから管理記録へ結び、登録後は実在する作業・レコードへの参照へ付け替える。
|
|
92
|
+
|
|
93
|
+
### 4.8. 検証と引き渡し
|
|
94
|
+
|
|
95
|
+
- 対象 YAML に schema・整形検査を実行し、対象ファイル、コマンド、結果を記録したか。失敗箇所を直した後の再実行まで追えるか。
|
|
96
|
+
- 検査では分からないコメントの内容や参照先を、読み手は連携名から確認できるか。目的・両端・方向・詳細契約を一つの利用場面として説明してもらう。
|
|
97
|
+
- 良い例は「検査成功と、売上登録の合意待ちによる受入保留を分けて引き継ぐ」。避けたい例は「schema が通ったので公開する」。未解消事項には担当と次アクションを添えて判断者へ渡す。
|
|
98
|
+
|
|
99
|
+
## 5. 深掘り手順
|
|
100
|
+
|
|
101
|
+
1. 一つの利用場面について、連携がなくても同じ結果を得られるかを問う。必要性を説明できなければ範囲の判断へ戻す。
|
|
102
|
+
2. 正常応答と応答欠落を追い、同じ行の中で異なる回復担当・完了条件が現れたら契約の分割を検討する。
|
|
103
|
+
3. 未決事項から影響する後続作業を逆にたどる。判断者・確認窓口が不明なら特定する作業へ、期限が決められないなら依存するマイルストーンの確認へ分解する。
|
|
104
|
+
4. 方式変更や連携の追加・廃止を一件仮に当てはめる。旧名との対応、詳細契約、DEV の実装対象、QE の結合テスト対象を追い、対象範囲が変わるなら PO へ何を確認するか整理する。
|
|
105
|
+
|
|
106
|
+
## 6. 良い例 / 悪い例
|
|
107
|
+
|
|
108
|
+
| 観点 | 良い例 | 悪い例 |
|
|
109
|
+
| ------------ | ------------------------------------------------------------ | ---------------------------------------- |
|
|
110
|
+
| 仮定と合意 | CLI 経由案は仮定とし、採否・公開条件を PO に確認する | 技術案の採用で外部公開も承認済みとする |
|
|
111
|
+
| 未決の出口 | 認証方式の決定後、DEV が契約を作成し QE が着手条件を確認する | 認証は後で決める |
|
|
112
|
+
| 変更の追跡 | 連携の分割元と影響する契約・テスト対象を対応づける | 改称後の一覧だけを渡し、旧契約を放置する |
|
|
113
|
+
| 管理への接続 | 連携コメントから Schedule の作業と残論点をたどれる | 一覧に期日・進捗表をコピーして別管理する |
|
|
114
|
+
|
|
115
|
+
## 7. レビュー観点
|
|
116
|
+
|
|
117
|
+
| 観点 | 確認する内容 |
|
|
118
|
+
| -------------- | ---------------------------------------------------------------------------------------- |
|
|
119
|
+
| 必要性と範囲 | 各連携が対象の目的へ結び付き、将来案と対象外を識別できるか |
|
|
120
|
+
| 境界の一貫性 | 両端、方向、方式、形式が同じ受け渡しを表すか |
|
|
121
|
+
| 下流への接続 | 連携名から契約と失敗時の確認先へ到達し、変更後の実装・結合テスト対象を選べるか |
|
|
122
|
+
| 合意と判断 | IF ごとの確認者・合意対象と、人間の PO に残る採否・公開判断の範囲を説明できるか |
|
|
123
|
+
| 委譲と未決事項 | 詳細を重複管理せず、論点から担当・解消条件・判断時点・保留する作業へたどれるか |
|
|
124
|
+
| 計画と管理 | 残作業やリスクが Schedule・PJR・決定記録へつながり、未登録なら PM への依頼時点が分かるか |
|
|
125
|
+
|
|
126
|
+
## 8. 仕上げチェック
|
|
127
|
+
|
|
128
|
+
- 作成前に集めた利用場面と一覧を突き合わせ、未記載の連携候補は対象外または判断待ちとして理由を説明できる。
|
|
129
|
+
- 各章の問いで得た回答が同じ連携を指し、例にある担当・判断時点を実案件の確認なしで転用していない。
|
|
130
|
+
- 検証記録と引き継ぎ内容が一致し、確認待ちを解消済みと扱わず、次の担当が着手条件を選べる。
|
|
@@ -17,25 +17,26 @@ Organization Definition Writing Recipe
|
|
|
17
17
|
|
|
18
18
|
- 目的、関係者、主要判断から必要な責任領域を抽出します。
|
|
19
19
|
- 兼務可能な最小組織モデルを定めます。
|
|
20
|
-
-
|
|
21
|
-
- プロジェクトの目的と主要判断(Why)、必要な責任領域と最終判断先(What)、最小組織モデルと owner 方針(How
|
|
20
|
+
- 採用判断をロール定義へ渡し、Member 割り当てと成果物別の責任を各正本へ接続します。
|
|
21
|
+
- プロジェクトの目的と主要判断(Why)、必要な責任領域と最終判断先(What)、最小組織モデルと owner 方針(How)を扱い、採用判断・正本の対応・見直し条件で追跡します(Trace)。共通の責務説明と Member 割り当ては各正本へ委譲します。
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| -------- |
|
|
27
|
-
| 規模 | 参加者数、外部関係者、継続運用の有無
|
|
28
|
-
| 判断 | 当事者価値、優先順位、費用・負荷、品質、公開
|
|
29
|
-
| 実行 | 仕様化、開発、検証、運用、AI支援
|
|
30
|
-
| 正本 | ロール定義、メンバー定義、RACI、ステークホルダー登録簿
|
|
31
|
-
| 拡張条件 | 滞留、参加者増加、外部責任、専門性の必要性
|
|
25
|
+
| 項目 | 集める情報 |
|
|
26
|
+
| -------- | -------------------------------------------------------------------- |
|
|
27
|
+
| 規模 | 参加者数、外部関係者、継続運用の有無 |
|
|
28
|
+
| 判断 | 当事者価値、優先順位、費用・負荷、品質、公開 |
|
|
29
|
+
| 実行 | 仕様化、開発、検証、運用、AI支援 |
|
|
30
|
+
| 正本 | ロール定義、メンバー定義、RACI、ステークホルダー登録簿 |
|
|
31
|
+
| 拡張条件 | 滞留、参加者増加、外部責任、専門性の必要性 |
|
|
32
|
+
| 採用判断 | 標準ロールごとの採用可否、未採用時の代替先、独自ロールを検討する理由 |
|
|
32
33
|
|
|
33
34
|
## 3. 全体の作成手順
|
|
34
35
|
|
|
35
36
|
1. 必要な責任領域と最終判断を整理します。
|
|
36
37
|
2. 実行・確認を誰が兼務できるか決めます。
|
|
37
38
|
3. 人間とAI Agentの境界を明記します。
|
|
38
|
-
4. Schedule owner
|
|
39
|
+
4. 各標準ロールと独自ロールの採用・未採用、判断理由、未採用時の代替先を整理し、Schedule の `owner` に使える集合を明示します。
|
|
39
40
|
5. 情報ごとの正本を一表で示します。
|
|
40
41
|
6. 体制を拡張する見直し条件を定めます。
|
|
41
42
|
|
|
@@ -43,27 +44,27 @@ Organization Definition Writing Recipe
|
|
|
43
44
|
|
|
44
45
|
### 4.1. 組織モデル
|
|
45
46
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
47
|
+
- 価値判断、実行、品質確認、公開・運用のどの責任領域が目的達成に必要ですか。
|
|
48
|
+
- 当事者・利用者の確認を誰が受け止め、内部 Role のどの人間が最終判断しますか。
|
|
49
|
+
- 兼務しても作業と判断を分けられますか。具体的な兼務先はメンバー定義で確認します。
|
|
49
50
|
|
|
50
51
|
### 4.2. ロール・owner方針
|
|
51
52
|
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
53
|
+
- 各標準ロールと独自ロールについて、採用・未採用を何を根拠に選びますか。未採用の責務は誰が代替するか、対象外の理由は何ですか。
|
|
54
|
+
- 採用は専任配置と別に判断できていますか。専門支援だけのロールを含め、使用可能な `owner` の集合はどれですか。
|
|
55
|
+
- RACI の採用列・省略列と、ロール定義へ転記する採用集合が一致しますか。未採用がなければその旨を残します。
|
|
55
56
|
|
|
56
57
|
### 4.3. 正本と責任境界
|
|
57
58
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
59
|
+
- 共通定義、採用判断、機械可読な採用結果、実行主体、詳細責任の更新先はどこですか。
|
|
60
|
+
- 名簿で必要な人間の責任領域をカバーでき、未作成の文書には作成時期または省略理由がありますか。
|
|
61
|
+
- 一覧・一般責務を再掲せず、参照先と本書で扱う判断を区別できていますか。
|
|
61
62
|
|
|
62
63
|
### 4.4. 見直し条件
|
|
63
64
|
|
|
64
|
-
-
|
|
65
|
-
- Role
|
|
66
|
-
-
|
|
65
|
+
- 作業・判断の滞留、参加者、範囲、公開・運用責任の何が変わると見直しを始めますか。
|
|
66
|
+
- 新しい Role を増やす前に既存責任を再配分できますか。採用変更を誰が判断しますか。
|
|
67
|
+
- ロール定義、メンバー定義、RACI、WBS・Schedule の追従を誰が管理・確認し、未決事項をどの管理記録へ渡しますか。
|
|
67
68
|
|
|
68
69
|
## 5. 深掘り手順
|
|
69
70
|
|
|
@@ -82,10 +83,12 @@ Organization Definition Writing Recipe
|
|
|
82
83
|
|
|
83
84
|
## 7. レビュー観点
|
|
84
85
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
86
|
+
| 観点 | 確認内容 |
|
|
87
|
+
| ---- | ------------------------------------------------------------------- |
|
|
88
|
+
| 目的 | 必要な責任領域と人間の最終判断を説明できるか |
|
|
89
|
+
| 採用 | 各ロールの採否・理由・代替先と使用可能な `owner` が明示されているか |
|
|
90
|
+
| 正本 | 共通定義や名簿を再掲せず、採用結果・割り当て・RACI と照合できるか |
|
|
91
|
+
| 維持 | 見直し開始条件、判断者、追従先と確認担当が決まっているか |
|
|
89
92
|
|
|
90
93
|
## 8. 仕上げチェック
|
|
91
94
|
|
|
@@ -22,20 +22,21 @@ Project Management Plan Writing Recipe
|
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| ---------- |
|
|
27
|
-
| 価値と判定 | 成功基準 ID、受入条件 ID、判定時期
|
|
28
|
-
| 境界 | スコープ内外、主要な変更条件
|
|
29
|
-
| 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限
|
|
30
|
-
| 実行管理 | Schedule、依存、主要成果物、登録簿
|
|
31
|
-
| 判断 | 公開、例外、主要変更、継続・停止の判断者
|
|
32
|
-
| 正本 | 組織、RACI、品質、コミュニケーション、記録の参照先
|
|
25
|
+
| 項目 | 集める情報 |
|
|
26
|
+
| ---------- | --------------------------------------------------------------------------- |
|
|
27
|
+
| 価値と判定 | 成功基準 ID、受入条件 ID、判定時期 |
|
|
28
|
+
| 境界 | スコープ内外、主要な変更条件 |
|
|
29
|
+
| 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限 |
|
|
30
|
+
| 実行管理 | Schedule、依存、主要成果物、登録簿 |
|
|
31
|
+
| 判断 | 公開、例外、主要変更、継続・停止の判断者 |
|
|
32
|
+
| 正本 | 組織、RACI、品質、コミュニケーション、記録の参照先 |
|
|
33
|
+
| 依存関係 | 概要・スコープ・成功基準・組織定義へのカタログ依存と、直接根拠にする文書 ID |
|
|
33
34
|
|
|
34
35
|
## 3. 全体の作成手順
|
|
35
36
|
|
|
36
|
-
1.
|
|
37
|
+
1. カタログを使う場合は概要・スコープ・成功基準と、直接根拠にする組織定義への依存を確認し、不足を先行作業にします。根拠 ID と依存の対応が確認できてから管理目的を価値と期間で一文にします。
|
|
37
38
|
2. 軽量プロファイルを基本とし、拡張が必要な条件を決めます。
|
|
38
|
-
3.
|
|
39
|
+
3. 管理対象ごとに価値・リスクの根拠 ID、基準・上限、確認契機、逸脱時対応、責任、証跡の正本と記録識別子を一表へ書きます。
|
|
39
40
|
4. 人間の判断が必要なゲートだけを定義します。
|
|
40
41
|
5. Schedule、RACI、費用記録、品質証跡、登録簿の正本を示します。
|
|
41
42
|
6. 未決事項へ決定時期と判断者を付けます。
|
|
@@ -45,27 +46,33 @@ Project Management Plan Writing Recipe
|
|
|
45
46
|
|
|
46
47
|
### 4.1. 管理目的と適用方針
|
|
47
48
|
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
49
|
+
- どの価値を、いつからいつまで検証しますか。運用前に集める比較基準値も前提作業へ置けていますか。
|
|
50
|
+
- 人間が最終判断する事項と AI Agent が支援する作業は何ですか。
|
|
51
|
+
- 軽量・拡張のどちらを選び、契約・監査・組織規模の何が変わると拡張しますか。
|
|
51
52
|
|
|
52
53
|
### 4.2. 統合管理方針
|
|
53
54
|
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
55
|
+
- 各行はどの価値・リスク・条件 ID を守りますか。基準と証跡の該当記録を行から一意に辿れますか。
|
|
56
|
+
- 誰が、いつ逸脱を検知し、どの行動へ移りますか。構成の版・承認済み基準や技術依存の変更も確認します。
|
|
57
|
+
- 現金支出、準備・開発時間、継続運用負荷を区別でき、同じ基準・証跡だけを重ねた行を統合できていますか。
|
|
57
58
|
|
|
58
59
|
### 4.3. 判断ゲートとエスカレーション
|
|
59
60
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
61
|
+
- ゲートに適用する成功基準・受入条件 ID は何ですか。初期受入と後続の観測を区別します。
|
|
62
|
+
- 未達・材料不足・上限超過なら何を保留し、誰が是正・再判定を起案しますか。
|
|
63
|
+
- 人間の最終判断者と判断記録先を、材料の整理担当から区別できていますか。
|
|
63
64
|
|
|
64
65
|
### 4.4. 正本・報告・見直し
|
|
65
66
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
67
|
+
- 情報ごとの更新先と報告を確認する Role は誰ですか。未整備の正本には整備担当・時期を付けます。
|
|
68
|
+
- 判断・逸脱・作業節目のどれを報告契機にしますか。作業担当と成果物の承認責任を混同していませんか。
|
|
69
|
+
- 変更時の影響先、更新順序、担当・期限・確認担当をどの追従タスクへ渡しますか。
|
|
70
|
+
|
|
71
|
+
### 4.5. 未決事項
|
|
72
|
+
|
|
73
|
+
- どの論点が未決で、決定まで何を保留しますか。
|
|
74
|
+
- 決定時期と人間の判断者は誰ですか。他の正本にあれば該当論点を参照します。
|
|
75
|
+
- 期限超過時に誰が管理簿へ移し、担当 Role と転送先を追跡しますか。
|
|
69
76
|
|
|
70
77
|
## 5. 深掘り手順
|
|
71
78
|
|
|
@@ -84,10 +91,12 @@ Project Management Plan Writing Recipe
|
|
|
84
91
|
|
|
85
92
|
## 7. レビュー観点
|
|
86
93
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
94
|
+
| 観点 | 確認内容 |
|
|
95
|
+
| ---- | ---------------------------------------------------------------------------- |
|
|
96
|
+
| 根拠 | 価値・スコープ・成功基準と管理行が対応し、カタログ依存から直接根拠を辿れるか |
|
|
97
|
+
| 委譲 | 個別計画、RACI、Schedule、登録簿を再掲せず、更新先と確認者を示せるか |
|
|
98
|
+
| 判定 | 条件 ID、不足時の保留、人間の最終判断者、証跡が接続しているか |
|
|
99
|
+
| 負荷 | 現金支出、作業時間、継続運用負荷を別々に判断できるか |
|
|
91
100
|
|
|
92
101
|
## 8. 仕上げチェック
|
|
93
102
|
|
|
@@ -22,49 +22,56 @@ Quality Management Plan Writing Recipe
|
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| ---------- |
|
|
27
|
-
| 価値品質 | 利用者評価、費用・負荷、継承、運用成果
|
|
28
|
-
| 成果物品質 | 構造、参照整合、検証、公開適性
|
|
29
|
-
| 判定条件 | 成功基準ID、受入条件ID、検証結果
|
|
30
|
-
| 証跡 | 試行記録、レビュー、費用・作業記録、ログ
|
|
31
|
-
| 責任 | 確認者、承認者、是正担当
|
|
32
|
-
| 例外 | 未達時の対応、再判定、変更判断
|
|
25
|
+
| 項目 | 集める情報 |
|
|
26
|
+
| ---------- | -------------------------------------------------------- |
|
|
27
|
+
| 価値品質 | 利用者評価、費用・負荷、継承、運用成果 |
|
|
28
|
+
| 成果物品質 | 構造、参照整合、検証、公開適性 |
|
|
29
|
+
| 判定条件 | 成功基準ID、受入条件ID、検証結果 |
|
|
30
|
+
| 証跡 | 試行記録、レビュー、費用・作業記録、ログ |
|
|
31
|
+
| 責任 | 確認者、承認者、是正担当 |
|
|
32
|
+
| 例外 | 未達時の対応、再判定、変更判断 |
|
|
33
|
+
| 対象期間 | 適用開始・終了のイベント、初期受入・試用・後続観測の境界 |
|
|
33
34
|
|
|
34
35
|
## 3. 全体の作成手順
|
|
35
36
|
|
|
36
|
-
1.
|
|
37
|
+
1. 品質方針を価値品質と成果物品質に分け、適用開始・終了と人間・AI Agent の境界を示します。
|
|
37
38
|
2. 必要な判定時点だけを品質ゲートにします。
|
|
38
39
|
3. 各ゲートへ合格条件、方法・証跡、時期、責任を置きます。
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
41
|
-
6.
|
|
40
|
+
4. レビュー対象ごとの主要観点、実施責任、出口条件、証跡、記録先を結びます。
|
|
41
|
+
5. 不適合区分と重大性の境界を定め、是正後の再判定条件・責任・記録先へ接続します。
|
|
42
|
+
6. 見直しと後続作業、未決事項と保留を整理し、成功基準や検証手順の再掲を削除します。
|
|
42
43
|
|
|
43
44
|
## 4. 各章の書き方
|
|
44
45
|
|
|
45
46
|
### 4.1. 品質方針と適用範囲
|
|
46
47
|
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
48
|
+
- 利用者のどの変化を価値品質とし、どの成果物・技術条件がそれを支えますか。
|
|
49
|
+
- いつからいつまで適用し、初期受入・公開後の試用・後続観測をどこで区切りますか。
|
|
50
|
+
- AI Agent が支援する確認と、人間が担う価値・例外・公開の最終判断は何ですか。
|
|
50
51
|
|
|
51
52
|
### 4.2. 品質ゲート
|
|
52
53
|
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
54
|
+
- 各ゲートはどの条件 ID と正本を参照し、どの時点で確認しますか。運用前に必要な比較基準値は採取できますか。
|
|
55
|
+
- 誰がどの方法・証跡で確認し、誰が承認しますか。未達・証跡不足・未決条件をどう保留しますか。
|
|
56
|
+
- 費用・負荷を扱うとき、現金支出、作業時間、継続運用負荷を別々の基準・記録で判断できますか。
|
|
56
57
|
|
|
57
58
|
### 4.3. レビューと証跡
|
|
58
59
|
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
60
|
+
- どの対象版を誰が、どの観点で確認しますか。
|
|
61
|
+
- 出口条件はどの状態で合否が分かれ、それを裏付ける証跡はどの記録先に残りますか。三つを別々の欄に記入します。
|
|
62
|
+
- 指摘から是正・再判定結果を辿れますか。生成物は生成元を直し、再生成結果を証跡にします。
|
|
62
63
|
|
|
63
64
|
### 4.4. 不適合と是正
|
|
64
65
|
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
66
|
+
- 対応が異なる区分と重大性の境界は何ですか。重大な不適合ではどのゲートを止め、誰へ報告しますか。
|
|
67
|
+
- 是正後のどの契機に何を再確認し、誰が再判定しますか。再判定条件と責任を別欄にします。
|
|
68
|
+
- 発生済みの支障、将来の品質リスク、目的・スコープ・条件の変更を、誰がどの課題・リスク・変更記録へつなぎますか。
|
|
69
|
+
|
|
70
|
+
### 4.5. 見直し条件と未決事項
|
|
71
|
+
|
|
72
|
+
- 成功基準、公開範囲、構造、検証方法、体制、重大不適合の傾向の何が変わると見直しますか。
|
|
73
|
+
- 管理計画、RACI、Schedule、証跡参照の更新先・担当・期限・確認者を誰が整理しますか。後続観測への引き継ぎ条件は何ですか。
|
|
74
|
+
- 未決論点の正本、判断材料の担当、決定時期・人間の判断者、未決中の保留対象を特定できますか。
|
|
68
75
|
|
|
69
76
|
## 5. 深掘り手順
|
|
70
77
|
|
|
@@ -83,10 +90,13 @@ Quality Management Plan Writing Recipe
|
|
|
83
90
|
|
|
84
91
|
## 7. レビュー観点
|
|
85
92
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
93
|
+
| 観点 | 確認内容 |
|
|
94
|
+
| -------- | --------------------------------------------------------------------------------- |
|
|
95
|
+
| 範囲 | 価値品質・成果物品質、適用期間、人間と AI Agent の境界が明確か |
|
|
96
|
+
| 判定 | 条件 ID、時期、確認・承認責任、方法・証跡が接続し、未達と材料不足を通過させないか |
|
|
97
|
+
| レビュー | 出口条件・証跡・記録先を個別に確認できるか |
|
|
98
|
+
| 是正 | 重大性の境界、再判定条件・責任、報告・登録先が明確か |
|
|
99
|
+
| 維持 | 見直し・未決・後続作業が担当と期限へ接続し、正本を重複させていないか |
|
|
90
100
|
|
|
91
101
|
## 8. 仕上げチェック
|
|
92
102
|
|
|
@@ -22,13 +22,13 @@ RACI Writing Recipe
|
|
|
22
22
|
|
|
23
23
|
## 2. 作成前に集める情報
|
|
24
24
|
|
|
25
|
-
| 項目 | 集める情報
|
|
26
|
-
| --------- |
|
|
27
|
-
| Role code | 採用済みの責任語彙
|
|
28
|
-
| 成果物 | 初期スコープ、管理計画、公開対象
|
|
29
|
-
| 判断 | 価値、費用・負荷、変更、品質例外、公開
|
|
30
|
-
| 実行 | Schedule
|
|
31
|
-
| 割り当て | member、兼務、Agent支援の正本
|
|
25
|
+
| 項目 | 集める情報 |
|
|
26
|
+
| --------- | ------------------------------------------------------------------- |
|
|
27
|
+
| Role code | 採用済みの責任語彙 |
|
|
28
|
+
| 成果物 | 初期スコープ、管理計画、公開対象 |
|
|
29
|
+
| 判断 | 価値、費用・負荷、変更、品質例外、公開 |
|
|
30
|
+
| 実行 | WBS の明示 `owner`、Schedule のタスク種別・action、作業ごとの主担当 |
|
|
31
|
+
| 割り当て | member、兼務、Agent支援の正本 |
|
|
32
32
|
|
|
33
33
|
## 3. 全体の作成手順
|
|
34
34
|
|
|
@@ -36,56 +36,64 @@ RACI Writing Recipe
|
|
|
36
36
|
2. 使用するRole code列を必要最小限に絞ります。
|
|
37
37
|
3. 各行へ一つの`A`と一つ以上の`R`を置きます。
|
|
38
38
|
4. 相談が必要なRoleに`C`、結果共有だけのRoleに`I`を置きます。
|
|
39
|
-
5. Schedule
|
|
40
|
-
6.
|
|
39
|
+
5. 複数 `R` の担当範囲を注記し、WBS の明示 `owner` とタスク種別から Schedule の担当を照合します。
|
|
40
|
+
6. 不一致時の更新先と見直し条件を定め、生成ビューや通常手順の重複行を削除します。
|
|
41
41
|
|
|
42
42
|
## 4. 各章の書き方
|
|
43
43
|
|
|
44
44
|
### 4.1. 適用方針
|
|
45
45
|
|
|
46
|
-
-
|
|
47
|
-
- 兼務とAgent
|
|
48
|
-
-
|
|
46
|
+
- どの成果物・判断で業務・技術・品質の責任衝突が起こり得ますか。対象外とする範囲と理由は何ですか。
|
|
47
|
+
- 兼務と AI Agent 支援を使っても、人間の最終判断を区別できますか。
|
|
48
|
+
- 採用済み Role のうち、どれを列に使い、どれをどの理由で省きますか。記号の意味は共通定義へ委譲します。
|
|
49
49
|
|
|
50
50
|
### 4.2. 成果物別RACI
|
|
51
51
|
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
52
|
+
- 主要成果物と管理文書を、作成・内容承認の責任が同じ単位でまとめられますか。
|
|
53
|
+
- 同じ正本から生成するビューを重ねず、各成果物 ID から行を一意に辿れますか。
|
|
54
|
+
- 誰が作成し、どの Role の人間が内容を承認しますか。複数の作業担当なら担当範囲を注記します。
|
|
55
55
|
|
|
56
56
|
### 4.3. 判断・プロセス別RACI
|
|
57
57
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
58
|
+
- 価値・費用・変更・品質例外・公開で、判断者や判断材料が異なるものはどれですか。
|
|
59
|
+
- 成果物行の承認とプロセス行の判断が重なる場合、それぞれ何を判断しますか。
|
|
60
|
+
- 当事者確認と必要な技術・品質相談を、どの採用 Role を介して受けますか。
|
|
61
61
|
|
|
62
62
|
### 4.4. Schedule・実行主体との対応
|
|
63
63
|
|
|
64
|
-
- owner
|
|
65
|
-
-
|
|
66
|
-
-
|
|
64
|
+
- WBS に明示 `owner` はありますか。あれば引き継ぎを先に確認し、未指定の作成作業は `R` から担当を展開します。複数なら action に最も近い担当を注記で特定し、一意でなければ分割します。`A/R` は作業担当も兼ねます。
|
|
65
|
+
- 対象は作成作業ですか、別タスクに分けた承認・レビュー・外部待ちですか。後者では対応する `A` / `C` と照合し、通知だけの `I` を担当にしません。
|
|
66
|
+
- WBS・Schedule、実行主体・兼務の正本はどこですか。不一致は責任配置の変更かタスク定義・生成処理の誤りかを調べ、修正先を決めます。
|
|
67
|
+
|
|
68
|
+
### 4.5. 見直し条件
|
|
69
|
+
|
|
70
|
+
- スコープ、成果物、採用 Role、判断ゲート、担当・兼務の何が変わると見直しますか。
|
|
71
|
+
- 誰が影響する RACI 行、正本、WBS・Schedule の追従担当と期限を整理しますか。
|
|
72
|
+
- 未決の担当変更・リスク・課題は、どの管理記録へ Role と転送先を付けて渡しますか。
|
|
67
73
|
|
|
68
74
|
## 5. 深掘り手順
|
|
69
75
|
|
|
70
76
|
1. 各行の`A`が本当に最終判断者か確認します。
|
|
71
77
|
2. `C`と`I`を必要最小限に減らします。
|
|
72
78
|
3. 同じ責任配置の行をグループ化します。
|
|
73
|
-
4.
|
|
79
|
+
4. 各行が成果物または主要判断に使われるか確認し、目的のない行を削除します。未計画の主要判断は後続タスクへ渡します。
|
|
74
80
|
|
|
75
81
|
## 6. 良い例 / 悪い例
|
|
76
82
|
|
|
77
|
-
| 観点 | 良い例
|
|
78
|
-
| ---- |
|
|
79
|
-
| 対象 | 主要成果物と公開判断へ絞る
|
|
80
|
-
| 責任 | 一行に`A`を一つ置く
|
|
81
|
-
| 実行 |
|
|
83
|
+
| 観点 | 良い例 | 悪い例 |
|
|
84
|
+
| ---- | ------------------------------------------------------------------ | --------------------------- |
|
|
85
|
+
| 対象 | 主要成果物と公開判断へ絞る | 全カタログ行を転記する |
|
|
86
|
+
| 責任 | 一行に`A`を一つ置く | `A`を複数置く |
|
|
87
|
+
| 実行 | 作成は WBS の明示担当を先に照合し、別の承認タスクは `A` と照合する | 全タスクを `R` に書き換える |
|
|
82
88
|
|
|
83
89
|
## 7. レビュー観点
|
|
84
90
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
91
|
+
| 観点 | 確認内容 |
|
|
92
|
+
| ---- | ---------------------------------------------------------------------- |
|
|
93
|
+
| 責任 | 各行の `A` と作業ごとの主担当を識別できるか |
|
|
94
|
+
| 採用 | 列が採用済み Role に対応し、省略理由と専門支援の取り込み先が分かるか |
|
|
95
|
+
| 展開 | WBS の明示担当、作成と承認・レビューの種別から Schedule と照合できるか |
|
|
96
|
+
| 範囲 | 業務・技術・品質の主要責任を辿れ、重複する行を増やしていないか |
|
|
89
97
|
|
|
90
98
|
## 8. 仕上げチェック
|
|
91
99
|
|