specdojo 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +4 -1
- package/CHANGELOG.md +64 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +4 -1
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +9 -1
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +9 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -12,34 +12,26 @@ specdojo:
|
|
|
12
12
|
|
|
13
13
|
Issue Log Documentation Rules
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
顕在化した課題の優先度・期限・対応・状態を追跡する課題ログの記述基準を定める。
|
|
16
16
|
|
|
17
17
|
## 1. 全体方針
|
|
18
18
|
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
- 曖昧表現を避け、未解決課題の判定が可能な記述にする。
|
|
19
|
+
- 顕在化した課題ごとに、未解決かどうかと次の対応を判定できる形で残す。
|
|
20
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
|
|
22
21
|
|
|
23
|
-
## 2.
|
|
22
|
+
## 2. 位置づけ
|
|
24
23
|
|
|
25
|
-
- `pm-
|
|
26
|
-
-
|
|
27
|
-
- `pm-issue-log`: 顕在化した課題の管理。
|
|
24
|
+
- プロジェクト登録簿を使うプロジェクトでは、課題 1 件を `item_type: issue` の個票に書き、`controls/generated/pm-issue-log.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
|
|
25
|
+
- 本書の判断基準は、個票と、登録簿を使わない単独の課題ログの両方に適用する。
|
|
28
26
|
|
|
29
27
|
## 3. ファイル命名・ID規則
|
|
30
28
|
|
|
31
|
-
- `id` は `<project-id>:pm-issue-log`
|
|
32
|
-
-
|
|
29
|
+
- `id` は `<project-id>:pm-issue-log`、ファイル名は `pm-issue-log.md` とする。
|
|
30
|
+
- 課題 ID は登録簿では `PJR-XXXX`、単独のログでは `IS-NNN` とし、再利用しない。
|
|
33
31
|
|
|
34
32
|
## 4. 推奨 Frontmatter 項目
|
|
35
33
|
|
|
36
|
-
|
|
37
|
-
| ---------- | -------------------------------- | ---- |
|
|
38
|
-
| id | `<project-id>:pm-issue-log` | ○ |
|
|
39
|
-
| type | `project` 固定 | ○ |
|
|
40
|
-
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
41
|
-
| based_on | 根拠仕様ID(配列) | 任意 |
|
|
42
|
-
| supersedes | 置換関係ID(配列) | 任意 |
|
|
34
|
+
- 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
|
|
43
35
|
|
|
44
36
|
## 5. 本文構成(標準テンプレ)
|
|
45
37
|
|
|
@@ -56,39 +48,35 @@ Issue Log Documentation Rules
|
|
|
56
48
|
|
|
57
49
|
### 6.1. 概要
|
|
58
50
|
|
|
59
|
-
-
|
|
51
|
+
- 管理対象、レビュー頻度、記録単位を 1〜3 行で示す。
|
|
60
52
|
|
|
61
53
|
### 6.2. 課題ログ一覧
|
|
62
54
|
|
|
63
|
-
- 課題ID
|
|
64
|
-
|
|
65
|
-
推奨フォーマット(表):
|
|
66
|
-
|
|
67
|
-
| 課題ID | 発生日 | 内容 | 優先度 | 対応策 | 担当 | 期限 | ステータス |
|
|
68
|
-
| ------ | ------ | ---- | ------ | ------ | ---- | ---- | ---------- |
|
|
55
|
+
- 課題 ID、発生日、内容、優先度、対応策、担当、期限、ステータスを一覧にする。
|
|
56
|
+
- 優先度とステータスは登録簿の `priority`・`item_status` の値を使い、言い換えない。
|
|
69
57
|
|
|
70
58
|
### 6.3. 優先度と期限
|
|
71
59
|
|
|
72
|
-
-
|
|
60
|
+
- 優先度の基準、期限の決め方、期限超過時のエスカレーション先、優先度の変更を決める者を書く。
|
|
73
61
|
|
|
74
62
|
### 6.4. 対応計画
|
|
75
63
|
|
|
76
|
-
-
|
|
64
|
+
- 対応策、依存事項、完了条件を書く。完了条件は確認の手段と合格の基準で書く。
|
|
77
65
|
|
|
78
66
|
### 6.5. 進捗レビュー
|
|
79
67
|
|
|
80
|
-
-
|
|
68
|
+
- レビュー周期、完了を判定する者と判定の観点、状態を更新する契機を書く。
|
|
81
69
|
|
|
82
70
|
### 6.6. 関連ドキュメント
|
|
83
71
|
|
|
84
|
-
-
|
|
85
|
-
- 関連がない場合でも `(本書のみ)` を明記する。
|
|
72
|
+
- 根拠、影響先、課題から起票したリスク・変更要求を文書 ID で示す。なければ `(本書のみ)` と書く。
|
|
86
73
|
|
|
87
74
|
## 7. 禁止事項
|
|
88
75
|
|
|
89
|
-
| 禁止事項
|
|
90
|
-
|
|
|
91
|
-
| 課題IDなしで記録する
|
|
92
|
-
| 優先度・期限を未記載にする
|
|
93
|
-
|
|
|
94
|
-
|
|
|
76
|
+
| 禁止事項 | 理由 |
|
|
77
|
+
| ------------------------------------------ | -------------------------- |
|
|
78
|
+
| 課題IDなしで記録する | 追跡不能になるため |
|
|
79
|
+
| 優先度・期限を未記載にする | 対応順序が判断できないため |
|
|
80
|
+
| 根拠のない完了判定を記載する | 品質低下を招くため |
|
|
81
|
+
| 個人情報・認証情報を内容や対応策に書き写す | 公開範囲を超えて広がるため |
|
|
82
|
+
| 生成された `pm-issue-log.md` を直す | 再生成で修正が失われるため |
|
|
@@ -16,40 +16,32 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
Project Human Member Roster Documentation Rulebook
|
|
18
18
|
|
|
19
|
-
`pm-members.yaml`
|
|
19
|
+
`pm-members.yaml` に人間の実行主体と対応 Role code を定義する基準です。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
- `members[].roles` には `pm-roles.yaml` に存在する Role code だけを記載します。
|
|
27
|
-
- 公開文書には、不要な個人名、私用メールアドレス、非公開組織情報、アクセス情報を記載しません。
|
|
28
|
-
- 人間の最終承認、公開可否、説明責任は agent 定義へ移しません。
|
|
23
|
+
- 対象は project の人間名簿です。agent の実行定義は含めません。
|
|
24
|
+
- Role・Member・`owner` の区別と公開情報の扱いは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
|
|
25
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱います。
|
|
29
26
|
|
|
30
27
|
## 2. 位置づけと用語定義
|
|
31
28
|
|
|
32
|
-
| 情報 | 正本 |
|
|
33
|
-
| ----------------------------- | ------------------------------ |
|
|
34
|
-
| 人間の identity・連絡先・兼務 | `pm-members.yaml`
|
|
35
|
-
| agent の identity・選択属性 | `.specdojo/agent-members.yaml` |
|
|
36
|
-
| provider の起動コマンド | `.specdojo/exec-defaults.yaml` |
|
|
37
|
-
| Role code と責務 | `pm-roles.yaml` | project |
|
|
38
|
-
| Schedule の主責任 | Schedule の `owner` | task |
|
|
39
|
-
|
|
40
|
-
`loadMemberRoster` は人間名簿と agent 定義を schema 検証した後に合成します。合成後の nickname は一意でなければならず、`--by` と実行イベントはこの合成名簿を参照します。
|
|
29
|
+
| 情報 | 正本 |
|
|
30
|
+
| ----------------------------- | ------------------------------ |
|
|
31
|
+
| 人間の identity・連絡先・兼務 | project の `pm-members.yaml` |
|
|
32
|
+
| agent の identity・選択属性 | `.specdojo/agent-members.yaml` |
|
|
33
|
+
| provider の起動コマンド | `.specdojo/exec-defaults.yaml` |
|
|
41
34
|
|
|
42
35
|
## 3. ファイル命名・ID規則
|
|
43
36
|
|
|
44
|
-
- ファイル名は `pm-members.yaml`
|
|
45
|
-
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-members.yaml` を推奨します。
|
|
37
|
+
- ファイル名は `pm-members.yaml`、推奨配置は `docs/ja/projects/<project-id>/030-project-management/` です。
|
|
46
38
|
- `id` は `<project-id>:pm-members`、`project_id` は配置先 project ID と一致させます。
|
|
47
|
-
- `members[].nickname`
|
|
48
|
-
- 実行ログへ記録済みの nickname は変更せず、交代時は新しい member を追加します。
|
|
49
|
-
- 同じ nickname を `.specdojo/agent-members.yaml` に定義しません。
|
|
39
|
+
- `members[].nickname` は1〜63文字、先頭は英小文字か数字、以降は英小文字・数字・`_`・`-` とします。
|
|
50
40
|
|
|
51
41
|
## 4. 推奨メタ項目
|
|
52
42
|
|
|
43
|
+
許可キーと型は `docs/specdojo/schemas/v1/pm-members.schema.yaml` を正本とし、メタ項目はルートに置きます。
|
|
44
|
+
|
|
53
45
|
| 項目 | 必須 | 内容 |
|
|
54
46
|
| ------------ | ---- | -------------------------------- |
|
|
55
47
|
| `id` | ○ | `<project-id>:pm-members` |
|
|
@@ -57,12 +49,11 @@ Project Human Member Roster Documentation Rulebook
|
|
|
57
49
|
| `status` | ○ | `draft` / `ready` / `deprecated` |
|
|
58
50
|
| `title` | ○ | 名簿の表示名 |
|
|
59
51
|
| `rulebook` | ○ | `specdojo:pm-members-rulebook` |
|
|
60
|
-
| `based_on` | 任意 | 根拠文書 ID
|
|
61
|
-
| `
|
|
52
|
+
| `based_on` | 任意 | 根拠文書 ID の配列 |
|
|
53
|
+
| `supersedes` | 任意 | 置き換える旧文書 ID の配列 |
|
|
54
|
+
| `version` | ○ | 1 以上の整数 |
|
|
62
55
|
| `project_id` | ○ | 対象 project ID |
|
|
63
56
|
|
|
64
|
-
schema にないメタ項目は追加しません。成果物の `status` は作成中は `draft` とし、`ready` への変更は人間が判断します。
|
|
65
|
-
|
|
66
57
|
## 5. 本文要件
|
|
67
58
|
|
|
68
59
|
| 要素 | 必須 | 内容 |
|
|
@@ -70,14 +61,14 @@ schema にないメタ項目は追加しません。成果物の `status` は作
|
|
|
70
61
|
| `members` | ○ | 人間 member の配列 |
|
|
71
62
|
| `rules` | 任意 | 名簿利用時の project 固有の運用ルール |
|
|
72
63
|
|
|
73
|
-
`members[]`
|
|
64
|
+
`members[]` の必須性は対応 schema を優先します。上位の人と組織の定義標準では任意の `roles` も、本形式では必須です。
|
|
74
65
|
|
|
75
66
|
| フィールド | 必須 | 内容 |
|
|
76
67
|
| -------------------- | ---- | --------------------------------------------------------- |
|
|
77
68
|
| `nickname` | ○ | CLI と履歴で使う安定識別子 |
|
|
78
69
|
| `display_name` | ○ | 公開可能な表示名 |
|
|
79
|
-
| `email` | 任意 |
|
|
80
|
-
| `roles` | ○ |
|
|
70
|
+
| `email` | 任意 | 公開可能な連絡先または `null` |
|
|
71
|
+
| `roles` | ○ | `pm-roles.yaml` に存在する Role code の重複なし配列 |
|
|
81
72
|
| `type` | ○ | `human` 固定 |
|
|
82
73
|
| `persona` | 任意 | 作業姿勢を示す短いラベル |
|
|
83
74
|
| `focus` | 任意 | 重視する観点の配列 |
|
|
@@ -89,31 +80,22 @@ schema にないメタ項目は追加しません。成果物の `status` は作
|
|
|
89
80
|
### 6.1. 人間 member
|
|
90
81
|
|
|
91
82
|
- 個人名を必要としない場合は、`po` や `store-owner` のような役割ベースの nickname と表示名を使います。
|
|
92
|
-
- `roles
|
|
93
|
-
- 最終判断、公開可否、説明責任を担う範囲は `note` に短く記載します。
|
|
83
|
+
- 兼務は `roles: [PO, BA]` のように記載します。
|
|
94
84
|
- 連絡先を公開できない場合は推測で補わず `email: null` とします。
|
|
95
85
|
|
|
96
86
|
### 6.2. 合成名簿との整合
|
|
97
87
|
|
|
98
|
-
-
|
|
99
|
-
- `--by` に人間または agent の nickname を指定する場合、合成名簿に一意に存在する値を使います。
|
|
88
|
+
- 人間名簿と agent 定義の合成後、全 nickname が一意であり、`--by`・実行イベントが登録値を使うことを照合します。
|
|
100
89
|
- `pm-members.yaml` に `type: agent` が残る場合は、`specdojo config migrate-members --dry-run` で移行内容を確認します。
|
|
101
|
-
- agent の追加・優先度・能力変更は、保護設定を変更できる人間または orchestrator が行います。
|
|
102
90
|
|
|
103
91
|
### 6.3. 運用ルール
|
|
104
92
|
|
|
105
|
-
- `rules`
|
|
106
|
-
- project 固有の公開制約や交代時の扱いだけを記載し、共通 schema を再掲しません。
|
|
107
|
-
- agent の provider、モデル、起動 command は記載しません。
|
|
108
|
-
- 名簿の変更理由は project の変更管理記録に残します。
|
|
93
|
+
- `rules` は project 固有の公開制約や交代時の扱いに限定し、共通標準・schema を再掲しません。
|
|
109
94
|
|
|
110
95
|
## 7. 禁止事項
|
|
111
96
|
|
|
112
|
-
| 禁止事項
|
|
113
|
-
|
|
|
114
|
-
| `type: agent` の member を記載する
|
|
115
|
-
| `provider`、`command`、`mode`、`stage_role` を記載する
|
|
116
|
-
|
|
|
117
|
-
| 未定義の Role code を `roles` に書く | ロール正本との整合が失われるため |
|
|
118
|
-
| 実行ログ記録後の nickname を変更する | 履歴の参照先が不明になるため |
|
|
119
|
-
| 秘密情報、私用連絡先、非公開組織情報を記載する | 公開適性と安全性を損なうため |
|
|
97
|
+
| 禁止事項 | 理由 |
|
|
98
|
+
| ---------------------------------------------------------------- | ---------------------------------------- |
|
|
99
|
+
| `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
|
|
100
|
+
| `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
|
|
101
|
+
| 実行ログ記録後の nickname を変更する(交代時は新 member を追加) | 履歴の参照先が不明になるため |
|
|
@@ -16,88 +16,80 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
Organization Definition Documentation Rulebook
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
プロジェクトの目的に必要な分担方針、Role code の採用判断、使用可能な `owner` と見直し条件を定義します。
|
|
20
20
|
|
|
21
21
|
## 1. 全体方針
|
|
22
22
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
- AI Agent は実行支援者とし、最終承認、当事者価値、公開可否、説明責任を人間に残します。
|
|
28
|
-
- 参加者や責務が増えた場合に、軽量体制から分担体制へ拡張する条件を示します。
|
|
23
|
+
- 規模・関係者・判断の複雑さに合う最小体制とし、価値判断、実行、品質確認、公開・運用の責任境界を示します。
|
|
24
|
+
- ロールの採用と専任配置を分け、兼務時も最終判断と実作業を区別します。
|
|
25
|
+
- 参加者や責務の増加に応じて、分担体制へ拡張する条件を示します。
|
|
26
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
|
|
29
27
|
|
|
30
28
|
## 2. 位置づけ
|
|
31
29
|
|
|
32
|
-
|
|
33
|
-
- 組織定義は、プロジェクト固有の採用・未採用 Role code、使用可能な `owner`、体制の設計根拠を管理し、Schedule と RACI のロール適合を確認する起点とします。
|
|
34
|
-
- `pm-roles.yaml` は採用ロールの機械可読な定義、メンバー定義は実行主体と兼務、RACI は成果物・プロセス別の責任分担を扱います。これらの内容を組織定義に複製しません。
|
|
30
|
+
共通定義と整合性ルールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。組織定義はプロジェクト固有の採用判断を残し、Schedule と RACI のロール適合を確認する起点です。採用結果の機械可読な定義は `pm-roles.yaml`、実行主体と兼務はメンバー定義、成果物・プロセス別の分担は RACI で扱います。
|
|
35
31
|
|
|
36
32
|
## 3. ファイル命名・ID規則
|
|
37
33
|
|
|
38
34
|
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-organization.md` を推奨します。
|
|
39
35
|
- ID は `<project-id>:pm-organization`、ファイル名は `pm-organization.md` とします。
|
|
40
|
-
- 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]
|
|
36
|
+
- 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
41
37
|
|
|
42
38
|
## 4. 推奨 Frontmatter 項目
|
|
43
39
|
|
|
44
40
|
- 共通項目の必須・任意、型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。
|
|
45
41
|
- `rulebook` には本書の ID を指定し、成果物の種別は本書の `deliverable_type` に合わせます。
|
|
46
|
-
- `based_on`
|
|
42
|
+
- `based_on` には採用判断の根拠となる先行成果物を指定し、依存関係に含まれない文書は本文で参照します。
|
|
47
43
|
|
|
48
44
|
## 5. 本文要件
|
|
49
45
|
|
|
50
46
|
以下はすべて必須です。見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。
|
|
51
47
|
|
|
52
|
-
| 要件 | 記載する判断・根拠
|
|
53
|
-
| ------------------ |
|
|
54
|
-
| 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界
|
|
55
|
-
| ロールの採用判断 |
|
|
56
|
-
| 使用可能な `owner` | Schedule
|
|
57
|
-
| 正本への参照 |
|
|
58
|
-
| 体制の見直し |
|
|
48
|
+
| 要件 | 記載する判断・根拠 |
|
|
49
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
50
|
+
| 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界 |
|
|
51
|
+
| ロールの採用判断 | 各標準ロールと独自ロールの採用・未採用、理由、プロジェクトでの扱い。未採用は代替先または対象外の理由を示し、未採用がなければ「なし」と明記 |
|
|
52
|
+
| 使用可能な `owner` | Schedule に使える採用ロールの集合。RACI の列とロール定義との整合 |
|
|
53
|
+
| 正本への参照 | 関連定義との責務境界。未作成の文書は作成予定または省略理由 |
|
|
54
|
+
| 体制の見直し | 開始トリガー、確認事項、更新先、判断者の Role code、追従確認。未決事項がある場合は論点と体制への影響 |
|
|
59
55
|
|
|
60
56
|
## 6. 記述ガイド
|
|
61
57
|
|
|
62
|
-
|
|
58
|
+
以下の判断基準と例に従います。Role code の値・構文は人と組織の定義標準と各 YAML の schema を参照します。
|
|
63
59
|
|
|
64
60
|
### 6.1. 組織モデル
|
|
65
61
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
- 良い例:
|
|
69
|
-
- 悪い例:
|
|
62
|
+
- 判断基準は、目的に必要な責任領域に漏れがなく、当事者・利用者の価値確認と内部の管理責任を区別できることです。
|
|
63
|
+
- 推奨表の列は「責任領域」「設計方針」「最終判断」「実行・確認」です。責任者は RACI と整合させます。
|
|
64
|
+
- 良い例: 「店主の操作確認を `BA` が受け止め、`PO` が受入を判断する。初期は兼務する」。
|
|
65
|
+
- 悪い例: 「小規模なので責任は全員で持つ」。判断者と実行・確認の分担が分かりません。
|
|
70
66
|
|
|
71
67
|
### 6.2. ロール・owner方針
|
|
72
68
|
|
|
73
|
-
-
|
|
74
|
-
- 推奨表の列は「Role code
|
|
75
|
-
- 良い例: 「`PO` と `BA`
|
|
76
|
-
- 悪い例: 「`PM`
|
|
69
|
+
- 判断基準は、採用可否の根拠と使用可能な `owner` を特定し、Schedule と RACI の列を照合できることです。
|
|
70
|
+
- 推奨表の列は「Role code」「採用/未採用」「判断理由・プロジェクトでの扱い」「未採用時の代替方針」です。共通の正式名称・責務は転載しません。
|
|
71
|
+
- 良い例: 「`PO` と `BA` を採用し、`owner` に使う。`PM` は未採用とし、計画・進捗管理は `PO` が担う」。他の標準ロールも採否を記載します。
|
|
72
|
+
- 悪い例: 「`PM` は専任者がいないので未採用だが、`owner` に使う」。採用と配置を混同しています。
|
|
77
73
|
|
|
78
74
|
### 6.3. 正本と責任境界
|
|
79
75
|
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
- 良い例:
|
|
83
|
-
- 悪い例:
|
|
76
|
+
- 判断基準は、情報の更新先が一意で、本書の採用判断を外部へ委譲していないことです。
|
|
77
|
+
- 推奨表の列は「情報」「正本」「本書で扱うこと」です。「位置づけ」の責務境界に従います。
|
|
78
|
+
- 良い例: 「本書で採用を決め、ロール定義に採用結果を反映する」。
|
|
79
|
+
- 悪い例: 「使用できるロールはロール定義を参照」とだけ書く、または名簿・詳細 RACI を複製する。採用根拠が欠けるか、更新先が分散します。
|
|
84
80
|
|
|
85
81
|
### 6.4. 見直し条件
|
|
86
82
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
- 良い例: 「兼務による承認待ちで Schedule の期限を超えた場合、管理担当が役割再配分を検討し、PO が採否を判断する。変更対象の RACI と Schedule の更新を確認する」。
|
|
83
|
+
- 判断基準は、目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化から、体制変更の開始条件を判定できることです。ロール追加の前に既存責任の再配分を検討します。
|
|
84
|
+
- 推奨表の列は「トリガー」「確認すること」「更新先」「判断者」です。追従先はロール定義、メンバー定義、RACI、WBS、Schedule とし、採用変更の影響箇所を確認します。
|
|
85
|
+
- 良い例: 「兼務による承認待ちで Schedule の期限を超えたら、役割再配分を検討する。変更対象の RACI と Schedule に担当不在や使用不可ロールが残らないことを確認する」。
|
|
91
86
|
- 悪い例: 「忙しくなったら体制を強化する」。開始条件、更新先、判断者が分かりません。
|
|
92
87
|
|
|
93
88
|
## 7. 禁止事項
|
|
94
89
|
|
|
95
|
-
| 禁止事項
|
|
96
|
-
|
|
|
97
|
-
| 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる
|
|
98
|
-
| 共通のロール定義、メンバー名簿、詳細な RACI を再掲する
|
|
99
|
-
| 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う
|
|
100
|
-
|
|
|
101
|
-
| 兼務を理由に最終判断者を曖昧にする、または Agent に最終承認・当事者価値・公開可否を委ねる | 人間の判断責任と説明責任が不明になるため |
|
|
102
|
-
| 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
|
|
103
|
-
| 個人情報、秘密情報、アクセス情報を記載する | 公開適性に反するため |
|
|
90
|
+
| 禁止事項 | 理由 |
|
|
91
|
+
| -------------------------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
92
|
+
| 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる | プロジェクト固有の採用判断と適合確認の根拠が失われるため |
|
|
93
|
+
| 共通のロール定義、メンバー名簿、詳細な RACI を再掲する | 正本が分散するため |
|
|
94
|
+
| 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う | 採用判断と責任語彙が不整合になるため |
|
|
95
|
+
| 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
|
|
@@ -21,94 +21,93 @@ Project Management Plan Documentation Rulebook
|
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
- 現金支出、人の作業時間、継続運用負荷を区別し、人への負荷転嫁をコスト削減とみなしません。
|
|
29
|
-
- AI Agent は整理・更新・検証を支援できますが、優先順位、例外、公開、GO / Not GO の最終判断は人間が担います。
|
|
24
|
+
- 管理対象ごとに、期待価値・リスク、逸脱の基準、対応、責任、証跡を結び付けます。
|
|
25
|
+
- プロジェクト概要、スコープ、成功基準を直接の根拠とし、期待価値の検証を管理目的にします。
|
|
26
|
+
- 個別計画や管理台帳の詳細は各正本へ委譲します。
|
|
27
|
+
- **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
|
|
30
28
|
|
|
31
29
|
## 2. 位置づけ
|
|
32
30
|
|
|
33
31
|
- 本計画は横断的な管理基準と判断の接続を担い、個別計画・管理記録の更新先を示します。
|
|
34
|
-
-
|
|
35
|
-
- 必要最小限の統合表と判断ゲートで管理する方式を軽量プロファイル、契約・監査・組織規模に応じて個別計画や詳細手順を追加する方式を拡張プロファイルとします。
|
|
32
|
+
- 小規模では統合表と判断ゲートによる軽量プロファイルを基本とし、契約・監査・組織規模に応じて個別計画を追加する拡張プロファイルを選びます。
|
|
36
33
|
|
|
37
34
|
## 3. ファイル命名・ID規則
|
|
38
35
|
|
|
39
36
|
- 配置は `docs/ja/projects/<project-id>/030-project-management/pm-plan.md` を推奨します。
|
|
40
37
|
- ID は `<project-id>:pm-plan`、ファイル名は `pm-plan.md` とします。
|
|
41
|
-
- 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]
|
|
38
|
+
- 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
|
|
42
39
|
|
|
43
40
|
## 4. 推奨 Frontmatter 項目
|
|
44
41
|
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
- 置き換え時の `supersedes` と状態変更はメタ情報標準に従います。
|
|
42
|
+
- 共通項目・型・許容値はメタ情報標準と成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
|
|
43
|
+
- `based_on` は必須とし、概要・スコープ・成功基準と、組織定義など直接根拠にした先行成果物の ID を記載します。
|
|
44
|
+
- カタログ利用時は参照先を `depends_on` の推移閉包に含め、不足する依存関係の整備を先行作業にします。根拠宣言の省略や閉包外の ID 追加で代替しません。
|
|
49
45
|
|
|
50
46
|
## 5. 本文要件
|
|
51
47
|
|
|
52
48
|
見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。本書は次の意味要件を定めます。
|
|
53
49
|
|
|
54
|
-
| 要件 | 必須条件 | 記載する判断・根拠
|
|
55
|
-
| ------------------ | ------------------------ |
|
|
56
|
-
| 管理範囲の選定 | 必須 |
|
|
57
|
-
| 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける
|
|
58
|
-
| 判断の成立条件 | 必須 |
|
|
59
|
-
| 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する
|
|
60
|
-
| 未決の扱い | 未決事項がある場合に必須 |
|
|
50
|
+
| 要件 | 必須条件 | 記載する判断・根拠 |
|
|
51
|
+
| ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
52
|
+
| 管理範囲の選定 | 必須 | 期待価値、対象期間、適用プロファイルと拡張条件 |
|
|
53
|
+
| 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける |
|
|
54
|
+
| 判断の成立条件 | 必須 | 継続・公開・変更・停止などの条件、判断材料、起案者、最終判断者、証跡。未達・材料不足時の扱いを含む |
|
|
55
|
+
| 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する |
|
|
56
|
+
| 未決の扱い | 未決事項がある場合に必須 | 論点・現状、当面の扱い、決定によって変わる管理行・ゲート。別の正本にある論点は参照し、未決事項がなければ「なし」と明記できる |
|
|
61
57
|
|
|
62
58
|
## 6. 記述ガイド
|
|
63
59
|
|
|
64
|
-
共通のメタ情報、役割、値・構文は上位標準と schema を参照し、ここでは計画固有の判断基準と部分例を示します。
|
|
65
|
-
|
|
66
60
|
### 6.1. 管理目的と適用方針
|
|
67
61
|
|
|
68
62
|
- 判断基準は、管理範囲と期間を価値・スコープ・成功基準へ結び付け、管理の厚さを選んだ理由を説明できることです。
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
- 悪い例: 「一般的な PM 項目をすべて管理し、完了したら Agent が公開する」。価値、期間、管理範囲の選定理由、人間の判断境界が分かりません。
|
|
63
|
+
- 良い例: 「初期公開から2週間で SC-01 の価値を検証する。軽量運用とし、外部契約が生じた場合は個別計画を追加する」。
|
|
64
|
+
- 悪い例: 「一般的な PM 項目をすべて管理する」。価値、期間、範囲の選定理由が不明です。
|
|
72
65
|
|
|
73
66
|
### 6.2. 統合管理方針
|
|
74
67
|
|
|
75
|
-
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
68
|
+
- 判断基準は、各行から根拠・判定条件・逸脱対応・責任・証跡を一続きで追跡できることです。標準列は次のとおりとし、行の結合 ID から一意に辿れる場合は列を統合できます。文書全体への参照だけで済ませません。
|
|
69
|
+
|
|
70
|
+
| 列 | 内容 |
|
|
71
|
+
| ---------- | --------------------------------------------- |
|
|
72
|
+
| 管理対象 | 追跡単位 |
|
|
73
|
+
| 根拠 | 価値・リスクの文書 ID と該当箇所または条件 ID |
|
|
74
|
+
| 基準・上限 | 適合・逸脱の判定条件 |
|
|
75
|
+
| 確認契機 | 観測時点 |
|
|
76
|
+
| 逸脱時対応 | 次の行動 |
|
|
77
|
+
| 責任 | 担当 Role code |
|
|
78
|
+
| 証跡・正本 | 記録先と記録の識別方法 |
|
|
79
|
+
|
|
80
|
+
- スコープ、Schedule、費用・負荷、品質、課題・リスク・変更から適用対象を選びます。現金支出、準備・開発の作業時間、日常操作・保守の継続運用負荷は別の行または基準・記録で管理し、負荷転嫁を削減とみなしません。
|
|
81
|
+
- 構成管理は対象版・承認済み基準・変更履歴の識別方法、確認者、記録先を示します。技術管理は技術制約・外部依存の変更検知契機、影響確認・判断を担う Role code、記録先を示します。個別方針へ委譲しても行から確認・対応を追跡できるようにします。
|
|
79
82
|
- 良い例: 「継続運用負荷」の根拠を成功基準文書の SC-03、基準を同条件の上限内、確認契機を試行中の営業日、超過時対応を `PM` による手順縮小案の起案、証跡を SC-03・確認日・確認者で識別する操作時間記録とします。数値・測定手順の正本は成功基準に残します。
|
|
80
83
|
- 悪い例: 「参加者の時間を無理のない範囲にし、必要に応じて確認する」。準備時間と日常負荷が混ざり、根拠、判定条件、証跡を照合できません。
|
|
81
84
|
|
|
82
85
|
### 6.3. 判断ゲートとエスカレーション
|
|
83
86
|
|
|
84
|
-
-
|
|
87
|
+
- 判断基準は、条件 ID、材料、最終判断者、判定記録が結び付き、未達と材料不足を合格扱いにしないことです。
|
|
85
88
|
- 成功基準・受入条件を複製せず、文書 ID と条件 ID を参照します。是正・再判定、保留・停止、例外判断を求める条件を定め、例外は上位の受入方針で認める範囲に限ります。
|
|
86
|
-
- 良い例:
|
|
89
|
+
- 良い例: 「初期受入は成功基準の SC-01 と AC-01〜AC-04 を必須とし、未達・証跡不足なら保留する。是正後に `QE` が再確認結果を整理し、判断ゲートの最終判断者が条件 ID ごとの結果と判定を記録する」。
|
|
87
90
|
- 悪い例: 「初期成功基準を満たしたら公開し、問題があれば必要に応じて相談する」。参照条件、不足時の処理、判断者を特定できません。
|
|
88
91
|
|
|
89
92
|
### 6.4. 正本・報告・見直し
|
|
90
93
|
|
|
91
94
|
- 判断基準は、情報ごとの更新先と確認者が一意に分かり、見直し時の追従作業をタスク化できることです。正本が未整備なら、整備時期・担当または省略理由と責任を確認する代替先を示します。
|
|
92
|
-
- Schedule
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
+
- Schedule と責任の正本を接続し、作業担当だけで判断責任を代替しません。RACI の採用・省略条件は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
|
|
96
|
+
- 判断・逸脱・作業節目の報告契機と確認者を定め、品質・コミュニケーションの詳細は各計画を参照します。
|
|
97
|
+
- 目的、スコープ、成功基準、体制、外部条件の変更時は、影響する個別計画・RACI・Schedule・証跡と担当 Role code を特定し、更新順序・期限・確認担当を追従タスクにします。
|
|
95
98
|
- 良い例: 「承認担当の交代時は、`PM` が RACI・メンバー定義・Schedule の影響箇所を特定し、更新担当と期限を設定する。`QE` が判断ゲートの最終判断者との整合を確認する」。
|
|
96
99
|
- 悪い例: 「担当は Schedule を参照し、変更時は関係文書を見直す」。成果物責任の正本、更新先、確認担当が不明です。
|
|
97
100
|
|
|
98
101
|
### 6.5. 未決事項
|
|
99
102
|
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
- 悪い例: 「費用・時間上限は後で決める」。未決状態、期限、判断者、未決の間の扱いを確認できません。
|
|
103
|
+
- 判断基準は、未決の論点と影響を示し、未決の上限や担当を確定済みとして着手・判定しないことです。他文書に正本があれば該当論点を参照します。
|
|
104
|
+
- 良い例: 「`_UNDECIDED_:` 試行準備の作業時間上限。未決中は着手を保留し、決定後に費用・負荷の管理行と準備着手ゲートへ反映する」。
|
|
105
|
+
- 悪い例: 「費用・時間上限は後で決める」。当面の扱いと変更先が不明です。
|
|
104
106
|
|
|
105
107
|
## 7. 禁止事項
|
|
106
108
|
|
|
107
|
-
| 禁止事項 | 理由
|
|
108
|
-
| ------------------------------------------------------ |
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
| 成功基準を本文へ複製する | 判定条件の正本が分散するため |
|
|
113
|
-
| Agent に例外、公開、GO / Not GO の最終判断を委ねる | 人間の説明責任を代替するため |
|
|
114
|
-
| 個人情報、認証情報、秘密情報、実装詳細を記載する | 公開適性と文書責務に反するため |
|
|
109
|
+
| 禁止事項 | 理由 |
|
|
110
|
+
| ------------------------------------------------------ | ---------------------------- |
|
|
111
|
+
| 管理対象を網羅目的で増やし、基準や逸脱時対応を置かない | 実行時の判断に使えないため |
|
|
112
|
+
| 現金支出だけを費用とし、人の作業・運用負荷を除外する | 負荷転嫁を見逃すため |
|
|
113
|
+
| 成功基準を本文へ複製する | 判定条件の正本が分散するため |
|