4.7 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| Existující projekty | Jak používat BMad Method na existujících kódových bázích |
|
Používejte BMad Method efektivně při práci na existujících projektech a starších kódových bázích.
Tento návod pokrývá základní workflow pro zapojení se do existujících projektů s BMad Method.
:::note[Předpoklady]
- BMad Method nainstalován (
npx bmad-method install) - Existující kódová báze, na které chcete pracovat
- Přístup k AI-powered IDE (Claude Code nebo Cursor) :::
Krok 1: Vyčistěte dokončené plánovací artefakty
Pokud jste dokončili všechny PRD epicy a stories procesem BMad, vyčistěte tyto soubory. Archivujte je, smažte nebo se spoléhejte na historii verzí. Nenechávejte tyto soubory v:
docs/_bmad-output/planning-artifacts/_bmad-output/implementation-artifacts/
Krok 2: Vytvořte kontext projektu
:::tip[Doporučeno pro existující projekty]
Vygenerujte project-context.md pro zachycení vzorů a konvencí vaší existující kódové báze. Tím zajistíte, že AI agenti budou při implementaci změn dodržovat vaše zavedené postupy.
:::
Spusťte workflow pro generování kontextu projektu:
bmad-generate-project-context
Toto skenuje vaši kódovou bázi a identifikuje:
- Technologický stack a verze
- Vzory organizace kódu
- Konvence pojmenování
- Přístupy k testování
- Vzory specifické pro framework
Vygenerovaný soubor můžete zkontrolovat a upravit, nebo ho vytvořit ručně na _bmad-output/project-context.md.
Zjistit více o kontextu projektu
Krok 3: Udržujte kvalitní projektovou dokumentaci
Vaše složka docs/ by měla obsahovat stručnou, dobře organizovanou dokumentaci, která přesně reprezentuje váš projekt:
- Záměr a obchodní zdůvodnění
- Obchodní pravidla
- Architektura
- Jakékoli další relevantní informace o projektu
Pro složité projekty zvažte použití workflow bmad-document-project. Nabízí varianty, které proskenují celý váš projekt a zdokumentují jeho aktuální stav.
Krok 3: Získejte pomoc
BMad-Help: Váš výchozí bod
Spusťte bmad-help kdykoli si nejste jisti, co dělat dál. Tento inteligentní průvodce:
- Prozkoumá váš projekt a zjistí, co už bylo uděláno
- Ukáže možnosti na základě nainstalovaných modulů
- Rozumí dotazům v přirozeném jazyce
bmad-help I have an existing Rails app, where should I start?
bmad-help What's the difference between quick-flow and full method?
bmad-help Show me what workflows are available
BMad-Help se také automaticky spouští na konci každého workflow a poskytuje jasné pokyny, co přesně dělat dál.
Volba přístupu
Máte dvě hlavní možnosti v závislosti na rozsahu změn:
| Rozsah | Doporučený přístup |
|---|---|
| Malé aktualizace či doplnění | Spusťte bmad-quick-dev pro vyjasnění záměru, plánování, implementaci a revizi v jednom workflow. Plná čtyřfázová metoda BMad je pravděpodobně přehnaná. |
| Velké změny či doplnění | Začněte s metodou BMad a aplikujte tolik nebo tak málo důkladnosti, kolik potřebujete. |
Během tvorby PRD
Při vytváření briefu nebo přímém přechodu na PRD zajistěte, aby agent:
- Našel a analyzoval vaši existující projektovou dokumentaci
- Přečetl si správný kontext o vašem aktuálním systému
Agenta můžete navést explicitně, ale cílem je zajistit, aby se nová funkce dobře integrovala s vaším existujícím systémem.
Úvahy o UX
Práce na UX je volitelná. Rozhodnutí nezávisí na tom, zda váš projekt má UX, ale na:
- Zda budete pracovat na změnách UX
- Zda jsou potřeba významné nové UX návrhy nebo vzory
Pokud vaše změny představují jednoduché aktualizace existujících obrazovek, se kterými jste spokojeni, plný UX proces je zbytečný.
Úvahy o architektuře
Při práci na architektuře zajistěte, aby architekt:
- Používal správné zdokumentované soubory
- Skenoval existující kódovou bázi
Věnujte zde zvláštní pozornost, abyste předešli znovuvynalézání kola nebo rozhodnutím, která neodpovídají vaší existující architektuře.
Další informace
- Rychlé opravy — Opravy chyb a ad-hoc změny
- FAQ pro existující projekty — Časté otázky o práci na existujících projektech