docs: update README-changes.md with v1.3.0 complexity routing feature

Updated documentation to include:
- Complexity-based routing overview
- MICRO/STANDARD/COMPLEX classification algorithm
- Risk keyword scoring system
- Token savings (50-70% for micro stories, 90% for early bailouts)
- Integration with super-dev-pipeline and batch-super-dev
- Latest commit information (9bdf4894)
This commit is contained in:
Jonah Schulte 2026-01-07 16:38:59 -05:00
parent 9bdf489438
commit 1dd5e6b0c3
1 changed files with 34 additions and 2 deletions

View File

@ -7,9 +7,10 @@ This document describes the customizations and enhancements in this fork compare
This fork extends the official BMAD Method with **production automation workflows** focused on:
- **Quality assurance automation** - Multi-stage validation pipelines
- **Token efficiency** - 60-70% reduction in token usage per story
- **Token efficiency** - 50-70% reduction through complexity-based routing
- **Autonomous processing** - Unattended epic completion
- **Anti-vibe-coding enforcement** - Mandatory gap analysis and code review
- **Smart routing** - Micro stories skip unnecessary quality gates
**Stats:** ~26,000+ lines of additions across 122 files
@ -31,6 +32,12 @@ Pre-validation → Development → Post-validation → Code Review → Fixes →
- Finds missed edge cases automatically
- Runs adversarial code review before human review
**Complexity-Based Routing (v1.3.0):**
- **MICRO stories** automatically skip steps 2 (pre-gap analysis) and 5 (code review)
- **STANDARD/COMPLEX stories** use full 7-step pipeline
- Early bailout checks prevent processing already-complete or invalid stories
- Token savings: 50-70% for micro stories, 90% for early bailouts
**Location:** `src/modules/bmm/workflows/4-implementation/super-dev-pipeline/`
---
@ -73,12 +80,18 @@ Interactive batch workflow for processing multiple stories with full quality gat
→ Select stories: 1-3,5,7 (or "all")
→ Validates story files (creates missing, regenerates invalid)
→ Scores complexity for each story (micro/standard/complex)
→ Routes to appropriate pipeline (lightweight vs full)
→ Processes each with super-dev-pipeline
→ Reconciles story status after each
→ All stories complete! ✅
```
**Features (v1.2.0):**
**Features (v1.3.0):**
- **Complexity-Based Routing** ⭐ NEW - Smart pipeline selection
- **MICRO** (≤3 tasks, low risk): Lightweight path, skips gap analysis + code review (50-70% token savings)
- **STANDARD** (4-15 tasks): Full pipeline with all quality gates
- **COMPLEX** (≥16 tasks or high-risk): Enhanced validation, suggest splitting
- **Smart Story Validation** - Checks 12 required BMAD sections
- **Auto-Creation** - Creates missing story files with codebase gap analysis
- **Auto-Regeneration** - Regenerates invalid/incomplete stories
@ -86,6 +99,20 @@ Interactive batch workflow for processing multiple stories with full quality gat
- **Story Reconciliation** - Verifies checkboxes match implementation
- **Epic filtering** - Process only specific epic's stories
**Complexity Scoring Algorithm:**
```
complexity_score = task_count + (high_risk_keywords × 5) + (medium_risk_keywords × 2)
MICRO: task_count ≤ 3 AND score ≤ 5 AND file_count ≤ 5 AND no HIGH risk keywords
COMPLEX: task_count ≥ 16 OR score ≥ 20 OR has HIGH risk keywords (auth, security, payment, etc.)
STANDARD: everything else
```
**Risk Keywords:**
- **HIGH** (5 points): auth, security, payment, encryption, migration, database, schema
- **MEDIUM** (2 points): api, integration, external, third-party, cache
- **LOW** (0 points): ui, style, config, docs, test
**Location:** `src/modules/bmm/workflows/4-implementation/batch-super-dev/`
---
@ -277,6 +304,11 @@ See `PR-DESCRIPTION.md` and `PR-STORY-PIPELINE.md` for prepared PR descriptions.
**Upstream Commit:** `5c766577` (Add CNAME file)
**Merge Commit:** `9df79392`
**Latest Fork Changes:**
- **Date:** 2026-01-07
- **Commit:** `9bdf4894` (Critical complexity routing fixes)
- **Features:** Complexity-based routing v1.3.0, multi-agent review integration
To sync with upstream:
```bash
git fetch upstream