Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

flywheel

Estrellas2

Forks0

Actualizado21 de abril de 2026 a las 16:05

Outer-loop shipping orchestrator. Composes /deliver, landing, /deploy, /monitor, and /reflect cycle per backlog item, then applies reflect outputs to the harness and backlog before looping. Use when: "flywheel", "run the outer loop", "next N items", "overnight queue", "cycle". Trigger: /flywheel.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Ejecutar en Manus

Fuente

misty-step

misty-step/volume

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ejecutar en Manus

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

Explorador de archivos

2 archivos

SKILL.md

readonly

name	flywheel
description	Outer-loop shipping orchestrator. Composes /deliver, landing, /deploy, /monitor, and /reflect cycle per backlog item, then applies reflect outputs to the harness and backlog before looping. Use when: "flywheel", "run the outer loop", "next N items", "overnight queue", "cycle". Trigger: /flywheel.
argument-hint	[--max-cycles N]

/flywheel

Compose cycles of: pick from backlog.d/ → /deliver → land via /settle → /deploy (Vercel + CONVEX_DEPLOYMENT=prod:whimsical-marten-631 bunx convex deploy -y) → /monitor (/api/health, Sentry, Canary, convex logs) → /reflect cycle <id> → apply reflect's outputs to backlog.d/ and ~/.claude/projects/-Users-phaedrus-Development-volume/memory/ → loop.

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 (/deliver, /settle, /deploy, /monitor, /reflect).
State lives in leaf receipts (.agents/worktrees/<cycle-id>/receipt.json), git, and backlog.d/. Flywheel holds none in memory.
Pick lowest-open ID from backlog.d/*.md (currently 002, 003, 004, 005, 006, 007, 009, 010) unless the user names one. Move shipped items to backlog.d/_done/ during reflect, not before.
Branch per item: feat/<NNN>-<slug> or fix/<NNN>-<slug>.
Clean loop before /settle: bun run quality:full + /code-review bench + /qa (or /volume-manual-qa for user-flow changes).
Land before deploy. Always. /settle runs gh pr merge <n> --squash --auto — never direct-merge (breaks release-please sequencing).
/deploy is gated on ./scripts/verify-env.sh --prod-only. No exceptions.
Deploy order: Convex prod first, then Vercel auto-promotes on master. Receipt records SHA, tag, /api/health status, rollback handle.
/monitor holds a 10-minute grace window (30s→60s→120s cadence) before the cycle closes. Red trips → write INCIDENT-<UTC>.md, pause flywheel, hand to /diagnose. Flywheel does NOT auto-rollback.
Reflect's mutations land before the cycle closes: backlog.d/ moves, follow-up files, and harness memory updates under ~/.claude/projects/-Users-phaedrus-Development-volume/memory/. If reflect surfaces a CI gap, patch .lefthook.yml, .github/workflows/ci.yml, or dagger/src/ in the same cycle. SKILL body gaps → update .agents/skills/<name>/SKILL.md. ADR-level decisions → draft docs/adr/ADR-NNNN.md. Harness edits never touch product master.
Human gate required before /deploy on ADR-reference commits, before advancing past a red monitor, and before flipping a subscription/state-machine path live (see ADR-0006).

Gotchas

/deliver's receipt is the contract — don't peer inside. If the receipt says clean, trust it; rerun the clean loop if you don't.
An item can be open in backlog.d/ but already shipped in git (common after manual hotfix). Reconcile the stale entry into _done/ before starting a cycle on it — don't re-deliver.
Review threads live in THREE GitHub endpoints: GraphQL reviewThreads, REST /pulls/$PR/comments, and REST /issues/$PR/comments. Claude and CodeRabbit post to the third. /settle must check all three.
Two /flywheel runs in the same checkout collide on git state and on the shared Convex dev deployment. Use .agents/worktrees/ for parallel experimentation; serialize deploys against prod:whimsical-marten-631.
Convex runtime code cannot import @/lib/logger — don't let reflect file that as a "fix" action. Convex uses console.warn.
Skipping /reflect to "move faster" decays the outer loop. Two consecutive cycle failures → stop and escalate to user. Queue invalidation by user signal → stop immediately.

Non-Goals

No cycle state machine, event enum, lock, or pick scoring. The backlog order and /monitor verdict are the only signals.
No USD tracking — Volume's agents run under subscription; per-token accounting belongs to OpenRouter-billed paths, not the orchestrator.
No auto-rollback. Incident authority stays with the human gate.
No cross-item parallelism on the shared master branch. Single-threaded by default; worktrees are for experimentation, not concurrent ships.

Más de este repositorio

mismo repositorio

ship

misty-step/volume

Final mile. Take a branch from merge candidate to shipped: run the /ci + /refactor + /code-review triad in parallel subagents, integrate fixes, and repeat until the branch is lean, green, clean, and shiny. Then archive backlog ticket(s) with Closes-backlog trailers preserved into the squash merge, land it, run /reflect, and apply its outputs. Use when: "ship it", "merge and close out", "final mile", "land and reflect", "finish this ticket". Trigger: /ship.

2026-04-232

a11y

misty-step/volume

Accessibility audit, remediation, and verification. WCAG 2.2 AA compliance. Three-agent protocol: audit (find issues) → remediate (fix them) → critique (verify fixes). Use when: "accessibility audit", "a11y", "WCAG", "screen reader", "keyboard navigation", "contrast check", "aria fix", "accessibility sprint", "audit accessibility", "fix accessibility", "a11y issues", "a11y check". Trigger: /a11y

2026-04-232

misty-step/volume

Audit a repo's CI gates, strengthen what is weak, then drive the pipeline green. Owns confidence in correctness — lint, types, tests, coverage, secrets. Dagger is the canonical pipeline owner; absence is auto-scaffolded, not escalated. Acts on its assessment; never returns a report where action would suffice. Never returns red without a structured diagnosis. Bounded self-heal: auto-fix lint/format, regenerate lockfiles, retry flakes. Escalates only genuine algorithm/logic failures. Use when: "run ci", "check ci", "fix ci", "audit ci", "is ci passing", "run the gates", "dagger check", "why is ci failing", "strengthen ci", "tighten ci", "ci is red", "gates failing". Trigger: /ci, /gates.

2026-04-232

deps

misty-step/volume

Analyze, test, and upgrade dependencies. One curated PR, not 47 version bumps. Reachability analysis, behavioral diffs, risk assessment. Package-manager agnostic. Use when: "upgrade deps", "dependency audit", "check for updates", "outdated packages", "security audit deps", "update dependencies", "vulnerable dependencies", "deps". Trigger: /deps.

2026-04-232

groom

misty-step/volume

Backlog management, brainstorming, architectural exploration, project bootstrapping. File-driven backlog via backlog.d/. Parallel investigation bench, synthesis protocol, themed recommendations. Product vision + technical excellence. Use when: backlog session, "groom", "what should we build", "rethink this", "biggest opportunity", "backlog", "prioritize", "tidy", "scaffold". Trigger: /groom, /backlog, /rethink, /moonshot, /scaffold, /tidy.

2026-04-232

misty-step/volume

Browser-based QA, exploratory testing, evidence capture, and bug reporting. Drive running applications and verify they work — not just that tests pass. Use when: "run QA", "test this", "verify the feature", "exploratory test", "check the app", "QA this PR", "capture evidence", "manual testing", "scaffold qa", "generate qa skill". Trigger: /qa.

2026-04-232

name	flywheel
description	Outer-loop shipping orchestrator. Composes /deliver, landing, /deploy, /monitor, and /reflect cycle per backlog item, then applies reflect outputs to the harness and backlog before looping. Use when: "flywheel", "run the outer loop", "next N items", "overnight queue", "cycle". Trigger: /flywheel.
argument-hint	[--max-cycles N]

/flywheel

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 (/deliver, /settle, /deploy, /monitor, /reflect).
State lives in leaf receipts (.agents/worktrees/<cycle-id>/receipt.json), git, and backlog.d/. Flywheel holds none in memory.
Pick lowest-open ID from backlog.d/*.md (currently 002, 003, 004, 005, 006, 007, 009, 010) unless the user names one. Move shipped items to backlog.d/_done/ during reflect, not before.
Branch per item: feat/<NNN>-<slug> or fix/<NNN>-<slug>.
Clean loop before /settle: bun run quality:full + /code-review bench + /qa (or /volume-manual-qa for user-flow changes).
Land before deploy. Always. /settle runs gh pr merge <n> --squash --auto — never direct-merge (breaks release-please sequencing).
/deploy is gated on ./scripts/verify-env.sh --prod-only. No exceptions.
Deploy order: Convex prod first, then Vercel auto-promotes on master. Receipt records SHA, tag, /api/health status, rollback handle.
/monitor holds a 10-minute grace window (30s→60s→120s cadence) before the cycle closes. Red trips → write INCIDENT-<UTC>.md, pause flywheel, hand to /diagnose. Flywheel does NOT auto-rollback.
Reflect's mutations land before the cycle closes: backlog.d/ moves, follow-up files, and harness memory updates under ~/.claude/projects/-Users-phaedrus-Development-volume/memory/. If reflect surfaces a CI gap, patch .lefthook.yml, .github/workflows/ci.yml, or dagger/src/ in the same cycle. SKILL body gaps → update .agents/skills/<name>/SKILL.md. ADR-level decisions → draft docs/adr/ADR-NNNN.md. Harness edits never touch product master.
Human gate required before /deploy on ADR-reference commits, before advancing past a red monitor, and before flipping a subscription/state-machine path live (see ADR-0006).

Gotchas

/deliver's receipt is the contract — don't peer inside. If the receipt says clean, trust it; rerun the clean loop if you don't.
An item can be open in backlog.d/ but already shipped in git (common after manual hotfix). Reconcile the stale entry into _done/ before starting a cycle on it — don't re-deliver.
Review threads live in THREE GitHub endpoints: GraphQL reviewThreads, REST /pulls/$PR/comments, and REST /issues/$PR/comments. Claude and CodeRabbit post to the third. /settle must check all three.
Two /flywheel runs in the same checkout collide on git state and on the shared Convex dev deployment. Use .agents/worktrees/ for parallel experimentation; serialize deploys against prod:whimsical-marten-631.
Convex runtime code cannot import @/lib/logger — don't let reflect file that as a "fix" action. Convex uses console.warn.
Skipping /reflect to "move faster" decays the outer loop. Two consecutive cycle failures → stop and escalate to user. Queue invalidation by user signal → stop immediately.

Non-Goals

No cycle state machine, event enum, lock, or pick scoring. The backlog order and /monitor verdict are the only signals.
No USD tracking — Volume's agents run under subscription; per-token accounting belongs to OpenRouter-billed paths, not the orchestrator.
No auto-rollback. Incident authority stays with the human gate.
No cross-item parallelism on the shared master branch. Single-threaded by default; worktrees are for experimentation, not concurrent ships.