You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: "Workflows should NOT include time estimates - AI development speed varies significantly"
160
-
severity: "low"
161
-
162
-
- id: "facilitator_not_generator"
163
-
description: "Workflow agents should act as facilitators (guide user input) not content generators (create without input)"
164
-
severity: "medium"
165
-
166
-
- id: "no_skip_optimization"
167
-
description: "Workflows must execute steps sequentially - no skipping or 'optimizing' step order"
61
+
- id: "skill_validation"
62
+
description: "Apply the full rule catalog defined in tools/skill-validator.md. That file is the single source of truth for all skill validation rules covering SKILL.md metadata, workflow.md constraints, step file structure, path references, variable resolution, sequential execution, and skill invocation syntax."
168
63
severity: "high"
169
64
170
65
# ============================================
@@ -183,27 +78,10 @@ areas:
183
78
description: "Agent files must define persona with role, identity, communication_style, and principles"
184
79
severity: "high"
185
80
186
-
- id: "agent_menu_valid_workflows"
187
-
description: "Menu triggers must reference valid workflow paths that exist"
81
+
- id: "agent_menu_valid_skills"
82
+
description: "Menu triggers must reference valid skill names that exist"
188
83
severity: "high"
189
84
190
-
# ============================================
191
-
# TEMPLATES
192
-
# ============================================
193
-
templates:
194
-
description: "Template files for workflow outputs"
195
-
globs:
196
-
- "src/**/template*.md"
197
-
- "src/**/templates/**/*.md"
198
-
rules:
199
-
- id: "placeholder_syntax"
200
-
description: "Use {variable_name} or {{variable_name}} syntax consistently for placeholders"
201
-
severity: "medium"
202
-
203
-
- id: "template_sections_marked"
204
-
description: "Template sections that need generation should be clearly marked (e.g., <!-- GENERATE: section_name -->)"
Copy file name to clipboardExpand all lines: CHANGELOG.md
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,36 @@
1
1
# Changelog
2
2
3
+
## v6.2.0 - 2026-03-15
4
+
5
+
### 🎁 Highlights
6
+
7
+
* Fix manifest generation so BMad Builder installs correctly when a module has no agents (#1998)
8
+
* Prototype preview of bmad-product-brief-preview skill — try `/bmad-product-brief-preview` and share feedback! (#1959)
9
+
* All skills now use native skill directory format for improved modularity and maintainability (#1931, #1945, #1946, #1949, #1950, #1984, #1985, #1988, #1994)
10
+
11
+
### 🎁 Features
12
+
13
+
* Rewrite code-review skill with sharded step-file architecture and auto-detect review intent from invocation args (#2007, #2013)
14
+
* Add inference-based skill validator with comprehensive rules for naming, variables, paths, and invocation syntax (#1981)
15
+
* Add REF-03 skill invocation language rule and PATH-05 skill encapsulation rule to validator (#2004)
16
+
17
+
### 🐛 Bug Fixes
18
+
19
+
* Validation pass 2 — fix path, variable, and sequence issues across 32 files (#2008)
20
+
* Replace broken party-mode workflow refs with skill syntax (#2000)
21
+
* Improve bmad-help description for accurate trigger matching (#2012)
22
+
* Point zh-cn doc links to Chinese pages instead of English (#2010)
Copy file name to clipboardExpand all lines: docs/how-to/project-context.md
+6-15Lines changed: 6 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ sidebar:
5
5
order: 7
6
6
---
7
7
8
-
Use the `project-context.md` file to ensure AI agents follow your project's technical preferences and implementation rules throughout all workflows.
8
+
Use the `project-context.md` file to ensure AI agents follow your project's technical preferences and implementation rules throughout all workflows. To make sure this is always available, you can also add the line `Important project context and conventions are located in [path to project context]/project-context.md` to your tools context or always rules file (such as `AGENTS.md`)
9
9
10
10
:::note[Prerequisites]
11
11
- BMad Method installed
@@ -114,20 +114,11 @@ A `project-context.md` file that:
114
114
115
115
## Tips
116
116
117
-
:::tip[Focus on the Unobvious]
118
-
Document patterns agents might miss such as "Use JSDoc style comments on every public class, function and variable", not universal practices like "use meaningful variable names" which LLMs know at this point.
119
-
:::
120
-
121
-
:::tip[Keep It Lean]
122
-
This file is loaded by every implementation workflow. Long files waste context. Do not include content that only applies to narrow scope or specific stories or features.
123
-
:::
124
-
125
-
:::tip[Update as Needed]
126
-
Edit manually when patterns change, or re-generate after significant architecture changes.
127
-
:::
128
-
129
-
:::tip[Works for All Project Types]
130
-
Just as useful for Quick Flow as for full BMad Method projects.
117
+
:::tip[Best Practices]
118
+
-**Focus on the unobvious** — Document patterns agents might miss (e.g., "Use JSDoc on every public class"), not universal practices like "use meaningful variable names."
119
+
-**Keep it lean** — This file is loaded by every implementation workflow. Long files waste context. Exclude content that only applies to narrow scope or specific stories.
120
+
-**Update as needed** — Edit manually when patterns change, or re-generate after significant architecture changes.
121
+
- Works for Quick Flow and full BMad Method projects alike.
Copy file name to clipboardExpand all lines: docs/reference/commands.md
+6-17Lines changed: 6 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -105,32 +105,21 @@ See [Workflow Map](./workflow-map.md) for the complete workflow reference organi
105
105
106
106
Tasks and tools are standalone operations that do not require an agent or workflow context.
107
107
108
-
#### BMad-Help: Your Intelligent Guide
108
+
**BMad-Help: Your Intelligent Guide**
109
109
110
-
**`bmad-help`** is your primary interface for discovering what to do next. It's not just a lookup tool — it's an intelligent assistant that:
111
-
112
-
-**Inspects your project** to see what's already been done
113
-
-**Understands natural language queries** — ask questions in plain English
114
-
-**Varies by installed modules** — shows options based on what you have
115
-
-**Auto-invokes after workflows** — every workflow ends with clear next steps
116
-
-**Recommends the first required task** — no guessing where to start
117
-
118
-
**Examples:**
110
+
`bmad-help` is your primary interface for discovering what to do next. It inspects your project, understands natural language queries, and recommends the next required or optional step based on your installed modules.
119
111
112
+
:::note[Example]
120
113
```
121
114
bmad-help
122
115
bmad-help I have a SaaS idea and know all the features. Where do I start?
123
116
bmad-help What are my options for UX design?
124
-
bmad-help I'm stuck on the PRD workflow
125
117
```
118
+
:::
126
119
127
-
#### Other Tasks and Tools
120
+
**Other Core Tasks and Tools**
128
121
129
-
| Example skill | Purpose |
130
-
| --- | --- |
131
-
|`bmad-shard-doc`| Split a large markdown file into smaller sections |
The core module includes 11 built-in tools — reviews, compression, brainstorming, document management, and more. See [Core Tools](./core-tools.md) for the complete reference.
0 commit comments