BMAD-METHOD/docs/cs/tutorials/getting-started.md

13 KiB
Raw Blame History

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+ — 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] Instalacenpx bmad-method install Zeptejte sebmad-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 (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 (115 stories) Pouze tech-spec
BMad Method Produkty, platformy, složité funkce (1050+ 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 13. 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
  • vytvoření product brief (bmad-create-product-brief) — Doporučený základní dokument

Fáze 2: Plánování (povinná)

Pro BMad Method a Enterprise cesty:

  1. Vyvolejte PM agenta (bmad-agent-pm) v novém chatu
  2. Spusťte workflow bmad-create-prd (bmad-create-prd)
  3. 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-create-ux-design) po vytvoření PRD. :::

Fáze 3: Solutioning (BMad Method/Enterprise)

Vytvoření architektury

  1. Vyvolejte Architect agenta (bmad-agent-architect) v novém chatu
  2. Spusťte bmad-create-architecture (bmad-create-architecture)
  3. 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. :::

  1. Vyvolejte PM agenta (bmad-agent-pm) v novém chatu
  2. Spusťte bmad-create-epics-and-stories (bmad-create-epics-and-stories)
  3. Workflow využívá jak PRD, tak architekturu k vytvoření technicky informovaných stories

Kontrola připravenosti k implementaci (vysoce doporučeno)

  1. Vyvolejte Architect agenta (bmad-agent-architect) v novém chatu
  2. Spusťte bmad-check-implementation-readiness (bmad-check-implementation-readiness)
  3. 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 SM agenta (bmad-agent-sm) 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 SM 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 SM agenta (bmad-agent-sm) 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 SM Inicializace sledování sprintu
bmad-create-story bmad-create-story SM 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. SM agent má workflow bmad-correct-course (bmad-correct-course) pro řešení změn rozsahu.

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
  • KomunitaDiscord (#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.