dflow-sdd-ddd 0.1.0 → 0.2.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 (52) hide show
  1. package/CHANGELOG.md +1176 -0
  2. package/CONTRIBUTING.md +123 -0
  3. package/README.md +199 -157
  4. package/TEMPLATE-COVERAGE.md +46 -0
  5. package/TEMPLATE-LANGUAGE-GLOSSARY.md +52 -0
  6. package/bin/dflow.js +73 -8
  7. package/docs/evaluating-dflow.md +226 -0
  8. package/docs/migrating-to-dflow-v1.md +212 -0
  9. package/docs/npm-publish-checklist.md +93 -0
  10. package/docs/release-versioning-policy.md +99 -0
  11. package/docs/using-with-claude-code.md +207 -0
  12. package/docs/using-with-codex.md +244 -0
  13. package/docs/why-ddd-for-ai.md +35 -0
  14. package/lib/init.js +444 -66
  15. package/package.json +13 -7
  16. package/templates/brownfield/scaffolding/AI-AGENT-GUIDE.md +92 -0
  17. package/templates/{webforms → brownfield}/scaffolding/CLAUDE-md-snippet.md +8 -9
  18. package/templates/{webforms → brownfield}/scaffolding/Git-principles-gitflow.md +1 -1
  19. package/templates/{webforms → brownfield}/scaffolding/Git-principles-trunk.md +1 -1
  20. package/templates/{webforms → brownfield}/scaffolding/_conventions.md +2 -1
  21. package/templates/{webforms → brownfield}/scaffolding/_overview.md +2 -2
  22. package/templates/{webforms → brownfield}/templates/context-map.md +1 -1
  23. package/templates/{webforms → brownfield}/templates/glossary.md +1 -1
  24. package/templates/{webforms → brownfield}/templates/models.md +1 -1
  25. package/templates/{webforms → brownfield}/templates/phase-spec.md +1 -1
  26. package/templates/{webforms → brownfield}/templates/rules.md +1 -1
  27. package/templates/{webforms → brownfield}/templates/tech-debt.md +1 -1
  28. package/templates/greenfield/scaffolding/AI-AGENT-GUIDE.md +92 -0
  29. package/templates/{core → greenfield}/scaffolding/CLAUDE-md-snippet.md +15 -14
  30. package/templates/{core → greenfield}/scaffolding/Git-principles-gitflow.md +1 -1
  31. package/templates/{core → greenfield}/scaffolding/Git-principles-trunk.md +1 -1
  32. package/templates/{core → greenfield}/scaffolding/_conventions.md +2 -1
  33. package/templates/{core → greenfield}/scaffolding/_overview.md +2 -2
  34. package/templates/{core → greenfield}/scaffolding/architecture-decisions-README.md +1 -1
  35. package/templates/{core → greenfield}/templates/context-map.md +1 -1
  36. package/templates/{core → greenfield}/templates/events.md +1 -1
  37. package/templates/{core → greenfield}/templates/glossary.md +1 -1
  38. package/templates/{core → greenfield}/templates/models.md +1 -1
  39. package/templates/{core → greenfield}/templates/phase-spec.md +1 -1
  40. package/templates/{core → greenfield}/templates/rules.md +1 -1
  41. package/templates/{core → greenfield}/templates/tech-debt.md +1 -1
  42. /package/templates/{webforms → brownfield}/templates/CLAUDE.md +0 -0
  43. /package/templates/{webforms → brownfield}/templates/_index.md +0 -0
  44. /package/templates/{webforms → brownfield}/templates/behavior.md +0 -0
  45. /package/templates/{webforms → brownfield}/templates/context-definition.md +0 -0
  46. /package/templates/{webforms → brownfield}/templates/lightweight-spec.md +0 -0
  47. /package/templates/{core → greenfield}/templates/CLAUDE.md +0 -0
  48. /package/templates/{core → greenfield}/templates/_index.md +0 -0
  49. /package/templates/{core → greenfield}/templates/aggregate-design.md +0 -0
  50. /package/templates/{core → greenfield}/templates/behavior.md +0 -0
  51. /package/templates/{core → greenfield}/templates/context-definition.md +0 -0
  52. /package/templates/{core → greenfield}/templates/lightweight-spec.md +0 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dflow-sdd-ddd",
3
- "version": "0.1.0",
4
- "description": "Dflow SDD/DDD project scaffolding CLI",
3
+ "version": "0.2.0",
4
+ "description": "Spec-first SDD/DDD workflow kit for AI-assisted development",
5
5
  "type": "commonjs",
