Add comprehensive async collaboration system for PRD/Epic development:
PRD & Epic Crowdsourcing:
- Create, open feedback rounds, synthesize, and sign-off workflows
- LLM-powered synthesis engine for conflict resolution
- Configurable sign-off thresholds (count, percentage, required approvers)
- Unified "my-tasks" view across PRDs and Epics
Story Coordination:
- Story locking/checkout for preventing concurrent work
- Lock status and unlock workflows
- Available stories view with lock status
Multi-Channel Notifications:
- GitHub @mentions, Slack webhooks, Email (SMTP/SendGrid/SES)
- Event-driven notifications for feedback/signoff requests
- Priority-based retry logic for urgent notifications
Cache System Extensions:
- PRD and Epic document caching with metadata migration
- Staleness detection and atomic file operations
- User task queries and extended statistics
GitHub integration is optional (disabled by default) - existing local-only
projects continue to work unchanged.
Includes 673 passing tests with comprehensive coverage for all new modules.
Note: Library files use CommonJS for Node.js compatibility. ESLint rules
for ES modules may need configuration adjustment.
- Update instructions.md Step 2.5 to explicitly halt when story
creation/regeneration is needed (agents cannot invoke workflows)
- Add clear user guidance with manual action steps
- Add manual_actions_required tracking to batch summary (Step 5)
- Update README.md with Critical Prerequisites section
- Create scripts/validate-all-stories.sh for pre-batch validation
This addresses the root cause where batch-super-dev told agents to
"Invoke workflow: /create-story-with-gap-analysis" which is not
possible in batch mode. Agents now gracefully skip invalid stories
and provide clear instructions for manual intervention.
Follows recommendations from BMAD-WORKFLOW-IMPROVEMENTS.md
WHO YOU GONNA CALL? 👻 GHOST-FEATURE-BUSTERS!
Implements reverse gap analysis to find "orphaned code" - functionality
that exists in the codebase but has no corresponding story documentation.
Use Case:
"Find functionality that doesn't exist in any story (was vibe coded or
magically appeared) and propose backfilling stories" - User
FEATURE: /ghost-features (trigger: GFD)
---------------------------------------
Scans codebase and cross-references with ALL stories to find orphans:
1. Codebase Scan:
- React/Vue/Angular components
- API endpoints (Next.js, NestJS, Express)
- Database tables (Prisma, TypeORM, migrations)
- Services and business logic modules
- Ignores tests, build artifacts, node_modules
2. Cross-Reference with Stories:
- Check if component mentioned in any File List
- Check if API mentioned in any Task/AC
- Check if table mentioned in any story
- Mark as DOCUMENTED if found, ORPHAN if not
3. Severity Classification:
- CRITICAL: APIs, auth, payment (security-critical)
- HIGH: Components, DB tables, services (significant features)
- MEDIUM: Utilities, helpers
- LOW: Config files, constants
4. Backfill Story Generation:
- Analyze orphan code to understand functionality
- Generate story draft documenting existing implementation
- Mark most tasks as [x] (already exists)
- Add tasks for missing tests/docs
- Suggest epic assignment based on functionality
5. Epic Organization:
- Option A: Create "Epic-Backfill" for all orphans
- Option B: Distribute to existing epics
- Option C: Leave in backlog
Output:
- Orphaned features list (by severity and type)
- Documentation coverage % (what % of code has stories)
- Backfill stories created (if requested)
- Comprehensive report (ghost-features-report-{timestamp}.md)
Usage:
```bash
# Detect orphans in entire sprint
/ghost-features
# Detect orphans in Epic 2
/ghost-features epic_number=2 scan_scope=epic
# Detect and create backfill stories
/ghost-features create_backfill_stories=true
# Full codebase scan
/ghost-features scan_scope=codebase
```
Files Created:
- detect-ghost-features/workflow.yaml: Reverse gap analysis config
- detect-ghost-features/instructions.md: 8-step detection + backfill process
Files Modified:
- sm.agent.yaml: Added GFD (Ghost Feature Detector) menu item
Benefits:
- Prevents "ghost features" from accumulating
- Documents vibe-coded functionality
- Maintains story-code parity
- Enables accurate sprint planning (know what actually exists)
- Makes codebase auditable (every feature has a story)
- Catches manual code additions that bypassed story process
Implements user-requested revalidation capability to verify checkbox accuracy.
Use Case:
"I am uncertain about the real status of some stories and epics that I've
worked on and would love a re-check" - User
FEATURE: /revalidate-story
-------------------------
Clears all checkboxes and re-verifies each item against codebase:
1. Clear Phase:
- Uncheck all boxes in ACs, Tasks, DoD
- Start from clean slate
2. Verification Phase:
- For each item: search codebase with Glob/Grep
- Read files to verify actual implementation (not stubs)
- Check for tests and verify they pass
- Re-check verified items: [x] verified, [~] partial, [ ] missing
3. Gap Reporting:
- Report what exists vs what's documented
- Calculate accuracy (before % vs after %)
- Identify over-reported (checked but missing) and under-reported (exists but unchecked)
4. Gap Filling Mode (optional):
- Implement missing items
- Run tests to verify
- Commit per gap or all at once
- Re-verify after filling
Token Cost Analysis:
- Verify-only: ~30-45K tokens (just scan and report)
- Verify-and-fill (10% gaps): ~35-55K tokens
- Verify-and-fill (50% gaps): ~60-90K tokens
- Compare to full re-implementation: ~80-120K tokens
- Savings: 40-60% when gaps <30%
FEATURE: /revalidate-epic
------------------------
Batch revalidation of all stories in an epic using semaphore pattern:
- Maintain pool of N concurrent workers
- As worker finishes → immediately start next story
- Constant concurrency until all stories revalidated
- Epic-wide summary with health score
- Stories grouped by completion %
Usage:
```bash
# Verify only
/revalidate-story story_file=path/to/story.md
# Verify and fill gaps
/revalidate-story story_file=path/to/story.md fill_gaps=true
# Revalidate entire epic
/revalidate-epic epic_number=2
# Revalidate epic and fill all gaps
/revalidate-epic epic_number=2 fill_gaps=true max_concurrent=5
```
Files Created:
- revalidate-story/workflow.yaml: Story revalidation config
- revalidate-story/instructions.md: 10-step revalidation process
- revalidate-epic/workflow.yaml: Epic batch revalidation config
- revalidate-epic/instructions.md: Semaphore pattern for parallel revalidation
Files Modified:
- dev.agent.yaml: Added RVS and RVE menu items
- sm.agent.yaml: Added RVS and RVE menu items
Next: Reverse gap analysis (detect orphaned code with no stories)
Implements user-requested semaphore/worker pool pattern for maximum parallelization efficiency.
OLD Pattern (Inefficient):
- Split stories into batches of N
- Spawn N agents for batch 1
- Wait for ALL N to finish (idle time if some finish early)
- Spawn N agents for batch 2
- Wait for ALL N to finish
- Repeat until done
NEW Semaphore Pattern (Efficient):
- Initialize pool with N worker slots
- Fill all N slots with first N stories
- Poll workers continuously (non-blocking)
- As soon as ANY worker completes → immediately refill that slot
- Maintain constant N concurrent agents until queue empty
- Zero idle time, maximum throughput
Benefits:
- 20-40% faster completion (eliminates batch synchronization delays)
- Constant utilization of all worker slots
- More predictable completion times
- Better resource efficiency
Implementation Details:
- run_in_background: true for Task agents (non-blocking spawns)
- TaskOutput(block=false) for polling without waiting
- Worker pool state tracking (active_workers map)
- Immediate slot refill on completion
- Live progress dashboard every 30 seconds
- Graceful handling of failures (continue_on_failure support)
Files Modified:
- batch-super-dev/instructions.md: Rewrote Step 4-Parallel with semaphore logic
- batch-super-dev/README.md: Updated to v1.3.0, documented semaphore pattern
- docs/HOW-TO-VALIDATE-SPRINT-STATUS.md: Explained semaphore vs batch patterns
- src/modules/cis/module.yaml: Auto-formatted by prettier
User Experience:
- Same concurrency selection (2, 4, or all stories)
- Same sequential vs parallel choice
- Now with continuous worker pool instead of batch synchronization
- Real-time visibility: "Worker 3 completed → immediately refilled"
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
- 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.
* fix(brainstorming): extend ideation phase with 100+ idea goal
Add emphasis on quantity-first approach to unlock better quality ideas.
Introduce energy checkpoints, multiple continuation options, and clearer
success metrics to keep users in generative exploration mode longer.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(brainstorming): improve exploration menus and fix workflow paths
- Change menu options from numbers [1-4] to letters [K/T/A/B/C] for clearer navigation
- Fix workflow references from .yaml to .md across agents and patterns
- Add universal facilitation rules emphasizing 100+ idea quantity goal
- Update exploration menu with Keep/Try/Advanced/Break/Continue options
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(brainstorming): implement research-backed procedural rigor
Phase 4 achievements:
- Added Anti-Bias Protocol (Every 10 ideas domain pivot)
- Added Chain-of-Thought requirements (Reasoning before generation)
- Implemented Simulated Temperature prompts for higher divergence
- Standardized Idea Format Template for quality control
- Fixed undefined Advanced Elicitation variables
- Synchronized documentation with new [K, T, A, P, C] pattern
* fix(brainstorming): align ideation goals and fix broken workflow paths
- Standardized quantity goals to 100+ ideas across all brainstorming steps
- Fixed broken .yaml references pointing to renamed .md workflow files
- Aligned documentation summaries with mandatory IDEA FORMAT TEMPLATE
- Cleaned up misplaced mindset/goal sections in core workflow file
- Fixed spelling and inconsistencies in facilitation rules
* Fix ambiguous variable names in brainstorming ideation step
* fix(brainstorming): enforce quality growth alongside quantity
* fix: correct dependency format and add missing frontmatter variable
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- 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
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.
- 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
* 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>
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)
- 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
Jonah Schulte
Brian Madison
Davor Racic
Alex Verkhovsky
Andaman Lekawat
Murat K Ozcan
Nick Pirocanac