v3.3.0

Features

• add next-step suggestions after each pipeline stage completes
• add code review to execute and audit stages
• add Brainstorm & Clarify gate to plan stage (conditional, before decomposition)
• add landing page with interactive terminal demo

Fixes

• update stale step cross-references in audit SKILL.md (Step 4→5, Step 5→6)
• address landing page review findings (4 important + 5 suggestions)
• add executable perms to 2 test files, add BLOCKED prefix to pre-shutdown stderr

Documentation

• update README tagline to match v3 pipeline architecture
• add landing page link to README, keep site/ source on main
• add landing page implementation plan (2 tasks)
• fix landing page spec review findings (2 medium + 6 low)
• add landing page design spec

Maintenance

• bump version to 3.3.0

v3.2.0

Added

• Workspace completeness hook (SubagentStart) — validates all 4 tracking files (progress.md, tasks.md, issues.md, task-graph.json) and required fields (Archetype, Pipeline status) before teammate spawn
• Plan-mode revision limit hook (PreToolUse(SendMessage)) — enforces max 2 revision rounds per teammate, blocks third PLAN_REVISION with guidance to approve or reassign
• Pre-shutdown commit hook (PreToolUse(TeamDelete)) — blocks TeamDelete if any owned files have uncommitted changes, reads file-locks.json for ownership
• Integration point file validation — enhanced existing check-integration-point.sh to verify upstream task output files exist on disk at convergence points (advisory warning)

Stats

• 3 new scripts, 1 enhanced script, 3 new test files
• 13 hook entries, 16 scripts, 16 test files (216 assertions)

Design Documents

• Spec: docs/specs/2026-03-24-tier2-execution-robustness-design.md
• Plan: docs/plans/2026-03-24-tier2-execution-robustness.md

v3.1.0

Added

• validate-task-graph.sh hook (SubagentStart) — validates task-graph.json schema and detects circular dependencies before teammate spawn. Blocks on invalid JSON, missing required fields, dangling dependency references, or cycles. 5 checks, hard enforcement (exit 2).
• Plan audit completeness gate — mandatory Plan Audit Result table in progress.md with all 7 checks filled before plan presentation. Hard gate in plan SKILL.md: "DO NOT present the plan until all 7 rows are filled."
• Plan Audit Result template in docs/workspace-templates.md for progress.md

Stats

• 1 new script, 1 new test file (12 assertions)
• 13 scripts, 13 test files total

v3.0.1

Fixes

• address 3 issues from end-to-end pipeline test

Documentation

• rewrite README demo for v3.0.0 pipeline architecture
• add repo sync and demo rewrite plan

Maintenance

• bump version to 3.0.1

v3.0.0

Breaking Changes

• Skill restructure: 5 archetype skills replaced with 4 pipeline stages (agent-team:start, agent-team:plan, agent-team:execute, agent-team:audit)
• Migrated shared docs into stage skills: shared-phases.md, spawn-templates.md, communication-protocol.md, coordination-patterns.md, coordination-advanced.md, report-format.md moved into stage-specific references/, agents/, examples/ subfolders

Added

• Pipeline entry point (skills/start/SKILL.md) — type detection, routing to plan/execute/audit
• Team per stage — each stage creates its own ephemeral team (plan: Researcher+Analyst+Plan Reviewer, execute: Implementers+Tester+Reviewer+Execute Reviewer, audit: Reviewer+Elegance Reviewer+Audit Reviewer)
• Prior context loading — plan stage loads lessons and error patterns from prior teams
• Plan-mode gate — teammates propose approach before executing; lead reviews and approves
• Error recovery loop — classifies errors (retry/recoverable/design_flaw), bounded auto-recovery
• Elegance review — 5-dimension quality assessment (advisory, not blocking)
• Lessons capture — post-execution insights for future teams
• Error pattern library — global ~/.claude/agent-team-patterns.json shared across projects
• Inter-stage review agents — plan-reviewer, execute-reviewer, audit-reviewer validate output between stages
• Elegance Reviewer role — new teammate role (13 total)
• recovery_class field — each role declares error recovery behavior
• Pipeline status handoff — Pipeline status, Stage, Archetype fields in progress.md
• New spawn templates: researcher.md, analyst.md (plan stage), reviewer.md (audit stage)
• FINDING, ANALYSIS, PLAN_PROPOSAL, PLAN_APPROVED, PLAN_REVISION, PLAN_REVIEW, EXECUTE_REVIEW, ELEGANCE_REVIEW, AUDIT_REVIEW message types

