// Overview of Forge's Agentic Coding Flywheel methodology. Use to route between plan, bead, and code space. See FLYWHEEL.md at the repo root.
| name | flywheel |
| description | Overview of Forge's Agentic Coding Flywheel methodology. Use to route between plan, bead, and code space. See FLYWHEEL.md at the repo root. |
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.
Deep review — random exploration + cross-agent review, alternating. Finds integration bugs that self-review misses. Run every 30–60 min during active implementation.
End-of-session ritual. Close finished beads, file new ones for remaining work, run verify, commit in logical groupings, push. Work is not complete until git push succeeds.
Start a new Flywheel planning round. Produce initial markdown plan, route to competing frontier models, synthesize hybrid, refine 4–5×. Use before any coding begins on a new feature.
Translate a polished markdown plan into self-contained beads in .beads/beads.jsonl. Every bead must be executable without reopening the plan. Use after the plan has converged.
Polishing pass over all open beads. Run 4–6 times. "Check your beads N times, implement once." Use after plan-to-beads and between refinement rounds.
Break the spell of local productivity. Ask whether completing all open beads actually closes the gap to the project goal. Use at milestones or when busy agents feel directionally off.