plan-to-beads

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.

Jump to install

Repository: hoangsonww/Forge-Agentic-Coding-CLI
Last source activity: April 21, 2026 at 20:38
Detected SKILL.md language: English
Stars: 22
Forks: 9

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/hoangsonww/Forge-Agentic-Coding-CLI --skill plan-to-beads

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

name	plan-to-beads
description	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.

Treat this as a translation problem, not task extraction.

Use the verbatim prompt at .flywheel/prompts/plan-to-beads.md, pointing it at the target plan file in .flywheel/plans/.

Each new bead in .beads/beads.jsonl requires:

id with fg- prefix (continue from the last existing number; preserve fg-0),
type, status, priority (P0–P4), labels,
depends_on and blocks edges,
description rich enough to execute without the plan (rationale, acceptance criteria, failure modes, Forge invariants touched),
tests list with concrete unit and e2e obligations,
created_at (ISO-8601 UTC).

Do NOT write pseudo-beads in markdown. Edit .beads/beads.jsonl directly.

Do NOT simplify during translation. If unsure, embed more context.

After: run polish-beads 4–6 times. If 20+ beads were added, also run .flywheel/prompts/dedupe-beads.md.

Back to search Back to installation

deep-review

Deep review — random exploration + cross-agent review, alternating. Finds integration bugs that self-review misses. Run every 30–60 min during active implementation.

2026-04-21

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.

2026-04-21

landing

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.

2026-04-21

View all from this repository

name	plan-to-beads
description	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.

Treat this as a translation problem, not task extraction.

Use the verbatim prompt at .flywheel/prompts/plan-to-beads.md, pointing it at the target plan file in .flywheel/plans/.

Each new bead in .beads/beads.jsonl requires:

id with fg- prefix (continue from the last existing number; preserve fg-0),
type, status, priority (P0–P4), labels,
depends_on and blocks edges,
description rich enough to execute without the plan (rationale, acceptance criteria, failure modes, Forge invariants touched),
tests list with concrete unit and e2e obligations,
created_at (ISO-8601 UTC).

Do NOT write pseudo-beads in markdown. Edit .beads/beads.jsonl directly.

Do NOT simplify during translation. If unsure, embed more context.

After: run polish-beads 4–6 times. If 20+ beads were added, also run .flywheel/prompts/dedupe-beads.md.

plan-to-beads

Source facts

Install options

Review the source files

More from this repository

More from this repository