bmad-method 6.2.3-next.17 → 6.2.3-next.19

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 (24) hide show
  1. package/.claude-plugin/marketplace.json +0 -1
  2. package/README.md +1 -1
  3. package/README_CN.md +1 -1
  4. package/README_VN.md +110 -0
  5. package/package.json +1 -1
  6. package/src/bmm-skills/2-plan-workflows/bmad-create-ux-design/steps/step-13-responsive-accessibility.md +1 -1
  7. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-01-document-discovery.md +1 -1
  8. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-02-prd-analysis.md +1 -1
  9. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/steps/step-03-epic-coverage-validation.md +1 -1
  10. package/src/bmm-skills/3-solutioning/bmad-check-implementation-readiness/workflow.md +1 -1
  11. package/src/bmm-skills/3-solutioning/bmad-create-epics-and-stories/workflow.md +1 -1
  12. package/src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md +3 -0
  13. package/src/bmm-skills/4-implementation/bmad-correct-course/checklist.md +2 -2
  14. package/src/bmm-skills/4-implementation/bmad-correct-course/workflow.md +8 -8
  15. package/src/bmm-skills/4-implementation/bmad-quick-dev/spec-template.md +1 -1
  16. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-01-clarify-and-route.md +7 -0
  17. package/src/bmm-skills/4-implementation/bmad-quick-dev/step-03-implement.md +2 -0
  18. package/src/bmm-skills/4-implementation/bmad-retrospective/workflow.md +134 -134
  19. package/src/bmm-skills/4-implementation/bmad-sprint-planning/sprint-status-template.yaml +1 -1
  20. package/src/bmm-skills/4-implementation/bmad-sprint-planning/workflow.md +3 -3
  21. package/src/bmm-skills/4-implementation/bmad-sprint-status/workflow.md +2 -2
  22. package/src/core-skills/bmad-party-mode/SKILL.md +1 -1
  23. package/src/bmm-skills/4-implementation/bmad-agent-sm/SKILL.md +0 -55
  24. package/src/bmm-skills/4-implementation/bmad-agent-sm/bmad-skill-manifest.yaml +0 -11
@@ -59,7 +59,6 @@
59
59
  "./src/bmm-skills/3-solutioning/bmad-create-epics-and-stories",
60
60
  "./src/bmm-skills/3-solutioning/bmad-generate-project-context",
61
61
  "./src/bmm-skills/4-implementation/bmad-agent-dev",
62
- "./src/bmm-skills/4-implementation/bmad-agent-sm",
63
62
  "./src/bmm-skills/4-implementation/bmad-dev-story",
64
63
  "./src/bmm-skills/4-implementation/bmad-quick-dev",
65
64
  "./src/bmm-skills/4-implementation/bmad-sprint-planning",
package/README.md CHANGED
@@ -16,7 +16,7 @@ Traditional AI tools do the thinking for you, producing average results. BMad ag
16
16
  - **AI Intelligent Help** — Invoke the `bmad-help` skill anytime for guidance on what's next
17
17
  - **Scale-Domain-Adaptive** — Automatically adjusts planning depth based on project complexity
18
18
  - **Structured Workflows** — Grounded in agile best practices across analysis, planning, architecture, and implementation
19
- - **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
19
+ - **Specialized Agents** — 12+ domain experts (PM, Architect, Developer, UX, and more)
20
20
  - **Party Mode** — Bring multiple agent personas into one session to collaborate and discuss
21
21
  - **Complete Lifecycle** — From brainstorming to deployment
22
22
 
package/README_CN.md CHANGED
@@ -16,7 +16,7 @@
16
16
  - **AI 智能引导** —— 随时调用 `bmad-help` 获取下一步建议
17
17
  - **规模与领域自适应** —— 按项目复杂度自动调整规划深度
18
18
  - **结构化工作流** —— 覆盖分析、规划、架构、实施全流程
19
- - **专业角色智能体** —— 提供 PM、架构师、开发者、UX、Scrum Master 等 12+ 角色
19
+ - **专业角色智能体** —— 提供 PM、架构师、开发者、UX 等 12+ 角色
20
20
  - **派对模式** —— 多个智能体可在同一会话协作讨论
21
21
  - **完整生命周期** —— 从头脑风暴一路到交付上线
22
22
 
