Skip to content

Quick Start

Install and scaffold

# One-shot (no install needed)
uvx wolverine-kit init my-project --agent claude

# Or install persistently
uv tool install wolverine-kit
wk init my-project --agent claude

Only prerequisite: uv.

Fill in your spec

After scaffolding, you have a spec/ directory with stub files. Start with these three:

  1. spec/INVARIANTS.md - your non-negotiable rules
  2. spec/DECISIONS.md - binding architectural choices
  3. spec/ARCHITECTURE.md - module boundaries and structure

Run your first check

/wk-check

The guardian reads your invariants and decisions, then checks the current state of your project against them.

Implement a module

/wk-impl auth

This runs the full gate chain:

  1. Guardian verifies the proposal is spec-compliant
  2. Spec-synthesizer produces a brief
  3. Test-author generates test specifications
  4. Implementation begins (only if all gates pass)

Record a decision

When the guardian emits NEEDS-DECISION, record the resolution:

/wk-decision Use JWT for session tokens

The agent asks for details, drafts the ADR, and propagates it through your spec files.

Update after upgrading wolverine-kit

wk update

Your spec/ files are never touched. Only managed agent/command files are regenerated.