The correct-course workflow restructures epics but did not update
sprint-status.yaml, leaving tracking out of sync. Added check-item 6.4
to Section 6 (after user approval) to update sprint-status.yaml when
epics are added, removed, renumbered, or stories are modified.
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Add human intervention detection with BLOCKING/WARNING pattern matching
- Detects .env issues, API keys, permissions, connection failures
- Categorizes issues for Barry to handle appropriately
- Add story context extraction for fix documents
- Extracts acceptance criteria from story files
- Includes Dev Agent Record (implementation notes)
- Enhance fix context generation
- Includes human intervention items section
- Adds root cause hints for each failure
- Appends story context with AC mapping
- Add human actions file generation
- Creates epic-{id}-human-actions.md with actionable checklist
- Provides specific guidance per issue type
- Add timing metrics to track UAT evaluation duration
- Captures start_time, end_time, duration_seconds
- Shows duration in summary output
- Update output signals with human action flags
- UAT_HUMAN_ACTION_REQUIRED: true/false
- UAT_HUMAN_ACTION_COUNT: N
- UAT_HUMAN_ACTION_FILE: path
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: apply style guide to TEA Lite quickstart
- Remove duplicate H1 header (frontmatter provides title)
- Remove horizontal rules throughout
- Convert Prerequisites to admonition
- Add Quick Path TL;DR admonition
- Convert Key Takeaway to tip admonition
- Convert TEA Workflows list to Quick Reference table
- Convert Troubleshooting to Common Questions FAQ format
- Rename Need Help to Getting Help section
- Remove redundant Feedback section
Also adds missing @clack/prompts dependency from upstream merge.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: spell out acronyms in TEA Lite quickstart
- MCP → Model Context Protocol
- E2E → End-to-end (also fix missing article)
- CI/CD → Continuous integration/continuous deployment
- ATDD → Acceptance Test-Driven Development
- TDD → Test-Driven Development
- NFR → non-functional requirements
- Remove inaccurate CRUD reference
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: spell out TDD in ATDD link text
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: update branding with new wordmark logo and banner
- Add banner image to README header
- Replace website logo with wordmark, hiding title text
- Left-align logo with sidebar by reducing header padding
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: update README banner to new design with waveform
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add banner to docs website welcome page
- Revert README to original banner
- Add waveform banner to docs site welcome page
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: use waveform banner as website header logo
- Remove banner from welcome page content
- Update header logo to use banner-bmad-method2.png
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add separate logo for dark mode
Use banner-bmad-method-dark.png in dark mode for better blending
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: update header logos for light and dark modes
- Light mode: bmad-light.png (dark blue background with lightning)
- Dark mode: bmad-dark.png (light background variant)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: clean up unused banner images and add readme2
- Remove unused banner-bmad-method2.png and bmad-wordmark.png
- Add readme2.md with upcoming features section
- Update banner-bmad-method-dark.png
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: remove unused banner image variants
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: finalize header logo graphics
- Rename bmad-light2.png to bmad-light.png as final version
- Remove readme2.md draft
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
* fix: web bundler entry point
* removed the web-bundles folder
* added web-bundles to gitignore
* disabled web bundles
---------
Co-authored-by: Brian <bmadcode@gmail.com>
* docs: apply style guide to TEA Lite quickstart
- Remove duplicate H1 header (frontmatter provides title)
- Remove horizontal rules throughout
- Convert Prerequisites to admonition
- Add Quick Path TL;DR admonition
- Convert Key Takeaway to tip admonition
- Convert TEA Workflows list to Quick Reference table
- Convert Troubleshooting to Common Questions FAQ format
- Rename Need Help to Getting Help section
- Remove redundant Feedback section
Also adds missing @clack/prompts dependency from upstream merge.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: spell out acronyms in TEA Lite quickstart
- MCP → Model Context Protocol
- E2E → End-to-end (also fix missing article)
- CI/CD → Continuous integration/continuous deployment
- ATDD → Acceptance Test-Driven Development
- TDD → Test-Driven Development
- NFR → non-functional requirements
- Remove inaccurate CRUD reference
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: spell out TDD in ATDD link text
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Murat K Ozcan <34237651+muratkeremozcan@users.noreply.github.com>
Add comprehensive test suite for the epic-chain script with 25 tests covering:
- Argument parsing and help text
- Dry-run and analyze-only modes
- Epic file validation and missing epic detection
- Dependency detection from epic files
- Chain plan YAML generation and structure
- Story count detection
- All CLI options (--start-from, --skip-done, --no-handoff, etc.)
- UAT gate options
- Directory creation
- Combined options compatibility
Note: Tests work around a path resolution issue in epic-chain.sh where
PROJECT_ROOT uses "../.." but scripts/ is only one level deep.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Replace inline prompts with actual BMAD workflow files:
- dev-story workflow (workflow.yaml, instructions.xml, checklist.md)
- code-review workflow (workflow.yaml, instructions.xml, checklist.md)
- UAT generation templates (step-04-generate-uat.md, uat-template.md)
- Add workflow validation at startup to ensure all required files exist
- Implement self-healing fix loop for review failures:
- When review fails, capture HIGH/MEDIUM severity findings
- Spawn new fix phase using dev-story workflow in targeted fix mode
- Re-run review after fixes to verify resolution
- Retry up to 3 times before marking story as failed
- Enhanced metrics tracking:
- fix_loop.total_fix_attempts: count of all fix phases
- fix_loop.stories_requiring_fixes: stories needing at least one fix
- fix_loop.max_retries_hit: stories that failed after 3 attempts
- story_details: per-story fix attempt outcomes with timestamps
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated 2 additional files to use the correct /dist/ path:
- docs/how-to/workflows/run-automate.md: Standalone mode example
- docs/reference/tea/configuration.md: Playwright BASE_URL example
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* 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>
* docs: clarify explanation checklist admonition limit
Disambiguate 2-3 admonitions max to explicitly show it is a per-document
limit that still respects the universal per-section rule.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: clarify header budget vs structure template relationship
Add note explaining that structure templates show content flow, not 1:1
header mapping. Admonitions and inline elements are within sections.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: remove horizontal rules to follow own guidelines
Remove all --- section separators to comply with Universal Formatting
Rules. The ## headers provide sufficient visual separation.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: address PR review findings for style guide
- Fix forward reference in Header Budget section
- Clarify descriptions rule scope (tables and 5+ item lists)
- Restore realistic FAQ examples
- Add qualifier to admonition content length guideline
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: further optimize style guide as delta-only document
- Add opener declaring adherence to Google Style Guide and Diataxis
- Remove generic Google style guide sections (Visual Hierarchy patterns,
Tables constraints, Code Blocks, Lists, Assets)
- Remove Diataxis explainer content (Document Types table, "X documents
do Y" explanatory sentences, Before/After example)
- Keep all project-specific structure templates and checklists
- Consolidate rules into single Project-Specific Rules table
Result: 367 lines (down from 597), pure delta document assuming
LLM training knowledge of baseline standards.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Expanded the security policy to include supported versions, reporting guidelines, response timelines, security scope, and best practices for users.
Co-authored-by: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
* fix(cli): replace inquirer with @clack/prompts for Windows compatibility
- Add new prompts.js wrapper around @clack/prompts to fix Windows arrow
key navigation issues (libuv #852)
- Fix validation logic in github-copilot.js that always returned true
- Add support for primitive choice values (string/number) in select/multiselect
- Add 'when' property support for conditional questions in prompt()
- Update all IDE installers to use new prompts module
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(cli): address code review feedback for prompts migration
- Move @clack/prompts from devDependencies to dependencies (critical)
- Remove unused inquirer dependency
- Fix potential crash in multiselect when initialValues is undefined
- Add async validator detection with explicit error message
- Extract validateCustomContentPathSync method in ui.js
- Extract promptInstallLocation methods in claude-code.js and antigravity.js
- Fix moduleId -> missing.id in installer.js remove flow
- Update multiselect to support native clack API (options/initialValues)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: update comments to reference @clack/prompts instead of inquirer
- Update bmad-cli.js comment about CLI prompts
- Update config-collector.js JSDoc comments
- Rename inquirer variable to choiceUtils in ui.js
- Update JSDoc returns and calls documentation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(cli): add spacing between prompts and installation progress
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(cli): add multiselect usage hints for inexperienced users
Add inline navigation hints to all multiselect prompts showing
(↑/↓ navigate, SPACE select, ENTER confirm) to help users
unfamiliar with terminal multiselect controls.
Also restore detailed warning when no tools are selected,
explaining that SPACE must be pressed to select items.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(cli): restore IDE grouping using groupMultiselect
Replace flat multiselect with native @clack/prompts groupMultiselect
component to restore visual grouping of IDE/tool options:
- "Previously Configured" - pre-selected IDEs from existing install
- "Recommended Tools" - starred preferred options
- "Additional Tools" - other available options
This restores the grouped UX that was lost during the Inquirer.js
to @clack/prompts migration.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Brian Madison
Alex Verkhovsky
Caleb
forcetrainer
MarkRadaba
Murat K Ozcan
jheyworth
Nwokoma Chukwuma U.
Kevin Heidt
Eduard Voiculescu
sjennings
VJSai
Davor Racic