specdojo 0.4.7 → 0.6.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 +16 -9
- package/CHANGELOG.md +106 -0
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/init.js +4 -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/deliverable/deliverable.js +77 -4
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/core.js +3 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +49 -3
- package/dist/exec/plans-generation.js +48 -8
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +6 -2
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register.js +22 -1
- package/dist/exec/repo-integration-sync.js +11 -0
- package/dist/exec/repo-integration.js +58 -6
- package/dist/exec/repo-trace.js +19 -4
- package/dist/exec/results.js +11 -5
- package/dist/exec/run/register-command.js +16 -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 +33 -1
- package/dist/exec/run/register-worktree.js +52 -8
- package/dist/exec/run/schedule-prepare.js +7 -3
- package/dist/exec/strategy.js +4 -1
- package/dist/exec/task-repos.js +92 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree.js +3 -3
- 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 +8 -0
- package/dist/register/create-commands.js +86 -4
- package/dist/register/deliverable-target.js +24 -17
- 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 +9 -2
- package/dist/register/events.js +10 -0
- package/dist/register/external-project.js +6 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +71 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +7 -3
- package/dist/register/renumber.js +16 -4
- package/dist/register/update.js +6 -0
- package/dist/register/views.js +55 -4
- package/dist/schedule/approach.js +9 -0
- 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 +22 -2
- package/dist/shared/agent-types.js +7 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -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 +42 -4
- 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-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- 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-config-guide.md +3 -1
- package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
- 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 +58 -16
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
- 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/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
- package/docs/ja/specdojo/references/command-reference.md +86 -15
- package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -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 +9 -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 +54 -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 +4 -1
- 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/dct-sample.yaml +5 -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 +44 -3
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- 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/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- 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 +21 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
- package/package.json +4 -3
- package/templates/antigravity/orchestrator.md +16 -9
- package/templates/claude/agents/specdojo-orchestrator.md +16 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
- package/templates/codex/orchestrator.md +16 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
- package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
$schema: "https://json-schema.org/draft/2020-12/schema"
|
|
2
2
|
title: Deliverables Front Matter
|
|
3
|
+
$defs:
|
|
4
|
+
deliverableType:
|
|
5
|
+
type: string
|
|
6
|
+
enum:
|
|
7
|
+
- project # プロジェクトの管理文書
|
|
8
|
+
- requirement # システム機能・非機能要件・受入基準
|
|
9
|
+
- glossary # 用語集
|
|
10
|
+
- flow # 業務フロー・プロセス仕様
|
|
11
|
+
- rule # 業務ルール仕様
|
|
12
|
+
- data # データ仕様
|
|
13
|
+
- ui # 画面・帳票仕様
|
|
14
|
+
- api # API・外部 I/F 仕様
|
|
15
|
+
- architecture # アーキテクチャ設計
|
|
16
|
+
- test # テスト仕様・設計
|
|
17
|
+
- operations # 運用設計・手順
|
|
3
18
|
# SpecDojo が所有する frontmatter は `specdojo:` 名前空間配下に置く。
|
|
4
19
|
# トップレベルは第三者ツール(VitePress 等)のキーを許容するため制限しない。
|
|
5
20
|
type: object
|
|
@@ -16,22 +31,12 @@ properties:
|
|
|
16
31
|
- rulebook
|
|
17
32
|
properties:
|
|
18
33
|
type:
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
- project # プロジェクト文書全般
|
|
26
|
-
# プロダクト仕様文書
|
|
27
|
-
- flow # 業務フロー・プロセス仕様
|
|
28
|
-
- rule # 業務ルール仕様
|
|
29
|
-
- data # データ仕様
|
|
30
|
-
- ui # 画面・帳票仕様
|
|
31
|
-
- api # API・外部I/F仕様
|
|
32
|
-
- architecture # アーキテクチャ設計
|
|
33
|
-
- test # テスト仕様・設計
|
|
34
|
-
- operations # 運用設計・手順
|
|
34
|
+
anyOf:
|
|
35
|
+
- $ref: "#/$defs/deliverableType"
|
|
36
|
+
- type: string
|
|
37
|
+
enum:
|
|
38
|
+
- template # テンプレート自身のメタ情報
|
|
39
|
+
- sample # 非推奨。rulebook を持つ sample は宣言された成果物 type に移行する。
|
|
35
40
|
description: "仕様の種別(rulebook/guide/standard は各専用スキーマを使用)"
|
|
36
41
|
rulebook:
|
|
37
42
|
$ref: "./common-frontmatter.schema.yaml#/$defs/rulebookRef"
|
|
@@ -60,6 +65,9 @@ properties:
|
|
|
60
65
|
item_type:
|
|
61
66
|
$ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
|
|
62
67
|
description: "プロジェクト登録項目の種別。pjr-*-template で使用する。"
|
|
68
|
+
track:
|
|
69
|
+
$ref: "./register-item-frontmatter.schema.yaml#/$defs/Track"
|
|
70
|
+
description: "epic が担う track。定義の検証は register コマンドが行う。"
|
|
63
71
|
item_status:
|
|
64
72
|
$ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemStatus"
|
|
65
73
|
description: "登録項目の処理状態。文書成熟度の status とは別の状態軸。"
|
|
@@ -48,10 +48,13 @@ $defs:
|
|
|
48
48
|
type: string
|
|
49
49
|
enum:
|
|
50
50
|
[
|
|
51
|
+
"draft",
|
|
51
52
|
"fully-guided",
|
|
52
53
|
"recipe-guided",
|
|
53
54
|
"freeform",
|
|
54
55
|
"bootstrap",
|
|
56
|
+
"catalog-planning",
|
|
57
|
+
"strategy-planning",
|
|
55
58
|
"rulebook-authoring",
|
|
56
59
|
"recipe-authoring",
|
|
57
60
|
"sample-authoring",
|
|
@@ -66,7 +69,8 @@ $defs:
|
|
|
66
69
|
"bootstrap-finalize",
|
|
67
70
|
]
|
|
68
71
|
description: >
|
|
69
|
-
How the task is carried out.
|
|
72
|
+
How the task is carried out. catalog-planning and strategy-planning create a catalog
|
|
73
|
+
or schedule strategy from register-only domain:<id> / track:<id> targets. draft researches and drafts within delegated context; fully-guided refines existing deliverables using declared references. fully-guided/recipe-guided/freeform describe how strictly
|
|
70
74
|
the agent follows reference materials (rulebook/recipe/sample/template) when working on
|
|
71
75
|
a deliverable. bootstrap authors the deliverable and its full reference set
|
|
72
76
|
(rulebook/recipe/sample/template) together in one task as a mutually consistent whole;
|
|
@@ -110,7 +110,7 @@ properties:
|
|
|
110
110
|
minLength: 1
|
|
111
111
|
minItems: 1
|
|
112
112
|
description: >
|
|
113
|
-
|
|
113
|
+
Document IDs, or domain:<id> / track:<id> for register planning approaches. Existing documents are resolvable via the
|
|
114
114
|
doc index. For deliverable work, the first entry is the target deliverable and subsequent
|
|
115
115
|
entries are reference materials the approach may modify or confirm. For *-authoring
|
|
116
116
|
register tasks, the entry is an intentionally not-yet-existing kata id; read-only
|
|
@@ -4,10 +4,18 @@ type: object
|
|
|
4
4
|
additionalProperties: false
|
|
5
5
|
required:
|
|
6
6
|
- id
|
|
7
|
+
- type
|
|
8
|
+
- rulebook
|
|
7
9
|
- title
|
|
8
10
|
- locale
|
|
9
11
|
- terms
|
|
10
12
|
properties:
|
|
13
|
+
type:
|
|
14
|
+
type: string
|
|
15
|
+
const: glossary
|
|
16
|
+
rulebook:
|
|
17
|
+
type: string
|
|
18
|
+
pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
|
|
11
19
|
id:
|
|
12
20
|
type: string
|
|
13
21
|
pattern: "^([a-z0-9-]+:)?gl-[a-z0-9-]+$"
|
|
@@ -26,7 +26,7 @@ properties:
|
|
|
26
26
|
minLength: 1
|
|
27
27
|
type:
|
|
28
28
|
type: string
|
|
29
|
-
enum: ["
|
|
29
|
+
enum: ["api", "template"]
|
|
30
30
|
status:
|
|
31
31
|
type: string
|
|
32
32
|
enum: ["draft", "ready", "deprecated"]
|
|
@@ -46,6 +46,10 @@ properties:
|
|
|
46
46
|
metadata_template:
|
|
47
47
|
type: object
|
|
48
48
|
additionalProperties: true
|
|
49
|
+
properties:
|
|
50
|
+
type:
|
|
51
|
+
type: string
|
|
52
|
+
const: api
|
|
49
53
|
|
|
50
54
|
command:
|
|
51
55
|
type: object
|
|
@@ -81,8 +81,9 @@ $defs:
|
|
|
81
81
|
required: [status, commit, merged_at]
|
|
82
82
|
properties:
|
|
83
83
|
status:
|
|
84
|
+
# branch-only is successful handling without a merge; commit and merged_at stay null.
|
|
84
85
|
type: string
|
|
85
|
-
enum: [pending, merged, unchanged, failed]
|
|
86
|
+
enum: [pending, merged, unchanged, branch-only, failed]
|
|
86
87
|
# Merge commit on the integration target. Null for the project repository (the merge commit
|
|
87
88
|
# contains this state) and for repositories that are not merged.
|
|
88
89
|
commit:
|
|
@@ -33,6 +33,22 @@ $defs:
|
|
|
33
33
|
- migrate
|
|
34
34
|
|
|
35
35
|
RegisterEventChange:
|
|
36
|
+
allOf:
|
|
37
|
+
- if:
|
|
38
|
+
required: [field]
|
|
39
|
+
properties:
|
|
40
|
+
field:
|
|
41
|
+
const: type
|
|
42
|
+
then:
|
|
43
|
+
properties:
|
|
44
|
+
from:
|
|
45
|
+
anyOf:
|
|
46
|
+
- $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
|
|
47
|
+
- enum: ["", "-", "_TODO_"]
|
|
48
|
+
to:
|
|
49
|
+
anyOf:
|
|
50
|
+
- $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
|
|
51
|
+
- enum: ["", "-", "_TODO_"]
|
|
36
52
|
type: object
|
|
37
53
|
additionalProperties: false
|
|
38
54
|
required:
|
|
@@ -47,7 +63,9 @@ $defs:
|
|
|
47
63
|
- status
|
|
48
64
|
- title
|
|
49
65
|
- description
|
|
66
|
+
- input
|
|
50
67
|
- type
|
|
68
|
+
- track
|
|
51
69
|
- priority
|
|
52
70
|
- difficulty
|
|
53
71
|
- owner
|
|
@@ -62,7 +80,10 @@ $defs:
|
|
|
62
80
|
- target_path
|
|
63
81
|
- target_rulebook
|
|
64
82
|
- derived_from
|
|
83
|
+
- depends_on
|
|
65
84
|
- autopilot
|
|
85
|
+
- commit_type
|
|
86
|
+
- commit_scope
|
|
66
87
|
from:
|
|
67
88
|
type: string
|
|
68
89
|
to:
|
|
@@ -99,6 +99,7 @@ properties:
|
|
|
99
99
|
approach:
|
|
100
100
|
enum:
|
|
101
101
|
[
|
|
102
|
+
draft,
|
|
102
103
|
fully-guided,
|
|
103
104
|
recipe-guided,
|
|
104
105
|
freeform,
|
|
@@ -107,6 +108,18 @@ properties:
|
|
|
107
108
|
finalize,
|
|
108
109
|
bootstrap-finalize,
|
|
109
110
|
]
|
|
111
|
+
- if:
|
|
112
|
+
required: [item_type]
|
|
113
|
+
properties:
|
|
114
|
+
item_type:
|
|
115
|
+
const: epic
|
|
116
|
+
then:
|
|
117
|
+
required: [track]
|
|
118
|
+
properties:
|
|
119
|
+
track: true
|
|
120
|
+
else:
|
|
121
|
+
properties:
|
|
122
|
+
track: false
|
|
110
123
|
- type: object
|
|
111
124
|
required:
|
|
112
125
|
- rulebook
|
|
@@ -150,6 +163,10 @@ properties:
|
|
|
150
163
|
$ref: "#/$defs/ItemType"
|
|
151
164
|
description: "Classification of the register item (list column: 分類)."
|
|
152
165
|
|
|
166
|
+
track:
|
|
167
|
+
$ref: "#/$defs/Track"
|
|
168
|
+
description: "Track governed by this epic; checked against tml-index.yaml when present."
|
|
169
|
+
|
|
153
170
|
item_status:
|
|
154
171
|
$ref: "#/$defs/ItemStatus"
|
|
155
172
|
description: "Processing status of the item (list column: ステータス)."
|
|
@@ -226,6 +243,19 @@ properties:
|
|
|
226
243
|
same project and <project-id>:PJR-XXXX for an item in another project. Omit the key
|
|
227
244
|
when the item was not derived from another register item.
|
|
228
245
|
|
|
246
|
+
depends_on:
|
|
247
|
+
type: array
|
|
248
|
+
items:
|
|
249
|
+
oneOf:
|
|
250
|
+
- $ref: "#/$defs/LocalRegisterItemRef"
|
|
251
|
+
- $ref: "#/$defs/QualifiedRegisterItemRef"
|
|
252
|
+
minItems: 1
|
|
253
|
+
uniqueItems: true
|
|
254
|
+
description: >
|
|
255
|
+
Predecessor register item IDs. Execution requires every predecessor to be done or
|
|
256
|
+
decided; rejected and deferred do not satisfy a dependency. References use the
|
|
257
|
+
same local or project-qualified syntax as derived_from. Cycles are forbidden.
|
|
258
|
+
|
|
229
259
|
autopilot:
|
|
230
260
|
type: string
|
|
231
261
|
const: approved
|
|
@@ -233,12 +263,25 @@ properties:
|
|
|
233
263
|
Human approval that the item's stated completion conditions may be executed by the
|
|
234
264
|
night orchestrator. Omit the key to keep the item out of the approved queue.
|
|
235
265
|
|
|
266
|
+
commit_type:
|
|
267
|
+
$ref: "#/$defs/CommitType"
|
|
268
|
+
description: >
|
|
269
|
+
Conventional Commits type for commits generated from this item.
|
|
270
|
+
Omit the key to derive it from item_type and configuration.
|
|
271
|
+
|
|
272
|
+
commit_scope:
|
|
273
|
+
$ref: "#/$defs/CommitScope"
|
|
274
|
+
description: >
|
|
275
|
+
Conventional Commits scope for commits generated from this item.
|
|
276
|
+
Omit the key when no scope applies.
|
|
277
|
+
|
|
236
278
|
approach:
|
|
237
279
|
$ref: "#/$defs/Approach"
|
|
238
280
|
description: >
|
|
239
281
|
Execution approach. Authoring approaches use the target as the new kata id and
|
|
240
282
|
sources as read-only exemplars. For compatibility, additional targets are also
|
|
241
|
-
accepted as exemplar sources.
|
|
283
|
+
accepted as exemplar sources. Planning approaches require one domain:<id> or track:<id>
|
|
284
|
+
target. Other approaches require one compatible document id.
|
|
242
285
|
|
|
243
286
|
targets:
|
|
244
287
|
type: array
|
|
@@ -247,7 +290,7 @@ properties:
|
|
|
247
290
|
minLength: 1
|
|
248
291
|
minItems: 1
|
|
249
292
|
description: >
|
|
250
|
-
|
|
293
|
+
Document IDs or planning units (domain:<id> for catalog-planning, track:<id> for strategy-planning). Deliverable targets
|
|
251
294
|
used with an approach prefer the project catalog; target_path and target_rulebook or existing frontmatter allow catalog-less resolution so that
|
|
252
295
|
not-yet-created deliverables can be selected; kata and standalone
|
|
253
296
|
targets are resolved via the doc index. When present, exec plan
|
|
@@ -279,10 +322,15 @@ properties:
|
|
|
279
322
|
key when the authoring task has no exemplar.
|
|
280
323
|
|
|
281
324
|
$defs:
|
|
325
|
+
Track:
|
|
326
|
+
type: string
|
|
327
|
+
pattern: "^[a-z0-9][a-z0-9-]*$"
|
|
328
|
+
|
|
282
329
|
ItemType:
|
|
283
330
|
type: string
|
|
284
331
|
enum:
|
|
285
332
|
- todo
|
|
333
|
+
- epic
|
|
286
334
|
- question
|
|
287
335
|
- risk
|
|
288
336
|
- issue
|
|
@@ -333,10 +381,13 @@ $defs:
|
|
|
333
381
|
Approach:
|
|
334
382
|
type: string
|
|
335
383
|
enum:
|
|
384
|
+
- draft
|
|
336
385
|
- fully-guided
|
|
337
386
|
- recipe-guided
|
|
338
387
|
- freeform
|
|
339
388
|
- bootstrap
|
|
389
|
+
- catalog-planning
|
|
390
|
+
- strategy-planning
|
|
340
391
|
- rulebook-authoring
|
|
341
392
|
- recipe-authoring
|
|
342
393
|
- sample-authoring
|
|
@@ -349,7 +400,7 @@ $defs:
|
|
|
349
400
|
- template-maintenance
|
|
350
401
|
- finalize
|
|
351
402
|
- bootstrap-finalize
|
|
352
|
-
description: "Execution approach shared with src/shared/agent-types.ts."
|
|
403
|
+
description: "Execution approach shared with src/shared/agent-types.ts. catalog-planning and strategy-planning are register-only."
|
|
353
404
|
|
|
354
405
|
Date:
|
|
355
406
|
type: string
|
|
@@ -376,3 +427,24 @@ $defs:
|
|
|
376
427
|
type: string
|
|
377
428
|
pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
|
|
378
429
|
description: "Project-qualified display id of a register item in another project."
|
|
430
|
+
|
|
431
|
+
CommitType:
|
|
432
|
+
type: string
|
|
433
|
+
enum:
|
|
434
|
+
- feat
|
|
435
|
+
- fix
|
|
436
|
+
- docs
|
|
437
|
+
- refactor
|
|
438
|
+
- test
|
|
439
|
+
- chore
|
|
440
|
+
- perf
|
|
441
|
+
- build
|
|
442
|
+
- ci
|
|
443
|
+
- style
|
|
444
|
+
- revert
|
|
445
|
+
description: "Conventional Commits type."
|
|
446
|
+
|
|
447
|
+
CommitScope:
|
|
448
|
+
type: string
|
|
449
|
+
pattern: "^[a-z0-9][a-z0-9-]*$"
|
|
450
|
+
description: "Conventional Commits scope."
|
|
@@ -11,11 +11,16 @@ properties:
|
|
|
11
11
|
allOf:
|
|
12
12
|
- $ref: "./common-frontmatter.schema.yaml"
|
|
13
13
|
- type: object
|
|
14
|
+
required:
|
|
15
|
+
- deliverable_type
|
|
14
16
|
properties:
|
|
15
17
|
type:
|
|
16
18
|
type: string
|
|
17
19
|
const: rulebook
|
|
18
20
|
description: "ドキュメント種別(rulebook 固定)"
|
|
21
|
+
deliverable_type:
|
|
22
|
+
$ref: "./deliverable-frontmatter.schema.yaml#/$defs/deliverableType"
|
|
23
|
+
description: "扱う成果物の type。Markdown 成果物・sample・生成物 Frontmatter 雛形との照合の正本。"
|
|
19
24
|
target_format:
|
|
20
25
|
type: string
|
|
21
26
|
enum:
|
|
@@ -50,6 +50,7 @@ $defs:
|
|
|
50
50
|
lint-ts,
|
|
51
51
|
lint-fm,
|
|
52
52
|
lint-md,
|
|
53
|
+
lint-mermaid,
|
|
53
54
|
build,
|
|
54
55
|
format-check,
|
|
55
56
|
]
|
|
@@ -99,6 +100,10 @@ $defs:
|
|
|
99
100
|
type: array
|
|
100
101
|
items:
|
|
101
102
|
$ref: "#/$defs/NonEmptyString"
|
|
103
|
+
commit_types:
|
|
104
|
+
description: >-
|
|
105
|
+
Mapping from register item types to Conventional Commits types for this project.
|
|
106
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
102
107
|
repos:
|
|
103
108
|
description: >-
|
|
104
109
|
Product repositories that tasks of this project may change. The project repository is
|
|
@@ -148,6 +153,20 @@ $defs:
|
|
|
148
153
|
integration_branch:
|
|
149
154
|
description: Branch exec integrates into. Omit to use the repository's current branch.
|
|
150
155
|
$ref: "#/$defs/NonEmptyString"
|
|
156
|
+
branch_template:
|
|
157
|
+
description: Product work branch template; must contain id or topic. Expanded values must be valid Git branch names.
|
|
158
|
+
type: string
|
|
159
|
+
default: "exec/{project}-{id}"
|
|
160
|
+
allOf:
|
|
161
|
+
- pattern: '\{(?:id|topic)\}'
|
|
162
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title)\})*$'
|
|
163
|
+
- not:
|
|
164
|
+
pattern: '[\s\u0000-\u001f\u007f~^:?*\[\\]|\.\.|@\{|^[-/]|/$|//|\.$|(^|/)\.|\.lock(/|$)'
|
|
165
|
+
integration_strategy:
|
|
166
|
+
description: Local merge commit (default), fast-forward only, or retain the branch for product-side PR review.
|
|
167
|
+
type: string
|
|
168
|
+
enum: [merge, branch-only, ff]
|
|
169
|
+
default: merge
|
|
151
170
|
setup:
|
|
152
171
|
description: Whether exec installs dependencies and builds in the repository worktree.
|
|
153
172
|
type: object
|
|
@@ -157,6 +176,23 @@ $defs:
|
|
|
157
176
|
type: boolean
|
|
158
177
|
build:
|
|
159
178
|
type: boolean
|
|
179
|
+
commit_types:
|
|
180
|
+
description: >-
|
|
181
|
+
Mapping from register item types to Conventional Commits types for this repository.
|
|
182
|
+
$ref: "#/$defs/CommitTypeMap"
|
|
183
|
+
commit_subject_template:
|
|
184
|
+
description: >-
|
|
185
|
+
Product commit subject. Omit to retain exec(register <ID>): <title>.
|
|
186
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
187
|
+
merge_message_template:
|
|
188
|
+
description: >-
|
|
189
|
+
Product merge message. Omit to retain exec(register <ID>): <title>. Refs is always appended.
|
|
190
|
+
$ref: "#/$defs/CommitMessageTemplate"
|
|
191
|
+
CommitMessageTemplate:
|
|
192
|
+
type: string
|
|
193
|
+
allOf:
|
|
194
|
+
- pattern: '\S'
|
|
195
|
+
- pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title|branch|target)\})*$'
|
|
160
196
|
Run:
|
|
161
197
|
type: object
|
|
162
198
|
properties:
|
|
@@ -190,3 +226,10 @@ $defs:
|
|
|
190
226
|
type: string
|
|
191
227
|
register_date_timezone:
|
|
192
228
|
type: string
|
|
229
|
+
CommitTypeMap:
|
|
230
|
+
type: object
|
|
231
|
+
description: >-
|
|
232
|
+
Mapping from register item type (e.g., todo, issue) to Conventional Commits type (e.g., feat, fix).
|
|
233
|
+
additionalProperties:
|
|
234
|
+
type: string
|
|
235
|
+
enum: [feat, fix, docs, refactor, test, chore, perf, build, ci, style, revert]
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "naoji3x",
|
|
@@ -90,9 +90,10 @@
|
|
|
90
90
|
"docs:generate": "node --import tsx src/specdojo.ts build",
|
|
91
91
|
"docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
|
|
92
92
|
"docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
|
|
93
|
-
"docs:rebuild:mermaid": "rm -f
|
|
93
|
+
"docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
|
|
94
94
|
"docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
|
|
95
95
|
"lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
|
|
96
|
+
"lint:mermaid": "node tools/lint-mermaid.mjs",
|
|
96
97
|
"validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
|
|
97
98
|
"validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
|
|
98
99
|
"validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
|
|
@@ -101,7 +102,7 @@
|
|
|
101
102
|
"validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
|
|
102
103
|
"validate:catalog": "tsx src/specdojo.ts catalog validate",
|
|
103
104
|
"validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
|
|
104
|
-
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
105
|
+
"check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
|
|
105
106
|
"check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
|
|
106
107
|
"dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
|
|
107
108
|
"dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
|
|
@@ -85,18 +85,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
|
|
|
85
85
|
|
|
86
86
|
type は次のように使い分ける。
|
|
87
87
|
|
|
88
|
-
| type | 用途
|
|
89
|
-
| ---------------- |
|
|
90
|
-
| `issue` | 解決すべき問題。原因調査を伴う
|
|
91
|
-
| `decision` | 選択肢から方針を決める
|
|
92
|
-
| `todo` | 実施する作業
|
|
93
|
-
| `question` | 判断を保留し、後で決める
|
|
94
|
-
| `risk` | 将来の不確実性
|
|
95
|
-
| `change-request` | 合意済み範囲の変更要求
|
|
96
|
-
| `note` | 記録として残す観測・分析
|
|
88
|
+
| type | 用途 | 終端状態 |
|
|
89
|
+
| ---------------- | ---------------------------------- | --------- |
|
|
90
|
+
| `issue` | 解決すべき問題。原因調査を伴う | `done` |
|
|
91
|
+
| `decision` | 選択肢から方針を決める | `decided` |
|
|
92
|
+
| `todo` | 実施する作業 | `done` |
|
|
93
|
+
| `question` | 判断を保留し、後で決める | `decided` |
|
|
94
|
+
| `risk` | 将来の不確実性 | `done` |
|
|
95
|
+
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
96
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
97
|
+
| `epic` | track ごとの仕事の着手と完了の管理 | `done` |
|
|
97
98
|
|
|
98
99
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
99
100
|
|
|
101
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
102
|
+
|
|
100
103
|
```bash
|
|
101
104
|
npx specdojo register add --project <project-id> \
|
|
102
105
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -123,6 +126,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
|
123
126
|
|
|
124
127
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
125
128
|
|
|
129
|
+
`epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
|
|
130
|
+
|
|
131
|
+
順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
|
|
132
|
+
|
|
126
133
|
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
127
134
|
|
|
128
135
|
## 実践の型(kata)の扱い
|
|
@@ -92,18 +92,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
|
|
|
92
92
|
|
|
93
93
|
type は次のように使い分ける。
|
|
94
94
|
|
|
95
|
-
| type | 用途
|
|
96
|
-
| ---------------- |
|
|
97
|
-
| `issue` | 解決すべき問題。原因調査を伴う
|
|
98
|
-
| `decision` | 選択肢から方針を決める
|
|
99
|
-
| `todo` | 実施する作業
|
|
100
|
-
| `question` | 判断を保留し、後で決める
|
|
101
|
-
| `risk` | 将来の不確実性
|
|
102
|
-
| `change-request` | 合意済み範囲の変更要求
|
|
103
|
-
| `note` | 記録として残す観測・分析
|
|
95
|
+
| type | 用途 | 終端状態 |
|
|
96
|
+
| ---------------- | ---------------------------------- | --------- |
|
|
97
|
+
| `issue` | 解決すべき問題。原因調査を伴う | `done` |
|
|
98
|
+
| `decision` | 選択肢から方針を決める | `decided` |
|
|
99
|
+
| `todo` | 実施する作業 | `done` |
|
|
100
|
+
| `question` | 判断を保留し、後で決める | `decided` |
|
|
101
|
+
| `risk` | 将来の不確実性 | `done` |
|
|
102
|
+
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
103
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
104
|
+
| `epic` | track ごとの仕事の着手と完了の管理 | `done` |
|
|
104
105
|
|
|
105
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
106
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
107
110
|
```bash
|
|
108
111
|
npx specdojo register add --project <project-id> \
|
|
109
112
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -130,6 +133,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
|
130
133
|
|
|
131
134
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
132
135
|
|
|
136
|
+
`epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
|
|
137
|
+
|
|
138
|
+
順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
|
|
139
|
+
|
|
133
140
|
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
134
141
|
|
|
135
142
|
## 実践の型(kata)の扱い
|
|
@@ -92,18 +92,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
|
|
|
92
92
|
|
|
93
93
|
type は次のように使い分ける。
|
|
94
94
|
|
|
95
|
-
| type | 用途
|
|
96
|
-
| ---------------- |
|
|
97
|
-
| `issue` | 解決すべき問題。原因調査を伴う
|
|
98
|
-
| `decision` | 選択肢から方針を決める
|
|
99
|
-
| `todo` | 実施する作業
|
|
100
|
-
| `question` | 判断を保留し、後で決める
|
|
101
|
-
| `risk` | 将来の不確実性
|
|
102
|
-
| `change-request` | 合意済み範囲の変更要求
|
|
103
|
-
| `note` | 記録として残す観測・分析
|
|
95
|
+
| type | 用途 | 終端状態 |
|
|
96
|
+
| ---------------- | ---------------------------------- | --------- |
|
|
97
|
+
| `issue` | 解決すべき問題。原因調査を伴う | `done` |
|
|
98
|
+
| `decision` | 選択肢から方針を決める | `decided` |
|
|
99
|
+
| `todo` | 実施する作業 | `done` |
|
|
100
|
+
| `question` | 判断を保留し、後で決める | `decided` |
|
|
101
|
+
| `risk` | 将来の不確実性 | `done` |
|
|
102
|
+
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
103
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
104
|
+
| `epic` | track ごとの仕事の着手と完了の管理 | `done` |
|
|
104
105
|
|
|
105
106
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
106
107
|
|
|
108
|
+
対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
|
|
109
|
+
|
|
107
110
|
```bash
|
|
108
111
|
npx specdojo register add --project <project-id> \
|
|
109
112
|
--type todo --title "<title>" --description "<description>" \
|
|
@@ -130,6 +133,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
|
130
133
|
|
|
131
134
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
132
135
|
|
|
136
|
+
`epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
|
|
137
|
+
|
|
138
|
+
順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
|
|
139
|
+
|
|
133
140
|
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
134
141
|
|
|
135
142
|
## 実践の型(kata)の扱い
|