6
6
  "bin": {
7
7
  "dflow": "bin/dflow.js",
@@ -12,7 +12,12 @@
12
12
  },
13
13
  "files": [
14
14
  "bin/",
15
+ "CHANGELOG.md",
16
+ "CONTRIBUTING.md",
17
+ "docs/",
15
18
  "lib/",
19
+ "TEMPLATE-COVERAGE.md",
20
+ "TEMPLATE-LANGUAGE-GLOSSARY.md",
16
21
  "templates/",
17
22
  "README.md"
18
23
  ],
@@ -21,17 +26,18 @@
21
26
  "ddd",
22
27
  "specification-driven-development",
23
28
  "domain-driven-design",
24
- "codex",
25
- "claude-code"
29
+ "spec-first",
30
+ "ai-assisted-development",
31
+ "ai-coding-agent"
26
32
  ],
27
33
  "repository": {
28
34
  "type": "git",
29
- "url": "git+ssh://git@github.com/weilung/AI-Guided-SDD-DDD-Development-Skills.git"
35
+ "url": "git+ssh://git@github.com/weilung/dflow-sdd-ddd.git"
30
36
  },
31
37
  "bugs": {
32
- "url": "https://github.com/weilung/AI-Guided-SDD-DDD-Development-Skills/issues"
38
+ "url": "https://github.com/weilung/dflow-sdd-ddd/issues"
33
39
  },
34
- "homepage": "https://github.com/weilung/AI-Guided-SDD-DDD-Development-Skills#readme",
40
+ "homepage": "https://github.com/weilung/dflow-sdd-ddd#readme",
35
41
  "scripts": {
36
42
  "test": "node test/smoke.mjs"
37
43
  },
@@ -0,0 +1,92 @@
1
+ # Dflow AI Agent Guide
2
+
3
+ This project uses Dflow for spec-first AI-assisted development.
4
+
5
+ ## Project Context
6
+
7
+ | Field | Value |
8
+ |---|---|
9
+ | Project | {System Name} |
10
+ | Dflow track | {edition} |
11
+ | Project type | {project-type} |
12
+ | Tech stack | {tech-stack-summary} |
13
+ | Migration / legacy context | {migration-context} |
14
+ | Prose language | {prose-language} |
15
+
16
+ ## Before Editing Code
17
+
18
+ Do not jump from a request directly to code. First identify the matching
19
+ Dflow workflow and confirm the intended path with the developer.
20
+
21
+ Use these workflow entry points as plain chat instructions if slash commands
22
+ are not available in the current AI tool:
23
+
24
+ | Workflow | Use when |
25
+ |---|---|
26
+ | `/dflow:new-feature` | A new user-visible capability or business behavior is requested. |
27
+ | `/dflow:modify-existing` | Existing behavior needs to change. |
28
+ | `/dflow:bug-fix` | A defect can be described with expected vs actual behavior. |
29
+ | `/dflow:new-phase` | An active feature needs another implementation slice. |
30
+ | `/dflow:finish-feature` | Implementation is complete and needs drift closure. |
31
+ | `/dflow:verify` | Specs, domain docs, implementation, and tests need consistency checks. |
32
+ | `/dflow:pr-review` | A change is ready for SDD/DDD review. |
33
+ | `/dflow:report-dflow-feedback` | You found a Dflow issue or improvement and want a sanitized upstream feedback draft. |
34
+
35
+ ## Source of Truth
36
+
37
+ Dflow-owned project documents live under `dflow/specs/`.
38
+
39
+ | Area | Path |
40
+ |---|---|
41
+ | Shared conventions | `dflow/specs/shared/_conventions.md` |
42
+ | System overview | `dflow/specs/shared/_overview.md` |
43
+ | Domain glossary | `dflow/specs/domain/glossary.md` |
44
+ | Context map | `dflow/specs/domain/context-map.md` |
45
+ | Active feature specs | `dflow/specs/features/active/` |
46
+ | Completed feature snapshots | `dflow/specs/features/completed/` |
47
+ | Technical debt | `dflow/specs/architecture/tech-debt.md` or `dflow/specs/migration/tech-debt.md` |
48
+
49
+ ## Core Rules
50
+
51
+ 1. Spec before code: meaningful behavior changes need a spec or lightweight bug spec before implementation.
52
+ 2. Keep domain language explicit: update glossary, rules, models, and behavior snapshots when domain meaning changes.
53
+ 3. Keep phase delta, feature snapshot, and system state separate.
54
+ 4. Check drift before calling work complete.
55
+ 5. Follow `dflow/specs/shared/_conventions.md`, especially `## Prose Language`.
56
+
57
+ ## Pre-V1 Artifacts Detection
58
+
59
+ When working in a project that adopted Dflow before `dflow-sdd-ddd@0.1.0`,
60
+ you may encounter layout or naming patterns that predate the V1 baseline.
61
+ If any of the following appear, surface the observation to the developer
62
+ and recommend manual migration; do not rewrite anything silently.
63
+
64
+ Signals:
65
+
66
+ - Top-level `specs/` directory containing Dflow-shaped content (V1 layout
67
+ uses `dflow/specs/`).
68
+ - `_共用/` directory under `specs/` or `dflow/specs/` (V1 uses `shared/`).
69
+ - Section headings in Traditional Chinese where V1 templates render
70
+ canonical English; compare against `TEMPLATE-LANGUAGE-GLOSSARY.md` if
71
+ available.
72
+ - References to a runtime `/dflow:init-project` slash command (V1
73
+ replaced it with the shell command `npx dflow-sdd-ddd init`).
74
+ - A root `CLAUDE.md`, `AGENTS.md`, or equivalent that holds the full
75
+ Dflow workflow text instead of being a thin shim pointing to this
76
+ file.
77
+ - `dflow/specs/shared/_conventions.md` is missing the `> Dflow Version:`
78
+ front-matter line (V1 init writes it automatically).
79
+
80
+ Recommend `docs/migrating-to-dflow-v1.md` for the manual migration
81
+ checklist. Migration affects every spec the team has written; manual
82
+ review is required.
83
+
84
+ ## Tool-Specific Notes
85
+
86
+ This file is the canonical Dflow guide. Root-level files such as
87
+ `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md`
88
+ should stay thin and point back here.
89
+
90
+ If a tool does not support Dflow slash commands, treat the command names as
91
+ plain workflow names and execute the matching process from the Dflow skill
92
+ source in this repository.
@@ -1,17 +1,15 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # CLAUDE.md Snippet — Dflow Adoption
4
4
 
