Interactive workflow guide, README Quick Start overhaul, and /bmad-help callouts

[forcetrainer]

Summary

• Interactive Workflow Guide (/workflow-guide): A standalone Astro page with track selector (Quick Flow / BMad Method / Enterprise) showing a vertical flow of slash commands with descriptions, agent badges, required/optional status, and a visual dev loop indicator
• README Quick Start overhaul: Replace wordy paragraphs and track table with two clear numbered command paths (3 commands for Quick Flow, 6 steps for BMad Method), prominent /bmad-help callout, Party Mode mention, and note about agent-based usage
• Getting-started tutorial: Add /bmad-help mention after installation
• Docs index: Add workflow guide link to "New Here?" section
• Link validator: Support custom Astro page routes (/workflow-guide)
• README tagline: Updated to "Breakthrough Method of Agile AI Driven Development"

Test plan

• All pre-commit hooks pass (lint, markdownlint, tests, format, link validation, full Astro build)
• Verify /workflow-guide page renders correctly with all three tracks
• Verify track switching shows/hides correct steps
• Verify dev loop visual indicator displays properly
• Verify dark and light mode both work
• Verify responsive layout on mobile

🤖 Generated with Claude Code

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR updates documentation content and introduces a new interactive Workflow Guide component. Changes include updates to README and tutorial documentation, additions to the docs site navigation, new Astro page and component for interactive workflow visualization, and refinement of link validation tooling to skip custom page routes.

Changes

Cohort / File(s)	Summary
Documentation Updates README.md, docs/index.md, docs/tutorials/getting-started/getting-started-bmadv6.md	Replaces tagline, adds "Party Mode" feature bullet, expands Quick Start narrative with /bmad-help reference, reorganizes Modules table with expanded descriptions, adds "Not sure what to do?" prompt, updates help path section to structured workflow, and adds navigation link to workflow guide tutorial.
Link Validation Tooling tools/validate-doc-links.js	Introduces CUSTOM_PAGE_ROUTES constant containing /workflow-guide to skip validation for specified site-relative links during resolution and processing.
Workflow Guide Component website/src/components/WorkflowGuide.astro, website/src/pages/workflow-guide.astro	Adds new interactive Astro page and component rendering a three-track selector (Quick Flow, BMad Method, Enterprise) with multi-phase flow visualization, status indicators, and JavaScript event handlers for track selection and visibility toggling.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• Add link auditor, reorganize documentation, and README update #1277: Related to doc link validation tooling enhancements, as both PRs modify the repository's link validation scripts with skip logic for certain routes.
• feat(docs): Diataxis restructure + Astro/Starlight migration #1263: Related to Astro/Starlight site migration, as both PRs introduce new site components/pages and update the docs site link-checking tooling.

Suggested reviewers

• bmadcode
• alexeyv

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and concisely summarizes the three main changes: interactive workflow guide, README Quick Start overhaul, and /bmad-help callouts.
Description check	✅ Passed	The description is comprehensive and directly related to the changeset, covering the interactive workflow guide, README updates, documentation changes, and link validator modifications.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@README.md`:
- Line 8: The tagline string containing "AI Driven Development" should be
changed to "AI-Driven Development" for grammatical consistency; locate the
sentence text "**Breakthrough Method of Agile AI Driven Development** — An
AI-driven agile development framework..." in README.md and replace the
unhyphenated phrase "AI Driven Development" with "AI-Driven Development" so it
matches the later usage "AI-driven".

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

Hyphenate "AI-Driven" for grammatical consistency.

The tagline uses "AI-driven" later in the same sentence (correctly hyphenated). For consistency and proper compound adjective usage, "AI Driven Development" should be "AI-Driven Development".

Proposed fix

-**Breakthrough Method of Agile AI Driven Development** — 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.
+**Breakthrough Method of Agile AI-Driven Development** — 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.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	**Breakthrough Method of Agile AI Driven Development** — 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.
	**Breakthrough Method of Agile AI-Driven Development** — 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.

🧰 Tools

🪛 LanguageTool

[grammar] ~8-~8: Use a hyphen to join words.
Context: ...XWmj) Breakthrough Method of Agile AI Driven Development — An AI-driven agil...

(QB_NEW_EN_HYPHEN)

🤖 Prompt for AI Agents

In `@README.md` at line 8, The tagline string containing "AI Driven Development"
should be changed to "AI-Driven Development" for grammatical consistency; locate
the sentence text "**Breakthrough Method of Agile AI Driven Development** — An
AI-driven agile development framework..." in README.md and replace the
unhyphenated phrase "AI Driven Development" with "AI-Driven Development" so it
matches the later usage "AI-driven".