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.
14 KiB
title, description
| title | description |
|---|---|
| Začínáme | Nainstalujte BMad a vytvořte svůj první projekt |
Vytvářejte software rychleji pomocí pracovních postupů řízených AI se specializovanými agenty, kteří vás provedou plánováním, architekturou a implementací.
Co se naučíte
- Nainstalovat a inicializovat BMad Method pro nový projekt
- Používat BMad-Help — vašeho inteligentního průvodce, který ví, co dělat dál
- Vybrat správnou plánovací cestu pro velikost vašeho projektu
- Postupovat fázemi od požadavků k fungujícímu kódu
- Efektivně používat agenty a pracovní postupy
:::note[Předpoklady]
- Node.js 20.12+ — Vyžadováno pro instalátor
- Git — Doporučeno pro správu verzí
- AI-powered IDE — Claude Code, Cursor nebo podobné
- Nápad na projekt — I jednoduchý stačí pro učení :::
:::tip[Nejsnadnější cesta]
Instalace → npx bmad-method install
Zeptejte se → bmad-help what should I do first?
Tvořte → Nechte BMad-Help vás provést workflow po workflow
:::
Seznamte se s BMad-Help: Váš inteligentní průvodce
BMad-Help je nejrychlejší způsob, jak začít s BMad. Nemusíte si pamatovat workflow nebo fáze — prostě se zeptejte a BMad-Help:
- Prozkoumá váš projekt a zjistí, co už bylo uděláno
- Ukáže vaše možnosti na základě nainstalovaných modulů
- Doporučí, co dál — včetně prvního povinného úkolu
- Odpoví na otázky jako „Mám nápad na SaaS, kde začít?“
Jak používat BMad-Help
Spusťte ho ve vašem AI IDE vyvoláním skillu:
bmad-help
Nebo ho spojte s otázkou pro kontextové poradenství:
bmad-help I have an idea for a SaaS product, I already know all the features I want. where do I get started?
BMad-Help odpoví s:
- Co je doporučeno pro vaši situaci
- Jaký je první povinný úkol
- Jak vypadá zbytek procesu
Řídí i pracovní postupy
BMad-Help nejen odpovídá na otázky — automaticky se spouští na konci každého workflow a řekne vám přesně, co dělat dál. Žádné hádání, žádné prohledávání dokumentace — jen jasné pokyny k dalšímu povinnému workflow.
:::tip[Začněte zde]
Po instalaci BMad okamžitě vyvolejte skill bmad-help. Detekuje, jaké moduly máte nainstalované, a navede vás ke správnému výchozímu bodu pro váš projekt.
:::
Pochopení BMad
BMad vám pomáhá vytvářet software prostřednictvím řízených pracovních postupů se specializovanými AI agenty. Proces probíhá ve čtyřech fázích:
| Fáze | Název | Co se děje |
|---|---|---|
| 1 | Analýza | Brainstorming, průzkum, product brief nebo PRFAQ (volitelné) |
| 2 | Plánování | Vytvoření požadavků (PRD nebo specifikace) |
| 3 | Solutioning | Návrh architektury (pouze BMad Method/Enterprise) |
| 4 | Implementace | Budování epic po epicu, story po story |
Otevřete Mapu pracovních postupů pro prozkoumání fází, workflow a správy kontextu.
Na základě složitosti vašeho projektu nabízí BMad tři plánovací cesty:
| Cesta | Nejlepší pro | Vytvořené dokumenty |
|---|---|---|
| Quick Flow | Opravy chyb, jednoduché funkce, jasný rozsah (1–15 stories) | Pouze tech-spec |
| BMad Method | Produkty, platformy, složité funkce (10–50+ stories) | PRD + architektura + UX |
| Enterprise | Compliance, multi-tenant systémy (30+ stories) | PRD + architektura + bezpečnost + DevOps |
:::note Počty stories jsou orientační, ne definitivní. Vyberte si cestu podle potřeb plánování, ne podle počtu stories. :::
Instalace
Otevřete terminál v adresáři vašeho projektu a spusťte:
npx bmad-method install
Pokud chcete nejnovější prereleaseový build místo výchozího release kanálu, použijte npx bmad-method@next install.
Při výzvě k výběru modulů zvolte BMad Method.
Instalátor vytvoří dvě složky:
_bmad/— agenti, workflow, úkoly a konfigurace_bmad-output/— prozatím prázdná, ale zde se budou ukládat vaše artefakty
:::tip[Váš další krok] Otevřete vaše AI IDE ve složce projektu a spusťte:
bmad-help
BMad-Help detekuje, co jste dokončili, a doporučí přesně, co dělat dál. Můžete mu také klást otázky jako „Jaké mám možnosti?“ nebo „Mám nápad na SaaS, kde začít?“ :::
:::note[Jak načítat agenty a spouštět workflow]
Každý workflow má skill, který vyvoláte jménem ve vašem IDE (např. bmad-create-prd). Váš AI nástroj rozpozná název bmad-* a spustí ho — nemusíte načítat agenty zvlášť. Můžete také vyvolat agentní skill přímo pro obecnou konverzaci (např. bmad-agent-pm pro PM agenta).
:::
:::caution[Nové chaty] Vždy začněte nový chat pro každý workflow. Tím předejdete problémům s kontextovými omezeními. :::
Krok 1: Vytvořte svůj plán
Projděte fázemi 1–3. Pro každý workflow používejte nové chaty.
:::tip[Kontext projektu (volitelné)]
Před začátkem zvažte vytvoření project-context.md pro dokumentaci vašich technických preferencí a pravidel implementace. Tím zajistíte, že všichni AI agenti budou dodržovat vaše konvence v průběhu celého projektu.
Vytvořte ho ručně na _bmad-output/project-context.md nebo ho vygenerujte po architektuře pomocí bmad-generate-project-context. Zjistit více.
:::
Fáze 1: Analýza (volitelná)
Všechny workflow v této fázi jsou volitelné:
- brainstorming (
bmad-brainstorming) — Řízená ideace - průzkum (
bmad-market-research/bmad-domain-research/bmad-technical-research) — Tržní, doménový a technický průzkum - product-brief (
bmad-product-brief) — Doporučený základní dokument, když je váš koncept jasný - prfaq (
bmad-prfaq) — Working Backwards výzva pro zátěžový test a zformování vašeho produktového konceptu
Fáze 2: Plánování (povinná)
Pro BMad Method a Enterprise cesty:
- Vyvolejte PM agenta (
bmad-agent-pm) v novém chatu - Spusťte workflow
bmad-create-prd(bmad-create-prd) - Výstup:
PRD.md
Pro Quick Flow cestu:
- Spusťte
bmad-quick-dev— zvládne plánování i implementaci v jednom workflow, přeskočte k implementaci
:::note[UX Design (volitelné)]
Pokud má váš projekt uživatelské rozhraní, vyvolejte UX-Designer agenta (bmad-agent-ux-designer) a spusťte UX design workflow (bmad-ux) po vytvoření PRD.
:::
Fáze 3: Solutioning (BMad Method/Enterprise)
Vytvoření architektury
- Vyvolejte Architect agenta (
bmad-agent-architect) v novém chatu - Spusťte
bmad-create-architecture(bmad-create-architecture) - Výstup: Dokument architektury s technickými rozhodnutími
Vytvoření epiců a stories
:::tip[Vylepšení ve V6] Epicy a stories se nyní vytvářejí po architektuře. Tím vznikají kvalitnější stories, protože architektonická rozhodnutí (databáze, API vzory, tech stack) přímo ovlivňují rozklad práce. :::
- Vyvolejte PM agenta (
bmad-agent-pm) v novém chatu - Spusťte
bmad-create-epics-and-stories(bmad-create-epics-and-stories) - Workflow využívá jak PRD, tak architekturu k vytvoření technicky informovaných stories
Kontrola připravenosti k implementaci (vysoce doporučeno)
- Vyvolejte Architect agenta (
bmad-agent-architect) v novém chatu - Spusťte
bmad-check-implementation-readiness(bmad-check-implementation-readiness) - Validuje soudržnost všech plánovacích dokumentů
Krok 2: Sestavte svůj projekt
Jakmile je plánování dokončeno, přejděte k implementaci. Každý workflow by měl běžet v novém chatu.
Inicializace plánování sprintu
Vyvolejte Developer agenta (bmad-agent-dev) a spusťte bmad-sprint-planning (bmad-sprint-planning). Tím se vytvoří sprint-status.yaml pro sledování všech epiců a stories.
Cyklus vývoje
Pro každou story opakujte tento cyklus s novými chaty:
| Krok | Agent | Workflow | Příkaz | Účel |
|---|---|---|---|---|
| 1 | DEV | bmad-create-story |
bmad-create-story |
Vytvoření story souboru z epicu |
| 2 | DEV | bmad-dev-story |
bmad-dev-story |
Implementace story |
| 3 | DEV | bmad-code-review |
bmad-code-review |
Validace kvality (doporučeno) |
Po dokončení všech stories v epicu vyvolejte Developer agenta (bmad-agent-dev) a spusťte bmad-retrospective (bmad-retrospective).
Co jste dosáhli
Naučili jste se základy budování s BMad:
- Nainstalovali BMad a nakonfigurovali ho pro vaše IDE
- Inicializovali projekt s vybranou plánovací cestou
- Vytvořili plánovací dokumenty (PRD, architektura, epicy a stories)
- Pochopili cyklus vývoje pro implementaci
Váš projekt nyní obsahuje:
váš-projekt/
├── _bmad/ # Konfigurace BMad
├── _bmad-output/
│ ├── planning-artifacts/
│ │ ├── PRD.md # Váš dokument požadavků
│ │ ├── architecture.md # Technická rozhodnutí
│ │ └── epics/ # Soubory epiců a stories
│ ├── implementation-artifacts/
│ │ └── sprint-status.yaml # Sledování sprintu
│ └── project-context.md # Pravidla implementace (volitelné)
└── ...
Rychlý přehled
| Workflow | Příkaz | Agent | Účel |
|---|---|---|---|
bmad-help ⭐ |
bmad-help |
Jakýkoli | Váš inteligentní průvodce — ptejte se na cokoli! |
bmad-create-prd |
bmad-create-prd |
PM | Vytvoření dokumentu požadavků (PRD) |
bmad-create-architecture |
bmad-create-architecture |
Architect | Vytvoření dokumentu architektury |
bmad-generate-project-context |
bmad-generate-project-context |
Analyst | Vytvoření souboru kontextu projektu |
bmad-create-epics-and-stories |
bmad-create-epics-and-stories |
PM | Rozklad PRD na epicy |
bmad-check-implementation-readiness |
bmad-check-implementation-readiness |
Architect | Validace soudržnosti plánování |
bmad-sprint-planning |
bmad-sprint-planning |
DEV | Inicializace sledování sprintu |
bmad-create-story |
bmad-create-story |
DEV | Vytvoření souboru story |
bmad-dev-story |
bmad-dev-story |
DEV | Implementace story |
bmad-code-review |
bmad-code-review |
DEV | Revize implementovaného kódu |
Časté otázky
Potřebuji vždy architekturu? Pouze pro BMad Method a Enterprise cesty. Quick Flow přeskakuje ze specifikace rovnou k implementaci.
Mohu později změnit svůj plán?
Ano. Workflow bmad-correct-course (bmad-correct-course) řeší změny rozsahu během implementace.
Co když chci nejdřív brainstormovat?
Vyvolejte Analyst agenta (bmad-agent-analyst) a spusťte bmad-brainstorming (bmad-brainstorming) před zahájením PRD.
Musím dodržovat striktní pořadí? Ne striktně. Jakmile se naučíte postup, můžete spouštět workflow přímo pomocí Rychlého přehledu výše.
Získání pomoci
:::tip[První zastávka: BMad-Help]
Vyvolejte bmad-help kdykoli — je to nejrychlejší způsob, jak se odpoutat. Zeptejte se na cokoli:
- „Co mám dělat po instalaci?“
- „Zasekl jsem se na workflow X“
- „Jaké mám možnosti pro Y?“
- „Ukaž mi, co bylo dosud uděláno“
BMad-Help prozkoumá váš projekt, detekuje, co jste dokončili, a řekne vám přesně, co dělat dál. :::
- Během workflow — Agenti vás provázejí otázkami a vysvětleními
- Komunita — Discord (#bmad-method-help, #report-bugs-and-issues)
Klíčové poznatky
:::tip[Zapamatujte si]
- Začněte s
bmad-help— Váš inteligentní průvodce, který zná váš projekt a možnosti - Vždy používejte nové chaty — Začněte nový chat pro každý workflow
- Cesta záleží — Quick Flow používá
bmad-quick-dev; Method/Enterprise vyžadují PRD a architekturu - BMad-Help se spouští automaticky — Každý workflow končí pokyny, co dělat dál :::
Jste připraveni začít? Nainstalujte BMad, vyvolejte bmad-help a nechte svého inteligentního průvodce ukázat cestu.