Commit Graph

269 Commits

Author SHA1 Message Date
Jonah Schulte 4eb889642d feat: add continuous sprint-status tracking with task-level progress
Implements requirements #1 and #2: stronger enforcement + progress tracking

REQUIREMENT #1: Stronger Enforcement
- dev-story Step 8 now MANDATES sprint-status.yaml update after EVERY task
- Previously: Updated only at story start (step 4) and end (step 9)
- Now: Updated after EACH task completion with CRITICAL + HALT enforcement
- Validation: Re-reads file to verify update persisted, HALTs on failure

REQUIREMENT #2: Progress Tracking
- Extended sprint-status.yaml format with inline progress comments
- Format: "story-key: in-progress  # X/Y tasks (Z%)"
- Real-time visibility into story progress without opening story files
- Automatically updated by dev-story and batch-super-dev reconciliation

Progress Comment Format:
- in-progress: "# 3/10 tasks (30%)"
- review: "# 10/10 tasks (100%) - awaiting review"
- done: "#  COMPLETED: Brief summary"

Benefits:
- Sprint-status.yaml becomes a real-time progress dashboard
- No need to open individual story files to check progress
- Immediate visibility when stories stall (same % for days)
- Enables better sprint planning and resource allocation

Files Modified:
- dev-story/instructions.xml (BMM + BMGD): Added mandatory task-level updates
- sprint-status/instructions.md (BMM + BMGD): Added progress parsing/display
- batch-super-dev/step-4.5-reconcile-story-status.md: Added progress to reconciliation
- docs/HOW-TO-VALIDATE-SPRINT-STATUS.md: Documented new format and enforcement

Breaking Change: None (backward compatible with old format)
- Old entries without progress comments still work
- New entries automatically add progress
- Gradual migration as stories are worked
2026-01-07 17:28:52 -05:00
Jonah Schulte 9bdf489438 fix: resolve critical complexity routing issues from multi-agent review
Fixes 6 critical issues discovered in multi-agent code review:

1. **Parameter propagation** - CRITICAL FIX
   - Added complexity_level parameter to super-dev-pipeline invocations
   - Fixed both sequential and parallel execution paths
   - Without this, complexity routing was completely non-functional

2. **Keyword matching rules** - CRITICAL FIX
   - Defined explicit matching algorithm in workflow.yaml
   - Case insensitive, word boundary matching, exact strategy
   - Added keyword variants (auth -> authentication, authorize, etc.)
   - Scan locations: story_title, task_descriptions, subtask_descriptions

3. **Threshold decision tree** - CRITICAL FIX
   - Rewrote overlapping logic to be mutually exclusive
   - Priority order: COMPLEX → MICRO → STANDARD
   - Prevents stories from matching multiple categories

4. **Task counting method** - CRITICAL FIX
   - Defined method: "top_level_only" (ignore subtasks)
   - Added documentation with examples
   - Eliminates ambiguity in complexity scoring

5. **max_files implementation** - FIX
   - Added file_count ≤ 5 check to MICRO classification
   - Previously extracted but never used (dead code)

6. **Version synchronization** - FIX
   - Updated super-dev-pipeline to v1.3.0 (was 1.2.0)
   - Matches batch-super-dev version for consistency

Impact: These fixes make complexity routing actually functional. The original
implementation computed complexity but never passed it to the pipeline,
rendering the entire feature non-operational.
2026-01-07 16:34:44 -05:00
Jonah Schulte e5ede9ec3f feat: add complexity-based routing and pipeline optimizations (v1.3.0)
Phase 1 & 2 improvements to reduce token waste and improve robustness:

1. Complexity scoring in batch-super-dev (step 2.6)
   - Score stories as micro/standard/complex based on task count + risk keywords
   - Micro (≤3 tasks, low risk): lightweight path
   - Standard: full pipeline
   - Complex (≥16 tasks or high-risk): enhanced validation

2. Lightweight path for micro stories
   - Skip pre-gap analysis (step 2) for micro complexity
   - Skip code review (step 5) for micro complexity
   - Estimated 50-70% token savings on simple stories

3. Smart batching clarification
   - Fixed contradictory instructions in step-03-implement.md
   - Default: one task at a time
   - Exception: batch low-risk patterns (package installs, imports)

4. Gap analysis optimization
   - dev-story skips step 1.5 if recent gap analysis exists (<24h)
   - Added skip_gap_analysis flag for pre-validated stories

5. Early bailout pre-flight check (step 4.5)
   - Bail early if story already complete (all tasks checked)
   - Bail if no tasks found (malformed story)
   - Bail if missing required sections
   - Saves tokens on stories that don't need processing

6. Multi-agent review integration (step 5)
   - For complex stories: recommend /multi-agent-review
   - Provides architecture, security, and performance review
   - Dynamic agent selection based on changed files
2026-01-07 16:20:34 -05:00
Jonah Schulte 7c1051b017 refactor: remove autonomous-epic in favor of batch-super-dev
- Remove autonomous-epic workflow from BMM and BMGD modules
- Remove agent menu entries for autonomous-epic
- Update workflow references to use batch-super-dev
- Add README-changes.md documenting fork customizations
- Remove outdated SPRINT-STATUS-SYNC-GUIDE.md

