BMAD-METHOD/docs
Brian Madison 30ba701c02 refactor(skills): lean agent personas + hardcode identity and invariants
Agent identity (name, title) and the Overview prose are now baked into
each SKILL.md rather than resolved from customize.yaml. This anchors
skill-discovery (description keywords still match), protects brand
identity (Mary is Mary), and leaves the customize.yaml surface for
behavior changes only.

customize.yaml slimming:
- Dropped metadata.title (hardcoded in SKILL.md heading + Overview)
- Dropped metadata.capabilities (dead field; nothing downstream read it)
- Luminary-anchored identity strings (Porter+Minto, Evans+Tufte,
  Cagan+Torres+Bezos, Norman+Cooper, Fowler+Vogels, Beck+Pragmatic
  Programmer) — higher signal density, ~55% token savings per persona
- Preserved distinctive communication_style voice beats per agent
- Principles trimmed to 3-4 cite-worthy heuristics each

SKILL.md changes (all 6 agents):
- New top-of-body heading: `# Name — Title`
- New `## Overview` section with hardcoded capability prose
- Step 2 (Adopt Persona) rewritten to layer customized persona on top
  of the Overview-established identity
- bmad-agent-dev gains an `## Operating Rules` section containing its
  8 non-negotiable behavioral invariants (moved from customize.yaml
  critical_actions, since they're brand-protected invariants, not
  team-customizable startup steps)

customize.yaml now defines per-agent:
- icon (cosmetic)
- persona.{role, identity, communication_style, principles} (customizable)
- critical_actions (empty by default, extensibility hook for teams)
- memories (empty by default, extensibility hook for teams)
- menu (default items, mergeable by code)

manifest-generator.js: dropped `capabilities` column from
agent-manifest.csv header, write, and read paths (field was write-only
noise — no consumer ever read it back).

Docs: customize-bmad.md now notes agent names are fixed by design so
skills can be reliably invoked by role or default name.
2026-04-18 22:53:57 -05:00
..
cs docs(cs): groom analysis-phase.md translation (#2242) 2026-04-10 06:23:00 -07:00
explanation docs(checkpoint): add explainer page and workflow diagram (#2183) 2026-04-01 22:20:48 -06:00
fr docs(fr): sync translations with upstream and fix sidebar ordering (#2231) 2026-04-09 20:58:43 -07:00
how-to refactor(skills): lean agent personas + hardcode identity and invariants 2026-04-18 22:53:57 -05:00
reference fix(docs): update stale Analyst triggers and add PRFAQ link (#2238) 2026-04-09 22:18:08 -07:00
tutorials chore: remove SM agent (Bob) and migrate to Developer agent (#2186) 2026-04-02 12:25:24 -07:00
vi-vn fix(docs): update stale Analyst triggers and add PRFAQ link (#2238) 2026-04-09 22:18:08 -07:00
zh-cn docs(zh-cn): add missing Chinese translations for 3 documents 2026-04-13 10:35:23 +08:00
404.md fix(docs): comprehensive documentation site review fixes (#1578) 2026-02-08 11:58:22 -06:00
_STYLE_GUIDE.md chore: remove SM agent (Bob) and migrate to Developer agent (#2186) 2026-04-02 12:25:24 -07:00
index.md docs: update terminology from commands to skills across all documentation (#1850) 2026-03-07 16:14:25 -07:00
roadmap.mdx feat(docs): add public roadmap and improve site navigation 2026-02-22 19:41:57 -06:00