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.
- package/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +100 -0
- package/README.md +2 -2
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +2 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/deliverable/deliverable.js +77 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +4 -3
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/core.js +1 -0
- package/dist/exec/parent-validation.js +14 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-core.js +46 -1
- package/dist/exec/plans-generation.js +45 -5
- package/dist/exec/plans-planning.js +1 -1
- package/dist/exec/plans-storage.js +1 -0
- 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-resume.js +28 -0
- package/dist/exec/register.js +6 -0
- package/dist/exec/repo-integration-sync.js +4 -2
- package/dist/exec/repo-integration.js +41 -4
- package/dist/exec/repo-trace.js +2 -0
- package/dist/exec/results.js +9 -5
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +22 -0
- package/dist/exec/run/register-resume.js +11 -1
- package/dist/exec/run/register-worktree.js +29 -8
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +49 -4
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/strategy.js +2 -1
- package/dist/exec/task-repos.js +78 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/exec/worktree.js +3 -3
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +54 -2
- package/dist/register/deliverable-target.js +24 -17
- package/dist/register/event-merge.js +4 -0
- package/dist/register/events.js +6 -0
- package/dist/register/external-project.js +2 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +61 -0
- package/dist/register/register.js +33 -25
- package/dist/register/renumber.js +4 -0
- package/dist/register/update.js +6 -0
- package/dist/schedule/approach.js +9 -0
- package/dist/schedule/strategy-profiles.js +22 -2
- package/dist/shared/agent-types.js +4 -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/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-config.js +35 -4
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -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/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 +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
- package/docs/ja/specdojo/guides/register-operation-guide.md +16 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- 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/schedule-operation-guide.md +14 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
- package/docs/ja/specdojo/references/command-reference.md +111 -46
- package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +8 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
- package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
- 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/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 +2 -1
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- 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/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
- package/package.json +6 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +2 -0
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -11,136 +11,167 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
# 概念データフロー図(ユースケース別): 欠品から補充まで
|
|
13
13
|
|
|
14
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
49
|
+
全体概要からこのケースで参照・更新する正本だけを同じ名称・区分で示す。
|
|
75
50
|
|
|
76
51
|
### 4.1. マスタ・構成データ
|
|
77
52
|
|
|
78
|
-
| データストア |
|
|
79
|
-
| ------------ |
|
|
80
|
-
| 商品台帳 |
|
|
53
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
54
|
+
| ------------ | ---------------- | ---------------------------------------------- |
|
|
55
|
+
| 商品台帳 | 在庫 | 補充基準と発注単位を参照し、補充対象を特定する |
|
|
81
56
|
|
|
82
57
|
### 4.2. トランザクションデータ
|
|
83
58
|
|
|
84
|
-
| データストア |
|
|
85
|
-
| ------------ |
|
|
86
|
-
| 在庫記録 |
|
|
87
|
-
| 仕入記録 |
|
|
88
|
-
| 売場棚 |
|
|
59
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
60
|
+
| ------------ | ---------------- | ------------------------------------------------------ |
|
|
61
|
+
| 在庫記録 | 在庫、仕入 | 在庫数量を参照して補充対象を判断し、入荷数量を反映する |
|
|
62
|
+
| 仕入記録 | 仕入 | 発注・受入結果を記録する |
|
|
63
|
+
| 売場棚 | 仕入、販売 | 受入品を配置し、販売が売場商品を引き受ける(物理保管) |
|
|
89
64
|
|
|
90
65
|
## 5. 概念データフロー
|
|
91
66
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
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
|
-
|
|
146
|
+
凡例は [[specdojo:cdfd-overview-sample|全体概要]] の「凡例(本プロダクト共通)」を参照し、通常線は情報、太線は商品の流れに用いる。各グループ内部は省略し、次の図でも在庫・仕入・販売の代表ノードを共有する。
|
|
147
|
+
|
|
148
|
+
### 5.2. 例外時の戻り
|
|
149
|
+
|
|
150
|
+
補充依頼の不足は仕入から在庫へ、受入結果や売場配置の不一致は販売から仕入へ返し、補完・再判断後の情報を再提示する。
|
|
133
151
|
|
|
134
|
-
|
|
152
|
+
```d2
|
|
153
|
+
direction: down
|
|
135
154
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
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
|
-
|
|
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_
|
|
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_
|
|
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_
|
|
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_
|
|
103
|
+
- `_TODO_:` / `_UNDECIDED_:` / `_ASSUMPTION_:` / `_CONTEXT_:` 以外の独自ラベルを、共通ルール未定義のまま追加しない。
|
|
103
104
|
|
|
104
105
|
## 8. 運用ルール
|
|
105
106
|
|