Emmanuel Atsé
cede485217
* feat(docs): add sidebar order validator
Adds tools/validate-sidebar-order.js to validate sidebar.order values
in YAML frontmatter across English and translated docs.
Checks for duplicate orders, gaps in sequence, and missing order fields.
For translations, also warns on order drift from English counterparts.
Wired into the quality script as docs:validate-sidebar.
* fix(validate-sidebar): tighten language detection and drift guard, add docstrings
* fix(validate-sidebar): replace subdirectory heuristic with locale pattern matching
detectLanguageDirs() previously classified any top-level docs/ directory
containing subdirectories as a translation language. This was too broad —
if an English section ever gained nested subfolders it would be silently
excluded from validation.
Replaced with a BCP 47 locale-code regex (/^[a-z]{2}(?:-[a-zA-Z]{2})?$/)
that matches known patterns (cs, fr, vi-vn, zh-cn) and won't falsely
classify content sections like explanation/ or reference/.
* fix(validate-sidebar): guard drift check against undefined order values
extractSidebarOrder() returns { hasSidebar: false } when no sidebar block
exists, leaving order as undefined rather than null. The drift check only
guarded against null, allowing undefined values to emit noisy warnings
like "Order drift: ... order undefined".
Changed the guard to typeof === 'number' which correctly excludes both
undefined and null without relying on a specific sentinel value.
* chore(validate-sidebar): add JSDoc docstrings to all functions
Adds @param and @returns annotations to extractSidebarOrder,
detectLanguageDirs, getEnglishSections, checkDirectory,
checkTranslationDrift, and relativePath.
* fix(validate-sidebar): add to pre-commit hook
* refactor(validate-sidebar): harden parsing and edge-case handling
Refactor to main() wrapper with pure return-based APIs, single directory
scan, and shared reporting. Harden frontmatter parsing (anchored delimiter,
direct-child-only order extraction, flow mapping support) and validation
(Infinity/zero guard, gap flood cap, multi-segment locales, graceful ENOENT).
* docs: fix sidebar.order duplicates and gaps across all locales
Resolves all validator errors flagged by the new
tools/validate-sidebar-order.js check.
English (docs/{explanation,how-to,reference}/):
- Renumbered to remove duplicates; established reading order
for new explanation pages added since orders were last set.
Translations (cs, fr, vi-vn, zh-cn):
- Mirrored English structural ordering where files exist, then
compacted to 1..N within each directory to eliminate gaps
caused by missing translation files.
Non-blocking drift warnings remain where translation directories
have fewer files than English; these are expected per the
validator's design.
---------
Co-authored-by: Brian Madison <bmadcode@gmail.com>
3.9 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Oficiální moduly | Doplňkové moduly pro tvorbu vlastních agentů, kreativní inteligenci, vývoj her a testování |
|
BMad se rozšiřuje prostřednictvím oficiálních modulů, které vyberete během instalace. Tyto doplňkové moduly poskytují specializované agenty, workflow a úkoly pro specifické domény nad rámec vestavěného jádra a BMM (Agile suite).
:::tip[Instalace modulů]
Spusťte npx bmad-method install a vyberte požadované moduly. Instalátor se postará o stažení, konfiguraci a integraci s IDE automaticky.
:::
BMad Builder
Vytvářejte vlastní agenty, workflow a doménově specifické moduly s řízenou asistencí. BMad Builder je meta-modul pro rozšiřování samotného frameworku.
- Kód:
bmb - npm:
bmad-builder - GitHub: bmad-code-org/bmad-builder
Poskytuje:
- Agent Builder — tvorba specializovaných AI agentů s vlastní odborností a přístupem k nástrojům
- Workflow Builder — návrh strukturovaných procesů s kroky a rozhodovacími body
- Module Builder — balíčkování agentů a workflow do sdílitelných, publikovatelných modulů
- Interaktivní nastavení s YAML konfigurací a podporou npm publikování
Creative Intelligence Suite
AI nástroje pro strukturovanou kreativitu, ideaci a inovace v rané fázi vývoje. Suite poskytuje více agentů, kteří facilitují brainstorming, design thinking a řešení problémů pomocí osvědčených frameworků.
- Kód:
cis - npm:
bmad-creative-intelligence-suite - GitHub: bmad-code-org/bmad-module-creative-intelligence-suite
Poskytuje:
- Agenty Innovation Strategist, Design Thinking Coach a Brainstorming Coach
- Problem Solver a Creative Problem Solver pro systematické a laterální myšlení
- Storyteller a Presentation Master pro narativy a prezentace
- Ideační frameworky včetně SCAMPER, reverzního brainstormingu a přeformulování problémů
Game Dev Studio
Strukturované workflow pro vývoj her adaptované pro Unity, Unreal, Godot a vlastní enginy. Podporuje rychlé prototypování přes Quick Flow a plnoscálovou produkci s epicky řízenými sprinty.
- Kód:
gds - npm:
bmad-game-dev-studio - GitHub: bmad-code-org/bmad-module-game-dev-studio
Poskytuje:
- Workflow pro generování Game Design Document (GDD)
- Režim Quick Dev pro rychlé prototypování
- Podporu narativního designu pro postavy, dialogy a budování světa
- Pokrytí 21+ typů her s architektonickým vedením specifickým pro engine
Test Architect (TEA)
Podniková testovací strategie, vedení automatizace a rozhodování o release gate prostřednictvím expertního agenta a devíti strukturovaných workflow. TEA jde daleko za vestavěného QA agenta s prioritizací založenou na riziku a trasovatelností požadavků.
- Kód:
tea - npm:
bmad-method-test-architecture-enterprise - GitHub: bmad-code-org/bmad-method-test-architecture-enterprise
Poskytuje:
- Agenta Murat (Master Test Architect a Quality Advisor)
- Workflow pro testovací design, ATDD, automatizaci, revizi testů a trasovatelnost
- Hodnocení NFR, nastavení CI a scaffolding frameworku
- Prioritizaci P0-P3 s volitelnými integracemi Playwright Utils a MCP
Komunitní moduly
Komunitní moduly a marketplace modulů přicházejí. Sledujte organizaci BMad na GitHubu pro aktualizace.