# Autonomous Epic Processing

## Concept

**Full-auto epic completion** - Create and develop all stories in an epic with zero human intervention.

```
/auto-epic epic-2

→ Creates story 2.1 → Super-dev → Done
→ Creates story 2.2 → Super-dev → Done
→ Creates story 2.3 → Super-dev → Done
...
→ Entire epic complete! ✅
```

## Workflow

```
┌──────────────────────────────────────┐
│  Auto-Epic Processor                  │
│                                       │
│  1. Read epic definition              │
│  2. For each story in epic:           │
│     ├─ create-story                   │
│     ├─ super-dev-story                │
│     │  ├─ Pre gap analysis            │
│     │  ├─ Development                 │
│     │  ├─ Post gap analysis           │
│     │  ├─ Code review                 │
│     │  └─ Fix issues                  │
│     └─ Mark done                      │
│  3. Epic retrospective                │
│  4. Report completion                 │
└──────────────────────────────────────┘
```

## Use Cases

### 1. Overnight Processing
```bash
# Start before leaving office
/auto-epic epic-3

# Come back next morning
# → Epic 100% complete
```

### 2. CI/CD Integration
```bash
# In GitHub Actions
bmad auto-epic epic-2 --config production.yaml
```

### 3. Batch Sprints
```bash
# Process multiple epics
/auto-epic epic-1,epic-2,epic-3
```

## Configuration

```yaml
# _bmad/bmm/config.yaml

autonomous_mode:
  enabled: true

  # Fail behavior
  halt_on_error: false        # Continue even if story fails
  max_retry_per_story: 3      # Retry failed stories

  # Quality gates
  require_super_dev: true     # Use super-dev for all stories
  require_100_percent: false  # Require 100% test coverage

  # Notification
  notify_on_complete: true    # Send notification when done
  notify_webhook: ""          # Slack/Discord webhook
```

## Safety

### Validation Before Start

```
Autonomous processing will:
- Create 15 stories
- Develop all automatically
- Take approximately 8 hours
- Commit all changes to: feature/epic-2-auto

Confirm? [Y/n]:
```

### Checkpoints

- Creates git branch for the epic
- Commits after each story
- Saves progress if interrupted
- Can resume from last completed story

### Rollback

```bash
# If something goes wrong
/auto-epic rollback epic-2

# Restores to pre-processing state
```

## Example Output

```
🤖 AUTONOMOUS EPIC PROCESSING: Epic 2 - User Management

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Story 2.1: User Registration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ create-story complete
✅ Pre-gap analysis: 0 changes needed
✅ Development: 8 tasks completed
✅ Post-gap analysis: All verified
✅ Code review: 2 minor issues found
✅ Fixes applied
✅ Story 2.1 DONE

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Story 2.2: User Login
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ create-story complete
✅ Pre-gap analysis: Reuse registration code
✅ Development: 6 tasks completed
✅ Post-gap analysis: All verified
✅ Code review: No issues
✅ Story 2.2 DONE

...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
EPIC 2 COMPLETE! 🎉
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Stories completed: 15/15
Total time: 7h 23m
Test coverage: 94%
Code review issues: 12 (all fixed)

Branch: feature/epic-2-auto
Ready to merge!
```

## Implementation Status

- 🚧 **Planned** for BMAD v6.1.0
- Requires: Super-dev mode (v6.0.0-alpha.23)
- Depends on: Robust error handling, progress tracking

## Contributing

Want to help build autonomous epic processing?

See [CONTRIBUTING.md](../CONTRIBUTING.md)

---

**The future: Tell BMAD what you want built, come back when it's done** ✨