zsl

ZSL Superpowers

Agent skills for real engineering, not vibe coding. Small, composable, model-agnostic — adapt them to your repo instead of letting a process framework take over.

📖 Full guide: superpowers.zsl.dev

[!IMPORTANT] Built for Claude Code. Skills depend on Claude Code's slash commands, /plugin install path, and tool surface (Agent, Monitor, Bash, SendMessage, TaskStop). They aren't drop-in for Cursor, Codex, Cline, or general LLM chat. ("Model-agnostic" above means any Claude model — Opus, Sonnet, Haiku — not any harness.) See Compatibility for what porting would look like.

Workflow

The skills compose into one end-to-end loop. Most days you only touch a few of them.

One-time setup

• /setup-zsl-superpowers — configure the issue tracker, triage label vocabulary, domain doc layout, and ship style for this repo. Run once before anything else.

Plan

• /grill-me or /grill-with-docs — interview yourself to surface what you're actually building. grill-with-docs also updates CONTEXT.md and ADRs inline.
• /to-prd — synthesise that conversation into a PRD on the issue tracker.

Break down

• /to-issues — break the PRD into vertical-slice sub-issues. Children are labeled needs-triage; the PRD parent is auto-relabeled to tracking. Slice titles use the [AFK|HITL] <wave>[<letter>] — <description> format so the dependency graph reads at a glance (same wave = runnable in parallel).
• /triage — triage each child to ready-for-agent (with an agent brief), ready-for-human, or needs-info. Skip triaging the PRD itself; you just wrote it.

Build

• /human-itl <PRD> — clear all [HITL] slices first: the manual actions a coding agent can't perform (console clicks, credential rotation, sign-off). Records each as an audit-trail comment, marks them done. Must be cleared before /tdd-parallel, not interleaved — the auto-pipeline refuses to start with any [HITL] open. Hard-refuses slices that are really decisions in disguise (those belong upstream in /grill-with-docs + an ADR).
• /tdd-parallel <PRD> — full-auto pipeline from a PRD to a pushed integration PR. Fans out the unblocked [AFK] ready-for-agent children into parallel /tdd sub-agents in worktrees (/tdd --no-ship). The orchestrator merges every slice branch onto the PRD branch in wave order with --no-ff, runs an integration /code-review --auto (step 4a), auto-chains /verify-coverage --auto (step 4b), and auto-fixes any gaps it finds — gap sub-issues land as ready-for-agent and re-fanout in the next round; loop iterates until gap=0 or a circuit breaker fires (--max-coverage-rounds, default 3). On clean coverage, step 4c delegates the defensive commit to /commit then pushes and opens one consolidated integration PR. Pre-flight (1d) refuses up front if any [HITL] is open or any user story isn't acceptance: automatable — both gates ensure the post-invocation pipeline runs through to PR-push with no human gates in the happy path. PR-style repos only.
• /tdd <child> — single-issue red-green-refactor. Refuses if you point it at a container. On local-markdown trackers, you can also call it with no argument — it scans .scratch/, resolves each open issue's ## Blocked by against the issues/done/ archive, and lets you pick from the unblocked ones.

Verify

• /verify-coverage <PRD> — check every PRD ## User Stories entry against the implemented code via tests, not prose. Tier A maps each story to a passing behavioral test; for stories with none, Tier B generates one from the story's observable: tag, mutation-proves it non-vacuous, and runs it. Quarantines failing tests, auto-files gaps as sub-issues of the PRD, and writes a coverage receipt against the verified sha. Almost always chained by /tdd-parallel step 4b in --auto mode (gaps filed as ready-for-agent directly, no triage hop; the orchestrator loops on them). Direct user invocation is for auditing PRDs whose slices shipped via a different path. The human-attestation HITL lane has been removed — non-automatable stories are refused at /to-prd time, so visual/UX/external work goes through a separate manual path that doesn't touch /tdd-parallel.

Ship