Agents¶

Wolverine Kit ships 10 agents with every scaffold. They are managed files (regenerated on wk update) and live in .claude/agents/.

Stewardship Agents¶

Guardian¶

Veto gate for any implementation or tech decision. Reads INVARIANTS.md, DECISIONS.md, and NFR.md. Returns PASS, BLOCK, or NEEDS-DECISION.

Drift Detector¶

Scans implementation for divergence after spec changes. Reports BREAKS, NEEDS UPDATE, and NO ACTION items with specific fix instructions.

Phase Tracker¶

Reads ROADMAP.md and reports progress. Identifies blocked items, stale checkboxes, and cross-phase dependencies.

Architect Reviewer¶

Holistic spec quality review. Checks invariant completeness, ADR coverage, module boundary integrity, roadmap sequencing, and cross-file consistency.

Glossary Steward¶

Scans spec files for terminology inconsistencies and glossary gaps.

Delivery Agents¶

Spec Synthesizer¶

Produces implementation briefs from spec files. Outputs READY (implementable) or DRAFT (with blockers that must be resolved first).

Test Author¶

Generates Given/When/Then test specifications from a READY brief. Does not write test code.

Authoring Agents¶

Decision Author¶

Drafts ADRs and propagates them through the spec document set.

Change Propagator¶

After a manual spec edit, fans the change across all related documents and verifies consistency.

Dependency Auditor¶

Checks project dependencies for available upgrades. Optionally runs tests against new versions and produces a categorized report (NO CHANGE / MINOR / BREAKING).

Pack Agents¶

Python Protocol Validator (python-library pack)¶

Validates that Python classes correctly implement their declared protocols (typing.Protocol, ABCs). Only included when --pack python-library is specified.