bmad-method 6.0.0-alpha.21 → 6.0.0-alpha.23

package/README.md

@@ -1,245 +1,79 @@
-# BMad Method & BMad Core
+# BMad Method
 
-[![Stable Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=stable)](https://www.npmjs.com/package/bmad-method)
-[![Alpha Version](https://img.shields.io/npm/v/bmad-method/alpha?color=orange&label=alpha)](https://www.npmjs.com/package/bmad-method)
+[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
----
-
-<div align="center">
-
-## 🎉 NEW: BMAD V6 Installer - Create & Share Custom Content!
-
-The completely revamped **BMAD V6 installer** now includes built-in support for creating, installing, and sharing custom modules, agents, workflows, templates, and tools! Build your own AI solutions or share them with your team - and real soon, with the whole BMad Community througha verified community sharing portal!
-
-**✨ What's New:**
-
-- 📦 **Streamlined Custom Module Installation** - Package your custom content as installable modules
-- 🤖 **Agent & Workflow Sharing** - Distribute standalone agents and workflows
-- 🔄 **Unitary Module Support** - Install individual components without full modules
-- ⚙️ **Dependency Management** - Automatic handling of module dependencies
-- 🛡️ **Update-Safe Customization** - Your custom content persists through updates
-
-**📚 Learn More:**
-
-- [**Custom Content Overview**](./docs/custom-content.md) - Discover all supported content types
-- [**Installation Guide**](./docs/custom-content-installation.md) - Learn to create and install custom content
-- [**Detail Content Docs**](./src/modules/bmb/docs/index.md) - Reference details for agents, modules, workflows and the bmad builder
-- [**2 Very simple Custom Modules of questionable quality**](./samples/sample-custom-modules/README.md) - if you want to download and try to install a custom shared module, get an idea of how to bundle and share your own, or create your own personal agents, workflows and modules.
-
-</div>
-
----
-
-## AI-Driven Agile Development That Scales From Bug Fixes to Enterprise
-
-**Build More, Architect Dreams** (BMAD) with **21 specialized AI agents** across 4 official modules, and **50+ guided workflows** that adapt to your project's complexity—from quick bug fixes to enterprise platforms, and new step file workflows that allow for incredibly long workflows to stay on the rails longer than ever before!
-
-Additionally - when we say 'Build More, Architect Dreams' - we mean it! The BMad Builder has landed, and now as of Alpha.15 is fully supported in the installation flow via NPX - custom stand along agents, workflows and the modules of your dreams! The community forge will soon open, endless possibility awaits!
-
-> **🚀 v6 is a MASSIVE upgrade from v4!** Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. [See what's new →](#whats-new-in-v6)
+**Build More, Architect Dreams** — An AI-driven agile development framework with 21 specialized agents, 50+ guided workflows, and scale-adaptive intelligence that adjusts from bug fixes to enterprise systems.
 
-> **📌 v6 Alpha Status:** Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to [BMadCode YouTube](https://www.youtube.com/@BMadCode).
+## Why BMad?
 
-## 🎯 Why BMad Method?
+Traditional AI tools do the thinking for you, producing average results. BMad agents act as expert collaborators who guide you through structured workflows to bring out your best thinking.
 
-Unlike generic AI coding assistants, BMad Method provides **structured, battle-tested workflows** powered by specialized agents who understand agile development. Each agent has deep domain expertise—from product management to architecture to testing—working together seamlessly.
+- **Scale-Adaptive**: Automatically adjusts planning depth based on project complexity (Level 0-4)
+- **Structured Workflows**: Grounded in agile best practices across analysis, planning, architecture, and implementation
+- **Specialized Agents**: 12+ domain experts (PM, Architect, Developer, UX, Scrum Master, and more)
+- **Complete Lifecycle**: From brainstorming to deployment, with just-in-time documentation
 
-**✨ Key Benefits:**
+## Quick Start
 
-- **Scale-Adaptive Intelligence** - Automatically adjusts planning depth from bug fixes to enterprise systems
-- **Complete Development Lifecycle** - Analysis → Planning → Architecture → Implementation
-- **Specialized Expertise** - 19 agents with specific roles (PM, Architect, Developer, UX Designer, etc.)
-- **Proven Methodologies** - Built on agile best practices with AI amplification
-- **IDE Integration** - Works with Claude Code, Cursor, Windsurf, VS Code
-
-## 🏗️ The Power of BMad Core
-
-**BMad Method** is actually a sophisticated module built on top of **BMad Core** (**C**ollaboration **O**ptimized **R**eflection **E**ngine). This revolutionary architecture means:
-
-- **BMad Core** provides the universal framework for human-AI collaboration
-- **BMad Method** leverages Core to deliver agile development workflows
-- **BMad Builder** lets YOU create custom modules as powerful as BMad Method itself
-
-With **BMad Builder**, you can architect both simple agents and vastly complex domain-specific modules (legal, medical, finance, education, creative) that will soon be sharable in an **official community marketplace**. Imagine building and sharing your own specialized AI team!
-
-## 📊 See It In Action
-
-<p align="center">
-  <img src="./src/modules/bmm/docs/images/workflow-method-greenfield.svg" alt="BMad Method Workflow" width="100%">
-</p>
-
-<p align="center">
-  <em>Complete BMad Method workflow showing all phases, agents, and decision points</em>
-</p>
-
-## 🚀 Get Started in 3 Steps
-
-### 1. Install BMad Method
+**Prerequisites**: [Node.js](https://nodejs.org) v20+
 
 ```bash
-# Install v6 Alpha (recommended)
 npx bmad-method@alpha install
-
-# Or stable v4 for production
-npx bmad-method install
 ```
 
-### 2. Initialize Your Project
-
-Load any agent in your IDE and run:
+Follow the installer prompts to configure your project. Then run:
 
-```
+```bash
 *workflow-init
 ```
 
-This analyzes your project and recommends the right workflow track.
-
-### 3. Choose Your Track
+This analyzes your project and recommends a track:
 
-BMad Method adapts to your needs with three intelligent tracks:
+| Track           | Best For                  | Time to First Story |
+| --------------- | ------------------------- | ------------------- |
+| **Quick Flow**  | Bug fixes, small features | ~5 minutes          |
+| **BMad Method** | Products and platforms    | ~15 minutes         |
+| **Enterprise**  | Compliance-heavy systems  | ~30 minutes         |
 
-| Track              | Use For                   | Planning                | Time to Start |
-| ------------------ | ------------------------- | ----------------------- | ------------- |
-| **⚡ Quick Flow**  | Bug fixes, small features | Tech spec only          | < 5 minutes   |
-| **📋 BMad Method** | Products, platforms       | PRD + Architecture + UX | < 15 minutes  |
-| **🏢 Enterprise**  | Compliance, scale         | Full governance suite   | < 30 minutes  |
+## Modules
 
-> **Not sure?** Run `*workflow-init` and let BMad analyze your project goal.
+| Module                                | Purpose                                                  |
+| ------------------------------------- | -------------------------------------------------------- |
+| **BMad Method (BMM)**                 | Core agile development with 34 workflows across 4 phases |
+| **BMad Builder (BMB)**                | Create custom agents and domain-specific modules         |
+| **Creative Intelligence Suite (CIS)** | Innovation, brainstorming, and problem-solving           |
 
-## 🔄 How It Works: 4-Phase Methodology
+## Documentation
 
-BMad Method guides you through a proven development lifecycle:
+**[Full Documentation](http://docs.bmad-method.org)** — Tutorials, how-to guides, concepts, and reference
 
-1. **📊 Analysis** (Optional) - Brainstorm, research, and explore solutions
-2. **📝 Planning** - Create PRDs, tech specs, or game design documents
-3. **🏗️ Solutioning** - Design architecture, UX, and technical approach
-4. **⚡ Implementation** - Story-driven development with continuous validation
-
-Each phase has specialized workflows and agents working together to deliver exceptional results.
-
-## 🤖 Meet Your Team
-
-**12 Specialized Agents** working in concert:
-
-| Development | Architecture   | Product       | Leadership     |
-| ----------- | -------------- | ------------- | -------------- |
-| Developer   | Architect      | PM            | Scrum Master   |
-| UX Designer | Test Architect | Analyst       | BMad Master    |
-| Tech Writer | Game Architect | Game Designer | Game Developer |
-
-**Test Architect** integrates with `@seontechnologies/playwright-utils` for production-ready fixture-based utilities.
-
-Each agent brings deep expertise and can be customized to match your team's style.
-
-## 📦 What's Included
-
-### Core Modules
-
-- **BMad Method (BMM)** - Complete agile development framework
-  - 12 specialized agents
-  - 34 workflows across 4 phases
-  - Scale-adaptive planning
-  - [→ Documentation Hub](./src/modules/bmm/docs/index.md)
-
-- **BMad Builder (BMB)** - Create custom agents and workflows
-  - Build anything from simple agents to complex modules
-  - Create domain-specific solutions (legal, medical, finance, education)
-  - [→ Builder Guide](./src/modules/bmb/docs/index.md)
-
-- **Creative Intelligence Suite (CIS)** - Innovation & problem-solving
-  - Brainstorming, design thinking, storytelling
-  - 5 creative facilitation workflows
-  - [→ Creative Workflows](./src/modules/cis/docs/index.md)
-
-### Key Features
-
-- **🎨 Customizable Agents** - Modify personalities, expertise, and communication styles
-- **🌐 Multi-Language Support** - Separate settings for communication and code output
-- **📄 Document Sharding** - 90% token savings for large projects
-- **🔄 Update-Safe** - Your customizations persist through updates
-- **🚀 Web Bundles** - Use in ChatGPT, Claude Projects, or Gemini Gems
-
-## 📚 Documentation
-
-### Quick Links
-
-- **[Quick Start Guide](./src/modules/bmm/docs/quick-start.md)** - 15-minute introduction
-- **[Complete BMM Documentation](./src/modules/bmm/docs/index.md)** - All guides and references
-- **[Agent Customization](./docs/agent-customization-guide.md)** - Personalize your agents
-- **[All Documentation](./docs/index.md)** - Complete documentation index
+- [Getting Started Tutorial](http://docs.bmad-method.org/tutorials/getting-started/getting-started-bmadv6/)
+- [Upgrading from Previous Versions](http://docs.bmad-method.org/how-to/installation/upgrade-to-v6/)
 
 ### For v4 Users
 
-- **[v4 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)**
-- **[v4 to v6 Upgrade Guide](./docs/v4-to-v6-upgrade.md)**
-
-## 💬 Community & Support
-
-- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help, share projects
-- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs, request features
-- **[YouTube Channel](https://www.youtube.com/@BMadCode)** - Video tutorials and demos
-- **[Web Bundles](https://bmad-code-org.github.io/bmad-bundles/)** - Pre-built agent bundles
-- **[Code of Conduct](.github/CODE_OF_CONDUCT.md)** - Community guidelines
-
-## 🛠️ Development
-
-For contributors working on the BMad codebase:
-
-```bash
-# Run all quality checks
-npm test
-
-# Development commands
-npm run lint:fix      # Fix code style
-npm run format:fix    # Auto-format code
-npm run bundle        # Build web bundles
-```
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for full development guidelines.
-
-## What's New in v6
-
-**v6 represents a complete architectural revolution from v4:**
-
-### 🚀 Major Upgrades
-
-- **BMad Core Framework** - Modular architecture enabling custom domain solutions
-- **Scale-Adaptive Intelligence** - Automatic adjustment from bug fixes to enterprise
-- **Visual Workflows** - Beautiful SVG diagrams showing complete methodology
-- **BMad Builder Module** - Create and share your own AI agent teams
-- **50+ Workflows** - Up from 20 in v4, covering every development scenario
-- **19 Specialized Agents** - Enhanced with customizable personalities and expertise
-- **Update-Safe Customization** - Your configs persist through all updates
-- **Web Bundles** - Use agents in ChatGPT, Claude, and Gemini
-- **Multi-Language Support** - Separate settings for communication and code
-- **Document Sharding** - 90% token savings for large projects
+- **[v4 Documentation](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4/docs)**
 
-### 🔄 For v4 Users
+## Community
 
-- **[Comprehensive Upgrade Guide](./docs/v4-to-v6-upgrade.md)** - Step-by-step migration
-- **[v4 Documentation Archive](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)** - Legacy reference
-- Backwards compatibility where possible
-- Smooth migration path with installer detection
+- [Discord](https://discord.gg/gk8jAdXWmj) — Get help, share ideas, collaborate
+- [YouTube](https://www.youtube.com/@BMadCode) — Video tutorials and updates
+- [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues) — Bug reports and feature requests
+- [Discussions](https://github.com/bmad-code-org/BMAD-METHOD/discussions) — Community conversations
 
-## 📄 License
+## Contributing
 
-MIT License - See [LICENSE](LICENSE) for details.
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-**Trademarks:** BMad™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
+## License
 
-Supported by:&nbsp;&nbsp;<a href="https://m.do.co/c/00f11bd932bb"><img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" height="24" alt="DigitalOcean" style="vertical-align: middle;"></a>
+MIT License — see [LICENSE](LICENSE) for details.
 
 ---
 
-<p align="center">
-  <a href="https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors">
-    <img src="https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD" alt="Contributors">
-  </a>
-</p>
+**BMad** and **BMAD-METHOD** are trademarks of BMad Code, LLC.
 
-<p align="center">
-  <sub>Built with ❤️ for the human-AI collaboration community</sub>
-</p>
+[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors)

package/docs/404.md

@@ -0,0 +1,9 @@
+---
+title: Page Not Found
+template: splash
+---
+
+
+The page you're looking for doesn't exist or has been moved.
+
+[Return to Home](/docs/index.md)

package/{src/modules/bmm/docs/images/README.md → docs/_README_WORKFLOW_DIAGRAMS.md}

@@ -1,4 +1,7 @@
-# Workflow Diagram Maintenance
+---
+title: "Workflow Diagram Maintenance"
+---
+
 
 ## Regenerating SVG from Excalidraw
 

package/docs/_STYLE_GUIDE.md

@@ -0,0 +1,347 @@
+# Documentation Style Guide
+
+Internal guidelines for maintaining consistent, high-quality documentation across the BMad Method project. This document is not included in the Starlight sidebar — it's for contributors and maintainers, not end users.
+
+## Quick Principles
+
+1. **Clarity over brevity** — Be concise, but never at the cost of understanding
+2. **Consistent structure** — Follow established patterns so readers know what to expect
+3. **Strategic visuals** — Use admonitions, tables, and diagrams purposefully
+4. **Scannable content** — Headers, lists, and callouts help readers find what they need
+
+## Validation Steps
+
+Before submitting documentation changes, run these checks from the repo root:
+
+1. **Fix link format** — Convert relative links (`./`, `../`) to site-relative paths (`/path/`)
+   ```bash
+   npm run docs:fix-links            # Preview changes
+   npm run docs:fix-links -- --write # Apply changes
+   ```
+
+2. **Validate links** — Check all links point to existing files
+   ```bash
+   npm run docs:validate-links            # Preview issues
+   npm run docs:validate-links -- --write # Auto-fix where possible
+   ```
+
+3. **Build the site** — Verify no build errors
+   ```bash
+   npm run docs:build
+   ```
+
+## Tutorial Structure
+
+Every tutorial should follow this structure:
+
+```
+1. Title + Hook (1-2 sentences describing the outcome)
+2. Version/Module Notice (info or warning admonition as appropriate)
+3. What You'll Learn (bullet list of outcomes)
+4. Prerequisites (info admonition)
+5. Quick Path (tip admonition - TL;DR summary)
+6. Understanding [Topic] (context before steps - tables for phases/agents)
+7. Installation (if applicable)
+8. Step 1: [First Major Task]
+9. Step 2: [Second Major Task]
+10. Step 3: [Third Major Task]
+11. What You've Accomplished (summary + folder structure if applicable)
+12. Quick Reference (commands table)
+13. Common Questions (FAQ format)
+14. Getting Help (community links)
+15. Key Takeaways (tip admonition - memorable points)
+```
+
+Not all sections are required for every tutorial, but this is the standard flow.
+
+## Visual Hierarchy
+
+### Avoid
+
+| Pattern | Problem |
+|---------|---------|
+| `---` horizontal rules | Fragment the reading flow |
+| `####` deep headers | Create visual noise |
+| **Important:** bold paragraphs | Blend into body text |
+| Deeply nested lists | Hard to scan |
+| Code blocks for non-code | Confusing semantics |
+
+### Use Instead
+
+| Pattern | When to Use |
+|---------|-------------|
+| White space + section headers | Natural content separation |
+| Bold text within paragraphs | Inline emphasis |
+| Admonitions | Callouts that need attention |
+| Tables | Structured comparisons |
+| Flat lists | Scannable options |
+
+## Admonitions
+
+Use Starlight admonitions strategically:
+
+```md
+:::tip[Title]
+Shortcuts, best practices, "pro tips"
+:::
+
+:::note[Title]
+Context, definitions, examples, prerequisites
+:::
+
+:::caution[Title]
+Caveats, potential issues, things to watch out for
+:::
+
+:::danger[Title]
+Critical warnings only — data loss, security issues
+:::
+```
+
+### Standard Admonition Uses
+
+| Admonition | Standard Use in Tutorials |
+|------------|---------------------------|
+| `:::note[Prerequisites]` | What users need before starting |
+| `:::tip[Quick Path]` | TL;DR summary at top of tutorial |
+| `:::caution[Fresh Chats]` | Context limitation reminders |
+| `:::note[Example]` | Command/response examples |
+| `:::tip[Check Your Status]` | How to verify progress |
+| `:::tip[Remember These]` | Key takeaways at end |
+
+### Admonition Guidelines
+
+- **Always include a title** for tip, info, and warning
+- **Keep content brief** — 1-3 sentences ideal
+- **Don't overuse** — More than 3-4 per major section feels noisy
+- **Don't nest** — Admonitions inside admonitions are hard to read
+
+## Headers
+
+### Budget
+
+- **8-12 `##` sections** for full tutorials following standard structure
+- **2-3 `###` subsections** per `##` section maximum
+- **Avoid `####` entirely** — use bold text or admonitions instead
+
+### Naming
+
+- Use action verbs for steps: "Install BMad", "Create Your Plan"
+- Use nouns for reference sections: "Common Questions", "Quick Reference"
+- Keep headers short and scannable
+
+## Code Blocks
+
+### Do
+
+```md
+```bash
+npx bmad-method install
+```
+```
+
+### Don't
+
+````md
+```
+You: Do something
+Agent: [Response here]
+```
+````
+
+For command/response examples, use an admonition instead:
+
+```md
+:::note[Example]
+Run `workflow-status` and the agent will tell you the next recommended workflow.
+:::
+```
+
+## Tables
+
+Use tables for:
+- Phases and what happens in each
+- Agent roles and when to use them
+- Command references
+- Comparing options
+- Step sequences with multiple attributes
+
+Keep tables simple:
+- 2-4 columns maximum
+- Short cell content
+- Left-align text, right-align numbers
+
+### Standard Tables
+
+**Phases Table:**
+```md
+| Phase | Name | What Happens |
+|-------|------|--------------|
+| 1 | Analysis | Brainstorm, research *(optional)* |
+| 2 | Planning | Requirements — PRD or tech-spec *(required)* |
+```
+
+**Quick Reference Table:**
+```md
+| Command | Agent | Purpose |
+|---------|-------|---------|
+| `*workflow-init` | Analyst | Initialize a new project |
+| `*prd` | PM | Create Product Requirements Document |
+```
+
+**Build Cycle Table:**
+```md
+| Step | Agent | Workflow | Purpose |
+|------|-------|----------|---------|
+| 1 | SM | `create-story` | Create story file from epic |
+| 2 | DEV | `dev-story` | Implement the story |
+```
+
+## Lists
+
+### Flat Lists (Preferred)
+
+```md
+- **Option A** — Description of option A
+- **Option B** — Description of option B
+- **Option C** — Description of option C
+```
+
+### Numbered Steps
+
+```md
+1. Load the **PM agent** in a new chat
+2. Run the PRD workflow: `*prd`
+3. Output: `PRD.md`
+```
+
+### Avoid Deep Nesting
+
+```md
+<!-- Don't do this -->
+1. First step
+   - Sub-step A
+     - Detail 1
+     - Detail 2
+   - Sub-step B
+2. Second step
+```
+
+Instead, break into separate sections or use an admonition for context.
+
+## Links
+
+- Use descriptive link text: `[Tutorial Style Guide](./tutorial-style.md)`
+- Avoid "click here" or bare URLs
+- Prefer relative paths within docs
+
+## Images
+
+- Always include alt text
+- Add a caption in italics below: `*Description of the image.*`
+- Use SVG for diagrams when possible
+- Store in `./images/` relative to the document
+
+## FAQ Sections
+
+Use a TOC with jump links, `###` headers for questions, and direct answers:
+
+```md
+## Questions
+
+- [Do I always need architecture?](#do-i-always-need-architecture)
+- [Can I change my plan later?](#can-i-change-my-plan-later)
+
+### Do I always need architecture?
+
+Only for BMad Method and Enterprise tracks. Quick Flow skips to implementation.
+
+### Can I change my plan later?
+
+Yes. The SM agent has a `correct-course` workflow for handling scope changes.
+
+**Have a question not answered here?** Please [open an issue](...) or ask in [Discord](...) so we can add it!
+```
+
+### FAQ Guidelines
+
+- **TOC at top** — Jump links under `## Questions` for quick navigation
+- **`###` headers** — Questions are scannable and linkable (no `Q:` prefix)
+- **Direct answers** — No `**A:**` prefix, just the answer
+- **No "Related Documentation"** — Sidebar handles navigation; avoid repetitive links
+- **End with CTA** — "Have a question not answered here?" with issue/Discord links
+
+## Folder Structure Blocks
+
+Show project structure in "What You've Accomplished":
+
+````md
+Your project now has:
+
+```
+your-project/
+├── _bmad/                         # BMad configuration
+├── _bmad-output/
+│   ├── PRD.md                     # Your requirements document
+│   └── bmm-workflow-status.yaml   # Progress tracking
+└── ...
+```
+````
+
+## Example: Before and After
+
+### Before (Noisy)
+
+```md
+---
+
+## Getting Started
+
+### Step 1: Initialize
+
+#### What happens during init?
+
+**Important:** You need to describe your project.
+
+1. Your project goals
+   - What you want to build
+   - Why you're building it
+2. The complexity
+   - Small, medium, or large
+
+---
+```
+
+### After (Clean)
+
+```md
+## Step 1: Initialize Your Project
+
+Load the **Analyst agent** in your IDE, wait for the menu, then run `workflow-init`.
+
+:::note[What Happens]
+You'll describe your project goals and complexity. The workflow then recommends a planning track.
+:::
+```
+
+## Checklist
+
+Before submitting a tutorial:
+
+- [ ] Follows the standard structure
+- [ ] Has version/module notice if applicable
+- [ ] Has "What You'll Learn" section
+- [ ] Has Prerequisites admonition
+- [ ] Has Quick Path TL;DR admonition
+- [ ] No horizontal rules (`---`)
+- [ ] No `####` headers
+- [ ] Admonitions used for callouts (not bold paragraphs)
+- [ ] Tables used for structured data (phases, commands, agents)
+- [ ] Lists are flat (no deep nesting)
+- [ ] Has "What You've Accomplished" section
+- [ ] Has Quick Reference table
+- [ ] Has Common Questions section
+- [ ] Has Getting Help section
+- [ ] Has Key Takeaways admonition
+- [ ] All links use descriptive text
+- [ ] Images have alt text and captions