5
5
  > This file is a **snippet**, not a standalone `CLAUDE.md`. Its purpose
6
6
  > is to be merged into your project's root `CLAUDE.md`:
7
7
  >
8
- > - If your project does **not** yet have a `CLAUDE.md`, the
9
- > `npx dflow-sdd-ddd init` flow will create one using this snippet as
10
- > the starting content.
11
- > - If your project **already has** a `CLAUDE.md`, the init flow will
12
- > copy this file into your repo and prompt you to merge the
13
- > sections below into the appropriate places in your existing
14
- > `CLAUDE.md`. No auto-merge — you keep editorial control.
8
+ > - New `npx dflow-sdd-ddd init` output uses
9
+ > `dflow/specs/shared/AI-AGENT-GUIDE.md` as the canonical guide and
10
+ > creates a thin `CLAUDE.md` shim that points back to it.
11
+ > - Use this legacy snippet only if you intentionally want the older
12
+ > Claude-specific two-H2 layout in your project's root `CLAUDE.md`.
15
13
 
16
14
  The snippet follows the Dflow `templates/CLAUDE.md` H2 segmentation
17
15
  (established in PROPOSAL-007c): **System Context** (what the system is)
@@ -93,7 +91,7 @@ src/
93
91
 
94
92
  AI 的完整決策樹、Workflow Transparency、Ceremony Scaling 三層判準
95
93
  (T1/T2/T3)、各 `/dflow:` 命令的具體流程,**全部定義於 Dflow skill
96
- 本體**(`sdd-ddd-webforms-skill/SKILL.md` 與 `references/*.md`)。
94
+ 本體**(`sdd-ddd-brownfield-skill/SKILL.md` 與 `references/*.md`)。
97
95
  本 `CLAUDE.md` 不重述這些內容,避免雙份維護。
98
96
 
99
97
  當你作為 AI assistant 被呼叫時,若偵測到使用者需要 SDD/DDD 工作流
@@ -107,6 +105,7 @@ AI 的完整決策樹、Workflow Transparency、Ceremony Scaling 三層判準
107
105
  - `/dflow:finish-feature` — feature 收尾
108
106
  - `/dflow:pr-review` — PR 審查
109
107
  - `/dflow:verify` — rules.md ↔ behavior.md 漂移檢查
