~/docs/agents-and-kit

Agents and kit

Wakii bundles a complete agentic workflow kit. It installs itself the first time the app runs — no setup, enabled by default.

The 9-agent story team

Every story run is staffed by nine specialists. Each one has a narrow job, and the checks-and-balances between them are the point:

AgentJob
phase0-impact-analystMaps blast radius before code exists — touch map, second-order effects, alternatives
spec-criticAdversarial review of the spec: ambiguity, missing edge cases, unverifiable criteria
plan-criticAdversarial review of the plan and its task dependency graph
task-executorImplements tasks in isolated worktrees, commits atomically
designerProduces high-fidelity design drafts for user review before UI gets built
code-reviewerReviews every diff for bugs, security issues, and scope creep
verifierIndependent pass/fail verdict on the finished work — self-reports don’t count
security-auditOWASP-focused audit when changes touch auth, input, or secrets
rollback-fixerReverts safely to the last known-good state when something diverges

The kit

The bundled kit (story-team-kit) carries the workflow machinery:

  • 20 skills — the skills agents load on demand: brainstorming, writing plans, executing plans, code review, story management, design pipelines, and more — including platform skills for controlling your machine and tools (computer use, orchestration, Linear integration).
  • 24 story-* CLIs — installed to ~/.claude/bin/: story-verify (gate checks), story-watchdog (stall detection), story-preflight, story-test, and the rest of the story-ops toolbox.

Installation happens automatically the first time Wakii runs — the kit is copied into ~/.claude/ and stays in sync with the app version. It is idempotent: re-running never duplicates or clobbers your local config.

License

The kit originates from the open-source superpowers project by Jesse Vincent, released under the MIT license — the same license Wakii and upstream Orca use.