Existující projekty

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.

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

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