108
+ - `/dflow:report-dflow-feedback` — 草擬給 Dflow upstream 的已清理回饋,不自動送出
110
109
  - `/dflow:status` / `/dflow:next` / `/dflow:cancel` — 狀態管理
111
110
 
112
111
  ### Project-Level Supplemental Rules
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Git Principles — Git Flow edition
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Git Principles — Trunk-based / GitHub Flow edition
4
4
 
@@ -1,8 +1,9 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Spec Writing Conventions — {System Name}
4
4
 
5
5
  > Created: {YYYY-MM-DD}
6
+ > Dflow Version: {dflow-version}
6
7
  > Scope: how spec documents are authored and named in this project.
7
8
  > Audience: engineers writing specs; AI assistants producing spec drafts.
8
9
 
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # System Overview — {System Name}
4
4
 
@@ -105,5 +105,5 @@ Link to any ADR or migration plan doc if one exists.}
105
105
  branching-strategy-specific file that matches this project
106
106
  - [Glossary](../domain/glossary.md)
107
107
  - [Tech debt backlog](../migration/tech-debt.md)
108
- - Dflow skill: see `CLAUDE.md` and the `sdd-ddd-webforms-skill/` bundle
108
+ - Dflow skill: see `CLAUDE.md` and the `sdd-ddd-brownfield-skill/` bundle
109
109
  for the full AI workflow guidance.
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Context Map
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Glossary
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Domain Models
4
4
 
@@ -173,7 +173,7 @@ Then {新的預期結果}
173
173
 
174
174
  > AI 在 Phase 4 實作規劃完成後,根據「Implementation Notes」產生的具體任務清單。
175
175
  > 格式:`[LAYER]-[NUMBER]: 任務描述`
176
- > 分類標籤(WebForms 版):
176
+ > 分類標籤(Brownfield track):
177
177
  > - `DOMAIN` — Domain 層類別、VO、Service、Interface
178
178
  > - `PAGE` — Code-Behind / ASPX 變更
179
179
  > - `DATA` — 資料表 schema 或 Repository 實作
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Business Rules
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Migration Tech Debt
4
4
 
