specdojo 0.4.7 → 0.5.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 +14 -9
- package/CHANGELOG.md +46 -0
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/core.js +2 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +3 -2
- package/dist/exec/plans-generation.js +9 -5
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/register.js +16 -1
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +22 -0
- package/dist/exec/run/register-worktree.js +23 -0
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/grade/apply.js +6 -2
- package/dist/grade/markdown.js +7 -2
- package/dist/grade/plan.js +6 -4
- package/dist/register/approach.js +19 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +3 -0
- package/dist/register/create-commands.js +34 -4
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +10 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +42 -4
- package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +50 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +14 -9
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-integrity-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-integrity-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Integrity Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-integrity`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 完全性
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-integrity` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 完全性 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -122,7 +123,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
122
123
|
```yaml
|
|
123
124
|
---
|
|
124
125
|
id: nfr-integrity
|
|
125
|
-
type:
|
|
126
|
+
type: requirement
|
|
126
127
|
title: 非機能要件: 完全性
|
|
127
128
|
status: draft
|
|
128
129
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-maintainability-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-maintainability-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Maintainability Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-maintainability`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 保守性
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-maintainability` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 保守性 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -122,7 +123,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
122
123
|
```yaml
|
|
123
124
|
---
|
|
124
125
|
id: nfr-maintainability
|
|
125
|
-
type:
|
|
126
|
+
type: requirement
|
|
126
127
|
title: 非機能要件: 保守性
|
|
127
128
|
status: draft
|
|
128
129
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-operations-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-operations-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Operations Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-operations`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 運用
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-operations` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 運用 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -122,7 +123,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
122
123
|
```yaml
|
|
123
124
|
---
|
|
124
125
|
id: nfr-operations
|
|
125
|
-
type:
|
|
126
|
+
type: requirement
|
|
126
127
|
title: 非機能要件: 運用
|
|
127
128
|
status: draft
|
|
128
129
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-performance-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-performance-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Performance Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-performance`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 性能
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-performance` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 性能 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -123,7 +124,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
123
124
|
```yaml
|
|
124
125
|
---
|
|
125
126
|
id: nfr-performance
|
|
126
|
-
type:
|
|
127
|
+
type: requirement
|
|
127
128
|
title: 非機能要件: 性能
|
|
128
129
|
status: draft
|
|
129
130
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-reliability-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-reliability-sample
|
|
@@ -50,14 +51,14 @@ Non-Functional Requirements Reliability Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| -------- |
|
|
55
|
-
| id | `nfr-reliability`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 信頼性
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
60
|
-
| based_on | 根拠仕様ID
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| -------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-reliability` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 信頼性 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
61
|
+
| based_on | 根拠仕様ID | 任意 |
|
|
61
62
|
|
|
62
63
|
### 4.2. 推奨ルール
|
|
63
64
|
|
|
@@ -124,7 +125,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
124
125
|
```yaml
|
|
125
126
|
---
|
|
126
127
|
id: nfr-reliability
|
|
127
|
-
type:
|
|
128
|
+
type: requirement
|
|
128
129
|
title: 非機能要件: 信頼性
|
|
129
130
|
status: draft
|
|
130
131
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-security-safety-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-security-safety-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Security and Safety Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-security-safety`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 機密性・安全性
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-security-safety` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 機密性・安全性 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -123,7 +124,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
123
124
|
```yaml
|
|
124
125
|
---
|
|
125
126
|
id: nfr-security-safety
|
|
126
|
-
type:
|
|
127
|
+
type: requirement
|
|
127
128
|
title: 非機能要件: 機密性・安全性
|
|
128
129
|
status: draft
|
|
129
130
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:nfr-usability-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: requirement
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:nfr-usability-sample
|
|
@@ -50,13 +51,13 @@ Non-Functional Requirements Usability Documentation Rules
|
|
|
50
51
|
|
|
51
52
|
Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
|
|
52
53
|
|
|
53
|
-
| 項目 | 説明
|
|
54
|
-
| ------- |
|
|
55
|
-
| id | `nfr-usability`
|
|
56
|
-
| type | `
|
|
57
|
-
| title | 非機能要件: 操作性
|
|
58
|
-
| status | `draft` / `ready` / `deprecated`
|
|
59
|
-
| part_of | `nfr-index`
|
|
54
|
+
| 項目 | 説明 | 必須 |
|
|
55
|
+
| ------- | -------------------------------- | ---- |
|
|
56
|
+
| id | `nfr-usability` | ○ |
|
|
57
|
+
| type | `requirement` 固定 | ○ |
|
|
58
|
+
| title | 非機能要件: 操作性 | ○ |
|
|
59
|
+
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
60
|
+
| part_of | `nfr-index` | 任意 |
|
|
60
61
|
|
|
61
62
|
### 4.2. 推奨ルール
|
|
62
63
|
|
|
@@ -123,7 +124,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
123
124
|
```yaml
|
|
124
125
|
---
|
|
125
126
|
id: nfr-usability
|
|
126
|
-
type:
|
|
127
|
+
type: requirement
|
|
127
128
|
title: 非機能要件: 操作性
|
|
128
129
|
status: draft
|
|
129
130
|
part_of: [nfr-index]
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:ntp-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: test
|
|
5
6
|
status: draft
|
|
6
7
|
sample: specdojo:ntp-sample
|
|
7
8
|
---
|
|
@@ -30,12 +31,12 @@ Migration Test Plan Documentation Rules
|
|
|
30
31
|
|
|
31
32
|
## 4. 推奨 Frontmatter 項目
|
|
32
33
|
|
|
33
|
-
| 項目 | 値
|
|
34
|
-
| -------- |
|
|
35
|
-
| id | 一意なID
|
|
36
|
-
| type |
|
|
37
|
-
| status | draft / ready / deprecated
|
|
38
|
-
| rulebook | `ntp-rulebook`
|
|
34
|
+
| 項目 | 値 | 必須 |
|
|
35
|
+
| -------- | -------------------------- | ---- |
|
|
36
|
+
| id | 一意なID | ○ |
|
|
37
|
+
| type | `test` 固定 | ○ |
|
|
38
|
+
| status | draft / ready / deprecated | ○ |
|
|
39
|
+
| rulebook | `ntp-rulebook` | 任意 |
|
|
39
40
|
|
|
40
41
|
## 5. 本文構成(標準テンプレ)
|
|
41
42
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:otp-index-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: operations
|
|
5
6
|
status: draft
|
|
6
7
|
recipe: undecided
|
|
7
8
|
sample: specdojo:otp-index-sample
|
|
@@ -40,7 +41,7 @@ Operations Transition Plan Documentation Rules
|
|
|
40
41
|
|
|
41
42
|
| id | `otp-index` | ○ |
|
|
42
43
|
|
|
43
|
-
| type | `
|
|
44
|
+
| type | `operations` 固定 | ○ |
|
|
44
45
|
| title | `運用切替計画: 全体` | ○ |
|
|
45
46
|
|
|
46
47
|
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:otp-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: operations
|
|
5
6
|
status: draft
|
|
6
7
|
sample: specdojo:otp-sample
|
|
7
8
|
---
|
|
@@ -56,7 +57,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
|
|
|
56
57
|
| 項目 | 説明 | 必須 |
|
|
57
58
|
| ---------- | -------------------------------------------- | ---- |
|
|
58
59
|
| id | OTP ID(`otp-<term>`) | ○ |
|
|
59
|
-
| type | `
|
|
60
|
+
| type | `operations` 固定 | ○ |
|
|
60
61
|
| title | 運用切替計画: <対象名> | ○ |
|
|
61
62
|
| status | `draft` / `ready` / `deprecated` | ○ |
|
|
62
63
|
| based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:pjr-rulebook
|
|
4
4
|
type: rulebook
|
|
5
|
+
deliverable_type: project
|
|
5
6
|
status: ready
|
|
6
7
|
target_format: markdown
|
|
7
8
|
recipe: not-needed
|
|
@@ -21,7 +22,7 @@ Project Register Documentation Rules
|
|
|
21
22
|
|
|
22
23
|
## 1. 全体方針
|
|
23
24
|
|
|
24
|
-
- TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘の全登録項目は、それぞれ 1 件の個票を持つ。
|
|
25
|
+
- epic、TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘の全登録項目は、それぞれ 1 件の個票を持つ。
|
|
25
26
|
- 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論、起票元の唯一の正本である。
|
|
26
27
|
- `events/pjr-XXXX.yaml` は、起票・状態遷移・更新を追う監査履歴の正本である。現在値の再計算には使わず、個票の現在値との整合を検証する。
|
|
27
28
|
- 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
|
|
@@ -55,34 +56,41 @@ Project Register Documentation Rules
|
|
|
55
56
|
|
|
56
57
|
個票には `register-item-frontmatter.schema.yaml` が定義する次の項目を置く。未定の担当、期限、完了日時、結論は表用のプレースホルダを保存せず、該当キーを省略する(期限なしだけは `due_on: null`)。
|
|
57
58
|
|
|
58
|
-
| 項目 | 説明 | 必須
|
|
59
|
-
| ----------------- | ------------------------------------------------ |
|
|
60
|
-
| `id` | `<project-id>:pjr-XXXX-<topic>` | ○
|
|
61
|
-
| `type` | `project` | ○
|
|
62
|
-
| `status` | 文書成熟度。`draft` / `ready` / `deprecated` | ○
|
|
63
|
-
| `rulebook` | `specdojo:pjr-rulebook` | ○
|
|
64
|
-
| `part_of` | `<project-id>:pjr-index` を要素に持つ配列 | ○
|
|
65
|
-
| `item_type` | 登録項目の分類 | ○
|
|
66
|
-
| `
|
|
67
|
-
| `
|
|
68
|
-
| `
|
|
69
|
-
| `
|
|
70
|
-
| `
|
|
71
|
-
| `
|
|
72
|
-
| `
|
|
73
|
-
| `
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
| `
|
|
78
|
-
| `
|
|
79
|
-
| `
|
|
80
|
-
|
|
59
|
+
| 項目 | 説明 | 必須 |
|
|
60
|
+
| ----------------- | ------------------------------------------------ | ----------- |
|
|
61
|
+
| `id` | `<project-id>:pjr-XXXX-<topic>` | ○ |
|
|
62
|
+
| `type` | `project` | ○ |
|
|
63
|
+
| `status` | 文書成熟度。`draft` / `ready` / `deprecated` | ○ |
|
|
64
|
+
| `rulebook` | `specdojo:pjr-rulebook` | ○ |
|
|
65
|
+
| `part_of` | `<project-id>:pjr-index` を要素に持つ配列 | ○ |
|
|
66
|
+
| `item_type` | 登録項目の分類 | ○ |
|
|
67
|
+
| `track` | epic が担う track。ほかの type では指定しない | epic で必須 |
|
|
68
|
+
| `item_status` | 登録項目の処理状態 | ○ |
|
|
69
|
+
| `priority` | 対応優先度 | ○ |
|
|
70
|
+
| `difficulty` | agent 振り分け用の作業難易度 | 任意 |
|
|
71
|
+
| `owner` | 主担当者または役割 | 任意 |
|
|
72
|
+
| `registered_at` | 起票日時 | 任意 |
|
|
73
|
+
| `due_on` | 対応期限または判断期限 | 任意 |
|
|
74
|
+
| `completed_at` | 完了・却下・決定日時 | 条件 |
|
|
75
|
+
| `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
|
|
76
|
+
| `conclusion` | 終端時の結論要約 | 任意 |
|
|
77
|
+
| `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
|
|
78
|
+
| `depends_on` | 実行前に完了しているべき先行の登録項目 ID の配列 | 任意 |
|
|
79
|
+
| `approach` | 対象を作成・修正するときの進め方 | 任意 |
|
|
80
|
+
| `target_path` | カタログなしで作成する成果物のリポジトリ相対パス | 任意 |
|
|
81
|
+
| `target_rulebook` | 対象成果物の rulebook ID | 任意 |
|
|
82
|
+
| `targets` | 変更対象文書の doc id リスト | 任意 |
|
|
83
|
+
|
|
84
|
+
- `epic` は track ごとの大きな仕事を表し、自身は実行しない。`track` は英小文字・数字・ハイフンの識別子とし、先頭は英小文字または数字にする。`tml-index.yaml` がある場合、定義済みの track を指定する。ない場合も識別子を保持できる。
|
|
85
|
+
- `register add --type epic --track <track>` で起票し、`register update --track <track>` で変更する。epic の `track` は削除できない。変更はイベントに残す。
|
|
81
86
|
- `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
|
|
82
87
|
- `item_type`、`item_status`、`priority`、`difficulty` の値は schema の enum だけを使用する。`difficulty` は `hard` / `medium` / `easy` のいずれかとし、省略時は従来の agent 自動選択を使う。
|
|
83
88
|
- `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
|
|
84
89
|
- Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
|
|
85
|
-
- `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX`
|
|
90
|
+
- `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。未設定の project は拒否する。別 project の存在確認は、その project のローカル統合ブランチを正とする。
|
|
91
|
+
- `depends_on` は実行順序、`derived_from` は起票の由来を表す。両者を相互に推測・転記しない。参照書式と別 project の存在確認は `derived_from` と同じ規則を使い、存在しない ID、自己参照、project をまたぐ循環を記帳前と `register build` で拒否する。
|
|
92
|
+
- `register add` / `update` の `--depends-on <ID>` は反復指定でき、一覧を置換する。`--depends-on -` は依存を削除し、ほかの ID と併用しない。変更は event に記録する。
|
|
93
|
+
- すべての先行項目が `done` / `decided` のときだけ実行を許可する。`rejected` / `deferred` は依存を満たさない。直接の `exec run --register` は未完了の先行 ID と状態を示して停止し、routine の sweep(`--register-filter`)と夜間 queue は理由を記録して対象を飛ばす。依存を理由に状態を自動で `waiting` へ変更しない。
|
|
86
94
|
|
|
87
95
|
### 3.1. 日時と日付の使い分け
|
|
88
96
|
|
|
@@ -109,22 +117,26 @@ Project Register Documentation Rules
|
|
|
109
117
|
| 末尾 | 関連ドキュメント | ○ | 根拠、影響先、追跡先を文書 ID で示す |
|
|
110
118
|
|
|
111
119
|
- H1 は `PJR-XXXX <タイトル>` 形式とする。
|
|
120
|
+
- `epic` は概要、範囲(track と domain)、完了の判断の基準、子項目、対応結果、関連ドキュメントを持つ。範囲には domain と境界、完了の基準には子項目と schedule を確認する判断条件、対応結果には人が完了を判断した根拠を記録する。
|
|
121
|
+
- 子 todo は `--from <epic-id>` で起票する。`derived_from` を逆引きした epic 別ビューは直接の子を type と状態付きで表示し、子がない epic も表示する。別 project の子は project 修飾 ID で識別する。孫を再帰的に含めず、状態の自動集約や自動 close は行わない。
|
|
112
122
|
- type 固有の構成は `todo` の概要・完了条件・作業内容・対応結果など、各 type 用テンプレートに従う。
|
|
113
123
|
- ID、分類、処理状態、優先度、担当、期限、完了日時は本文へ重複記載せず、Frontmatter を参照する。
|
|
114
124
|
- 終端前に未確定の結果・結論がある場合は、`-` または共通ラベルを用い、確定済みの記述と混在させない。
|
|
115
125
|
|
|
116
126
|
### 4.2. 生成一覧と派生ビュー
|
|
117
127
|
|
|
118
|
-
| 生成物 | 内容
|
|
119
|
-
| ------------------------------------ |
|
|
120
|
-
| `generated/pjr-index.md` |
|
|
121
|
-
| `generated/pjr-views-by-status.md` | 状態別の補助一覧
|
|
122
|
-
| `generated/pjr-views-by-priority.md` | 優先度別の補助一覧
|
|
123
|
-
| `generated/pjr-views-by-owner.md` | 担当者別の補助一覧
|
|
124
|
-
| `generated/pjr-derived-items.md` | 元項目と派生先の一覧
|
|
125
|
-
| `
|
|
126
|
-
|
|
127
|
-
|
|
128
|
+
| 生成物 | 内容 | 編集可否 |
|
|
129
|
+
| ------------------------------------ | ------------------------------------ | -------- |
|
|
130
|
+
| `generated/pjr-index.md` | `depends_on` を含む全個票の一覧 | 不可 |
|
|
131
|
+
| `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
|
|
132
|
+
| `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
|
|
133
|
+
| `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
|
|
134
|
+
| `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
|
|
135
|
+
| `generated/pjr-epic-items.md` | epic ごとの直接の子項目と状態 | 不可 |
|
|
136
|
+
| `generated/pjr-dependent-items.md` | 先行項目から後続項目を逆引きする一覧 | 不可 |
|
|
137
|
+
| `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
|
|
138
|
+
|
|
139
|
+
- 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票、`depends_on` とする。
|
|
128
140
|
- タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。
|
|
129
141
|
- 登録日と完了日の列は、`registered_at` / `completed_at` をプロジェクトの登録日タイムゾーンへ変換した暦日として生成する。
|
|
130
142
|
- 生成ビューに独自の詳細情報や手作業の修正を追加しない。修正は個票に行い、`register build` を再実行する。
|
|
@@ -166,6 +178,7 @@ Project Register Documentation Rules
|
|
|
166
178
|
|
|
167
179
|
| `item_type` | 通常終端 | 遷移条件 | `conclusion` に残す内容 |
|
|
168
180
|
| ---------------- | --------- | ---------------------------------------------------------------------- | ---------------------------- |
|
|
181
|
+
| `epic` | `done` | 子項目と schedule を材料に、track の完了基準を満たすと人が判断した | 判断の根拠と残課題 |
|
|
169
182
|
| `todo` | `done` | 個票に記載した完了条件をすべて満たした | 実施内容と完了を確認した根拠 |
|
|
170
183
|
| `question` | `decided` | 問いへの回答を確認し、後続作業の要否を判断できる | 確定した回答 |
|
|
171
184
|
| `decision` | `decided` | 選択肢、採択理由、影響を記録し、必要な承認を得た | 決定内容 |
|
|
@@ -175,7 +188,8 @@ Project Register Documentation Rules
|
|
|
175
188
|
| `change-request` | `done` | 採択した変更を対象へ反映し、必要な確認を終えた | 反映内容と確認結果 |
|
|
176
189
|
|
|
177
190
|
- `question` / `decision` の通常終端に `done` を使わず、回答・決定が確定したことを示す `decided` を使う。
|
|
178
|
-
- `todo` / `risk` / `issue` / `change-request` の通常終端に `decided` を使わず、対応または追跡が完了したことを示す `done` を使う。
|
|
191
|
+
- `epic` / `todo` / `risk` / `issue` / `change-request` の通常終端に `decided` を使わず、対応または追跡が完了したことを示す `done` を使う。
|
|
192
|
+
- `epic` は todo と同じ処理状態と例外終端(`rejected` / `deferred`)を使用する。`exec run --register` の実行対象にはせず、filter と夜間 queue も飛ばす。具体的な作業は子 todo で実行する。
|
|
179
193
|
- `note` の `open` は未対応を意味しない。内容を継続して更新できる、生きている記録であることを示す。
|
|
180
194
|
- `note` から対応・回答・判断が必要になった場合は、`todo` / `question` / `decision` など目的に合う別項目を起票し、note 自体は `open` のまま参照元として保持する。
|
|
181
195
|
- `note` の内容が陳腐化または置換された場合は、その事実と参照先を本文へ追記する。`done` / `decided` / `rejected` / `deferred` へ遷移させて閉じない。
|