dflow-sdd-ddd 0.6.0 → 0.8.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 (59) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.en.md +30 -0
  3. package/README.md +14 -0
  4. package/bin/dflow.js +7 -3
  5. package/docs/evaluating-dflow.en.md +14 -5
  6. package/docs/evaluating-dflow.md +14 -5
  7. package/docs/npm-publish-checklist.md +8 -0
  8. package/docs/using-with-claude-code.en.md +118 -11
  9. package/docs/using-with-claude-code.md +94 -9
  10. package/docs/using-with-codex.en.md +14 -0
  11. package/docs/using-with-codex.md +10 -0
  12. package/docs/using-with-github-copilot.en.md +36 -0
  13. package/docs/using-with-github-copilot.md +26 -0
  14. package/lib/init.js +461 -24
  15. package/package.json +1 -1
  16. package/templates/brownfield/references/dflow-feedback-flow.md +179 -0
  17. package/templates/brownfield/references/drift-verification.md +183 -0
  18. package/templates/brownfield/references/finish-feature-flow.md +259 -0
  19. package/templates/brownfield/references/git-integration.md +312 -0
  20. package/templates/brownfield/references/init-project-flow.md +413 -0
  21. package/templates/brownfield/references/modify-existing-flow.md +444 -0
  22. package/templates/brownfield/references/new-feature-flow.md +367 -0
  23. package/templates/brownfield/references/new-phase-flow.md +259 -0
  24. package/templates/brownfield/references/pr-review-checklist.md +179 -0
  25. package/templates/brownfield/scaffolding/AI-AGENT-GUIDE.md +31 -4
  26. package/templates/brownfield/scaffolding/CLAUDE-md-snippet.md +12 -8
  27. package/templates/brownfield/scaffolding/Git-principles-gitflow.md +1 -1
  28. package/templates/brownfield/scaffolding/Git-principles-trunk.md +1 -1
  29. package/templates/brownfield/scaffolding/_conventions.md +1 -1
  30. package/templates/brownfield/scaffolding/_overview.md +3 -3
  31. package/templates/brownfield/templates/context-map.md +1 -1
  32. package/templates/brownfield/templates/glossary.md +1 -1
  33. package/templates/brownfield/templates/models.md +1 -1
  34. package/templates/brownfield/templates/rules.md +1 -1
  35. package/templates/brownfield/templates/tech-debt.md +1 -1
  36. package/templates/common/skill/SKILL.md +35 -0
  37. package/templates/greenfield/references/ddd-modeling-guide.md +351 -0
  38. package/templates/greenfield/references/dflow-feedback-flow.md +179 -0
  39. package/templates/greenfield/references/drift-verification.md +195 -0
  40. package/templates/greenfield/references/finish-feature-flow.md +280 -0
  41. package/templates/greenfield/references/git-integration.md +285 -0
  42. package/templates/greenfield/references/init-project-flow.md +447 -0
  43. package/templates/greenfield/references/modify-existing-flow.md +362 -0
  44. package/templates/greenfield/references/new-feature-flow.md +397 -0
  45. package/templates/greenfield/references/new-phase-flow.md +273 -0
  46. package/templates/greenfield/references/pr-review-checklist.md +130 -0
  47. package/templates/greenfield/scaffolding/AI-AGENT-GUIDE.md +31 -4
  48. package/templates/greenfield/scaffolding/CLAUDE-md-snippet.md +15 -13
  49. package/templates/greenfield/scaffolding/Git-principles-gitflow.md +1 -1
  50. package/templates/greenfield/scaffolding/Git-principles-trunk.md +1 -1
  51. package/templates/greenfield/scaffolding/_conventions.md +1 -1
  52. package/templates/greenfield/scaffolding/_overview.md +5 -3
  53. package/templates/greenfield/scaffolding/architecture-decisions-README.md +1 -1
  54. package/templates/greenfield/templates/context-map.md +1 -1
  55. package/templates/greenfield/templates/events.md +1 -1
  56. package/templates/greenfield/templates/glossary.md +1 -1
  57. package/templates/greenfield/templates/models.md +1 -1
  58. package/templates/greenfield/templates/rules.md +1 -1
  59. package/templates/greenfield/templates/tech-debt.md +1 -1
package/docs/using-with-github-copilot.md CHANGED
@@ -90,6 +90,32 @@ workflow 與 `dflow/specs/shared/AI-AGENT-GUIDE.md`，不複製 workflow 步驟
90
90
  Copilot 的 `/` parser 行為與 Claude / Codex 不同：選單入口是 `/dflow-<id>`，
91
91
  但在 chat 文字中也可以直接說 canonical `/dflow:<id>`。
92
92
 
93
+ ### 產生物的版控政策與升級
94
+
95
+ `.github/prompts/dflow-<id>.prompt.md` 是從 canonical guide 投影出來的**衍生物**。Dflow 的
96
+ **建議預設**是不版控、由 clone 後重跑 `dflow configure-agents --command-adapters` 重生成；團隊若
97
+ 想 clone 後立即有原生 prompt 選單，也可改為**版控**。請對同專案的所有工具採一致策略（政策總覽見
98
+ [README「Init 產生的檔案」](../README.md#init-產生的檔案)）。
99
+
100
+ 採 gitignore 預設時，在專案 `.gitignore` 加入（**注意 glob 副作用**）：
101
+
102
+ ```gitignore
103
+ .github/prompts/dflow-*.prompt.md
104
+ ```
105
+
106
+ 此 glob 會一併 ignore 你自己以 `dflow-` 開頭命名的 prompt 檔。若你有同前綴的自訂 prompt，請改用
107
+ 更精確的規則或替自訂檔改名。若這些 prompt **已被版控**，新增 ignore 不會自動移出版控，需先：
108
+
109
+ ```bash
110
+ git rm --cached .github/prompts/dflow-*.prompt.md
111
+ ```
112
+
113
+ （`--cached` 只移出版控、保留工作目錄檔案。）
114
+
115
+ 升級 dflow 後重跑 `dflow configure-agents --command-adapters`，prompt adapter 會用**新版 registry**
116
+ 重投影；但既有 `dflow/specs/shared/AI-AGENT-GUIDE.md` **不會**被覆寫——「重投影 adapter」不等於
117
+ 「升級 canonical guide」。請以**相同的 dflow CLI 版本**重投影。
118
+
93
119
  ### 對話範例
94
120
 
95
121
  典型的 Copilot Chat workflow 如下：