Removed

• skills/agent-team/, skills/agent-implement/, skills/agent-research/, skills/agent-audit/, skills/agent-plan/
• docs/shared-phases.md, docs/spawn-templates.md, docs/communication-protocol.md, docs/coordination-patterns.md, docs/coordination-advanced.md, docs/report-format.md

v2.5.1

Fixes

• add missing communication-protocol.md to README plugin structure

Refactors

• split teammate-roles into overview + spawn-templates (both under 500 lines)
• split coordination-patterns into core + advanced (both under 500 lines)

Documentation

• mark skill best practices audit plan as COMPLETED
• add table of contents to shared-phases.md
• update cross-references for split coordination-patterns and teammate-roles
• add concrete decomposition examples to research, audit, and plan skills
• add skill best practices audit implementation plan

Maintenance

• bump version to 2.5.1

v2.5.0

Fixes

• address 5 issues from dry-run testing

Documentation

• update README Phase 1 description for plan-awareness
• add plan-aware detection note to team-archetypes
• update 4 archetype skills Phase 1 and Phase 5 overrides for plan-aware workflow
• update agent-team Phase 1 and Phase 5 overrides for plan-aware workflow
• update phase checklist for plan-aware workflow
• add plan file conventions to workspace-templates
• add plan status update section to Phase 5
• add plan source line to Phase 2 presentation template
• replace Phase 1 steps with Phase 1b plan-driven decomposition
• add Phase 1a plan detection and preparation to shared-phases
• add early exit and budget constraints to Phase 1
• fix plan review issues in implementation plan
• address spec review findings for plan-aware Phase 1
• add plan-aware Phase 1 design spec
• update README demo to match real actions flow

Maintenance

• bump version to 2.5.0
• remove package.json and LICENSE, move design docs to specs/

v2.4.0

Features

• add PROGRESS and CHECKPOINT to lead processing rules
• add anti-pattern catalog to coordination patterns
• add warm vs cold handoff distinction to result handoff pattern
• add graceful degradation coordination pattern
• add circular dependency detection to Phase 2 and coordination patterns
• add confidence grades and priority marking to protocol
• add deadline escalation coordination pattern
• add PROGRESS and CHECKPOINT optional message types to protocol
• add checkpoint/rollback coordination pattern
• document scaling patterns in team archetypes

Documentation

• add completed plan files for v2.3 archetype split and v2.4 protocol improvement
• add research findings reference to CLAUDE.md
• update README with new protocol message types

Maintenance

• bump version to 2.4.0

v2.3.0

Features

• add shared-phases doc and 4 archetype-specific skills

Refactors

• slim agent-team SKILL.md to hybrid catch-all, simplify team-archetypes.md

Documentation

• update tests, README, and CLAUDE.md for archetype skill split

Maintenance

• bump version to 2.3.0

v2.2.1

Refactors

• trim SKILL.md, add quick start, examples, and protocol injection
• replace protocol blocks with placeholders in spawn templates
• deduplicate protocol in coordination-patterns, add setup failures
• rename worker-roles.md to teammate-roles.md

Documentation

• clarify coordination-patterns scope reference
• update CLAUDE.md for renamed teammate-roles and new protocol file
• add canonical communication protocol definition
• apply 5 audit amendments to implementation plan
• add skill best-practices implementation plan
• add skill best-practices compliance overhaul design
• add animated demo GIF to README
• add demo walkthrough section to README and demo recording script

Maintenance

• bump version to 2.2.1