batch-super-dev is the superior approach with proactive story
validation, auto-creation of missing stories, and smart reconciliation.
2026-01-07 16:00:32 -05:00
Jonah Schulte 9df7939225 Merge upstream/main: Diataxis docs restructure + Astro migration
Resolves conflict by accepting upstream deletion of
docs/bmad-core-concepts/installing/index.md (moved to
docs/how-to/installation/)
2026-01-07 14:50:08 -05:00
Jonah Schulte b517a8b1d0 Add batch-super-dev workflow with auto-installation and quality gates
Features:
- Interactive batch selector for processing multiple ready-for-dev stories
- 5-layer quality gate system (pre-gap, post-validation, reconciliation, code review, sprint-status sync)
- Smart story reconciliation (auto-updates checkboxes based on Dev Agent Record)
- Anti-vibe-coding enforcement (verifies files exist, tests pass, implementations aren't stubs)
- Story validation & auto-creation (validates 12 BMAD sections, creates missing stories)
- Auto-generates /batch-super-dev and /super-dev-pipeline slash commands on installation

Platform Support:
- Claude Code: Auto-creates .claude-commands/batch-super-dev.md
- Windsurf: Auto-creates slash commands for cross-compatibility

Workflow Location:
- Source: src/modules/bmm/workflows/4-implementation/batch-super-dev/
- Installed: _bmad/bmm/workflows/4-implementation/batch-super-dev/

Quality Gates:
1. Pre-gap analysis validates story completeness
2. Post-implementation validation verifies every task (anti-vibe-coding)
3. Smart reconciliation updates checkboxes based on evidence
4. Multi-agent code review finds issues before commit
5. Python script validates sprint-status.yaml accuracy
2026-01-07 12:12:13 -05:00
Brian Madison 7bf05c9d9d fix missing scripts from installation, and add ability to exclude workflows from being added as commands in tools, the first being the example workflow meant just for workflow example to the workflow builder 2026-01-07 16:21:25 +08:00
Jonah Schulte 1ddf2afcea feat: enhance sprint scripts with smart path resolution and conditional batching
- Add auto-detection of project root and story directories
- Enable scripts to work from any working directory
- Add explicit path override options via CLI arguments
- Improve error messages with suggested paths when files not found
- Update smart batching to show options only when time_saved > 0
- Reduce decision fatigue by skipping batching menu when no benefit
2026-01-06 08:21:44 -05:00
Jonah Schulte 4ea18e97fb Merge remote-tracking branch 'upstream/main'
# Conflicts:
#	src/modules/bmm/workflows/4-implementation/create-story/instructions.xml
2026-01-05 23:52:36 -05:00
Jonah Schulte 343b4ef425 Merge origin/main: sync epic-specific tracking files with backwards compatibility
Resolved conflict in autonomous-epic/workflow.yaml by:
- Accepting origin/main's cleaner naming: .autonomous-epic-{epic_num}-progress.yaml
- Adding backwards compatibility to check both new and legacy formats
- Updated all progress file references to use dynamic {{progress_file_path}}

Changes:
- workflow.yaml: Use new naming convention
- instructions.xml: Check for both formats (new + legacy) on resume
- README.md: Document backwards compatibility

This ensures no in-progress epics are missed when upgrading between versions.
2026-01-02 20:20:35 -05:00
Jonah Schulte 73b8190e7b feat(validation): Add comprehensive story validation system with Haiku agents
VALIDATION WORKFLOWS (6 total):
- validate-story: Quick task checkbox validation
- validate-story-deep: Deep code verification with Haiku agent
- validate-all-stories: Batch quick validation
- validate-all-stories-deep: Comprehensive platform audit
- validate-epic-status: Per-epic validation
- validate-all-epics: All epics validation

VALIDATION SCRIPTS (4 total):
- sprint-status-updater.py: Compare story files vs sprint-status.yaml
- task-verification-engine.py: Python-based task verification
- llm-task-verifier.py: LLM-powered verification (alternative)
- add-status-fields.py: Add Status field to stories

HAIKU AGENT APPROACH:
- One agent per story (not per task - avoids 99% overhead)
- Agent reads actual code with Glob/Read tools
- Verifies stubs vs real implementation
- Checks multi-tenant, error handling, tests
- Evidence-based verification (line numbers, code snippets)

COST OPTIMIZATION:
- Haiku: $0.15/story vs Sonnet: $1.80/story (92% savings)
- Full platform: $76 vs $920 (saves $844)
- Batching: 5 concurrent agents (prevents overload)

CAPABILITIES:
- False positive detection (checked but code missing)
- False negative detection (unchecked but code exists)
- Code quality review (TODOs, stubs, missing features)
- Status recommendation (done/review/in-progress)
- Automated status updates

DOCUMENTATION:
- HOW-TO-VALIDATE-SPRINT-STATUS.md
- SPRINT-STATUS-VALIDATION-COMPLETE.md
- Slash command docs in .claude-commands/

USE CASES:
- Weekly: Quick validation (free, 5 sec)
- Pre-done: Deep story check ($0.15, 2-5 min)
- Pre-launch: Full audit ($76, 4-6h)
- Quality sweep: Phase 3 comprehensive validation

Enables bulletproof production confidence for any BMAD project.
2026-01-02 19:20:11 -05:00
Jonah Schulte 04ad0b5019 fix: use epic-specific tracking files for parallel epic processing
- Change tracking file from `.autonomous-epic-progress.yaml` to
  `.autonomous-epic-progress-epic-{{epic_num}}.yaml`
- Prevents race conditions when multiple epics run in parallel
- Each epic now maintains isolated tracking state
- Updates: README.md, instructions.xml (4 locations), workflow.yaml

Resolves issue where parallel epic processing would stomp on
shared tracking file causing data loss and synchronization issues
2026-01-01 14:15:18 -05:00
Brian Madison c748f0f6cc paths for workflow and sprint tatus files fixed 2026-01-01 21:20:14 +08:00
Andaman Lekawat 4142972b6a
fix: standardize variable naming from {project_root} to {project-root} (#1217)
Fixed inconsistent variable naming in workflow instruction files across
CIS, BMGD, and BMM modules. The standard variable format uses hyphens
({project-root}) not underscores ({project_root}).

Affected files:
- CIS: problem-solving, innovation-strategy, design-thinking, storytelling
- BMGD: brainstorm-game, narrative, create-story checklist
- BMM: excalidraw diagrams, create-story checklist

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2026-01-01 21:14:21 +08:00
Murat K Ozcan cd45d22eb6
docs: chose your tea engagement (#1228)
* docs: chose your tea engagement

* docs: addressed PR comments

* docs: made refiements to the mermaid diagram

* docs: wired in test architect discoverability nudges

---------

Co-authored-by: Brian <bmadcode@gmail.com>
2026-01-01 19:06:55 +08:00
Jonah Schulte eecff22f91 feat: add anti-skip safeguards and verification to implementation workflows
- Add YOLO mode clarification: auto-approve prompts only, NOT skip steps
- Add mandatory story creation verification (file exists, 4kb+ size)
- Add quality requirements for create-story output
- Add sprint-status tracking updates
- Harden autonomous-epic, create-story, and story-pipeline workflows
- Ensure stories contain required sections (Tasks, Acceptance Criteria, Dev Notes)
2026-01-01 02:52:48 -05:00
Jonah Schulte 387c42178e Merge upstream/main: sync with 6.0.0-alpha.22 release 2026-01-01 00:31:12 -05:00
Nick Pirocanac a297235862
fix: *code-review is picking up non-application files (#1232)
Co-authored-by: Nick Pirocanac <nick.pirocanac@rtktickets.com>
2026-01-01 13:22:51 +08:00
Brian Madison 484990de50 all sharded progressive workflows integrate language choice deeply with each step biased towards configured language. Tested with Spanish and Pirate Speak, worked really well. 2025-12-29 19:35:20 +08:00
Jonah Schulte 0ff7099af7 feat: add smart batching to super-dev-pipeline for repetitive work
Add intelligent task grouping that automatically detects and batches
similar low-risk tasks while maintaining full validation discipline.

KEY INNOVATION:
Smart batching is NOT vibe coding - it's systematic pattern detection
with batch validation and automatic fallback to individual execution.

PROBLEM SOLVED:
- One-task-at-a-time is too slow for repetitive work
- 100 package installations × 2min = 200 minutes (unnecessarily slow)
- Pattern: Add package → install → build is repeated 100 times identically

SMART BATCHING SOLUTION:
- Step 2: Detect batchable patterns in pre-gap analysis
- Step 3: Execute similar tasks together, validate as batch
- Fallback: If batch fails, revert to one-at-a-time for that batch
- Safety: High-risk tasks NEVER batched

BATCHABLE PATTERNS (low risk):
- Package installations (validated by build)
- Module registrations (validated by TypeScript)
- Code deletions (validated by tests)
- Import updates (validated by build)

NON-BATCHABLE (individual execution):
- Business logic (varies per case)
- Security code (high risk)
- Data migrations (irreversible)
- Novel patterns (unproven)

TIME SAVINGS:
- Example: 100-task story with 80 batchable + 20 individual
- Without batching: 100 × 2min = 200 minutes
- With batching: 5 batches × 10min + 20 × 2min = 90 minutes
- Savings: 110 minutes (55% faster!)

FEATURES ADDED:
- Pattern detection in step-02-pre-gap-analysis.md
- Batch execution in step-03-implement.md
- Batching configuration in workflow.yaml
- Smart batching documentation in workflow.md and README.md

SAFETY MECHANISMS:
- Conservative pattern detection (default to individual)
- Explicit validation strategy per batch
- Automatic fallback if batch fails
- High-risk tasks never batched
- All quality gates still enforced

VERSION:
- super-dev-pipeline: 1.0.0 → 1.1.0 (smart batching added)

INSTALLATIONS:
- craftedcall: Updated with smart batching
- usmax-nda: Updated with smart batching

This solves the velocity problem while maintaining anti-vibe-coding discipline!
2025-12-28 23:49:53 -05:00
Brian Madison f0520c39d9 fix wording in create-epics-and-stories doc discovery continuation 2025-12-29 09:25:56 +08:00
Brian Madison ff0517f4d0 workflow-status phase paths corrected with current reality 2025-12-29 09:25:56 +08:00
Jonah Schulte efce6a9d85 fix: update autonomous-epic description to reference super-dev-pipeline 2025-12-28 12:31:46 -05:00
Jonah Schulte 7feab0e233 docs: update all documentation for super-dev-pipeline
Updated documentation to accurately reflect current state:

KEY CHANGES:
1. super-dev-pipeline is now the production workflow (not story-pipeline)
2. Corrected token estimates (40-60K vs 65% claim for story-pipeline)
3. Updated autonomous-epic v2.0 description
4. Clarified workflow purposes and use cases

DOCUMENTATION UPDATED:
- INTEGRATION-NOTES.md
  * Updated to focus on super-dev-pipeline as production solution
  * Explained evolution: story-pipeline → brownfield problem → super-dev-pipeline
  * Workflow comparison table shows all three options
  * Task-based completion explained
  * Anti-vibe-coding enforcement detailed

- PR-STORY-PIPELINE.md
  * Renamed focus to super-dev-pipeline (the actual deliverable)
  * Updated all metrics to 50% savings (not 65%)
  * Added problem statement about brownfield
  * Explained adaptive implementation

- autonomous-epic/README.md
  * Updated to reference super-dev-pipeline
  * Corrected token estimates (40-60K per story)
  * Updated time estimates (2-5 hrs small, 5-10 hrs medium, 10-20 hrs large)
  * Example session shows super-dev-pipeline steps

KEY POINTS CLARIFIED:
- super-dev-pipeline: Production (greenfield + brownfield, 40-60K tokens)
- story-pipeline: Greenfield only (25-30K tokens, 65% savings)
- super-dev-story: Legacy (100-150K tokens, allows vibe coding)

- autonomous-epic v2.0 uses super-dev-pipeline by default
- Task-based completion (not status-based)
- Anti-vibe-coding enforcement via step-file architecture
- Works for real-world scenarios (most work is brownfield!)

All documentation now consistent and accurate.
2025-12-28 12:23:55 -05:00
Jonah Schulte d4b8246bd9 feat: add super-dev-pipeline for brownfield + anti-vibe-coding enforcement
Create new super-dev-pipeline workflow that solves critical issues:
1. Works for BOTH greenfield AND brownfield development
2. Uses step-file architecture to prevent vibe coding at high token counts
3. Adaptive implementation (TDD for new, refactor for existing)
4. All quality gates with disciplined execution

PROBLEM SOLVED:
- story-pipeline assumes greenfield (ATDD doesn't work for brownfield)
- super-dev-story allows vibe coding when tokens >100K
- Need workflow that handles real-world scenarios (most work is brownfield!)

NEW WORKFLOW: super-dev-pipeline
- 7 step files with mandatory sequences
- Detects greenfield vs brownfield automatically
- Pre-gap analysis validates against existing code
- Adaptive implementation methodology
- Post-validation catches false positives
- Code review finds 3-10 issues
- Anti-vibe-coding enforcement

STEPS:
1. Init - Load story, detect development mode
2. Pre-gap - Validate tasks against codebase (critical for brownfield!)
3. Implement - Adaptive (TDD for new, refactor for existing)
4. Post-validate - Verify completion vs reality
5. Code review - Adversarial (3-10 issues)
6. Complete - Commit + push
7. Summary - Audit trail

BENEFITS:
- Works for greenfield AND brownfield
- 40-60K tokens per story (vs 100-150K for orchestration)
- Prevents vibe coding even at 200K+ tokens
- All super-dev quality gates preserved
- Step-file discipline from story-pipeline

AUTONOMOUS-EPIC UPDATED:
- Now uses super-dev-pipeline instead of story-pipeline
- Handles create-story separately for backlog stories
- More realistic token estimates (40-60K vs 25-30K)
- Updated time estimates

FILES ADDED:
- src/modules/bmm/workflows/4-implementation/super-dev-pipeline/* (14 files)
- .claude-commands/super-dev-pipeline.md
- ~/.codex/prompts/bmad-super-dev-pipeline.md

FILES MODIFIED:
- autonomous-epic/instructions.xml (use super-dev-pipeline)
- autonomous-epic/workflow.yaml (updated settings)

INSTALLATIONS:
- craftedcall: super-dev-pipeline + updated autonomous-epic
- usmax-nda: super-dev-pipeline + updated autonomous-epic

This is the production-ready solution for autonomous epic processing!
2025-12-28 12:09:06 -05:00
Brian Madison 8d679b177b advanced elicitation moved to workflows folder. core module extensive documentation added. 2025-12-28 19:44:55 +08:00
Jonah Schulte ee68b027fc Merge remote-tracking branch 'upstream/main' into feature/autonomous-epic-processing 2025-12-27 21:17:07 -05:00
Jonah Schulte c5afd8906f feat: integrate story-pipeline with autonomous-epic for 65% token savings
This commit integrates the story-pipeline workflow (PR #1194) with autonomous-epic
and adds post-implementation validation to catch false positives.

MAJOR CHANGES:
1. Merged story-pipeline workflow from upstream PR #1194 (20 files, 4,564 additions)
2. Added post-validation step (step-05b) between implementation and code review
3. Integrated story-pipeline as the default workflow for autonomous-epic
4. Replaced super-dev-story with story-pipeline in batch mode

NEW FEATURES:
- Post-implementation validation (step-05b-post-validation.md)
  * Verifies completed tasks against actual codebase
  * Catches false positives (tasks marked done but not implemented)
  * Re-runs implementation if gaps found
  * Uses Glob/Grep/Read to verify file existence and completeness

BENEFITS:
- Token efficiency: 25-30K per story (vs 100-150K with super-dev-story)
- 65% token savings per story, 75% savings per epic
- All super-dev-story quality gates PLUS post-validation
- Checkpoint/resume capability for long stories
- Batch mode for fully unattended execution

ARCHITECTURE:
- autonomous-epic orchestrates epic-level processing
- story-pipeline handles single-story lifecycle (9 steps including 5b)
- Role-switching in same session (vs separate workflow calls)
- Single session per story = massive token savings

TIME ESTIMATES (updated):
- Small epic (3-5 stories): 2-4 hours (was 3-6 hours)
- Medium epic (6-10 stories): 4-8 hours (was 6-12 hours)
- Large epic (11+ stories): 8-16 hours (was 12-24 hours)

FILES MODIFIED:
- autonomous-epic/instructions.xml (integrated story-pipeline)
- autonomous-epic/workflow.yaml (updated settings, removed super-dev choice)
- story-pipeline/* (20 new files from PR #1194)
- story-pipeline/steps/step-05-implement.md (points to step-05b)
- story-pipeline/workflow.md (added step 5b to map and gates)
- story-pipeline/workflow.yaml (added step 5b definition)
- story-pipeline/templates/*.yaml → *.yaml.template (renamed to avoid linting)

FILES ADDED:
- story-pipeline/steps/step-05b-post-validation.md (NEW)
- INTEGRATION-NOTES.md (comprehensive documentation)

TESTING:
- PR #1194 validated with real User Invitation system story
- 17 files, 2,800+ lines generated successfully
- Context exhaustion recovery tested

See INTEGRATION-NOTES.md for full details.

Co-authored-by: tjetzinger (story-pipeline PR #1194)
2025-12-27 12:53:35 -05:00
Brian Madison 2a8a4388a9 v4 detection cleanup 2025-12-27 20:31:12 +08:00
Jonah Schulte 949a8c3236 feat: add planning-time gap analysis and parallel execution enhancements
- Add create-story-with-gap-analysis workflow for verified codebase scanning at planning time
- Fix autonomous-epic to support parallel execution (no auto-branch creation)
- Fix autonomous-epic and super-dev-story to auto-accept gap analysis in autonomous mode
- Fix push-all to support targeted file commits (safe for parallel agents)
- Update dev-story and super-dev-story to pass auto_accept_gap_analysis parameter
- Add explicit autonomous mode instructions to workflows

Breaking changes: None - all enhancements are backward compatible
2025-12-27 02:29:46 -05:00
Brian Madison 949cf64d3b workflow status, init and phase 4 items aligned with planning_artifacts and implementation_artifacts for discovery and output 2025-12-27 10:59:44 +08:00
Brian Madison aba9d11c88 quick flow updates to aid discovery and implementation 2025-12-27 10:40:23 +08:00
Alex Verkhovsky 208f27dcdb
refactor: convert create-tech-spec to sharded workflow with orient-first pattern (#1185)
* refactor: convert create-tech-spec to sharded workflow with orient-first pattern

* docs: reposition deep exploration isolation guideline within universal code investigation section

* docs: Update terminology from 'Requirement Delta' to 'Problem Statement' in step-02-investigate.md context.

* Update src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-04-review.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/modules/bmm/workflows/bmad-quick-flow/create-tech-spec/steps/step-01-understand.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-12-27 09:43:59 +08:00
Jonah Schulte 5b3f3479c8 refactor: use invoke-workflow for orchestration
- super-dev-story now invokes dev-story, code-review, push-all
- autonomous-epic now invokes create-story, super-dev/dev-story
- Eliminated code duplication (690→283, 419→208 lines)
- Clean sequential step numbering (1,2,3,4,5)
- ~1,200 lines removed through proper orchestration

Makes workflows maintainable and follows DRY principles
2025-12-26 20:26:30 -05:00
Jonah Schulte 15af99990a feat: integrate push-all into autonomous-epic workflow
- Each story now commits and pushes after completion
- Auto-generated commit messages per story
- Safety checks run before each push
- Continues on push failures (doesn't halt entire epic)
- All changes backed up to remote incrementally

Ensures epic progress is saved to remote as work completes
2025-12-26 18:33:16 -05:00
Jonah Schulte 356dd48f49 feat: add push-all workflow as standalone command
- New /push-all workflow for commit and push with safety
- Can be used anywhere (not just in super-dev-story)
- Comprehensive safety checks (secrets, API keys, large files)
- Smart commit message generation (conventional commits)
- Handles push failures (rebase, upstream, auth)
- Registered in Dev and SM agent menus
- Also integrated into super-dev-story Step 11

Applies to both BMM and BMGD modules
2025-12-26 18:32:00 -05:00
Jonah Schulte 57968001a6 feat: add push-all step to super-dev-story
- Add Step 11: Commit and push all changes after validation
- Safety checks: secrets, API keys, large files, build artifacts
- API key validation (blocks real keys, allows placeholders)
- Generates conventional commit messages
- Requests user confirmation before pushing
- Handles push failures (rebase, upstream branch)
- Warns when pushing to main/master

Completes super-dev workflow with automated git operations
2025-12-26 18:29:27 -05:00
Jonah Schulte 9e7b097bb0 feat: add autonomous-epic workflow for full epic automation
- New /autonomous-epic command processes entire epic
- Just-in-time planning: creates each story before developing
- Auto-develops using super-dev-story or dev-story
- Progress tracking with resume capability
- Git commits after each story completion
- Error handling with retry logic and continue-on-failure
- Epic completion report with statistics
- Estimated: 100K-150K tokens per story

Use cases:
- Overnight epic completion
- CI/CD integration
- Batch sprint processing

Applies to both BMM and BMGD modules
2025-12-26 14:36:38 -05:00
Jonah Schulte cff53fb3d8 feat: add super-dev-story workflow for enhanced quality
- New /super-dev-story command for comprehensive validation
- Includes all dev-story steps PLUS:
  - Step 9.5: Post-dev gap analysis (verify completion)
  - Step 9.6: Automated code review (catch issues)
- Auto-fixes issues and loops back if gaps/problems found
- Max iteration safety (default 3 cycles)
- Opt-in via separate command (not forced)
- ~30% more tokens but prevents review rework cycles

Applies to both BMM and BMGD modules
2025-12-26 14:21:18 -05:00
Jonah Schulte b26f822979 feat: add standalone gap-analysis workflow
- Audit completed stories to verify claims match code
- Validate any story without starting development
- Detect false positives (marked done but not implemented)
- Batch mode to audit multiple stories
- Generate audit reports for team review

Applies to both BMM and BMGD modules
2025-12-26 14:02:41 -05:00
Jonah Schulte db05fb7ae7 feat: add mandatory gap analysis to dev-story workflow
- Add Step 1.5 gap analysis before development starts
- Scan codebase to validate draft tasks against reality
- Propose task refinements (add/modify/remove)
- Six user options: approve, auto-accept, reject, edit, skip, review
- Update story file with Gap Analysis section
- Prevents duplicate implementations in batch planning

Applies to both BMM and BMGD modules
2025-12-26 14:02:13 -05:00
Jonah Schulte 62eb2626d9 refactor: shift create-story to requirements-focused planning
- Remove codebase scanning from planning phase
- Mark generated tasks as DRAFT
- Add notation that tasks will be validated at dev-time
- Focus on requirements analysis and architecture context
- Simplify workflow by deferring gap analysis to execution

Applies to both BMM and BMGD modules
2025-12-26 14:01:42 -05:00
Brian Madison c15ad174ed chore: bump version to 6.0.0-alpha.21
Major improvements:
- All agents now use consistent 2-letter menu codes (compound triggers)
- Phase 1-3 workflows updated to use planning_artifacts folder
- Windows installer fixed with inquirer multiselection resolution
- Chat and party mode auto-injected into all agents
- All agents pass comprehensive validation checks
- Restored agent files from Docusaurus merge
2025-12-26 20:55:10 +08:00
Brian Madison 24cedea690 phase 3 input disco and output updated 2025-12-26 20:44:45 +08:00
Brian Madison bdb6bde9b5 disco and output fix for ux design 2025-12-26 20:18:31 +08:00
Brian Madison cfdffe3f7a prd and brief workflows disco and output fixed 2025-12-26 20:05:02 +08:00
Murat K Ozcan 1a1a806d99
docs: remove old links in test architect (#1183)
* docs: remove dead links in  test architecture documentation

* docs: updated test architecture documentation for clarity and consistenc

* docs: update test architecture documentation for clarity and consistency

* docs: addressed PR comments
2025-12-23 23:09:08 +08:00
Brian Madison 925b715d4f prettier no longer should screw up md files underscores 2025-12-23 22:29:51 +08:00
Brian Madison e4a4f47a1e remove unnecessary \ before _ and disable md auto fix 2025-12-23 22:21:59 +08:00
Alex Verkhovsky dcaa892ce1
refactor(bmm): convert quick-dev workflow to sharded format with adversarial review (#1182)
convert quick-dev workflow to sharded format with adversarial review
2025-12-23 17:48:47 +08:00
Brian Madison 12dd97fe9b start implementing new bm paths into phases 1-4 2025-12-23 11:40:38 +08:00
Brian Madison a20198b94b workflow step location fixed in create product brief 2025-12-20 16:39:43 +08:00
Serhii 4271fe5f2b
fix(bmm): resolve dead references and syntax errors in agents and workflows (#1164)
- Fix XML syntax error in dev-story/instructions.xml:20 (goto element)
- Fix path typo in tech-writer.agent.yaml (_bmadbmm → _bmad/bmm)
- Fix wrong route in analyst.agent.yaml (edit-agent → party-mode)
- Comment out unimplemented validate-create-story in sm.agent.yaml
- Comment out unimplemented validate-design in ux-designer.agent.yaml
- Remove misleading validate-create-story reference in create-story output

Fixes #1075
Related to #1163

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-20 13:37:09 +08:00
Alex Verkhovsky 00a3af3eb0
fix(bmm): sprint-status workflow improvements (#1141)
* fix(bmm): sprint-status workflow improvements

- Remove dead by_epic template block and context_status variable (#1116, #1117)
- Define "first" story ordering as epic number then story number (#1119)
- Clarify retrospective check: "any retrospective status == optional" (#1120)
- Strengthen validate mode: check required metadata fields and valid statuses (#1121)
- Expand risk detection: stale file, orphaned stories, empty epics (#1122)
- Fix retrospective valid status: use "done" instead of "completed" for consistency

Fixes #1116, fixes #1117, fixes #1119, fixes #1120, fixes #1121, fixes #1122

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(bmm): address CodeRabbit review feedback

- Improve retrospective status descriptions for clarity
- Fix empty epic detection to only warn on in-progress epics
- Add 'generated' to required metadata field validation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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>
2025-12-16 17:59:42 +08:00
Brian Madison 1da7705821 folder workflow naming alignment for consistency 2025-12-15 10:17:58 +08:00
Alex Verkhovsky 82cc10824a
fix(bmm): improve sprint-status validation and epic status handling (#1125)
* fix(bmm): improve sprint-status validation and epic status handling

- Add status validation with interactive correction for unknown values
- Update epic statuses to match state machine: backlog, in-progress, done
- Map legacy "contexted" status to "in-progress" explicitly
- Add retrospective status counting (optional, completed)
- Rewrite risk detection rules for LLM clarity
- Fix warnings vs risks naming inconsistency in data mode

Closes #1106
Closes #1118

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* style: fix prettier formatting in sprint-status instructions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 07:17:30 +08:00
Brian Madison ae9851acab _cfg -> _config 2025-12-13 19:41:09 +08:00
Brian Madison 25c79e3fe5 folder rename from .bmad to _bmad 2025-12-13 16:22:34 +08:00
Murat K Ozcan e34f53d6f8
Merge branch 'main' into fix/normalize-status-kebab-case 2025-12-12 12:42:49 -06:00
Alex Verkhovsky 7a9f1d4a3c fix(bmm): normalize story status references to lowercase kebab-case
Updated status references to use canonical lowercase kebab-case format:

- dev-story/instructions.xml: Status field set to "review" (was "Ready for Review")
- dev-story/instructions.xml: Output messages reference actual "review" status
- dev-story/checklist.md: Status field instruction uses "review"
- daily-standup.xml: Status examples use "in-progress, review"

Story lifecycle: backlog → ready-for-dev → in-progress → review → done

Fixes #1105

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 23:22:05 -07:00
Alex Verkhovsky 7d6aae1b78 fix(bmm): remove stale 'drafted' story state from docs and workflows
The `drafted` story state is no longer used since create-story now sets
status directly to `ready-for-dev`. This PR removes all references to
this legacy state from BMM documentation and workflow files.

Changes:
- Remove `drafted` from story status definitions and state machine docs
- Remove dead story-context file detection (story-context files no longer exist)
- Replace "draft" verb with "create" in story-related messaging
- Add legacy `drafted` → `ready-for-dev` migration in sprint-status
- Clarify that validate-create-story is optional and doesn't change status
- Document story handoff sequence: create-story → (optional) validate → dev-story

Story lifecycle is now: backlog → ready-for-dev → in-progress → review → done

Closes #1089

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 21:20:44 -07:00
Alex Verkhovsky 0f5a9cf0dd
fix: correct grammar in PRD workflow description (#1087) 2025-12-12 06:43:40 +08:00
Alex Verkhovsky e2d9d35ce9
fix(bmm): improve code review completion message (#1095)
Change "Story is ready for next work!" to "Code review complete!"

The original phrasing was misleading - when a code review finishes
with status "done", it means the review itself is complete and the
story is marked done in tracking. However, the user may choose to
do additional reviews or the story may genuinely be finished.
"Code review complete" more accurately describes what actually
happened without implying next steps.
2025-12-12 06:42:52 +08:00
Alex Verkhovsky 82e6433b69
refactor: standardize file naming to use dashes instead of underscores (#1094)
Rename output/template files and update all references to use kebab-case
(dashes) instead of snake_case (underscores) for consistency:

- project_context.md -> project-context.md (13 references)
- backlog_template.md -> backlog-template.md
- agent_commands.md -> agent-commands.md
- agent_persona.md -> agent-persona.md
- agent_purpose_and_type.md -> agent-purpose-and-type.md
2025-12-12 06:42:24 +08:00
murat 6e9fe6c9a2 fix: addressed review comment 2025-12-11 11:36:33 -06:00
Alex Verkhovsky 0f06ef724b
Merge branch 'main' into fix/issue-1088-remove-stale-workflow-refs 2025-12-10 16:00:11 -07:00
Brian Madison 446a0359ab fix bmb workflow paths 2025-12-10 20:50:24 +09:00
Alex Verkhovsky b9ba98d3f8 docs: remove stale references to deleted Phase 4 workflows
Removes references to epic-tech-context, story-context, story-done,
and story-ready workflows that were deleted in the Phase 4 transformation.

Also renames mislabeled excalidraw element IDs from proc-story-done
to proc-code-review to match the actual displayed text.

Fixes #1088
2025-12-09 21:50:39 -07:00
Alex Verkhovsky ec73e44097 fix: correct markdown formatting in product-brief next steps
Fixes #1080
2025-12-09 12:45:56 -07:00
Alex Verkhovsky e3f756488a
feat(quality): add markdownlint-cli2 to quality checks (#1039)
- Add markdownlint-cli2 as dev dependency
- Add lint:md script to package.json
- Add markdownlint job to CI workflow
- Configure 5 rules: heading-increment, no-duplicate-heading,
  no-trailing-punctuation, no-bare-urls, no-space-in-emphasis
- Fix existing violations across 19 markdown files
- No auto-fix to prevent destructive changes

Closes #1034

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-06 12:40:07 -06:00
Alex Verkhovsky e979b47fe5
fix(workflows): remove hardcoded years from WebSearch queries (#1040)
* update 2024 to 2025

* fix(workflows): remove hardcoded years from WebSearch queries

Years in search queries (2024/2025) do not improve results - search
engines already prioritize current documentation. Tested all patterns
and confirmed identical quality results with/without years.

Removes years from:
- step-03-starter.md (5 queries)
- step-04-decisions.md (2 queries)
- game-architecture/instructions.md (2 queries)

Leaves file-utils.md unchanged (test fixture data, not a search query).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(workflows): remove year placeholders from research WebSearch queries

Search engines return current results regardless of year - removes
{{current_year}} and hardcoded 2025 from step-05-technical-trends.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor(workflows): replace {{current_year}} with semantic alternatives

Replaces year placeholder with context-appropriate wording:
- 'current data' for up-to-date information
- 'web searches' without year qualifier
- Updated failure mode to focus on using web searches

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(workflows): clarify failure mode about stale training data

Rephrased to explicitly mention training data cutoff as the reason
to use web searches for current technology trends.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor(workflows): make web search references platform-agnostic

- Remove hardcoded year references from WebSearch queries
- Replace `WebSearch` tool name with natural language "search the web"
- Soften "training data is stale" to "verify and supplement your knowledge"
- Add web search prerequisite check to research workflow
- Add platform-agnostic design note to CLAUDE.md

This framework targets 15+ agentic platforms, not just Claude Code.
Tool-specific syntax like `WebSearch:` won't work across all platforms.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* refactor(research): clean up prompts and routing

---------

Co-authored-by: Pomazan Bohdan <pomazan.bogdan@gmail.com>
Co-authored-by: Brian <bmadcode@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-12-06 12:37:50 -06:00
Hang 282bc27c7e
feat(bmm): enhance PRD workflow with brownfield project support (#1047)
- Add three-branch conditional logic for document-based discovery:
  - PATH A: Has Product Brief (any project type)
  - PATH B: No Brief + Has Project Docs (brownfield)
  - PATH C: No Documents (greenfield from scratch)
- Add YAML frontmatter to all 12 PRD step files
- Add documentCounts to frontmatter for state tracking
- Fix step count (11 steps, not 10) and path typos
- Remove non-existent workflow references (story-context, validate-architecture)
- Update workflow chains and glossary definitions

Key insight: Branch based on DOCUMENT TYPE, not PROJECT TYPE.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-06 12:35:30 -06:00
Alex Verkhovsky 5ee1551b5b
fix(bmm): remove stale validate-prd references (fixes #1030) (#1038)
- Remove validate-prd workflow references from all workflow path YAML files
- Update Excalidraw diagram: remove Validate PRD box and zombie JSON elements
- Re-export SVG at 1x scale
- Standardize implementation-readiness descriptions across all docs
- Add validation script (validate-svg-changes.sh) and README for SVG export process
- Correct Excalidraw timestamps

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-05 21:35:46 -06:00
Alex Verkhovsky c95b65f462
fix(bmm): correct code-review workflow status logic and checklist (#1015) (#1028)
- Fix checklist to only accept 'review' status (not 'ready-for-review')
- Include MEDIUM issues in done/in-progress status determination
- Initialize and track fixed_count/action_count variables for summary
- Add sprint-status.yaml sync when story status changes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-05 21:27:11 -06:00
Nguyen Quang Huy 72ef9e9722
fix: use backticks for quoted phrase in code-review description (#1025)
Replace 'looks good' with `looks good` to avoid nested single quote
issues when IDEs generate command files from workflow YAML.

Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-05 21:26:04 -06:00
Murat K Ozcan f99e192e74
fix: tea ci nvmrc (#1036) 2025-12-05 12:30:20 -06:00
Brian Madison 0b9290789e installer fixes 2025-12-03 22:44:13 -06:00
Brian Madison aa1cf76f88 new workflow types generate slash commands 2025-12-03 21:36:24 -06:00
Alex Verkhovsky 686af5b0ee
feat: add intelligent routing to quick-dev workflow (#1019)
Add escalation threshold and scale-adaptive routing to quick-dev:
- Simple requests get standard [t]/[e] choice
- Complex requests evaluated against project-levels.yaml
- Level 1-2 or uncertain → tech-spec recommended
- Level 3+ → BMad Method (workflow-init) recommended

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-03 12:14:36 -06:00
Dicky Moore 65658a499b
Feat/sprint status command (#1012)
* feat: add sprint-status command

* minor changes to reduce the change radius

---------

Co-authored-by: mq-bot <mq-bot@local>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-12-03 12:00:34 -06:00
Brian Madison aa30ef3e79 convert create epics and stories and implementation readiness to the new workflow step format 2025-12-02 19:22:15 -06:00
Brian Madison 6365a63dff workflow builder understands how to build continuable workflows 2025-12-02 19:22:15 -06:00
Alex Verkhovsky fe0817f590
fix(bmm): complete cleanup of epic-tech-context workflow removal (#1001)
- Remove references to deprecated epic-tech-context, story-context,
  validate-epic-tech-context, validate-story-context, and story-done workflows
- Simplify epic status: backlog → in-progress → done (was backlog → contexted)
- Update create-story to handle legacy 'contexted' status for backward compat
- Clean up sprint-planning instructions and status template
- Update docs: agents-guide, brownfield-guide, faq, glossary, quick-start

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-11-30 23:52:04 -06:00
Brian Madison 788c746857 product brief compliance with documented workflow standards 2025-11-30 22:45:48 -06:00
Brian Madison 829d051c91 move agent builder docs, create workflow builder docs, and a new workflow builder to conform to stepwise workflow creation 2025-11-29 23:23:35 -06:00
Brian Madison a0732df56c more step sharded workflows added for architecture and some fixes across all workflows to improve their file loading and reduction of time based estimates. 2025-11-29 01:49:15 -06:00
Brian Madison 4e254d7c63 brainstorming, research and partymode updated to use sharded step flow workflows 2025-11-29 01:49:15 -06:00
Brian Madison 00e72e66f8 Initial stepwise converstion of the phase 1 and 2 workflows complete. 2025-11-29 01:49:15 -06:00
Brian Madison 5a11519dc1 converted ux design to sharded step workflow 2025-11-29 01:49:14 -06:00
Alex Verkhovsky 5ea02d7091
feat: add adversarial code review recommendation to quick-dev workflow (#989)
* feat: add adversarial code review recommendation to quick-dev workflow

* fix: clarify scope of code review with 'in it' reference
2025-11-27 23:38:54 -06:00
Alex Verkhovsky 7b21708868
feat: recommend different LLM for code review in dev-story (#984)
Co-authored-by: Brian <bmadcode@gmail.com>
2025-11-27 23:38:32 -06:00
Brian Madison 3c81d78991 the first reworked sharded workflow, prd, works great and resolves the issues with latest sonnet udpates 2025-11-27 22:33:03 -06:00
Brian Madison 355ccebca2 workflow-status can call workflow init 2025-11-26 19:48:47 -06:00
Brian Madison d6b98afd2b minor udpates to prd, architecture, and create epics and stories flows. 2025-11-26 00:28:49 -06:00
Brian Madison 24e952c511 updated code review 2025-11-25 16:59:00 -06:00
Brian Madison cd98a7f5bb feat: complete Phase 4 workflow transformation - simpler, faster, better results
MAJOR BREAKING CHANGES: Phase 4 completely reengineered for developer efficiency and quality

🚀 **Phase 4 Streamlined & Supercharged:**
- **Reduced from 11 to 5 essential workflows** (55% reduction in complexity)
- **Eliminated redundant steps** that created token waste and confusion
- **Created single source of truth** story files with comprehensive implementation context
- **Achieved more reliable results** with fewer steps and better developer guidance

💡 **Revolutionary Dev Agent Behavior Fixes:**
- **Story file is now LAW:** Tasks/subtasks sequence is absolutely binding
- **Red-green-refactor enforcement:** Tests written first, validated, then implementation
- **Zero tolerance for cheating:** Tests must ACTUALLY exist and pass before marking complete
- **Sequential execution only:** No more "doing whatever you want" - follow the story exactly
- **Continuous execution:** No premature pausing until all tasks complete

🎯 **Quality Competition System:**
- **Enhanced story context engine** prevents common LLM development mistakes
- **Quality competition between LLMs** ensures optimal story preparation
- **Comprehensive anti-pattern prevention** stops wheel reinvention and wrong approaches
- **Developer optimization focus** for maximum clarity with minimum verbosity

📋 **Enhanced Definition of Done:**
- **27-point validation checklist** covers all implementation aspects
- **Multiple validation gates** prevent claiming work that isn't actually done
- **Comprehensive test requirements** ensure no functionality goes untested
- **File tracking and documentation** for complete project visibility

🔧 **Technical Improvements:**
- **Variable consistency** throughout all workflow files
- **XML instruction format** for better workflow engine compatibility
- **Proper ask tag handling** for user interaction clarity
- **Project context integration** without blocking implementation
- **Fixed all agent schema compliance** for proper array formatting

**Result:** Phase 4 now delivers superior development outcomes with:
-  **55% fewer workflows** to learn and maintain
-  **Dramatically reduced token usage** and context switching
-  **Eliminated dev agent behavioral issues** that caused quality problems
-  **Faster time-to-completion** with more reliable, predictable results
-  **Better developer experience** with clearer guidance and validation

This represents the most significant Phase 4 improvement since BMAD Method inception - fundamentally fixing developer workflow quality while drastically simplifying the implementation process.
2025-11-23 16:43:04 -06:00
Brian Madison 4308b36d4d feat: add custom agents and quick-flow workflows, remove tech-spec track
Major Changes:
- Add sample custom agents demonstrating installable agent system
  - commit-poet: Generates semantic commit messages (BMAD Method repo sample)
  - toolsmith: Development tooling expert with knowledge base covering bundlers, deployment, docs, installers, modules, and tests (BMAD Method repo sample)
  - Both agents demonstrate custom agent architecture and are installable to projects via BMAD installer system
  - Include comprehensive installation guides and sidecar knowledge bases

- Add bmad-quick-flow methodology for rapid development
  - create-tech-spec: Direct technical specification workflow
  - quick-dev: Flexible execution workflow supporting both tech-spec-driven and direct instruction development
  - quick-flow-solo-dev (Barry): 1 man show agent specialized in bmad-quick-flow methodology
  - Comprehensive documentation for quick-flow approach and solo development

- Remove deprecated tech-spec workflow track
  - Delete entire tech-spec workflow directory and templates
  - Remove quick-spec-flow.md documentation (replaced by quick-flow docs)
  - Clean up unused epic and story templates

- Fix custom agent installation across IDE installers
  - Repair antigravity and multiple IDE installers to properly support custom agents
  - Enable custom agent installation via quick installer, agent installer, regular installer, and special agent installer
  - All installation methods now accessible via npx with full documentation

Infrastructure:
- Update BMM module configurations and team setups
- Modify workflow status paths to support quick-flow integration
- Reorganize documentation with new agent and workflow guides
- Add custom/ directory for user customizations
- Update platform codes and installer configurations
2025-11-23 08:51:26 -06:00
Murat K Ozcan 00b541f5d4
feat: playwright-utils integration (#954)
* feat: playwright-utils integration

* removed the temp plan file, and addressed changelog

* feat: edited the installer question for pw-utils

* feat: even more n00b friendly install prompt

* Update README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/modules/bmm/_module-installer/install-config.yaml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Murat Ozcan <murat@mac.lan>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-11-20 17:34:08 -06:00
Dicky Moore d7f045b11e
Align UX design workflow references (#935)
Co-authored-by: Brian <bmadcode@gmail.com>
2025-11-19 20:40:07 -06:00
Brian Madison f17e4ef0b7 refactor(bmm,cis,core): Align diagram workflows with agile roles and distribute capabilities
## The Tale of the Frame Expert

Once upon a time, BMad Method had a specialized agent called Frame Expert.
This agent was the master of all visual artifacts - flowcharts, diagrams,
wireframes, data flows. Whenever anyone needed a diagram, they called upon
Frame Expert. The agent lived in its own isolated domain with four dedicated
workflows and a library of shared templates.

## The Awakening

But something felt wrong. Teams using BMad Method were meant to mirror real
agile teams - Product Managers, Architects, UX Designers, Tech Writers,
Developers. Each agent represented an authentic role you'd find in any
software team.

Except Frame Expert.

No real agile team has a "Frame Expert" or "Diagram Specialist" who creates
all visual artifacts. In real teams, Architects diagram system architecture.
PMs flowchart processes. UX Designers wireframe interfaces. Tech Writers
create documentation diagrams. The visuals emerge from the domain experts
who need them, not from a centralized diagram factory.

Frame Expert was an abstraction that made technical sense but violated the
very soul of BMad Method - authentic agile role modeling.

## The Transformation

And so Frame Expert was dissolved, its knowledge distributed to those who
truly needed it:

**The Architect** inherited system architecture diagrams and data flows -
the blueprints of technical systems they design.

**The Product Manager** received process flowcharts - the visual maps of
features and workflows they orchestrate.

**The UX Designer** claimed wireframes - the interface sketches that bring
their vision to life.

**The Tech Writer** gained all diagram types - the visual aids that clarify
their documentation.

Each agent now creates diagrams in their domain, using their expertise,
serving their purpose.

## The Shared Knowledge

But the wisdom of diagram creation itself - the Excalidraw templates, the
component libraries, the validation patterns - this knowledge was too
valuable to scatter. It was elevated to core resources, where both BMM
agents AND the new CIS presentation-master agent could draw upon it.

Shared infrastructure for common needs. Distributed execution for domain
expertise.

## The Ripple Effects

With diagrams now properly distributed, other misalignments became visible:

Epic creation was happening in Phase 2 (Planning), before Architecture
existed. But epics need architectural context - API contracts, data models,
technical decisions. So epic creation migrated to Phase 3 (Solutioning),
after Architecture provides that foundation.

Workflow paths were updated. Documentation gained visual flowcharts showing
the complete journey. Agent naming standards were clarified - filenames are
stable roles, persona names are user dreams.

## What Changed

**Removed:**
- frame-expert.agent.yaml (the centralized specialist)
- All frame-expert workflows and shared resources
- Phase 2 epic creation workflow (wrong timing)
- game-design workflow path (consolidated to method track)
- v6-open-items.md (planning doc, now complete)

**Distributed Diagram Capabilities:**
- Architect: create-excalidraw-diagram, create-excalidraw-dataflow
- PM: create-excalidraw-flowchart
- Tech Writer: create-excalidraw-{diagram,dataflow,flowchart}, generate-mermaid
- UX Designer: create-excalidraw-wireframe

**Created:**
- src/core/resources/ (shared diagram context for all modules)
- src/modules/cis/agents/presentation-master.agent.yaml (visual comms specialist)
- src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/ (epic creation's new home)
- src/modules/bmm/workflows/diagrams/ (distributed diagram implementations)
- src/modules/bmm/docs/images/ (workflow visualization assets)

**Enhanced:**
- All agent definitions with domain-appropriate diagram workflows
- Documentation with embedded workflow diagrams and visual guides
- Agent compilation docs with critical naming convention rules
- All 4 workflow paths (enterprise/method × brownfield/greenfield)

**Fixed:**
- Epic creation now in Phase 3 after Architecture
- Story context path variables in BMGD module
- PRD workflow descriptions (epics moved to Phase 3)

## For Users

The Frame Expert commands are gone. In their place:

- Need architecture diagrams? Ask `/architect`
- Need process flows? Ask `/pm`
- Need wireframes? Ask `/ux-designer`
- Need documentation visuals? Ask `/tech-writer`

Each expert creates diagrams in their domain, with their context, using
their judgment.

This is how real teams work.
2025-11-18 21:55:47 -06:00