@edupia-tutor/spec-driven-docs 0.14.6 → 0.14.7

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 (97) hide show
  1. package/bin/index.js +1 -1
  2. package/commands/debug.md +1 -1
  3. package/commands/define-product.md +1 -1
  4. package/commands/dev-gen-test.md +1 -1
  5. package/commands/dev-run-test.md +1 -1
  6. package/commands/dev-smoke-test.md +1 -1
  7. package/commands/fix-bug.md +1 -1
  8. package/commands/generate-bdd.md +15 -1
  9. package/commands/generate-bdd.tmpl +14 -0
  10. package/commands/generate-code.md +1 -1
  11. package/commands/generate-design-spec.md +15 -1
  12. package/commands/generate-design-spec.tmpl +14 -0
  13. package/commands/generate-prd.md +2 -1
  14. package/commands/generate-prd.tmpl +1 -0
  15. package/commands/generate-spec-manifest.md +1 -1
  16. package/commands/generate-tech-docs.md +1 -1
  17. package/commands/learn.md +1 -1
  18. package/commands/map-testids.md +1 -1
  19. package/commands/propose-scenario.md +1 -1
  20. package/commands/qc-analyze.md +1 -1
  21. package/commands/qc-design-test.md +1 -1
  22. package/commands/qc-plan.md +1 -1
  23. package/commands/qc-report.md +1 -1
  24. package/commands/qc-review.md +1 -1
  25. package/commands/qc-run-test.md +1 -1
  26. package/commands/refine-prd.md +18 -9
  27. package/commands/refine-prd.tmpl +17 -8
  28. package/commands/report-bug.md +1 -1
  29. package/commands/review-code.md +1 -1
  30. package/commands/review-context.md +39 -21
  31. package/commands/review-context.tmpl +38 -20
  32. package/commands/review-tech-docs.md +1 -1
  33. package/commands/setup-ai-first.md +10 -10
  34. package/commands/setup-ai-first.tmpl +9 -9
  35. package/commands/sync.md +1 -1
  36. package/commands/update-framework.md +1 -1
  37. package/commands/validate-traces.md +1 -1
  38. package/core/FRAMEWORK_VERSION +1 -1
  39. package/core/commands/debug.md +1 -1
  40. package/core/commands/define-product.md +1 -1
  41. package/core/commands/dev-gen-test.md +1 -1
  42. package/core/commands/dev-run-test.md +1 -1
  43. package/core/commands/dev-smoke-test.md +1 -1
  44. package/core/commands/fix-bug.md +1 -1
  45. package/core/commands/generate-bdd.md +15 -1
  46. package/core/commands/generate-code.md +1 -1
  47. package/core/commands/generate-design-spec.md +15 -1
  48. package/core/commands/generate-prd.md +2 -1
  49. package/core/commands/generate-spec-manifest.md +1 -1
  50. package/core/commands/generate-tech-docs.md +1 -1
  51. package/core/commands/learn.md +1 -1
  52. package/core/commands/map-testids.md +1 -1
  53. package/core/commands/propose-scenario.md +1 -1
  54. package/core/commands/qc-analyze.md +1 -1
  55. package/core/commands/qc-design-test.md +1 -1
  56. package/core/commands/qc-plan.md +1 -1
  57. package/core/commands/qc-report.md +1 -1
  58. package/core/commands/qc-review.md +1 -1
  59. package/core/commands/qc-run-test.md +1 -1
  60. package/core/commands/refine-prd.md +18 -9
  61. package/core/commands/report-bug.md +1 -1
  62. package/core/commands/review-code.md +1 -1
  63. package/core/commands/review-context.md +39 -21
  64. package/core/commands/review-tech-docs.md +1 -1
  65. package/core/commands/setup-ai-first.md +10 -10
  66. package/core/commands/sync.md +1 -1
  67. package/core/commands/update-framework.md +1 -1
  68. package/core/commands/validate-traces.md +1 -1
  69. package/core/skills/code/SKILL.md +2 -2
  70. package/core/skills/debug/SKILL.md +3 -3
  71. package/core/skills/design-spec/SKILL.md +1 -1
  72. package/core/skills/prd/SKILL.md +1 -1
  73. package/core/skills/setup-ai-first/SKILL.md +1 -1
  74. package/core/skills/spec/SKILL.md +2 -2
  75. package/core/skills/test/SKILL.md +3 -3
  76. package/core/steps/report-footer.md +1 -1
  77. package/core/templates/project-context.yaml +2 -2
  78. package/docs/01-getting-started/core-concepts.md +1 -1
  79. package/docs/02-guides/developer/bdd-and-trace.md +3 -3
  80. package/docs/02-guides/developer/scenarios.md +2 -2
  81. package/docs/02-guides/developer/workflow.md +1 -1
  82. package/docs/02-guides/product-owner/README.md +2 -2
  83. package/docs/02-guides/product-owner/handoff-checklist.md +5 -5
  84. package/docs/02-guides/product-owner/scenarios.md +19 -17
  85. package/docs/03-concepts/traceability.md +3 -3
  86. package/docs/04-operations/sync-and-update.md +3 -3
  87. package/docs/05-reference/command-cheatsheet.md +1 -1
  88. package/package.json +1 -1
  89. package/skills/code/SKILL.md +2 -2
  90. package/skills/debug/SKILL.md +3 -3
  91. package/skills/design-spec/SKILL.md +1 -1
  92. package/skills/prd/SKILL.md +1 -1
  93. package/skills/setup-ai-first/SKILL.md +1 -1
  94. package/skills/spec/SKILL.md +2 -2
  95. package/skills/test/SKILL.md +3 -3
  96. package/steps/report-footer.md +1 -1
  97. package/templates/project-context.yaml +2 -2
