Brian
ee47e30cf6
* refactor(bmad-ux): replace bmad-create-ux-design with lean spine-based bmad-ux
* refactor(bmad-ux): adopt DESIGN.md spec, split into two-file spine, align prd/brief
DESIGN.md (visual identity per the Google Labs spec) and EXPERIENCE.md
(behavior, flow, IA) replace the single design.md spine. EXPERIENCE.md
cross-references DESIGN.md tokens via the spec's {path.to.token} syntax.
Example suite restructure
- 3 DESIGN.md examples: editorial (Stitch source / Linen & Logic), calm
native mobile (Quill), shadcn-on-Tailwind web SaaS (Drift)
- 2 paired EXPERIENCE.md examples (Quill, Drift); Linen & Logic unpaired
to model the Stitch handoff scenario
- Replaces the prior 2-example combined spine set
Discovery additions (outcome-driven, one line each)
- Source scan: glob {planning_artifacts}/ for candidates, parent never reads
- Form-factor: resolve before IA closes; journeys often derive it
- Surface closure: every stated need has a surface, every surface a journey
- Named-protagonist journeys (Mary, not "the user")
- Design handoff working mode (extensible producer registry, default: Stitch)
PRD and brief alignment with same insights
- bmad-prd: dropped standalone Primary Persona section from template;
renamed "Personas + Journeys" entry to "Journey-led"; named-protagonist
rule on UJs; form-factor probe; validation checklist updated
- bmad-product-brief: form-factor surfaced in Discovery topics
Quality scan fixes
- Added ## Overview heading; renamed ## Activation to ## On Activation
- Replaced ../ paths in example assets with {planning_artifacts}/
- Sources section compressed (abstract delta-only rule)
- Working mode aligned to "Fast path" / "Coaching path" BMad-wide convention
New
- references/design-md-spec.md: working summary of the spec for the LLM
- customize.toml: design_md_examples, experience_md_examples,
design_handoffs registries
- .prettierignore: ignore .analysis/ quality-scan artifacts repo-wide
* refactor(bmad-ux): activation parity with prd/brief, opt-in reviewer gate, no headline grade
- Restructure On Activation as numbered six-step list mirroring bmad-prd
and bmad-product-brief, restoring the explicit key-resolution list that
earlier crammed-paragraph form had dropped (planning_artifacts and
friends were silently unresolved at Create).
- Make Reviewer Gate opt-in and lens-selectable. At Finalize, ask before
spending tokens on parallel reviewer subagents; at Validate intent,
skip that question but still confirm lens picks. Stops the auto-run
WCAG audit on hobby-stakes work.
- Drop the overall validation grade. Per-category verdicts and severity
counts already say what is true; a single headline grade conflated
design rigor with release readiness and led "POOR" pills landing on
reports whose own bodies described the work as strong. Removed from
references/validate.md (ladder rule + markdown twin), HTML template
(grade pill div + CSS vars + classes).
- Trim creative-tools.md: drop the Custom entries section. Runtime
prompt files should only carry what the LLM needs to act in this
moment; how-to-extend-via-TOML is setup-time human documentation
already covered by customize.toml comments.
* fix(bmad-ux): align validation report template with 8-category rubric
Template placeholders referenced 'Decision-readiness' and 'seven dimensions'
from the prior rubric. Replace with TEMPLATE_CATEGORY_NAME and inline the
eight canonical categories from references/validate.md so the synthesis pass
names them verbatim.
* fix(validate-skills): remove stale WF-01/WF-02 rules
WF-01/WF-02 were originally scoped to workflow.md files (now mostly gone)
but had been generalized to flag name/description in any non-SKILL.md
markdown. That over-captured legitimate spec files — e.g. DESIGN.md
examples in bmad-ux/assets/ that carry name/description per the Google
Labs DESIGN.md spec.
Step files are already covered by STEP-06. Rule count: 14 → 12.
* fix(bmad-ux): address PR review followups
- validation-report-template.html: severity badge class is badge-sev-*,
not sev-* (the comment misled the synthesis pass).
- Sweep dangling bmad-create-ux-design references: module-help.csv,
bmad-agent-ux-designer/customize.toml, bmad-prd/SKILL.md handoff list,
workflow-map.md (en + 4 translations), getting-started.md (en + 4
translations). Workflow-map output column updated to DESIGN.md +
EXPERIENCE.md.
- references/validate.md: Markdown capitalized as a proper noun.
6.9 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Mapa pracovních postupů | Vizuální reference fází workflow BMad Method a jejich výstupů |
|
BMad Method (BMM) je modul v ekosystému BMad, zaměřený na dodržování osvědčených postupů context engineeringu a plánování. AI agenti fungují nejlépe s jasným, strukturovaným kontextem. Systém BMM buduje tento kontext progresivně napříč 4 odlišnými fázemi — každá fáze a volitelně více workflow v každé fázi produkují dokumenty, které informují další, takže agenti vždy vědí, co budovat a proč.
Zdůvodnění a koncepty vycházejí z agilních metodik, které byly v průmyslu úspěšně používány jako mentální framework.
Pokud si kdykoli nejste jisti, co dělat, skill bmad-help vám pomůže zůstat na cestě nebo vědět, co dělat dál. Vždy se můžete odkázat sem — ale bmad-help je plně interaktivní a mnohem rychlejší, pokud již máte nainstalovaný BMad Method. Navíc, pokud používáte různé moduly, které rozšířily BMad Method nebo přidaly další komplementární moduly — bmad-help se vyvíjí a zná vše, co je dostupné, aby vám dal nejlepší radu v daném okamžiku.
Důležitá poznámka: Každý workflow níže lze spustit přímo vaším nástrojem přes skill nebo načtením agenta a použitím záznamu z nabídky agenta.
Otevřít diagram v novém panelu ↗
Fáze 1: Analýza (volitelná)
Prozkoumejte problémový prostor a validujte nápady před závazkem k plánování.
| Workflow | Účel | Produkuje |
|---|---|---|
bmad-brainstorming |
Brainstorming nápadů na projekt s řízenou facilitací brainstormingového kouče | brainstorming-report.md |
bmad-domain-research, bmad-market-research, bmad-technical-research |
Validace tržních, technických nebo doménových předpokladů | Výzkumné nálezy |
bmad-product-brief |
Zachycení strategické vize — nejlepší, když je váš koncept jasný | product-brief.md |
bmad-prfaq |
Working Backwards — zátěžový test a zformování vašeho produktového konceptu | prfaq-{project}.md |
Fáze 2: Plánování
Definujte, co budovat a pro koho.
| Workflow | Účel | Produkuje |
|---|---|---|
bmad-create-prd |
Definice požadavků (FR/NFR) | PRD.md |
bmad-ux |
Návrh uživatelského zážitku (když záleží na UX) | DESIGN.md, EXPERIENCE.md |
Fáze 3: Solutioning
Rozhodněte, jak to budovat, a rozložte práci na stories.
| Workflow | Účel | Produkuje |
|---|---|---|
bmad-create-architecture |
Explicitní technická rozhodnutí | architecture.md s ADR |
bmad-create-epics-and-stories |
Rozložení požadavků na implementovatelnou práci | Soubory epiců se stories |
bmad-check-implementation-readiness |
Kontrola brány před implementací | Rozhodnutí PASS/CONCERNS/FAIL |
Fáze 4: Implementace
Budujte to, jednu story po druhé. Brzy plná automatizace fáze 4!
| Workflow | Účel | Produkuje |
|---|---|---|
bmad-sprint-planning |
Inicializace sledování (jednou na projekt pro sekvencování dev cyklu) | sprint-status.yaml |
bmad-create-story |
Příprava další story pro implementaci | story-[slug].md |
bmad-dev-story |
Implementace story | Fungující kód + testy |
bmad-code-review |
Validace kvality implementace | Schváleno nebo požadovány změny |
bmad-correct-course |
Řešení významných změn uprostřed sprintu | Aktualizovaný plán nebo přesměrování |
bmad-sprint-status |
Sledování průběhu sprintu a stavu stories | Aktualizace stavu sprintu |
bmad-retrospective |
Revize po dokončení epicu | Poučení |
Quick Flow (paralelní cesta)
Přeskočte fáze 1–3 pro malou, dobře pochopenou práci.
| Workflow | Účel | Produkuje |
|---|---|---|
bmad-quick-dev |
Sjednocený quick flow — vyjasněte záměr, plánujte, implementujte, revidujte a prezentujte | spec-*.md + kód |
Správa kontextu
Každý dokument se stává kontextem pro další fázi. PRD říká architektovi, jaká omezení záleží. Architektura říká dev agentovi, jaké vzory následovat. Soubory stories poskytují zaměřený, kompletní kontext pro implementaci. Bez této struktury agenti dělají nekonzistentní rozhodnutí.
Kontext projektu
:::tip[Doporučeno]
Vytvořte project-context.md pro zajištění toho, aby AI agenti dodržovali pravidla a preference vašeho projektu. Tento soubor funguje jako ústava vašeho projektu — vede implementační rozhodnutí napříč všemi workflow. Tento volitelný soubor lze vygenerovat na konci tvorby architektury, nebo u existujícího projektu ho lze také vygenerovat pro zachycení toho, co je důležité pro zachování souladu se současnými konvencemi.
:::
Jak ho vytvořit:
- Ručně — Vytvořte
_bmad-output/project-context.mds vaším technologickým stackem a pravidly implementace - Vygenerujte ho — Spusťte
bmad-generate-project-contextpro automatické generování z vaší architektury nebo kódové báze