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:
parent
07c3c42b03
commit
7bda706da2
12 changed files with 1349 additions and 15 deletions
|
|
@ -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]
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue