specdojo 0.5.0 → 0.7.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.
Files changed (137) hide show
  1. package/.github/agents/specdojo-orchestrator.md +2 -0
  2. package/CHANGELOG.md +100 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/generate.js +144 -13
  5. package/dist/commands/agent.js +33 -0
  6. package/dist/commands/init.js +2 -0
  7. package/dist/commands/orchestrator.js +10 -1
  8. package/dist/deliverable/deliverable.js +77 -4
  9. package/dist/devcontainer/command.js +18 -0
  10. package/dist/devcontainer/host-script.js +21 -0
  11. package/dist/devcontainer/scaffold.js +4 -3
  12. package/dist/exec/antigravity-session.js +154 -0
  13. package/dist/exec/core.js +1 -0
  14. package/dist/exec/parent-validation.js +14 -0
  15. package/dist/exec/plan-markdownlint.js +89 -0
  16. package/dist/exec/plans-core.js +46 -1
  17. package/dist/exec/plans-generation.js +45 -5
  18. package/dist/exec/plans-planning.js +1 -1
  19. package/dist/exec/plans-storage.js +1 -0
  20. package/dist/exec/product-branch-records.js +105 -0
  21. package/dist/exec/product-branches.js +52 -0
  22. package/dist/exec/register-product-message.js +50 -0
  23. package/dist/exec/register-resume.js +28 -0
  24. package/dist/exec/register.js +6 -0
  25. package/dist/exec/repo-integration-sync.js +4 -2
  26. package/dist/exec/repo-integration.js +41 -4
  27. package/dist/exec/repo-trace.js +2 -0
  28. package/dist/exec/results.js +9 -5
  29. package/dist/exec/run/lifecycle-commands.js +85 -16
  30. package/dist/exec/run/register-command.js +22 -0
  31. package/dist/exec/run/register-resume.js +11 -1
  32. package/dist/exec/run/register-worktree.js +29 -8
  33. package/dist/exec/run/schedule-mode.js +22 -2
  34. package/dist/exec/run/schedule-prepare.js +49 -4
  35. package/dist/exec/run/schedule-task.js +3 -0
  36. package/dist/exec/strategy.js +2 -1
  37. package/dist/exec/task-repos.js +78 -16
  38. package/dist/exec/worktree-command.js +2 -2
  39. package/dist/exec/worktree-ops-commit.js +1 -13
  40. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  41. package/dist/exec/worktree.js +3 -3
  42. package/dist/register/core.js +5 -0
  43. package/dist/register/create-commands.js +54 -2
  44. package/dist/register/deliverable-target.js +24 -17
  45. package/dist/register/event-merge.js +4 -0
  46. package/dist/register/events.js +6 -0
  47. package/dist/register/external-project.js +2 -0
  48. package/dist/register/input.js +168 -0
  49. package/dist/register/item.js +61 -0
  50. package/dist/register/register.js +33 -25
  51. package/dist/register/renumber.js +4 -0
  52. package/dist/register/update.js +6 -0
  53. package/dist/schedule/approach.js +9 -0
  54. package/dist/schedule/strategy-profiles.js +22 -2
  55. package/dist/shared/agent-types.js +4 -1
  56. package/dist/shared/branch-template.js +26 -0
  57. package/dist/shared/commit-message-template.js +38 -0
  58. package/dist/shared/commit-types.js +15 -0
  59. package/dist/shared/git.js +7 -0
  60. package/dist/shared/provider-scaffold.js +2 -0
  61. package/dist/shared/specdojo-config.js +35 -4
  62. package/dist/shared/specdojo-gitignore.js +1 -0
  63. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  64. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  65. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  66. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  67. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  68. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  69. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  70. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  71. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  72. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  73. package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
  74. package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
  75. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  76. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  77. package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
  78. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  79. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  80. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  81. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  82. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  83. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  84. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  85. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  86. package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
  87. package/docs/ja/specdojo/references/command-reference.md +111 -46
  88. package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
  89. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  90. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  91. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  92. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  93. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  94. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
  95. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
  96. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
  97. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  98. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  99. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  100. package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
  101. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  102. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  103. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  104. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  105. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
  106. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  107. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  108. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  109. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  110. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  111. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  112. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  113. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  114. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  115. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  116. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
  117. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  118. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
  119. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  120. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
  121. package/package.json +6 -2
  122. package/templates/antigravity/README.md +19 -46
  123. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  124. package/templates/antigravity/orchestrator.md +2 -0
  125. package/templates/antigravity/settings.edit.json +73 -0
  126. package/templates/antigravity/settings.orchestrator.json +15 -0
  127. package/templates/antigravity/settings.report.json +7 -0
  128. package/templates/antigravity/settings.review.json +7 -0
  129. package/templates/claude/agents/specdojo-orchestrator.md +2 -0
  130. package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
  131. package/templates/codex/orchestrator.md +2 -0
  132. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  133. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
  134. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  135. package/templates/init-agent-members.yaml +1 -0
  136. package/templates/init-exec-defaults.yaml +1 -1
  137. package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
