Brian
cf54f4d76d
* refactor(bmm): move sprint-planning and sprint-status to plan/ They sit at the plan/ship boundary and their outputs are planning artifacts of the dev cycle; next commit makes sprint-planning the readiness gate, which is plan-side work. * refactor(bmm): fold readiness gate into sprint-planning, retire check-implementation-readiness The old skill was 1,154 lines of legacy numbered-step ceremony whose document discovery hardcoded filename globs (*prd*, *ux*, *epic*) that miss what current skills produce (SPEC.md, DESIGN.md) and still treated retired sharded docs as first-class. Sprint-planning now opens with a lean readiness gate: generic artifact discovery by content, forward/back traceability, PASS/CONCERNS/FAIL, stop on FAIL with findings. The IR trigger on John's and Winston's menus dispatches sprint-planning, so 'check implementation readiness' still works everywhere it used to. * refactor(bmm): modernize sprint-planning with deterministic script core SKILL.md drops the legacy XML step dialect for the product-brief style (~100 lines, uv run, headless contract). New scripts/sprint_plan.py owns the mechanical work — epic parsing, key derivation, ordering, preserve- never-downgrade merge, story-file detection, action_items carry-over, atomic writes, drift checks — with 11 tests wired in as test:sprint-planning. Judgment stays with the LLM: epic discovery, the readiness gate, and reconciling script-reported orphans and unparsed headings. checklist.md retired (the script performs that checklist); sprint-status-template.yaml is the single source for the status vocabulary. Output stays byte-compatible with build's sprint sync and retrospective's tooling. * refactor(bmm): fold sprint-status into sprint-planning's status view sprint_plan.py gains a status subcommand: counts (legacy values mapped), risk flags, open action items, and a priority-ordered next-action recommendation — the old skill's inference-driven summary, computed deterministically and covered by 9 new tests. bmad-sprint-status becomes a v6-shims husk that forwards with status-view intent and a deprecation notice; its dead data/validate modes had zero callers and are gone. If a hand-edited status file defeats the script, the skill falls back to reading it directly and summarizing by best judgment. New explanation page docs/explanation/sprint-planning.md covers the consolidated skill; workflow maps and references updated across all languages. * docs: changelog entries for skill reorg and sprint consolidation * fix(bmm): harden sprint_plan.py per review; add validate/fix intents with full progressive disclosure Review fixes (PR #2659 findings, bot + internal review): - Normalize legacy v6 statuses (drafted/contexted) on every read — merged by meaning and reported, never treated as illegal or reset - dropped_orphans carry their old status; transplant renames via --set - project_key/tracking_system/story_location preserved from the existing file unless overridden; refresh round-trips custom keys and user comments - Hardened write path: dump-to-bytes, fsync, permission-preserving atomic write inside the guarded block, explicit checks (no asserts), atomic restore - JSON-only argparse (errors and -h emit JSON); unicode-aware slugs with hash fallback; fenced code blocks ignored when parsing epics - Odd retro keys, date-typed stamps, and non-mapping YAML report cleanly instead of crashing; unparseable timestamps warn instead of silently disabling the staleness check; malformed action items flagged, not dropped - Dead check subcommand removed; generate --dry-run reports drift/in_sync - test:sprint-planning wired into quality and CI (was test-only) - Retro tests use a vendored template fixture (PATH-05); repo-level test-template-sync.js keeps it byte-identical to the source; template example timestamps and story_location fixed; header block pinned to the template by test New capability: - validate subcommand + reference: structural validation, never writes - fix flow: evidence-gathering subagents -> user-confirmed state table -> generate --fresh --set writes a pristine file (the one path allowed to downgrade); universal script-failure fallback to inference for every intent - SKILL.md is now a lean router: gate, tracking, status, fix, and validate each load as progressive-disclosure references Docs: explanation page gains Repair section; workflow-map and getting-started across all five languages mention the status view; headless payload nests under 'report' to avoid the status key collision; changelog updated. Test suite grows 20 -> 37; retro suite 91/91; docs build and validators green. * docs: mention repair in sprint-planning explanation description
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
- Zvolit správnou hloubku plánování pro vaši práci
- 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 podle potřeby |
| 4 | Implementace | Implementace každé změny nebo naplánované story, volitelně pomocí automatizované orchestrace |
Otevřete Mapu pracovních postupů pro prozkoumání fází, workflow a správy kontextu.
Hloubka plánování je flexibilní:
| Hloubka | Nejlepší pro | Kontext před implementací |
|---|---|---|
| Přímá | Jasné opravy, funkce, issues nebo existující specifikace | Záměr, issue nebo specifikace |
| Produktové plánování | Produkty, platformy a složité funkce | PRD a volitelný UX návrh |
| Plné solutioning | Koordinované, rizikové nebo mezisystémové iniciativy | PRD, UX, architektura, epicy, stories a sprint plán |
:::note
Nejde o oddělené implementační cesty. Všechny vstupy se sbíhají do bmad-build; plánování pouze mění množství dostupného kontextu.
:::
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-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: Zvolte hloubku plánování
Použijte z fází 1–3 tolik, kolik vaše práce potřebuje. U jasné, ohraničené práce můžete přejít přímo ke Kroku 2. 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-deep-recon) — Navrhne prompt pro váš vlastní nástroj hloubkového výzkumu, zpracuje hotovou zprávu do stručného shrnutí pro navazující práci, nebo výzkum provede přímo — tržní, doménový, technický, konkurenční, uživatelský a akademický — s ověřováním tvrzení a životním cyklem obnovy - 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í (podle potřeby)
Pro práci, které prospívá produktové plánování:
- Vyvolejte PM agenta (
bmad-agent-pm) v novém chatu - Spusťte workflow
bmad-prd(bmad-prd) - Výstup:
PRD.md
:::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 (podle potřeby)
Vytvoření architektury
- Vyvolejte Architect agenta (
bmad-agent-architect) v novém chatu - Spusťte
bmad-architecture(bmad-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-sprint-planning(bmad-sprint-planning) — otevírá se bránou připravenosti - Validuje soudržnost všech plánovacích dokumentů
Krok 2: Sestavte svůj projekt
Přejděte k implementaci s jakýmkoli dostupným kontextem: přímým požadavkem, issue, specifikací nebo plně naplánovanou story. Každý workflow by měl běžet v novém chatu.
U plánované práce spusťte bmad-build a určete vybranou story nebo položku sprintu, například: Implementuj story 2.3 z _bmad-output/planning-artifacts/epics.md.
Inicializace plánování sprintu (pro plánovanou práci)
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.
Když Build v tomto souboru rozpozná vybranou story, během implementace ji přesune do stavu in-progress a po dokončení implementace do stavu review.
Cyklus vývoje
Pro každou přímou změnu nebo naplánovanou story opakujte tento cyklus s novými chaty:
| Krok | Agent | Workflow | Příkaz | Účel |
|---|---|---|---|---|
| 1 | DEV | bmad-build |
bmad-build |
Upřesnění, plán, implementace, revize a prezentace |
| 2 | DEV | bmad-code-review |
bmad-code-review |
Dodatečná validace kvality (doporučeno) |
Revize v Build je součástí každého běhu. bmad-code-review je volitelná nezávislá validační vrstva v novém kontextu.
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
- Zvolili hloubku plánování odpovídající vaší práci
- 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-prd |
bmad-prd |
PM | Vytvoření dokumentu požadavků (PRD) |
bmad-architecture |
bmad-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-sprint-planning |
bmad-sprint-planning |
DEV | Brána připravenosti + inicializace sledování sprintu + přehled stavu |
bmad-build |
bmad-build |
DEV | Implementace záměru, issue, funkce, opravy nebo story |
bmad-code-review |
bmad-code-review |
DEV | Revize implementovaného kódu |
Časté otázky
Potřebuji vždy architekturu?
Ne. Architekturu použijte, když je třeba explicitně zachytit technická rozhodnutí nebo mezisystémová omezení. Jasná práce může vstoupit přímo do bmad-build; větší iniciativa přináší do stejného workflow plánovací artefakty.
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
- Hloubka plánování se liší — přímý záměr i plně naplánované stories vstupují do
bmad-build - 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.