From flywheel
Defines planning contract and framework slots for flywheel project setup with planning-with-files, OpenSpec, superpowers; generates feature-checklist.json
npx claudepluginhub romanticamaj/flywheel --plugin flywheelThis skill uses the workspace's default tool permissions.
Defines the contract that any planning tool must satisfy to work with flywheel, plus framework slots for three supported tools. When no external tool is installed, the built-in default generates `feature-checklist.json` directly.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Defines the contract that any planning tool must satisfy to work with flywheel, plus framework slots for three supported tools. When no external tool is installed, the built-in default generates feature-checklist.json directly.
A planning tool must produce:
All output is normalized into feature-checklist.json regardless of which tool produces it.
The Initializer prompts the user to describe features, then Claude generates .flywheel/feature-checklist.json directly. No external tool required.
| Tool | Install | Contract Mapping |
|---|---|---|
| planning-with-files | npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g | task_plan.md phases → checklist items; findings.md → acceptance criteria |
| OpenSpec | npm install openspec | /opsx:propose generates proposal.md + specs/ → checklist items with full specs |
| superpowers | Already a Claude Code plugin | brainstorming → writing-plans → plan file on disk → checklist extraction |
| Tool | How to Detect |
|---|---|
| planning-with-files | planning-with-files in installed skills list |
| OpenSpec | openspec in node_modules or global npm |
| superpowers | superpowers in Claude Code plugins |
Path: .flywheel/feature-checklist.json
{
"version": 1,
"features": [
{
"id": "feat-001",
"title": "User authentication",
"priority": 1,
"status": "pending",
"acceptance_criteria": [
"User can sign up with email/password",
"User can log in and receive a session token",
"Invalid credentials return 401"
],
"dependencies": [],
"completed_by_session": null
}
]
}
| Field | Description |
|---|---|
version | Schema version wrapper for future migration. Currently 1. |
status | Valid values: pending, in-progress, completed, blocked |
dependencies | Array of feature IDs. Used for ordering — blocked features are skipped. |
completed_by_session | null initially. Set to session timestamp (ISO 8601) on completion. |
priority | Integer. Lower number = higher priority. Coding Agent picks highest priority uncompleted item. |
completed_by_session — provides traceability back to which session completed a feature.