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.
- package/CHANGELOG.md +1176 -0
- package/CONTRIBUTING.md +123 -0
- package/README.md +199 -157
- package/TEMPLATE-COVERAGE.md +46 -0
- package/TEMPLATE-LANGUAGE-GLOSSARY.md +52 -0
- package/bin/dflow.js +73 -8
- package/docs/evaluating-dflow.md +226 -0
- package/docs/migrating-to-dflow-v1.md +212 -0
- package/docs/npm-publish-checklist.md +93 -0
- package/docs/release-versioning-policy.md +99 -0
- package/docs/using-with-claude-code.md +207 -0
- package/docs/using-with-codex.md +244 -0
- package/docs/why-ddd-for-ai.md +35 -0
- package/lib/init.js +444 -66
- package/package.json +13 -7
- package/templates/brownfield/scaffolding/AI-AGENT-GUIDE.md +92 -0
- package/templates/{webforms → brownfield}/scaffolding/CLAUDE-md-snippet.md +8 -9
- package/templates/{webforms → brownfield}/scaffolding/Git-principles-gitflow.md +1 -1
- package/templates/{webforms → brownfield}/scaffolding/Git-principles-trunk.md +1 -1
- package/templates/{webforms → brownfield}/scaffolding/_conventions.md +2 -1
- package/templates/{webforms → brownfield}/scaffolding/_overview.md +2 -2
- package/templates/{webforms → brownfield}/templates/context-map.md +1 -1
- package/templates/{webforms → brownfield}/templates/glossary.md +1 -1
- package/templates/{webforms → brownfield}/templates/models.md +1 -1
- package/templates/{webforms → brownfield}/templates/phase-spec.md +1 -1
- package/templates/{webforms → brownfield}/templates/rules.md +1 -1
- package/templates/{webforms → brownfield}/templates/tech-debt.md +1 -1
- package/templates/greenfield/scaffolding/AI-AGENT-GUIDE.md +92 -0
- package/templates/{core → greenfield}/scaffolding/CLAUDE-md-snippet.md +15 -14
- package/templates/{core → greenfield}/scaffolding/Git-principles-gitflow.md +1 -1
- package/templates/{core → greenfield}/scaffolding/Git-principles-trunk.md +1 -1
- package/templates/{core → greenfield}/scaffolding/_conventions.md +2 -1
- package/templates/{core → greenfield}/scaffolding/_overview.md +2 -2
- package/templates/{core → greenfield}/scaffolding/architecture-decisions-README.md +1 -1
- package/templates/{core → greenfield}/templates/context-map.md +1 -1
- package/templates/{core → greenfield}/templates/events.md +1 -1
- package/templates/{core → greenfield}/templates/glossary.md +1 -1
- package/templates/{core → greenfield}/templates/models.md +1 -1
- package/templates/{core → greenfield}/templates/phase-spec.md +1 -1
- package/templates/{core → greenfield}/templates/rules.md +1 -1
- package/templates/{core → greenfield}/templates/tech-debt.md +1 -1
- /package/templates/{webforms → brownfield}/templates/CLAUDE.md +0 -0
- /package/templates/{webforms → brownfield}/templates/_index.md +0 -0
- /package/templates/{webforms → brownfield}/templates/behavior.md +0 -0
- /package/templates/{webforms → brownfield}/templates/context-definition.md +0 -0
- /package/templates/{webforms → brownfield}/templates/lightweight-spec.md +0 -0
- /package/templates/{core → greenfield}/templates/CLAUDE.md +0 -0
- /package/templates/{core → greenfield}/templates/_index.md +0 -0
- /package/templates/{core → greenfield}/templates/aggregate-design.md +0 -0
- /package/templates/{core → greenfield}/templates/behavior.md +0 -0
- /package/templates/{core → greenfield}/templates/context-definition.md +0 -0
- /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.
|
|
4
|
-
"description": "
|
|
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
|
-
"
|
|
25
|
-
"
|
|
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/
|
|
35
|
+
"url": "git+ssh://git@github.com/weilung/dflow-sdd-ddd.git"
|
|
30
36
|
},
|
|
31
37
|
"bugs": {
|
|
32
|
-
"url": "https://github.com/weilung/
|
|
38
|
+
"url": "https://github.com/weilung/dflow-sdd-ddd/issues"
|
|
33
39
|
},
|
|
34
|
-
"homepage": "https://github.com/weilung/
|
|
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
|
-
> -
|
|
9
|
-
> `
|
|
10
|
-
>
|
|
11
|
-
> -
|
|
12
|
-
>
|
|
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-
|
|
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 — 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-
|
|
108
|
+
- Dflow skill: see `CLAUDE.md` and the `sdd-ddd-brownfield-skill/` bundle
|
|
109
109
|
for the full AI workflow guidance.
|
|
@@ -173,7 +173,7 @@ Then {新的預期結果}
|
|
|
173
173
|
|
|
174
174
|
> AI 在 Phase 4 實作規劃完成後,根據「Implementation Notes」產生的具體任務清單。
|
|
175
175
|
> 格式:`[LAYER]-[NUMBER]: 任務描述`
|
|
176
|
-
> 分類標籤(
|
|
176
|
+
> 分類標籤(Brownfield track):
|
|
177
177
|
> - `DOMAIN` — Domain 層類別、VO、Service、Interface
|
|
178
178
|
> - `PAGE` — Code-Behind / ASPX 變更
|
|
179
179
|
> - `DATA` — 資料表 schema 或 Repository 實作
|
|
@@ -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 (
|
|
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
|
|
9
|
-
> `sdd-ddd-
|
|
10
|
-
> version, use that instead.
|
|
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
|
-
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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-
|
|
101
|
-
- `sdd-ddd-
|
|
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-
|
|
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 — 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-
|
|
164
|
+
- Dflow skill: see `CLAUDE.md` and the `sdd-ddd-greenfield-skill/` bundle
|
|
165
165
|
for the full AI workflow guidance.
|
|
@@ -178,7 +178,7 @@ And {產生的 Domain Event}
|
|
|
178
178
|
|
|
179
179
|
> AI 在 Phase 4 實作規劃完成後,根據「Implementation Plan (Layer by Layer)」產生的具體任務清單。
|
|
180
180
|
> 格式:`[LAYER]-[NUMBER]: 任務描述`
|
|
181
|
-
> 分類標籤(
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|