BMAD-METHOD/docs
Alex Verkhovsky 21f9da5e2f docs: optimize style guide for LLM readers
Restructure documentation style guide with dependency-first ordering
and LLM-optimized content based on editorial-review-structure analysis.

Key changes:
- Add Universal Formatting Rules section at top (consolidated anti-patterns)
- Move Visual Hierarchy and formatting rules before document types
- Add Document Types decision table for type selection
- Move Before/After example to follow Visual Hierarchy
- Merge Links/Images into single Assets table
- Move tutorial-specific checklist into Tutorial Structure section
- Move Validation Steps to end (submission workflow)
- Cut abstract Quick Principles (no execution value for LLMs)
- Remove emotional/orientation language throughout
- Condense FAQ Sections structure

Result: ~35% reduction (539 deletions, 383 insertions) with improved
parseability for AI agents writing documentation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:15:10 -08:00
..
_archive docs: comprehensive style guide update with reference and glossary standards 2026-01-12 00:23:05 -05:00
explanation remove hard inclusion of AV from installer, to replace with module soon 2026-01-14 23:04:19 -06:00
how-to remove hard inclusion of AV from installer, to replace with module soon 2026-01-14 23:04:19 -06:00
reference docs: comprehensive style guide update with reference and glossary standards 2026-01-12 00:23:05 -05:00
tutorials Add link auditor, reorganize documentation, and README update (#1277) 2026-01-10 02:55:33 +08:00
404.md Add link auditor, reorganize documentation, and README update (#1277) 2026-01-10 02:55:33 +08:00
_README_WORKFLOW_DIAGRAMS.md feat(docs): Diataxis restructure + Astro/Starlight migration (#1263) 2026-01-07 14:42:15 +08:00
_STYLE_GUIDE.md docs: optimize style guide for LLM readers 2026-01-15 10:15:10 -08:00
downloads.md Add link auditor, reorganize documentation, and README update (#1277) 2026-01-10 02:55:33 +08:00
index.md Add link auditor, reorganize documentation, and README update (#1277) 2026-01-10 02:55:33 +08:00