4.3 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| Správa kontextu projektu | Vytvoření a údržba project-context.md pro vedení AI agentů |
|
Použijte soubor project-context.md k zajištění toho, aby AI agenti dodržovali technické preference a pravidla implementace vašeho projektu ve všech workflow. Aby byl vždy dostupný, můžete také přidat řádek Important project context and conventions are located in [cesta k project context]/project-context.md do souboru kontextu nebo pravidel vašeho nástroje (jako je AGENTS.md).
:::note[Předpoklady]
- BMad Method nainstalován
- Znalost technologického stacku a konvencí vašeho projektu :::
Kdy to použít
- Máte silné technické preference před začátkem architektury
- Dokončili jste architekturu a chcete zachytit rozhodnutí pro implementaci
- Pracujete na existující kódové bázi se zavedenými vzory
- Všimnete si, že agenti dělají nekonzistentní rozhodnutí napříč stories
Krok 1: Vyberte přístup
Ruční vytvoření — Nejlepší, když přesně víte, jaká pravidla chcete dokumentovat
Generování po architektuře — Nejlepší pro zachycení rozhodnutí učiněných během solutioningu
Generování pro existující projekty — Nejlepší pro objevení vzorů v existujících kódových bázích
Krok 2: Vytvořte soubor
Možnost A: Ruční vytvoření
Vytvořte soubor na _bmad-output/project-context.md:
mkdir -p _bmad-output
touch _bmad-output/project-context.md
Přidejte váš technologický stack a pravidla implementace:
---
project_name: 'MyProject'
user_name: 'YourName'
date: '2026-02-15'
sections_completed: ['technology_stack', 'critical_rules']
---
# Project Context for AI Agents
## Technology Stack & Versions
- Node.js 20.x, TypeScript 5.3, React 18.2
- State: Zustand
- Testing: Vitest, Playwright
- Styling: Tailwind CSS
## Critical Implementation Rules
**TypeScript:**
- Strict mode enabled, no `any` types
- Use `interface` for public APIs, `type` for unions
**Code Organization:**
- Components in `/src/components/` with co-located tests
- API calls use `apiClient` singleton — never fetch directly
**Testing:**
- Unit tests focus on business logic
- Integration tests use MSW for API mocking
Možnost B: Generování po architektuře
Spusťte workflow v novém chatu:
bmad-generate-project-context
Workflow skenuje váš dokument architektury a soubory projektu a generuje kontextový soubor zachycující učiněná rozhodnutí.
Možnost C: Generování pro existující projekty
Pro existující projekty spusťte:
bmad-generate-project-context
Workflow analyzuje vaši kódovou bázi, identifikuje konvence a vygeneruje kontextový soubor, který můžete zkontrolovat a upřesnit.
Krok 3: Ověřte obsah
Zkontrolujte vygenerovaný soubor a ujistěte se, že zachycuje:
- Správné verze technologií
- Vaše skutečné konvence (ne generické osvědčené postupy)
- Pravidla, která předcházejí běžným chybám
- Vzory specifické pro framework
Ručně upravte pro doplnění chybějícího nebo odstranění nepřesností.
Co získáte
Soubor project-context.md, který:
- Zajistí, že všichni agenti dodržují stejné konvence
- Zabrání nekonzistentním rozhodnutím napříč stories
- Zachytí architektonická rozhodnutí pro implementaci
- Slouží jako reference pro vzory a pravidla vašeho projektu
Tipy
:::tip[Osvědčené postupy]
- Zaměřte se na neočividné — Dokumentujte vzory, které agenti mohou přehlédnout (např. „Použijte JSDoc na každé veřejné třídě"), ne univerzální postupy jako „používejte smysluplné názvy proměnných."
- Udržujte to stručné — Tento soubor načítá každý implementační workflow. Dlouhé soubory plýtvají kontextem. Vylučte obsah, který platí pouze pro úzký rozsah nebo specifické stories.
- Aktualizujte dle potřeby — Upravte ručně, když se vzory změní, nebo přegenerujte po významných změnách architektury.
- Funguje pro projekty Quick Flow i plné metody BMad. :::
Další kroky
- Vysvětlení kontextu projektu — Zjistěte více o tom, jak to funguje
- Mapa pracovních postupů — Podívejte se, které workflow načítají kontext projektu