v3.6.0 — Encyclopedia-Grade Documentation

What's New

Encyclopedia-Grade Documentation Rewrite

Complete rewrite of all user-facing documentation. Every agent, command, and skill now has its own reference page with consistent structure: What It Does → When to Use → How It Works → Examples → Power Use Cases → Combines With → Level Progression (L1/L2/L3) → Tips & Gotchas.

By the numbers:

• 92 new documentation files
• 10,870 lines of documentation
• 112 lines average per doc
• Written by 5 parallel agent teams reading all source files

New Documentation

• docs/agents/ — 33 individual agent reference pages
• docs/commands/ — 23 individual command reference pages
• docs/skills/ — 32 individual skill reference pages
• docs/LEVELS.md — Consolidated L1→L2→L3 journey with feature matrix, upgrade criteria, and downgrade path
• docs/GLOSSARY.md — 18 Forge terms explained three ways (analogy → definition → Forge-specific context)
• docs/README.md — Documentation hub with user journey, architecture diagram, quick reference

Quality Improvements (UAT-Driven)

• Agent differentiation table — "Which Quality Agent Do I Use?" comparison (Detective vs Guardian vs Security vs Compliance vs Crucible) with speed, depth, and use-case guidance
• Cross-reference links — Pipeline breadcrumbs on Planner, Builder, Guardian showing the feature pipeline flow
• Pre-release checklist — Step-by-step release workflow with agent references and failure recovery
• Mermaid workflow diagrams — Architecture, feature pipeline, daily workflow, release process
• Anti-pattern tables — "Common Rationalizations" in Guardian and Security docs (pattern from superpowers plugin)
• Skills clarification — "You don't need to configure anything" callout at top of skills README
• Agent count fixed — C-13 updated from "23 agents" to "33 agents"
• All 13 chapter docs linked — No more orphan documentation

Plugin Updates

• Description updated to reflect governance-native positioning
• Version bump: 3.5.1 → 3.6.0