# Flywheel

> Overview of Forge's Agentic Coding Flywheel methodology. Use to route between plan, bead, and code space. See FLYWHEEL.md at the repo root.

- Skill: `hoangsonww/flywheel` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hoangsonww/flywheel`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/flywheel/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangsonww/flywheel

---


Forge follows the Agentic Coding Flywheel: plan obsessively in
markdown, translate polished plans into self-contained beads, then
let a swarm execute.

| Phase                 | Skill / Prompt                                  |
| --------------------- | ----------------------------------------------- |
| new feature           | `plan`                                          |
| competing plans → one | `.flywheel/prompts/plan-synthesize-best-of-all-worlds.md` |
| refine plan           | `.flywheel/prompts/plan-refine.md` (4–5×)       |
| translate to beads    | `plan-to-beads`                                 |
| polish beads          | `polish-beads` (4–6×)                           |
| session reset         | start fresh + `.flywheel/prompts/fresh-eyes.md` |
| cross-agent review    | `deep-review`                                   |
| strategic drift?      | `reality-check`                                 |
| end of session        | `landing`                                       |
| post-compaction       | "Reread AGENTS.md, CLAUDE.md, FLYWHEEL.md"      |

Layered artifacts:

- `.flywheel/plans/` — plan space.
- `.beads/beads.jsonl` — bead space (source of truth once polished).
- `src/`, `test/` — code space.

Core invariants live in `FLYWHEEL.md` (the Kernel, 9 items). Read
`AGENTS.md` and `CLAUDE.md` for Forge-wide rules.