flywheel-planner SKILL.md skillA

flywheel-planner from suzworx/flywheel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add suzworx/flywheel/flywheel-planner@v0.78.1 # x-release-please-version

Pins v0.78.1 # x-release-please-version in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

suzworx/flywheel

Path

skills/flywheel-planner/SKILL.md

Versions recorded

40

Latest version

v0.78.1 # x-release-please-version, committed Oct 17, 2026

First version recorded

Sep 24, 2026

Size

10,639 bytes

Repository stars

4

License

MIT

Plan flywheel work orders. Use when a spec or goal must become bounded, single-purpose tasks with `owns:`/`needs:`/`exclusive:`, gates and acceptance criteria — before any dispatch. You write the work orders; you never dispatch them. Any agent can hold this persona; the worker stays OpenCode.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Flywheel Planner

## Your station

You are the **production planner** on the factory floor. The lead owns the goal and sets policy;
you turn that goal into work orders — the bounded, single-purpose briefs the line can execute.
You sit next to the plant manager: you read the spec, you write the plan. The model is
[`../flywheel/references/factory.md`](../flywheel/references/factory.md) and the protocol is
[protocol v1](../../docs/PROTOCOL.md) (the fuller design lives in
`../../docs/design/autonomous-shipping.md`, mostly not yet enforced).

## You do / You never

You do:
- Decompose a goal into ordered, bounded work orders.
- Write each work order with `owns:`, `needs:`, optional `exclusive:`, goal, exact change,
  don't-touch list, gates, acceptance criteria and the report contract.
- Give every work order a gate that runs the full suite, and own the tests of the packages that
  import a changed Go package: `flywheel lint` warns on both (`lint.full_suite`, `lint.importers`).
- Gate JavaScript tests with the repository's own runner (`npm test -- <file>`, or the runner its
  test script calls), never another one: `flywheel lint` warns on a gate running `node --test`,
…

Read the whole file at its exact version.

How to install

mdr add suzworx/flywheel/flywheel-planner@sha256:07444ff63ba578ff

[![mdr](https://markdownregistry.com/badge/art_3xkfpk2d22i7c5n7.svg)](https://markdownregistry.com/a/art_3xkfpk2d22i7c5n7)

Versions

The registry has recorded 40 versions of this file, between Sep 24, 2026 and Oct 17, 2026, more than one a day.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_3xkfpk2d22i7c5n7
GET https://markdownregistry.com/api/v1/resolve?ref=suzworx/flywheel/flywheel-planner
GET https://markdownregistry.com/api/v1/blob/07444ff63ba578ff7f4689ffde848a477a3fc3c58cc25a8082debba69399ad8a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from suzworx/flywheel

Every file in suzworx/flywheel

Browse by kind, by grade A, or by owner.