package/skills/prd/SKILL.md CHANGED
@@ -424,7 +424,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
424
424
  | /define-product | `/generate-prd {product-definition-file}` |
425
425
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
426
426
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
427
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
427
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
428
428
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
429
429
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
430
430
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
package/skills/setup-ai-first/SKILL.md CHANGED
@@ -175,7 +175,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
175
175
  | /define-product | `/generate-prd {product-definition-file}` |
176
176
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
177
177
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
178
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
178
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
179
179
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
180
180
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
181
181
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
package/skills/spec/SKILL.md CHANGED
@@ -244,7 +244,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
244
244
  | /define-product | `/generate-prd {product-definition-file}` |
245
245
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
246
246
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
247
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
247
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
248
248
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
249
249
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
250
250
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -421,7 +421,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
421
421
  | /define-product | `/generate-prd {product-definition-file}` |
422
422
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
423
423
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
424
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
424
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
425
425
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
426
426
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
427
427
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
package/skills/test/SKILL.md CHANGED
@@ -287,7 +287,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
287
287
  | /define-product | `/generate-prd {product-definition-file}` |
288
288
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
289
289
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
290
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
290
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
291
291
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
292
292
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
293
293
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -763,7 +763,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
763
763
  | /define-product | `/generate-prd {product-definition-file}` |
764
764
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
765
765
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
766
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
766
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
767
767
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
768
768
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
769
769
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -1257,7 +1257,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
1257
1257
  | /define-product | `/generate-prd {product-definition-file}` |
1258
1258
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
1259
1259
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
1260
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
1260
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
1261
1261
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
1262
1262
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
1263
1263
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
package/steps/report-footer.md CHANGED
@@ -60,7 +60,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
60
60
  | /define-product | `/generate-prd {product-definition-file}` |
61
61
  | /generate-prd | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
62
62
  | /refine-prd | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
63
- | /review-context (PRD) | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
63
+ | /review-context (PRD) | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
64
64
  | /generate-design-spec | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
65
65
  | /generate-bdd | `/review-context {feature-file}` để kiểm tra độ phủ |
66
66
  | /review-context (BDD) | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
package/templates/project-context.yaml CHANGED
@@ -14,7 +14,7 @@
14
14
  # 3. When a workflow says "→ key.subkey", look up that key
15
15
  # and use the resolved value as the actual path
16
16
  # 4. All paths are RELATIVE to workspace root
17
- # 5. For "{domain}", substitute from spec's @trace.domain
17
+ # 5. For "{domain}", substitute the feature's domain (PRD: row `Domain` in Metadata / folder path; .feature: @trace.domain)
18
18
  # =============================================================
19
19
 
20
20
  project:
@@ -132,7 +132,7 @@ domains:
132
132
  # With spec_source set, only ONE override is needed instead of four separate dir vars.
133
133
  #
134
134
  # services: # domain → service submodule routing
135
- # {{DOMAIN_1}}: # must match @trace.domain in PRD files
135
+ # {{DOMAIN_1}}: # must match the PRD's `Domain` (Metadata row) / folder path segment
136
136
  # path: "{{SERVICE_SUBMODULE_DIR}}" # relative path to service submodule (code + .trace/)
137
137
  # module: "{{STACK_MODULE}}" # e.g., java-spring, nextjs, flutter
138
138
  # # NOTE: with spec_source set, BDD + tech-docs are cross-team and live in the spec repo —