phrazzld/flywheel
skills/flywheel/SKILL.md
Outer-loop shipping orchestrator. Composes /shape, /implement, /yeet, /deliver --polish-only, /ship, and /monitor per backlog item. Closure (archive, reflect, harness routing) lives in /ship; flywheel does not invoke /reflect directly. Use when: "flywheel", "run the outer loop", "next N items", "overnight queue", "cycle". Trigger: /flywheel.
$ install --global
skillsauthnpx skillsauth add phrazzld/spellbook flywheelInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 4, 2026, 7:41 AM124.5s1 file scanned
SKILL.md
- name:
- flywheel
- description:
- |
- Use when:
- flywheel", "run the outer loop", "next N items",
- Trigger:
- /flywheel.
- argument-hint:
- [--max-cycles N]
/flywheel
Compose cycles of: pick a backlog item → /shape (if unshaped) →
/implement → /yeet → /deliver --polish-only → /ship → /monitor →
loop.
Abbreviated form using the convenience composer:
pick → /deliver → /yeet → /ship → /monitor → loop.
(/deliver = /shape → /implement → clean loop; /deliver --polish-only
runs that same clean loop on an existing branch.)
Migration: the polish step was
/settleuntil backlog 080 collapsed it into/deliver --polish-only;/settleis a deprecated redirect for one release.
You already know how to do each of these. This skill exists only to encode the invariants that aren't inferable from the leaf names.
Invariants
- Flywheel composes. Phase logic lives in the leaf skill. Flywheel has none.
- State lives in leaf receipts, git, and
backlog.d/. Flywheel has none. - If
.harness-kit/flywheel.yamlexists, load it once at cycle start with the Harness Kit config loader and use it only for cycle tuning: cadence,max_cycles, token budget, backlog include filters, and stop conditions. If absent, use invocation flags and built-in defaults. - Provider-roster behavior lives in the leaf workflow skills. If the repo has
.harness-kit/agents.yaml,/flywheelexpects two or more roster-member receipts or explicit exceptions in phase evidence, but it does not dispatch providers directly. - The cycle closeout includes the roster delegation report from
/ship, plus any provider-health follow-ups surfaced by failed or low-signal lanes. /shipowns closure: squash-merge, backlog archive,/reflect, and applying reflect's outputs. Flywheel does not invoke/reflectdirectly.- Ship before deploy. Always.
- Harness edits from reflect never touch master.
/shiproutes them toharness/reflect-outputsfor human review.
Delegation Floor
Delegation floor applies: probe the roster first; dispatch two or more
providers for substantive work; direct solo only for mechanical, emergency,
user-forbidden, or fewer-than-two-providers cases. See
harnesses/shared/AGENTS.md (Roster).
Local lane guidance: Leaf skills own dispatch; /flywheel verifies phase receipts and uses lanes only for cycle strategy, risk critique, and closure-state review.
Gotchas
/deliver's receipt is the contract — don't peer inside.- An item can be open in
backlog.d/but already shipped in git. Fix the stale entry before starting a cycle on it. - Library repos still ship + reflect when deploy/monitor no-op.
- Two
/flywheelruns in the same worktree collide on git state. Use separate worktrees for parallelism.
Non-Goals
- No cycle state machine, event enum, lock, or pick scoring.
- No direct
/reflectinvocation — that's/ship's job. - No USD tracking — the orchestrator runs under subscription. USD is a concern of systems that pay per token (e.g. ThinkTank itself).
Related Skills
phrazzld/debrief
development
VerifiedTrustedCommunity
Lightweight evidence-backed retro and catch-up reports for a current repo, branch, PR, backlog slice, or recent agent session. Use when the user asks for a debrief, catch me up, what changed, why it matters, product implications, end-user implications, developer experience implications, current app state, backlog state, workspace state, alternatives considered, or context rebuild after losing the thread. Trigger: /debrief.
13SKILL.mdUpdated Jun 5, 2026
phrazzld/trace
testing
VerifiedTrustedCommunity
Capture agent-session work records as local JSONL audit evidence. Links a backlog/spec, branch, commits, review verdicts, QA/demo evidence, transcript refs, and shipped ref without storing raw private transcripts. Use when: "trace this work", "write work record", "agent session trace", "journal this delivery", "link transcript evidence". Trigger: /trace, /journal.
13SKILL.mdUpdated Jun 4, 2026
phrazzld/skillify
data-ai
VerifiedTrustedCommunity
Turn proven agent-session patterns into first-party Harness Kit skills. Use when: "skillify this conversation", "make this into a skill", "generate a skill from current transcript", "extract reusable workflow". Trigger: /skillify.
13SKILL.mdUpdated Jun 4, 2026
phrazzld/critique
testing
VerifiedTrustedCommunity
Run one targeted, read-only architecture or quality critique through a named lens from the shared rubric. Use when: "critique this module", "run an Ousterhout pass", "lens critique", "architecture critique". Trigger: /critique.
13SKILL.mdUpdated Jun 4, 2026