@@ -0,0 +1,92 @@
1
+ # Dflow AI Agent Guide
2
+
3
+ This project uses Dflow for spec-first AI-assisted development.
4
+
5
+ ## Project Context
6
+
7
+ | Field | Value |
8
+ |---|---|
9
+ | Project | {System Name} |
10
+ | Dflow track | {edition} |
11
+ | Project type | {project-type} |
12
+ | Tech stack | {tech-stack-summary} |
13
+ | Migration / legacy context | {migration-context} |
14
+ | Prose language | {prose-language} |
15
+
16
+ ## Before Editing Code
17
+
18
+ Do not jump from a request directly to code. First identify the matching
19
+ Dflow workflow and confirm the intended path with the developer.
20
+
21
+ Use these workflow entry points as plain chat instructions if slash commands
22
+ are not available in the current AI tool:
23
+
24
+ | Workflow | Use when |
25
+ |---|---|
26
+ | `/dflow:new-feature` | A new user-visible capability or business behavior is requested. |
27
+ | `/dflow:modify-existing` | Existing behavior needs to change. |
28
+ | `/dflow:bug-fix` | A defect can be described with expected vs actual behavior. |
29
+ | `/dflow:new-phase` | An active feature needs another implementation slice. |
30
+ | `/dflow:finish-feature` | Implementation is complete and needs drift closure. |
31
+ | `/dflow:verify` | Specs, domain docs, implementation, and tests need consistency checks. |
32
+ | `/dflow:pr-review` | A change is ready for SDD/DDD review. |
33
+ | `/dflow:report-dflow-feedback` | You found a Dflow issue or improvement and want a sanitized upstream feedback draft. |
34
+
35
+ ## Source of Truth
36
+
37
+ Dflow-owned project documents live under `dflow/specs/`.
38
+
39
+ | Area | Path |
40
+ |---|---|
41
+ | Shared conventions | `dflow/specs/shared/_conventions.md` |
42
+ | System overview | `dflow/specs/shared/_overview.md` |
43
+ | Domain glossary | `dflow/specs/domain/glossary.md` |
44
+ | Context map | `dflow/specs/domain/context-map.md` |
45
+ | Active feature specs | `dflow/specs/features/active/` |
46
+ | Completed feature snapshots | `dflow/specs/features/completed/` |
47
+ | Technical debt | `dflow/specs/architecture/tech-debt.md` or `dflow/specs/migration/tech-debt.md` |
48
+
49
+ ## Core Rules
50
+
51
+ 1. Spec before code: meaningful behavior changes need a spec or lightweight bug spec before implementation.
52
+ 2. Keep domain language explicit: update glossary, rules, models, and behavior snapshots when domain meaning changes.
53
+ 3. Keep phase delta, feature snapshot, and system state separate.
54
+ 4. Check drift before calling work complete.
55
+ 5. Follow `dflow/specs/shared/_conventions.md`, especially `## Prose Language`.
56
+
57
+ ## Pre-V1 Artifacts Detection
58
+
59
+ When working in a project that adopted Dflow before `dflow-sdd-ddd@0.1.0`,
60
+ you may encounter layout or naming patterns that predate the V1 baseline.
61
+ If any of the following appear, surface the observation to the developer
62
+ and recommend manual migration; do not rewrite anything silently.
63
+
64
+ Signals:
65
+
66
+ - Top-level `specs/` directory containing Dflow-shaped content (V1 layout
67
+ uses `dflow/specs/`).
68
+ - `_共用/` directory under `specs/` or `dflow/specs/` (V1 uses `shared/`).
69
+ - Section headings in Traditional Chinese where V1 templates render
70
+ canonical English; compare against `TEMPLATE-LANGUAGE-GLOSSARY.md` if
71
+ available.
72
+ - References to a runtime `/dflow:init-project` slash command (V1
73
+ replaced it with the shell command `npx dflow-sdd-ddd init`).
74
+ - A root `CLAUDE.md`, `AGENTS.md`, or equivalent that holds the full
75
+ Dflow workflow text instead of being a thin shim pointing to this
76
+ file.
77
+ - `dflow/specs/shared/_conventions.md` is missing the `> Dflow Version:`
78
+ front-matter line (V1 init writes it automatically).
79
+
80
+ Recommend `docs/migrating-to-dflow-v1.md` for the manual migration
81
+ checklist. Migration affects every spec the team has written; manual
82
+ review is required.
83
+
84
+ ## Tool-Specific Notes
85
+
86
+ This file is the canonical Dflow guide. Root-level files such as
87
+ `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md`
88
+ should stay thin and point back here.
89
+
90
+ If a tool does not support Dflow slash commands, treat the command names as
91
+ plain workflow names and execute the matching process from the Dflow skill
92
+ source in this repository.
@@ -1,24 +1,24 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
- # CLAUDE.md Snippet — Dflow Adoption (Core edition)
3
+ # CLAUDE.md Snippet — Dflow Adoption (Greenfield track)
4
4
 
5
5
  > Source: `scaffolding/CLAUDE-md-snippet.md`
6
6
  > Purpose: a minimal block you paste into (or replace with) your
7
7
  > project's root `CLAUDE.md` when adopting Dflow.
8
- > For the Core skill, the full reference template lives at
9
- > `sdd-ddd-core-skill/templates/CLAUDE.md` — if you want the complete
10
- > version, use that instead. This snippet is a lighter starting point.
8
+ > For the Greenfield track, the full reference template lives at
9
+ > `sdd-ddd-greenfield-skill/templates/CLAUDE.md` — if you want the complete
10
+ > legacy Claude-specific version, use that instead. New CLI init output uses
11
+ > `AI-AGENT-GUIDE.md` plus a generated `CLAUDE.md` shim.
11
12
 
12
13
  ---
13
14
 
14
15
  ## How to use this snippet
15
16
 
16
- - **If your project has no `CLAUDE.md`**: `npx dflow-sdd-ddd init` will
17
- create one using this snippet as the base
18
- - **If your project already has a `CLAUDE.md`**: do NOT overwrite.
19
- Merge the **two H2 blocks** below (`System Context` / `Development Workflow`) into your
20
- existing file, preserving any project-specific content you already
21
- have
17
+ - New `npx dflow-sdd-ddd init` output uses
18
+ `dflow/specs/shared/AI-AGENT-GUIDE.md` as the canonical guide and creates
19
+ a thin `CLAUDE.md` shim that points back to it.
20
+ - Use this legacy snippet only if you intentionally want the older
21
+ Claude-specific two-H2 layout in your project's root `CLAUDE.md`.
22
22
 
23
23
  The two-H2 structure (`System Context` / `Development Workflow`) is intentional and must be
24
24
  preserved — it matches the Dflow skill's `templates/CLAUDE.md` and