@@ -11,136 +11,167 @@ specdojo:
11
11
 
12
12
  # 概念データフロー図(ユースケース別): 欠品から補充まで
13
13
 
14
- 本書は、[[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] のケース `C-02`「欠品から補充まで」について、在庫、仕入、販売の順序と、グループ間の引き渡し条件を定める概念仕様である。product 成果物として作成する場合の ID は `cdfd-uc-replenishment` とする。
14
+ 本書は、駄菓子屋きぬやの [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] のケース `C-02`「欠品から補充まで」について、在庫・仕入・販売を通る流れと、受け渡す情報・商品を示す。product 成果物として作成する場合の ID は `cdfd-uc-replenishment` とする。
15
15
 
16
16
  ## 1. 目的
17
17
 
18
- - 店主代表は、欠品を検知してから売場で販売可能になるまでのグループ順序、引き渡し条件、条件不成立時の戻り先を承認する。
19
- - 開発担当は、在庫・仕入・販売の境界で受け渡す補充依頼、入荷数量、売場商品を後続設計の入力として利用する。
20
- - 同行レビュー担当は、ケース `C-02` の参加グループ、引き渡し、戻り経路に重複・欠落がなく、各グループの内部処理を再掲していないことを確認する。
18
+ 欠品した商品を補充し、売場で販売できるようにするために、在庫の補充判断から仕入を経て販売が商品を引き受けるまでの流れを示す。
21
19
 
22
20
  ## 2. 適用範囲
23
21
 
24
- - ケースは `C-02`「欠品から補充まで」であり、在庫の補充判断、仕入への依頼、発注・入荷を経た売場補充、販売による売場商品の引き受けまでの責任境界を扱う。
25
- - 開始イベントは、在庫記録の数量が商品台帳の補充基準を下回ったことである。終了条件は、受入品が売場棚へ配置され、販売グループが販売対象として扱えることである。
26
- - 正常系は在庫(`P-05`〜`P-06`)→ 仕入(`P-01`〜`P-02`)→ 販売(`P-03`〜`P-04`)の三グループを横断する。単一店舗の店主代表と店番担当を対象組織とし、仕入先は各グループ内部の外部主体として本書では展開しない。
27
- - システム境界は、補充依頼、発注・受入結果、入荷数量の記録確認と、売場商品の引き渡しまでである。画面操作、保存方式、仕入先との通信方式は対象外とする。
28
- - 在庫計算と補充判断の内部は `cdfd-inventory`、発注と入荷検品の内部は `cdfd-purchasing`、店頭販売の内部は `cdfd-sales` を正本とし、本書では内部プロセスと内部例外を再掲しない。
29
- - 商品の状態名・成立条件・遷移元・遷移先・イベント・遷移条件は `stsd-product` を正本とし、本書では定義しない。
30
- - 店主代表、店番担当、システムの責任分担は [[specdojo:prj-overview-sample|プロジェクト概要]] に従う。補充数量、発注、受入可否の最終判断は店主代表が担い、システムは記録と照合を支援する。
22
+ - **対象**: 単一店舗の `C-02`「欠品から補充まで」として、在庫が補充基準を下回ってから在庫(`P-05`〜`P-06`)→ 仕入(`P-01`〜`P-02`)→ 販売(`P-03`〜`P-04`)を経て、受入品を売場棚へ配置し、販売が商品を扱えるまでを対象とする。
23
+ - **対象外**: 在庫計算・補充判断・発注・入荷検品・店頭販売の内部は `cdfd-inventory`・`cdfd-purchasing`・`cdfd-sales`、商品の状態定義・遷移は `stsd-product` へ委ね、補助操作・画面・保存方式・仕入先との通信は扱わず、店主代表・店番担当・システムの責任分担は [[specdojo:cdfd-overview-sample|全体概要]] を参照する。
31
24
 
32
25
  ## 3. プロセス領域
33
26
 
34
- ケース `C-02` は在庫、仕入、販売の三つのプロセスグループを正常系の順序で横断する。グループ名、含む領域、業務目的は全体概要を正本とし、本章では各グループが欠品から補充までで担う役割を定める。
27
+ ケース `C-02` は在庫、仕入、販売の三グループをこの順に横断する。領域の分割・名称は全体概要を正本とし、本章は各グループの役割、図は受け渡しの正本とする。
35
28
 
36
29
  ### 3.1. 在庫(P-05〜P-06)
37
30
 
38
- 補充基準を下回った商品を特定して補充対象と数量を確定し、店主代表の承認を得た補充依頼を仕入へ渡す。
39
-
40
- - **主要入力**: 商品台帳の補充基準・発注単位、在庫記録の在庫数量
41
- - **主要出力**: 補充対象の商品・数量・補充判断
42
- - **データストア**: 商品台帳、在庫記録
43
-
44
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
45
- | ---- | ---------------- | -------------- | ---------------------------------------------------------------------------- | ---------------- |
46
- | 1 | 在庫 | `P-05`〜`P-06` | 補充基準を下回った商品について補充対象と数量を確定し、仕入へ補充依頼を渡す。 | `cdfd-inventory` |
31
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
32
+ | ---- | ---------------------- | -------------- | -------------------------------------------------------------------------------------------------- | ---------------- |
33
+ | 1 | 在庫 | `P-05`〜`P-06` | 商品台帳で補充対象を特定し、発注単位に合う数量を確定して、店主代表が承認した補充依頼を仕入へ渡す。 | `cdfd-inventory` |
47
34
 
48
35
  ### 3.2. 仕入(P-01〜P-02)
49
36
 
50
- 補充依頼を受けて発注・入荷を行い、受入結果と入荷数量を記録して受入品を売場へ渡す。
51
-
52
- - **主要入力**: 補充対象の商品・数量・補充判断
53
- - **主要出力**: 受入品、入荷数量、受入結果、売場への配置
54
- - **データストア**: 仕入記録、在庫記録、売場棚
55
-
56
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
57
- | ---- | ---------------- | -------------- | ---------------------------------------------------------------- | ----------------- |
58
- | 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受け、受入結果と入荷数量を記録し、受入品を売場へ渡す。 | `cdfd-purchasing` |
37
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
38
+ | ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------ | ----------------- |
39
+ | 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受けて発注・入荷を行い、受入結果と入荷数量を記録し、記録と一致する受入品を売場棚へ配置する。 | `cdfd-purchasing` |
59
40
 
60
41
  ### 3.3. 販売(P-03〜P-04)
61
42
 
62
- 売場棚へ配置された受入品を販売対象として引き受け、店頭販売で利用できる状態にする。
63
-
64
- - **主要入力**: 受入品、入荷数量、受入結果、売場への配置
65
- - **主要出力**: 販売対象として引き受けた売場商品
66
- - **データストア**: 売場棚
67
-
68
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
69
- | ---- | ---------------- | -------------- | ---------------------------------------------------- | ------------ |
70
- | 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を販売対象として引き受ける。 | `cdfd-sales` |
43
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
44
+ | ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------ | ------------ |
45
+ | 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を、確定した入荷数量・受入結果と照合し、販売対象として引き受ける。 | `cdfd-sales` |
71
46
 
72
47
  ## 4. データストア
73
48
 
74
- 全体概要の「データストア」から、`H-01`・`H-02` で引き渡す情報または引き渡し条件の判定に使う行だけを同じ名称・区分で示す。各行は概念データフローの同名ノードと対応する。
49
+ 全体概要からこのケースで参照・更新する正本だけを同じ名称・区分で示す。
75
50
 
76
51
  ### 4.1. マスタ・構成データ
77
52
 
78
- | データストア | 関連引き渡し | 横断上の利用 |
79
- | ------------ | ------------ | ---------------------------------- |
80
- | 商品台帳 | `H-01` | 補充基準と発注単位の判定根拠にする |
53
+ | データストア | 関連する参加単位 | 横断上の利用 |
54
+ | ------------ | ---------------- | ---------------------------------------------- |
55
+ | 商品台帳 | 在庫 | 補充基準と発注単位を参照し、補充対象を特定する |
81
56
 
82
57
  ### 4.2. トランザクションデータ
83
58
 
84
- | データストア | 関連引き渡し | 横断上の利用 |
85
- | ------------ | -------------- | ------------------------------------------------ |
86
- | 在庫記録 | `H-01`、`H-02` | 補充対象の判定と入荷数量の引き渡しを確認する |
87
- | 仕入記録 | `H-02` | 発注・受入結果が確定したことを確認する |
88
- | 売場棚 | `H-02` | 受入品の現物が販売グループへ渡ったことを確認する |
59
+ | データストア | 関連する参加単位 | 横断上の利用 |
60
+ | ------------ | ---------------- | ------------------------------------------------------ |
61
+ | 在庫記録 | 在庫、仕入 | 在庫数量を参照して補充対象を判断し、入荷数量を反映する |
62
+ | 仕入記録 | 仕入 | 発注・受入結果を記録する |
63
+ | 売場棚 | 仕入、販売 | 受入品を配置し、販売が売場商品を引き受ける(物理保管) |
89
64
 
90
65
  ## 5. 概念データフロー
91
66
 
92
- 開始イベントから在庫、仕入、販売へ進む正常系と、`H-01`・`H-02` の成立条件を一図で示す。各角丸長方形は一つのプロセスグループを表す。
93
-
94
- ```mermaid
95
- flowchart LR
96
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
97
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
98
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
99
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
100
-
101
- 補充基準割れ{{"⚡ 在庫が補充基準を下回った"}}
102
- 在庫("📦 在庫<br>P-05〜P-06")
103
- 補充依頼成立{{"⚡ H-01 補充対象・数量・承認がそろった"}}
104
- 仕入("🚚 仕入<br>P-01〜P-02")
105
- 売場引渡成立{{"⚡ H-02 記録と受入品が一致し売場へ配置された"}}
106
- 販売("🛒 販売<br>P-03〜P-04")
107
- 販売引受完了{{"⚡ 販売が売場商品を扱える"}}
108
- 商品台帳[("📐 商品台帳")]
109
- 在庫記録[("📒 在庫記録")]
110
- 仕入記録[("📒 仕入記録")]
111
- 売場棚(["🏬 売場棚"])
112
-
113
- 補充基準割れ -->|"起動条件"| 在庫
114
- 商品台帳 -->|"補充基準・発注単位"| 在庫
115
- 在庫記録 -->|"在庫数量"| 在庫
116
- 在庫 -->|"H-01 補充依頼"| 補充依頼成立
117
- 補充依頼成立 -->|"起動条件"| 仕入
118
- 仕入 -->|"発注・受入結果"| 仕入記録
119
- 仕入 -->|"入荷数量"| 在庫記録
120
- 仕入 ==>|"受入品"| 売場棚
121
- 仕入 -->|"H-02 入荷数量・受入結果"| 売場引渡成立
122
- 売場引渡成立 -->|"起動条件"| 販売
123
- 売場棚 ==>|"売場商品"| 販売
124
- 販売 -->|"完了条件"| 販売引受完了
125
-
126
- class 在庫,仕入,販売 process
127
- class 補充基準割れ,補充依頼成立,売場引渡成立,販売引受完了 event
128
- class 商品台帳 storeMaster
129
- class 在庫記録,仕入記録,売場棚 storeTransaction
67
+ ### 5.1. 欠品から売場補充まで
68
+
69
+ 在庫が承認済みの補充依頼を仕入へ渡し、仕入が入荷数量・受入結果を記録して、販売が売場商品を引き受ける。
70
+
71
+ ```d2
72
+ direction: down
73
+
74
+ classes: {
75
+ process: {
76
+ shape: rectangle
77
+ style: {
78
+ border-radius: 8
79
+ fill: "#e3f2fd"
80
+ stroke: "#1e88e5"
81
+ font-color: "#000000"
82
+ }
83
+ }
84
+ event: {
85
+ shape: hexagon
86
+ style: {
87
+ fill: "#fff3e0"
88
+ stroke: "#fb8c00"
89
+ font-color: "#000000"
90
+ }
91
+ }
92
+ store_master: {
93
+ shape: cylinder
94
+ style: {
95
+ fill: "#e8f5e9"
96
+ stroke: "#43a047"
97
+ font-color: "#000000"
98
+ }
99
+ }
100
+ store_transaction: {
101
+ shape: cylinder
102
+ style: {
103
+ fill: "#c8e6c9"
104
+ stroke: "#2e7d32"
105
+ font-color: "#000000"
106
+ }
107
+ }
108
+ physical_store: {
109
+ shape: rectangle
110
+ style: {
111
+ border-radius: 20
112
+ fill: "#c8e6c9"
113
+ stroke: "#2e7d32"
114
+ font-color: "#000000"
115
+ }
116
+ }
117
+ material_flow: {
118
+ style: {
119
+ stroke-width: 3
120
+ }
121
+ }
122
+ }
123
+
124
+ start: "⚡ 在庫が補充基準を\n下回った" { class: event }
125
+ inventory: "📦 在庫\nP-05〜P-06" { class: process }
126
+ purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
127
+ sales: "🛒 販売\nP-03〜P-04" { class: process }
128
+ end: "⚡ 販売が売場商品を\n扱える" { class: event }
129
+ item_master: "📐 商品台帳" { class: store_master }
130
+ inventory_record: "📒 在庫記録" { class: store_transaction }
131
+ purchase_record: "📒 仕入記録" { class: store_transaction }
132
+ display_shelf: "🏬 売場棚" { class: physical_store }
133
+
134
+ start -> inventory: "起動条件"
135
+ item_master -> inventory: "補充基準・発注単位"
136
+ inventory_record -> inventory: "在庫数量"
137
+ inventory -> purchasing: "補充依頼(商品・数量・承認)"
138
+ purchasing -> purchase_record: "発注・受入結果"
139
+ inventory_record <- purchasing: "入荷数量"
140
+ purchasing -> display_shelf: "受入品" { class: material_flow }
141
+ purchasing -> sales: "入荷数量・受入結果"
142
+ display_shelf -> sales: "売場商品" { class: material_flow }
143
+ sales -> end: "販売対象の引受結果"
130
144
  ```
131
145
 
132
- 凡例の形状・色・絵文字は全体概要の「凡例(本プロダクト共通)」を参照する。`-->` は情報、`==>` は商品の流れを表す。各グループ内部の在庫計算、補充判断、発注、入荷検品、売場補充、店頭販売は省略し、三つの代表ノードだけを置く。商品台帳と在庫記録は `H-01`、仕入記録と売場棚は `H-02` の成立を確認する正本として必要なため図へ置いている。
146
+ 凡例は [[specdojo:cdfd-overview-sample|全体概要]] の「凡例(本プロダクト共通)」を参照し、通常線は情報、太線は商品の流れに用いる。各グループ内部は省略し、次の図でも在庫・仕入・販売の代表ノードを共有する。
147
+
148
+ ### 5.2. 例外時の戻り
149
+
150
+ 補充依頼の不足は仕入から在庫へ、受入結果や売場配置の不一致は販売から仕入へ返し、補完・再判断後の情報を再提示する。
133
151
 
134
- ## 6. 引き渡し
152
+ ```d2
153
+ direction: down
135
154
 
136
- | 引き渡し ID | 送り元グループ | 受け側グループ | 引き渡す情報 | 引き渡し条件 | 戻す条件 |
137
- | ----------- | -------------- | -------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
138
- | `H-01` | 在庫 | 仕入 | 補充対象の商品、数量、補充判断 | 商品を商品台帳で一意に特定でき、補充数量が発注単位で示され、店主代表が補充判断を承認している。 | 商品を特定できない、数量がない、発注単位に合わない、または承認を確認できない。 |
139
- | `H-02` | 仕入 | 販売 | 受入品、入荷数量、受入結果、売場への配置 | 入荷数量と受入結果が記録され、受入品と記録が一致し、受入品が売場棚へ配置されている。 | 記録と受入品が一致しない、受入結果が確定していない、または売場棚に受入品がない。 |
155
+ classes: {
156
+ process: {
157
+ shape: rectangle
158
+ style: {
159
+ border-radius: 8
160
+ fill: "#e3f2fd"
161
+ stroke: "#1e88e5"
162
+ font-color: "#000000"
163
+ }
164
+ }
165
+ }
140
166
 
141
- ## 7. 例外時の戻り先
167
+ inventory: "📦 在庫\nP-05〜P-06" { class: process }
168
+ purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
169
+ sales: "🛒 販売\nP-03〜P-04" { class: process }
170
+
171
+ inventory <- purchasing: "不足項目・商品候補・現在庫・補充基準"
172
+ inventory -> purchasing: "修正・再承認済みの補充依頼"
173
+ purchasing <- sales: "数量の差異・未確定の受入結果・配置状況"
174
+ purchasing -> sales: "照合・配置確認済みの入荷数量・受入結果"
175
+ ```
142
176
 
143
- | 対象引き渡し | 条件不成立 | 戻り先グループ | 戻す情報 | 再開条件 |
144
- | ------------ | ------------------------------------------------------------------------------------------------ | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
145
- | `H-01` | 商品を一意に特定できない、数量または発注単位が不足している、または店主代表の承認を確認できない。 | 在庫 | 不足項目、商品候補、現在庫、補充基準 | 商品と発注単位に合う数量を確定し、店主代表が修正後の補充依頼を承認して `H-01` を再提示した。 |
146
- | `H-02` | 入荷数量・受入結果と受入品が一致しない、受入結果が未確定、または受入品が売場棚にない。 | 仕入 | 記録と受入品の差異、未確定の受入結果、売場棚への配置状況 | 記録と受入品が一致し、受入結果の確定と売場棚への配置を確認して `H-02` を再提示した。 |
177
+ 凡例は [[specdojo:cdfd-overview-sample|全体概要]] を参照し、本図は通常線による情報の戻りと再提示を示す。商品と発注単位に合う数量を再確定する在庫の判断、受入結果の確定と現物照合・売場配置を確認する仕入の判断が重要なため図を追加し、データストアと物の流れ、内部の再試行は省略する。
@@ -3,7 +3,7 @@
3
3
  # 成果物カタログ(ドメイン別)の完成例。
4
4
  # 駄菓子屋きぬや販売管理システム構築プロジェクトのプロジェクト定義ドメインを題材とする。
5
5
  # 構造・必須キー・型制約は docs/specdojo/schemas/v1/dct.schema.yaml に従う。
6
- # work / control / generated の3種別と、done_criteria の記述例を示す。
6
+ # work / control / generated の3種別と、done_criteria、および brief(YAML アンカー共有)の記述例を示す。
7
7
  id: specdojo:dct-sample
8
8
  type: project
9
9
  status: draft
@@ -21,6 +21,9 @@ groups:
21
21
  kind: work
22
22
  depends_on: []
23
23
  overview: 駄菓子屋きぬや販売管理システムの目的・背景・ゴールを定義する
24
+ brief: &project_baseline_brief |
25
+ - 駄菓子屋の既存店舗業務を止めない段階的な移行を前提とする
26
+ - POS 端末および在庫管理端末はタブレット Web アプリケーションとする
24
27
  path: prj-overview.md
25
28
  rulebook: specdojo:prj-overview-rulebook
26
29
  done_criteria:
@@ -42,6 +45,7 @@ groups:
42
45
  depends_on:
43
46
  - prj-overview
44
47
  overview: 対象業務と対象外業務を明確化し、合意境界を固定する
48
+ brief: *project_baseline_brief
45
49
  path: prj-scope.md
46
50
  rulebook: specdojo:prj-scope-rulebook
47
51
  done_criteria:
@@ -141,6 +141,22 @@ specdojo:
141
141
  - 生成時プレースホルダは `frontmatter_template` と本文の相互参照の両方に現れ、生成処理が一括置換する。
142
142
  - 記入プレースホルダは生成物に残し、recipe に従って作成者が埋める。生成処理は置換しない。
143
143
 
144
+ ### 2.4. 文脈の目印
145
+
146
+ - 本文の斜体は、共通の目印 `_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` / `_CONTEXT_` に限って使用する。
147
+ - `_CONTEXT_` は、成果物を下書きするために人が記入する前提や調査・選定の指示を示す。適用する場所の段落の先頭に `_CONTEXT_:` と書く。文書全体にかかる指示は先頭の章に置き、文脈専用の章は増やさない。
148
+ - 一つの指示は一つの段落にまとめる。記法の説明や元の指示の引用では、インラインコードまたはコードブロックを使い、未反映の指示と区別する。
149
+ - `draft` は指示を本文へ反映した後、その段落から目印と元の指示を消し、元の指示と反映箇所を result に記録する。反映できない指示は残し、理由と次の行動を記録する。executor / reporter pipeline では元の指示と反映箇所を executor の報告の `handoff` に記載し、reporter と runner が result へ転記する。
150
+ - `fully-guided` は残った指示を反映・削除せず、未反映の指示と必要な下書きを論点として result に記録し、`draft` へ申し送る。
151
+ - `finalize` / `bootstrap-finalize` は、確定対象に未反映の指示が残っていれば承認せず差し戻す。
152
+ - `lint:fm` の `remark-md-content` は、コード例を除き段落先頭の `_CONTEXT_:` を検出する。Frontmatter の `specdojo.status` が `ready` なら error、それ以外(状態の指定なしを含む)は情報とする。
153
+
154
+ ```markdown
155
+ ## 1. 概要
156
+
157
+ _CONTEXT_: 静的サイトに適した技術を調べ、候補と選定理由を提案する。
158
+ ```
159
+
144
160
  ## 3. 独立 YAML データファイルのメタ情報
145
161
 
146
162
  独立 YAML データファイルは Frontmatter を持たないため、ファイル先頭のトップレベル項目でメタ情報を表す。
@@ -40,6 +40,7 @@ Human Finalize Execution Standard
40
40
  ### 3.2. 本文
41
41
 
42
42
  - 「確認チェックリスト」には catalog の全 `done_criteria` を重複なく展開します。
43
+ - 「確認チェックリスト」には、確定対象の本文に未反映の `_CONTEXT_:` が残っていないことを含めます。残っていれば承認せず、理由を result に記録して `draft` へ差し戻します。
43
44
  - 「確定対象」には `targets` から解決した実在文書を列挙し、確認と `ready` 昇格後にチェックします。
44
45
  - 「確定判断」は承認または差し戻しのどちらかを実値で記録し、プレースホルダを残しません。
45
46
  - `bootstrap-finalize` では実践の型の種別別確認を追加し、対象に存在しない種別の行は削除します。
@@ -104,6 +104,7 @@ specdojo:
104
104
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
105
105
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
106
106
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
107
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
107
108
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
108
109
 
109
110
  ## 7. 禁止事項
@@ -113,7 +114,7 @@ specdojo:
113
114
  - 規範(must ルール・規約)を guide で新規に定義しない。standard / rulebook を正本とする。
114
115
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
115
116
  - デッドリンクを記載しない。
116
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
117
118
  - `導入ブロック` の3ブロックを省略しない。ラベル名を変えない。順序を入れ替えない。
118
119
  - 全 guide / reference を並べた目的別の横断一覧を、`specdojo:specdojo-overview-guide` 以外に置かない。
119
120
 
@@ -95,6 +95,7 @@ specdojo:
95
95
  - 比較・対応・区別など、見比べる情報は表に置く。
96
96
  - 例を用いる場合は、[sample-authoring-standard.md](sample-authoring-standard.md) の `共通サンプル文脈` に合わせる。
97
97
  - 未確定事項や仮置き情報は、`_TODO_` / `_UNDECIDED_` / `_ASSUMPTION_` のラベルで記述する。
98
+ - 下書きへの指示には `_CONTEXT_:` を使う。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
98
99
 
99
100
  ## 7. 禁止事項
100
101
 
@@ -71,6 +71,7 @@ Recipe Authoring Standard
71
71
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
72
72
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
73
73
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
74
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
74
75
  - リンクはファイルがある場合に記載し、ない場合はバッククォートで仮置きする。
75
76
 
76
77
  ### 5.1. Why・What・How・Trace の共通原則
@@ -134,7 +135,7 @@ Why は What の必要性を説明し、What は How が満たすべき境界を
134
135
  - rulebook / recipe / sample / template の種別ごとの役割分担表を recipe 本文に置かない(実践の型全体の役割は [kata-guide.md](../guides/kata-guide.md) が扱う)。
135
136
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
136
137
  - recipe 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
137
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
138
139
 
139
140
  ## 8. 運用ルール
140
141
 
@@ -111,6 +111,7 @@ specdojo:
111
111
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
112
112
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
113
113
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
114
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
114
115
  - `サンプル` 章を置く場合は、最小例をコードブロックで本文内に自己完結して埋め込む。sample ファイルの要否と所在は Frontmatter の `sample` で宣言し、本文にリンクを記載しない。
115
116
  - template が不要な場合は Frontmatter へ `template: not-needed`、要否未判断なら `template: undecided` を宣言する。項目省略は必要だが未整備を表す。いずれも `deliverable scaffold` は最小雛形へ退避する。
116
117
 
@@ -131,7 +132,7 @@ specdojo:
131
132
  - 本文に sample / recipe / template への wikilink・リンク章を置かない。対応関係は Frontmatter の `sample` / `recipe` / `template` で示す。
132
133
  - rulebook 本文に実装詳細(SQL 全文、具体クラス名、詳細 API 設計)を書かない。
133
134
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
134
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
135
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
135
136
  - 確定済みの内容をラベル付きのまま放置したり、ラベルを本文の代替として多用したりしない。
136
137
 
137
138
  ## 8. 運用ルール
@@ -82,6 +82,7 @@ specdojo:
82
82
  - _TODO_: 後で人または生成 AI が確認・追記・修正する必要がある事項
83
83
  - _UNDECIDED_: 情報不足ではなく、意思決定が未了で未確定の事項
84
84
  - _ASSUMPTION_: 現時点で仮置きしている前提・仮説
85
+ - `_CONTEXT_:`: 下書きへの指示。記法と反映・記録は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従う。
85
86
 
86
87
  ## 6. 内容充実化(薄いドキュメント防止)
87
88
 
@@ -99,7 +100,7 @@ specdojo:
99
100
  - 手順・操作・使い方など guide が担う説明を standard の主目的にしない。
100
101
  - 曖昧語(十分、適切、問題ない)を根拠なく使用しない。
101
102
  - schema で機械検証する制約を本文に二重定義し、両者を乖離させない。
102
- - _TODO_: / _UNDECIDED_: / _ASSUMPTION_: 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
+ - `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
103
104
 
104
105
  ## 8. 運用ルール
105
106