Overview of Forge's Agentic Coding Flywheel methodology — plan space, bead space, code space. Invoke this skill when you need to know which Flywheel skill or prompt applies to the current phase.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Forge follows the Agentic Coding Flywheel methodology: plan obsessively in markdown, translate polished plans into self-contained beads, and only then let a swarm execute.
| If you are… | Use |
|---|---|
| starting a new feature / subsystem | /plan → write the initial plan |
| you have 2+ competing plans from different models | /plan-synthesize → GPT Pro synthesizes hybrid |
| refining a plan | .flywheel/prompts/plan-refine.md (fresh chats, 4–5×) |
| plan feels stable and complete | /plan-to-beads → create .beads/beads.jsonl |
| beads were just created | /polish-beads (run 4–6×) |
| polishing has flatlined | /fresh-eyes → new session, reload docs |
| ≥ 20 new beads were just batched in | /dedupe-beads |
| adding features to existing Forge | /idea-wizard (30 → 5 → 15 funnel) |
| swarm is running, agents finished a bead | self-review inline, then /deep-review every hour |
| swarm feels busy but directionally off | /reality-check |
| end of session | /landing → close beads, commit, push |
| agent confused after compaction | "Reread AGENTS.md, CLAUDE.md, and FLYWHEEL.md" |
.flywheel/plans/*.md (where architecture lives).beads/beads.jsonl (where execution lives)src/ + test/ (where implementation lives).claude/, .codex/, .cursor/, .agents/
(how agents behave)Once polished beads exist, the beads are the source of truth for execution. You don't keep editing the plan while agents implement.
AGENTS.md re-reads, beads).See FLYWHEEL.md at the repo root for the full methodology.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).
The English summary is being prepared. Showing the original description.
Scaffold a new model provider for Forge — class implementation, registry wiring, providerEnum entry, local-catalog classification, and unit test with mocked transport. Use for anything under src/models/.
The English summary is being prepared. Showing the original description.
Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.
The English summary is being prepared. Showing the original description.