Skip to content
cccskills
FreePublished on GitHub

plan-to-beads

Translate a polished markdown plan into self-contained beads in .beads/beads.jsonl. Treat this as a distinct translation problem, not task extraction. Use after /plan-synthesize produces a stable hybrid plan.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/plan-to-beads — translate plan → executable memory

Bead space is different from plan space. A beautiful plan does not automatically produce a good bead graph. Treat this as a translation problem: every rich-in-context element in the plan must end up embedded in a bead, so a fresh agent can execute the bead without reopening the plan.

Plan file: $ARGUMENTS (e.g. .flywheel/plans/2026-04-20-async-validation-hybrid.md).

Prompt

Use the verbatim prompt at .flywheel/prompts/plan-to-beads.md. Point it at $ARGUMENTS.

What "good" looks like

Each new bead in .beads/beads.jsonl must have:

  • id with prefix fg- (numbering continues from the last existing bead; preserve fg-0).
  • description rich enough to execute without the plan — embed rationale, acceptance criteria, failure modes, invariants touched.
  • tests populated with concrete unit and e2e obligations.
  • correct depends_on / blocks edges.
  • labels that reflect subsystem (core, executor, tools, models, permissions, sandbox, persistence, ui, …).
  • priority on P0–P4 (0 = critical, 4 = backlog).

What NOT to do

  • Don't write pseudo-beads in a markdown document. Edit .beads/beads.jsonl directly.
  • Don't simplify. If unsure, include more context in the description, not less.
  • Don't lose features during translation. Run Operator 4 (plan-to-beads transfer audit) afterwards: .flywheel/operators/4-plan-to-beads-transfer-audit.md.

After

Run /polish-beads 4–6 times before any implementation.

Reviews

No reviews yet. Tell others what you thought.

Comments

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.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

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.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

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.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

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.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

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.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

See all skills by hoangsonww

Report a problem with this skill