feat(v3.32.0): Plan-Validate-Execute Pipeline — 3-command AI-first workflow

New workflow for production teams: dynamic agent teams, ADR learning loop,
automated execution from PRD to merged PR.

Added:
- guide/workflows/plan-pipeline.md — complete workflow guide (philosophy,
  non-prescriptive AI-first, No Bandaids first principles, ADR learning loop,
  CLAUDE.md 120-line discipline, /clear context reset, cost profile)
- examples/commands/plan-start.md — 5-phase planning with 12-agent dynamic
  pool (trigger-based selection, Tier 0 Solo → Tier 4 Full Spectrum,
  planning-coordinator synthesis, auto-transition to validate)
- examples/commands/plan-validate.md — 2-layer validation (structural inline +
  8 specialist agents), ADR-aware auto-fix (Bucket A ~95% auto-resolve,
  Bucket B human input → new rule), issue persistence in metrics JSON
- examples/commands/plan-execute.md — worktree → TDD scaffold → level-based
  parallel agents → drift detection → quality gate → smoke test → PR squash
  merge → post-merge metrics → cleanup
- examples/agents/planning-coordinator.md — Opus synthesis agent: merges
  multi-agent reports into coherent task graph, resolves conflicts via ADR
  precedence, verifies plan completeness before output
- examples/agents/integration-reviewer.md — Opus runtime validator: connection
  params, async/sync consistency, env var completeness, library API
  correctness (WebFetch), OTEL pipeline validation

Updated:
- machine-readable/reference.yaml — 16 new indexed keys
- CHANGELOG.md — v3.32.0 entry with 6 detailed items
- VERSION, README.md, guide/cheatsheet.md, guide/ultimate-guide.md — bumped to 3.32.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-03-06 17:24:26 +01:00
parent 07c3c42b03
commit 7bda706da2
12 changed files with 1349 additions and 15 deletions

View file

@ -3,7 +3,7 @@
# Source: guide/ultimate-guide.md
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
version: "3.31.0"
version: "3.32.0"
updated: "2026-03-03"
# ════════════════════════════════════════════════════════════════
@ -685,6 +685,28 @@ deep_dive:
dual_instance_pattern: "Vertical separation (planner vs implementer) - orthogonal to Boris horizontal scaling"
dual_instance_cost: "$100-200/month (vs $500-1K Boris pattern)"
dual_instance_audience: "Solo devs, spec-heavy work, quality > speed"
# Plan-Validate-Execute Pipeline (Mar 2026)
plan_pipeline_workflow: "guide/workflows/plan-pipeline.md"
plan_pipeline_philosophy: "non-prescriptive AI-first + No Bandaids first principles + ADR learning loop"
plan_pipeline_commands: "/plan-start → /plan-validate → /plan-execute"
plan_pipeline_agent_pool: "12 research agents (trigger-based) + 8 validation agents (trigger-based)"
plan_pipeline_adr_loop: "Watching (1) → Emerging (2) → Confirmed (3+) → CLAUDE.md promotion"
plan_pipeline_claude_md_limit: "120 lines hard limit + pointer strategy for sub-files"
plan_pipeline_context_reset: "/clear between each command (plan, validate, execute)"
plan_pipeline_cost: "$2-10 typical Tier 2 feature, compounds down as ADR coverage grows"
plan_start_command: "examples/commands/plan-start.md"
plan_start_phases: "5 phases: PRD analysis, design analysis, technical decisions, dynamic team, metrics"
plan_start_tiers: "Tier 0 Solo (0 agents) → Tier 4 Full Spectrum (10+ agents)"
plan_validate_command: "examples/commands/plan-validate.md"
plan_validate_layer1: "structural checks inline: format, deps, file existence, ADR consistency, CLAUDE.md"
plan_validate_layer2: "0-8 specialist agents triggered by plan content (security Opus, db Opus, integration Opus)"
plan_validate_autofix: "Bucket A auto-resolve (ADR/PATTERNS/first-principles ~95%) + Bucket B human input"
plan_execute_command: "examples/commands/plan-execute.md"
plan_execute_flow: "worktree → TDD scaffold → parallel level execution → drift detection → quality gate → smoke test → PR merge → cleanup"
planning_coordinator_agent: "examples/agents/planning-coordinator.md"
planning_coordinator_role: "Opus synthesis agent: merges multi-agent reports into coherent task graph, resolves conflicts via ADR precedence"
integration_reviewer_agent: "examples/agents/integration-reviewer.md"
integration_reviewer_role: "Opus runtime validator: connection params, async/sync, env vars, library API correctness, OTEL pipeline"
# Boris Tane Pattern (Annotation Cycle, Feb 2026)
annotation_cycle_pattern: "guide/workflows/plan-driven.md#the-annotation-cycle"
custom_markdown_plans: "guide/workflows/plan-driven.md#why-custom-plans-over-plan"
@ -1462,7 +1484,7 @@ ecosystem:
- "Cross-links modified → Update all 4 repos"
history:
- date: "2026-01-20"
event: "Code Landing sync v3.31.0, 66 templates, cross-links"
event: "Code Landing sync v3.32.0, 66 templates, cross-links"
commit: "5b5ce62"
- date: "2026-01-20"
event: "Cowork Landing fix (paths, README, UI badges)"
@ -1474,7 +1496,7 @@ ecosystem:
onboarding_matrix_meta:
version: "2.0.0"
last_updated: "2026-02-05"
aligned_with_guide: "3.31.0"
aligned_with_guide: "3.32.0"
changelog:
- version: "2.0.0"
date: "2026-02-05"
@ -1502,7 +1524,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, commands]
time_budget: "5 min"
topics_max: 3
note: "SECURITY FIRST - sandbox before commands (v3.31.0 critical fix)"
note: "SECURITY FIRST - sandbox before commands (v3.32.0 critical fix)"
beginner_15min:
core: [rules, sandbox_native_guide, workflow, essential_commands]
@ -1587,7 +1609,7 @@ onboarding_matrix:
- default: agent_validation_checklist
time_budget: "60 min"
topics_max: 6
note: "Dual-instance pattern for quality workflows (v3.31.0)"
note: "Dual-instance pattern for quality workflows (v3.32.0)"
learn_security:
intermediate_30min:
@ -1598,7 +1620,7 @@ onboarding_matrix:
- default: permission_modes
time_budget: "30 min"
topics_max: 4
note: "NEW goal (v3.31.0) - Security-focused learning path"
note: "NEW goal (v3.32.0) - Security-focused learning path"
power_60min:
core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@ -1623,7 +1645,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
time_budget: "60 min"
topics_max: 6
note: "Security foundation + core workflow (v3.31.0 sandbox added)"
note: "Security foundation + core workflow (v3.32.0 sandbox added)"
intermediate_120min:
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]