From 9859ce67f5722787ee34fd8fef25cd08d1e58af7 Mon Sep 17 00:00:00 2001 From: Jonah Schulte Date: Tue, 27 Jan 2026 00:55:08 -0500 Subject: [PATCH] docs: update changelog and workflow-map for 6.1.0-Beta.1 unified workflow architecture --- CHANGELOG.md | 53 ++++++++++++++++++++++++++++++++++ docs/reference/workflow-map.md | 29 ++++++++++++++++++- 2 files changed, 81 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ccc9ed7c..7266b0c1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,58 @@ # Changelog +## [6.1.0-Beta.1] + +**Release: January 2026 - Unified Workflow Architecture** + +### 🎯 Major Refactor: GSD-Style Unified Workflows + +Complete refactor of all Phase 4 implementation workflows from verbose XML/multi-file format to streamlined GSD-style unified markdown. + +**Philosophy Change:** +- **Simpler is better**: LLMs work better with clear, semantic instructions vs complex XML +- **Single-file workflows**: `workflow.md` replaces `instructions.xml` + step files +- **Semantic tags**: ``, ``, ``, ``, `` +- **Pattern references**: `@patterns/verification.md` for shared context +- **Orchestrator-driven**: Orchestrator does bookkeeping, agents do creative work + +### 🔧 Workflows Converted + +**Phase 4 Implementation (14 workflows unified):** +- `validate` - Consolidated 6 separate validation workflows into 1 with parameters +- `gap-analysis` - Verify story tasks against codebase +- `push-all` - Safe git staging/commit/push with secret detection +- `super-dev-story` - Dev pipeline with validation and review gates +- `create-story-with-gap-analysis` - Regenerate story with verified codebase scan +- `batch-super-dev` - Parallel story execution pipeline +- `super-dev-pipeline` - Full orchestration workflow +- `story-pipeline` - Story lifecycle management +- `multi-agent-review` - Parallel code review with specialized agents +- `recover-sprint-status` - Rebuild sprint-status.yaml from artifacts +- `revalidate-story` - Clear and re-verify story checkboxes +- `revalidate-epic` - Batch revalidation for epic stories +- `detect-ghost-features` - Find undocumented code +- `migrate-to-github` - Export stories to GitHub Issues + +**Patterns Library (5 shared patterns):** +- `verification.md` - Evidence-based checkbox verification +- `hospital-grade.md` - Production reliability standards +- `structured-output.md` - Agent return format contracts +- `parallel-execution.md` - Multi-agent coordination +- `context-loading.md` - Efficient context management + +### 📊 Impact + +- **Net reduction: ~15,000+ lines** of verbose XML/instructions +- **Simpler mental model**: One file per workflow +- **Better LLM comprehension**: Semantic tags over complex nesting +- **Easier maintenance**: Patterns shared across workflows + +### 🔄 Migration Notes + +Existing installations will automatically use the new workflow format. No user action required. + +--- + ## [6.0.0-Beta.0] **Release: January 2026 - Alpha to Beta Transition** diff --git a/docs/reference/workflow-map.md b/docs/reference/workflow-map.md index 22b97299..b152cc7d 100644 --- a/docs/reference/workflow-map.md +++ b/docs/reference/workflow-map.md @@ -46,7 +46,9 @@ Decide how to build it and break work into stories. ## Phase 4: Implementation -Build it, one story at a time. +Build it, one story at a time. All implementation workflows use a unified GSD-style format with semantic tags (``, ``, ``, ``, ``) and shared patterns for consistency. + +### Core Development | Workflow | Purpose | Produces | | ----------------- | -------------------------------------- | ----------------------------- | @@ -57,6 +59,31 @@ Build it, one story at a time. | `correct-course` | Handle significant mid-sprint changes | Updated plan or re-routing | | `retrospective` | Review after epic completion | Lessons learned | +### Quality & Validation + +| Workflow | Purpose | Produces | +| ----------------- | ----------------------------------------- | --------------------------- | +| `validate` | Unified validation (story/epic/all, quick/deep) | Validation report with categories | +| `gap-analysis` | Verify story checkboxes against codebase | Accuracy report, optional fixes | +| `revalidate-story`| Clear and re-verify all checkboxes | Updated story with evidence | +| `multi-agent-review` | Parallel code review with specialists | Combined review verdict | + +### Pipelines & Automation + +| Workflow | Purpose | Produces | +| -------------------- | ------------------------------------------ | ---------------------------- | +| `super-dev-story` | Dev + validation + review + push pipeline | Production-ready code | +| `batch-super-dev` | Parallel execution of multiple stories | Multiple stories completed | +| `push-all` | Safe git staging/commit/push with checks | Committed and pushed changes | + +### Maintenance & Recovery + +| Workflow | Purpose | Produces | +| ------------------------- | ------------------------------------ | -------------------------- | +| `recover-sprint-status` | Rebuild sprint-status from artifacts | Reconstructed status file | +| `detect-ghost-features` | Find undocumented code | Orphan report, backfill stories | +| `migrate-to-github` | Export stories to GitHub Issues | GitHub Issues with labels | + ## Quick Flow (Parallel Track) Skip phases 1-3 for small, well-understood work.