@@ -97,8 +97,8 @@ AI 的完整決策樹、Workflow Transparency、Ceremony Scaling 三層判準
97
97
  (T1 Heavy / T2 Light / T3 Trivial)、所有 slash command 的 step-by-step
98
98
  流程 **不在此重述**,請以 Dflow skill 本體為準:
99
99
 
100
- - `sdd-ddd-core-skill/SKILL.md`(決策樹 + Slash Commands 總表)
101
- - `sdd-ddd-core-skill/references/` 內各 flow 文件
100
+ - `sdd-ddd-greenfield-skill/SKILL.md`(決策樹 + Slash Commands 總表)
101
+ - `sdd-ddd-greenfield-skill/references/` 內各 flow 文件
102
102
 
103
103
  本專案採用的 Dflow entry points:
104
104
  - `npx dflow-sdd-ddd init` — 專案初始化(一次性,已執行過)
@@ -108,6 +108,7 @@ AI 的完整決策樹、Workflow Transparency、Ceremony Scaling 三層判準
108
108
  - `/dflow:bug-fix` — Bug 修復
109
109
  - `/dflow:finish-feature` — Feature 收尾 + 整合摘要
110
110
  - `/dflow:pr-review` — PR 審查檢查點
111
+ - `/dflow:report-dflow-feedback` — 草擬給 Dflow upstream 的已清理回饋,不自動送出
111
112
 
112
113
  ### Core Principles (Project Reaffirmed)
113
114
 
@@ -158,7 +159,7 @@ AI 的完整決策樹、Workflow Transparency、Ceremony Scaling 三層判準
158
159
  ## Notes
159
160
 
160
161
  - This snippet is intentionally lighter than
161
- `sdd-ddd-core-skill/templates/CLAUDE.md`. If you want the full version
162
+ `sdd-ddd-greenfield-skill/templates/CLAUDE.md`. If you want the full version
162
163
  (with detailed flow descriptions per slash command), use that
163
164
  template instead
164
165
  - The snippet does NOT re-copy the Dflow decision tree, Ceremony
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Git Principles — Git Flow edition
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Git Principles — Trunk-based / GitHub Flow edition
4
4
 
@@ -1,8 +1,9 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # Spec Writing Conventions — {System Name}
4
4
 
5
5
  > Created: {YYYY-MM-DD}
6
+ > Dflow Version: {dflow-version}
6
7
  > Scope: how spec documents are authored and named in this project.
7
8
  > Audience: engineers writing specs; AI assistants producing spec drafts.
8
9
 
@@ -1,4 +1,4 @@
1
- <!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->
1
+ <!-- Scaffolding template maintained alongside Dflow skill. See archive/proposals/PROPOSAL-010 for origin. -->
2
2
 
3
3
  # System Overview — {System Name}
4
4
 
@@ -161,5 +161,5 @@ Initial ADRs that typically exist:
161
161
  - [Glossary](../domain/glossary.md)
162
162
  - [Tech debt backlog](../architecture/tech-debt.md)
163
163
  - [Architecture decisions](../architecture/decisions/)
164
- - Dflow skill: see `CLAUDE.md` and the `sdd-ddd-core-skill/` bundle
164
+ - Dflow skill: see `CLAUDE.md` and the `sdd-ddd-greenfield-skill/` bundle
165
165
  for the full AI workflow guidance.
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Architecture Decisions
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Context Map
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Domain Events
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Glossary
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Domain Models
4
4
 
@@ -178,7 +178,7 @@ And {產生的 Domain Event}
178
178
 
179
179
  > AI 在 Phase 4 實作規劃完成後,根據「Implementation Plan (Layer by Layer)」產生的具體任務清單。
180
180
  > 格式:`[LAYER]-[NUMBER]: 任務描述`
181
- > 分類標籤(Core 版,對應 Clean Architecture 各層):
181
+ > 分類標籤(Greenfield track,對應 Clean Architecture 各層):
182
182
  > - `DOMAIN` — Aggregate、Entity、VO、Domain Event、Domain Service、Repository Interface
183
183
  > - `APP` — Command/Query、Handler、Validator、DTO、Event Handler
184
184
  > - `INFRA` — EF Configuration、Repository Impl、外部服務 adapter、Migration
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Business Rules
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Template maintained by Dflow. See proposals/PROPOSAL-013 for origin. -->
1
+ <!-- Template maintained by Dflow. See archive/proposals/PROPOSAL-013 for origin. -->
2
2
 
3
3
  # Architecture Tech Debt
4
4