package/README_VN.md ADDED
@@ -0,0 +1,110 @@
1
+ ![BMad Method](banner-bmad-method.png)
2
+
3
+ [![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
+ [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
6
+ [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
7
+
8
+ [English](README.md) | [简体中文](README_CN.md) | Tiếng Việt
9
+
10
+ **Build More Architect Dreams** - một mô-đun khung phát triển hướng AI trong hệ sinh thái BMad, có khả năng thích ứng theo quy mô từ sửa lỗi nhỏ đến các hệ thống doanh nghiệp.
11
+
12
+ **100% miễn phí và mã nguồn mở.** Không có tường phí. Không có nội dung bị khóa. Không có Discord giới hạn quyền truy cập. Chúng tôi tin vào việc trao quyền cho mọi người, không chỉ cho những ai có thể trả tiền để vào một cộng đồng hay khóa học khép kín.
13
+
14
+ ## Vì sao chọn BMad Method?
15
+
16
+ Các công cụ AI truyền thống thường làm thay phần suy nghĩ của bạn và tạo ra kết quả ở mức trung bình. Các agent chuyên biệt và quy trình làm việc có hướng dẫn của BMad hoạt động như những cộng tác viên chuyên gia, dẫn dắt bạn qua một quy trình có cấu trúc để khai mở tư duy tốt nhất của bạn cùng với AI.
17
+
18
+ - **Trợ giúp AI thông minh** - Gọi skill `bmad-help` bất kỳ lúc nào để biết bước tiếp theo
19
+ - **Thích ứng theo quy mô và miền bài toán** - Tự động điều chỉnh độ sâu lập kế hoạch theo độ phức tạp của dự án
20
+ - **Quy trình có cấu trúc** - Dựa trên các thực hành tốt nhất của agile xuyên suốt phân tích, lập kế hoạch, kiến trúc và triển khai
21
+ - **Agent chuyên biệt** - Hơn 12 chuyên gia theo vai trò như PM, Architect, Developer, UX, Scrum Master và nhiều vai trò khác
22
+ - **Party Mode** - Đưa nhiều persona agent vào cùng một phiên để cộng tác và thảo luận
23
+ - **Vòng đời hoàn chỉnh** - Từ động não ý tưởng cho đến triển khai
24
+
25
+ [Tìm hiểu thêm tại **docs.bmad-method.org**](https://docs.bmad-method.org/vi-vn/)
26
+
27
+ ---
28
+
29
+ ## 🚀 Điều gì tiếp theo cho BMad?
30
+
31
+ **V6 đã có mặt và đây mới chỉ là khởi đầu!** BMad Method đang phát triển rất nhanh với các cải tiến như đội agent đa nền tảng và tích hợp sub-agent, kiến trúc Skills, BMad Builder v1, tự động hóa vòng lặp phát triển và nhiều thứ khác vẫn đang được xây dựng.
32
+
33
+ **[📍 Xem lộ trình đầy đủ →](https://docs.bmad-method.org/vi-vn/roadmap/)**
34
+
35
+ ---
36
+
37
+ ## Bắt đầu nhanh
38
+
39
+ **Điều kiện tiên quyết**: [Node.js](https://nodejs.org) v20+
40
+
41
+ ```bash
42
+ npx bmad-method install
43
+ ```
44
+
45
+ > Muốn dùng bản prerelease mới nhất? Hãy dùng `npx bmad-method@next install`. Hãy kỳ vọng mức độ biến động cao hơn bản cài đặt mặc định.
46
+
47
+ Làm theo các lời nhắc của trình cài đặt, sau đó mở AI IDE của bạn như Claude Code hoặc Cursor trong thư mục dự án.
48
+
49
+ **Cài đặt không tương tác** (cho CI/CD):
50
+
51
+ ```bash
52
+ npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes
53
+ ```
54
+
55
+ [Xem toàn bộ tùy chọn cài đặt](https://docs.bmad-method.org/vi-vn/how-to/non-interactive-installation/)
56
+
57
+ > **Chưa chắc nên làm gì?** Hãy hỏi `bmad-help` - nó sẽ cho bạn biết chính xác bước nào tiếp theo và bước nào là tùy chọn. Bạn cũng có thể hỏi kiểu như `bmad-help Tôi vừa hoàn thành phần kiến trúc, tiếp theo tôi cần làm gì?`
58
+
59
+ ## Mô-đun
60
+
61
+ BMad Method có thể được mở rộng bằng các mô-đun chính thức cho những miền chuyên biệt. Chúng có sẵn trong lúc cài đặt hoặc bất kỳ lúc nào sau đó.
62
+
63
+ | Module | Mục đích |
64
+ | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
65
+ | **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | Khung lõi với hơn 34 quy trình |
66
+ | **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | Tạo agent và quy trình BMad tùy chỉnh |
67
+ | **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | Chiến lược kiểm thử và tự động hóa dựa trên rủi ro |
68
+ | **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | Quy trình phát triển game (Unity, Unreal, Godot) |
69
+ | **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | Đổi mới, động não ý tưởng, tư duy thiết kế |
70
+
71
+ ## Tài liệu
72
+
73
+ [Trang tài liệu BMad Method](https://docs.bmad-method.org/vi-vn/) - bài hướng dẫn, hướng dẫn tác vụ, giải thích khái niệm và tài liệu tham chiếu
74
+
75
+ **Liên kết nhanh:**
76
+ - [Hướng dẫn bắt đầu](https://docs.bmad-method.org/vi-vn/tutorials/getting-started/)
77
+ - [Nâng cấp từ các phiên bản trước](https://docs.bmad-method.org/vi-vn/how-to/upgrade-to-v6/)
78
+ - [Tài liệu Test Architect](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/)
79
+
80
+ ## Cộng đồng
81
+
82
+ - [Discord](https://discord.gg/gk8jAdXWmj) - Nhận trợ giúp, chia sẻ ý tưởng, cộng tác
83
+ - [Đăng ký trên YouTube](https://www.youtube.com/@BMadCode) - video hướng dẫn, lớp chuyên sâu và podcast (ra mắt tháng 2 năm 2025)
84
+ - [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) - Báo lỗi và yêu cầu tính năng
85
+ - [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) - Trao đổi cộng đồng
86
+
87
+ ## Hỗ trợ BMad
88
+
89
+ BMad miễn phí cho tất cả mọi người - và sẽ luôn như vậy. Nếu bạn muốn hỗ trợ quá trình phát triển:
90
+
91
+ - ⭐ Hãy nhấn sao cho dự án ở góc trên bên phải của trang này
92
+ - ☕ [Buy Me a Coffee](https://buymeacoffee.com/bmad) - Tiếp thêm năng lượng cho quá trình phát triển
93
+ - 🏢 Tài trợ doanh nghiệp - Nhắn riêng trên Discord
94
+ - 🎤 Diễn thuyết và truyền thông - Sẵn sàng cho hội nghị, podcast, phỏng vấn (BM trên Discord)
95
+
96
+ ## Đóng góp
97
+
98
+ Chúng tôi luôn chào đón đóng góp. Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết hướng dẫn.
99
+
100
+ ## Giấy phép
101
+
102
+ Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết.
103
+
104
+ ---
105
+
106
+ **BMad** và **BMAD-METHOD** là các nhãn hiệu của BMad Code, LLC. Xem [TRADEMARK.md](TRADEMARK.md) để biết chi tiết.
107
+
108
+ [![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)
109
+
110
+ Xem [CONTRIBUTORS.md](CONTRIBUTORS.md) để biết thông tin về những người đóng góp.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.2.3-next.17",
4
+ "version": "6.2.3-next.19",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -240,7 +240,7 @@ When user selects 'C', append the content directly to the document using the str
240
240
  ✅ Appropriate breakpoint strategy established
241
241
  ✅ Accessibility requirements determined and documented
242
242
  ✅ Comprehensive testing strategy planned
243
- ✅ Implementation guidelines provided for development team
243
+ ✅ Implementation guidelines provided for Developer agent
244
244
  ✅ A/P/C menu presented and handled correctly
245
245
  ✅ Content properly appended to document when C selected
246
246
 
@@ -20,7 +20,7 @@ To discover, inventory, and organize all project documents, identifying duplicat
20
20
 
21
21
  ### Role Reinforcement:
22
22
 
23
- - ✅ You are an expert Product Manager and Scrum Master
23
+ - ✅ You are an expert Product Manager
24
24
  - ✅ Your focus is on finding organizing and documenting what exists
25
25
  - ✅ You identify ambiguities and ask for clarification
26
26
  - ✅ Success is measured in clear file inventory and conflict resolution
@@ -21,7 +21,7 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun
21
21
 
22
22
  ### Role Reinforcement:
23
23
 
24
- - ✅ You are an expert Product Manager and Scrum Master
24
+ - ✅ You are an expert Product Manager
25
25
  - ✅ Your expertise is in requirements analysis and traceability
26
26
  - ✅ You think critically about requirement completeness
27
27
  - ✅ Success is measured in thorough requirement extraction
@@ -20,7 +20,7 @@ To validate that all Functional Requirements from the PRD are captured in the ep
20
20
 
21
21
  ### Role Reinforcement:
22
22
 
23
- - ✅ You are an expert Product Manager and Scrum Master
23
+ - ✅ You are an expert Product Manager
24
24
  - ✅ Your expertise is in requirements traceability
25
25
  - ✅ You ensure no requirements fall through the cracks
26
26
  - ✅ Success is measured in complete FR coverage
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Goal:** Validate that PRD, Architecture, Epics and Stories are complete and aligned before Phase 4 implementation starts, with a focus on ensuring epics and stories are logical and have accounted for all requirements and planning.
4
4
 
5
- **Your Role:** You are an expert Product Manager and Scrum Master, renowned and respected in the field of requirements traceability and spotting gaps in planning. Your success is measured in spotting the failures others have made in planning or preparation of epics and stories to produce the users product vision.
5
+ **Your Role:** You are an expert Product Manager, renowned and respected in the field of requirements traceability and spotting gaps in planning. Your success is measured in spotting the failures others have made in planning or preparation of epics and stories to produce the user's product vision.
6
6
 
7
7
  ## WORKFLOW ARCHITECTURE
8
8
 
@@ -1,6 +1,6 @@
1
1
  # Create Epics and Stories
2
2
 
3
- **Goal:** Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value, creating detailed, actionable stories with complete acceptance criteria for development teams.
3
+ **Goal:** Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value, creating detailed, actionable stories with complete acceptance criteria for the Developer agent.
4
4
 
5
5
  **Your Role:** In addition to your name, communication_style, and persona, you are also a product strategist and technical specifications writer collaborating with a product owner. This is a partnership, not a client-vendor relationship. You bring expertise in requirements decomposition, technical implementation context, and acceptance criteria writing, while the user brings their product vision, user needs, and business requirements. Work together as equals.
6
6
 
@@ -45,6 +45,9 @@ When you are in this persona and the user calls a skill, this persona must carry
45
45
  | QD | Unified quick flow — clarify intent, plan, implement, review, present | bmad-quick-dev |
46
46
  | QA | Generate API and E2E tests for existing features | bmad-qa-generate-e2e-tests |
47
47
  | CR | Initiate a comprehensive code review across multiple quality facets | bmad-code-review |
48
+ | SP | Generate or update the sprint plan that sequences tasks for implementation | bmad-sprint-planning |
49
+ | CS | Prepare a story with all required context for implementation | bmad-create-story |
50
+ | ER | Party mode review of all work completed across an epic | bmad-retrospective |
48
51
 
49
52
  ## On Activation
50
53
 
@@ -217,8 +217,8 @@
217
217
  <check-item id="5.5">
218
218
  <prompt>Establish agent handoff plan</prompt>
219
219
  <action>Identify which roles/agents will execute the changes:</action>
220
- - Development team (for implementation)
221
- - Product Owner / Scrum Master (for backlog changes)
220
+ - Developer agent (for implementation)
221
+ - Product Owner / Developer (for backlog changes)
222
222
  - Product Manager / Architect (for strategic changes)
223
223
  <action>Define responsibilities for each role</action>
224
224
  <status>[ ] Done / [ ] N/A / [ ] Action-needed</status>
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Goal:** Manage significant changes during sprint execution by analyzing impact across all project artifacts and producing a structured Sprint Change Proposal.
4
4
 
5
- **Your Role:** You are a Scrum Master navigating change management. Analyze the triggering issue, assess impact across PRD, epics, architecture, and UX artifacts, and produce an actionable Sprint Change Proposal with clear handoff.
5
+ **Your Role:** You are a Developer navigating change management. Analyze the triggering issue, assess impact across PRD, epics, architecture, and UX artifacts, and produce an actionable Sprint Change Proposal with clear handoff.
6
6
 
7
7
  ---
8
8
 
@@ -192,8 +192,8 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
192
192
  <action>Section 5: Implementation Handoff</action>
193
193
 
194
194
  - Categorize change scope:
195
- - Minor: Direct implementation by dev team
196
- - Moderate: Backlog reorganization needed (PO/SM)
195
+ - Minor: Direct implementation by Developer agent
196
+ - Moderate: Backlog reorganization needed (PO/DEV)
197
197
  - Major: Fundamental replan required (PM/Architect)
198
198
  - Specify handoff recipients and their responsibilities
199
199
  - Define success criteria for implementation
@@ -219,8 +219,8 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
219
219
  <action>Finalize Sprint Change Proposal document</action>
220
220
  <action>Determine change scope classification:</action>
221
221
 
222
- - **Minor**: Can be implemented directly by development team
223
- - **Moderate**: Requires backlog reorganization and PO/SM coordination
222
+ - **Minor**: Can be implemented directly by Developer agent
223
+ - **Moderate**: Requires backlog reorganization and PO/DEV coordination
224
224
  - **Major**: Needs fundamental replan with PM/Architect involvement
225
225
 
226
226
  <action>Provide appropriate handoff based on scope:</action>
@@ -228,12 +228,12 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
228
228
  </check>
229
229
 
230
230
  <check if="Minor scope">
231
- <action>Route to: Development team for direct implementation</action>
231
+ <action>Route to: Developer agent for direct implementation</action>
232
232
  <action>Deliverables: Finalized edit proposals and implementation tasks</action>
233
233
  </check>
234
234
 
235
235
  <check if="Moderate scope">
236
- <action>Route to: Product Owner / Scrum Master agents</action>
236
+ <action>Route to: Product Owner / Developer agents</action>
237
237
  <action>Deliverables: Sprint Change Proposal + backlog reorganization plan</action>
238
238
  </check>
239
239
 
@@ -261,7 +261,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
261
261
  - Implementation handoff plan
262
262
 
263
263
  <action>Report workflow completion to user with personalized message: "Correct Course workflow complete, {user_name}!"</action>
264
- <action>Remind user of success criteria and next steps for implementation team</action>
264
+ <action>Remind user of success criteria and next steps for Developer agent</action>
265
265
  </step>
266
266
 
267
267
  </workflow>
@@ -3,7 +3,7 @@ title: '{title}'
3
3
  type: 'feature' # feature | bugfix | refactor | chore
4
4
  created: '{date}'
5
5
  status: 'draft' # draft | ready-for-dev | in-progress | in-review | done
6
- context: [] # optional: max 3 project-wide standards/docs. NO source code files.
6
+ context: [] # optional: project-wide standards/docs the implementation agent should load. Keep short only what isn't already distilled into the spec body.
7
7
  ---
8
8
 
9
9
  <!-- Target: 900–1300 tokens. Above 1600 = high risk of context rot.
@@ -42,6 +42,13 @@ Never ask extra questions if you already understand what the user intends.
42
42
  1. Load context.
43
43
  - List files in `{planning_artifacts}` and `{implementation_artifacts}`.
44
44
  - If you find an unformatted spec or intent file, ingest its contents to form your understanding of the intent.
45
+ - Planning artifacts are the output of BMAD phases 1-3. Typical files include:
46
+ - **PRD** (`*prd*`) — product requirements and success criteria
47
+ - **Architecture** (`*architecture*`) — technical design decisions and constraints
48
+ - **UX/Design** (`*ux*`) — user experience and interaction design
49
+ - **Epics** (`*epic*`) — feature breakdown into implementable stories
50
+ - **Product Brief** (`*brief*`) — project vision and scope
51
+ - Scan the listing for files matching these patterns. If any look relevant to the current intent, load them selectively — you don't need all of them, but you need the right constraints and requirements rather than guessing from code alone.
45
52
  2. Clarify intent. Do not fantasize, do not leave open questions. If you must ask questions, ask them as a numbered list. When the human replies, verify that every single numbered question was answered. If any were ignored, HALT and re-ask only the missing questions before proceeding. Keep looping until intent is clear enough to implement.
46
53
  3. Version control sanity check. Is the working tree clean? Does the current branch make sense for this intent — considering its name and recent history? If the tree is dirty or the branch is an obvious mismatch, HALT and ask the human before proceeding. If version control is unavailable, skip this check.
47
54
  4. Multi-goal check (see SCOPE STANDARD). If the intent fails the single-goal criteria:
@@ -24,6 +24,8 @@ Capture `baseline_commit` (current HEAD, or `NO_VCS` if version control is unava
24
24
 
25
25
  Change `{spec_file}` status to `in-progress` in the frontmatter before starting implementation.
26
26
 
27
+ If `{spec_file}` has a non-empty `context:` list in its frontmatter, load those files before implementation begins. When handing to a sub-agent, include them in the sub-agent prompt so it has access to the referenced context.
28
+
27
29
  Hand `{spec_file}` to a sub-agent/task and let it implement. If no sub-agents are available, implement directly.
28
30
 
29
31
  **Path formatting rule:** Any markdown links written into `{spec_file}` must use paths relative to `{spec_file}`'s directory so they are clickable in VS Code. Any file paths displayed in terminal/conversation output must use CWD-relative format with `:line` notation (e.g., `src/path/file.ts:42`) for terminal clickability. No leading `/` in either case.