**Step 1b (Load Playbooks):**
- Agent reads playbook index
- Agent reads story requirements
- Agent DECIDES which playbooks are relevant
- Loads only applicable playbooks (0-3 max)
**Step 12 (Extract Learnings):**
- Agent self-reflects on implementation
- What went well? What went wrong?
- What patterns emerged? What mistakes made?
- Agent decides which playbooks to update
- Specific, evidence-based learnings only
**Why Better:**
- Agent understands context (not dumb keyword match)
- Can connect concepts (charge creation = billing)
- Won't load irrelevant playbooks
- Won't miss relevant playbooks with different terminology
**Example:**
Story: 'Create charge model with state machine'
Agent sees: billing-playbook (charge creation), state-machine-playbook (transitions)
Agent decides: Load both (relevant)
Agent skips: queue-playbook (not needed), auth-playbook (not applicable)
Much smarter than: story contains 'charge' → load all playbooks with 'charge'.
**New Steps:**
- Step 1b: Load Applicable Playbooks (before gap analysis)
- Step 12: Extract Learnings (after summary)
**How It Works:**
1. Step 1b analyzes story keywords (auto-detect from tasks/title)
2. Searches docs/playbooks/ for matching playbooks
3. Loads applicable playbooks into context
4. Agent uses learnings during implementation
5. Step 12 extracts new patterns from completed work
6. Updates playbooks with learnings
7. Next story benefits from previous work
**Positive Feedback Loop:**
- Story N implements feature → extracts patterns
- Story N+1 loads patterns → implements better
- Gets smarter with every story
- Prevents repeated mistakes
**Self-Contained:**
- No external skill dependencies
- All logic built into workflow steps
- Works with any project (generic)
- Playbook format configurable
**Configuration:**
- learning_feedback section in workflow.yaml
- Keyword auto-detection
- Playbook directory configurable
- Extract/load triggers customizable
**Benefits:**
- Cumulative intelligence across epic
- Prevents repeating same mistakes
- Documents successful patterns
- Builds project-specific knowledge base
Ready for v1.6.0 release with learning feedback!
Jonah Schulte