Read .gromit/plans markdown files and output JSON bead definitions.
npx skills add https://github.com/danabrams/gromit --skill gromit-decompose
Please help me install this Agent Skill. Skill: gromit-decompose Source: https://github.com/danabrams/gromit/tree/main/skills/gromit-decompose Command: npx skills add https://github.com/danabrams/gromit --skill gromit-decompose
Decomposes implementation plans into bead definitions for automated creation via bd create, enabling a deterministic, machine-readable workflow from plan to beads.
Run gromit decompose on a plan to generate a machine-readable JSON bead array.
High-intent search queries and answers about installing and using this skill.
To convert a markdown plan into JSON bead definitions, use the gromit decompose tool to read the .gromit/plans/<name>.md file. It extracts the plan frontmatter and Implementation Tasks section, outputting a JSON array of bead definitions.
The bead sizing limit when decomposing implementation tasks is a strict 1-3 beads per task. This strict sizing rule ensures that each resulting bead definition represents atomic, testable work items.
Yes, you can automate bead creation from plan files without interactive prompts. The gromit decompose tool is designed for non-interactive use, reading plan files and producing only machine-readable JSON output for automated workflows.
To generate bead definitions from a plan, you need a markdown plan file located at .gromit/plans/<name>.md. The file must contain the plan frontmatter and an Implementation Tasks section for the tool to parse.
If your decomposed beads are not self-contained, ensure your plan file's Implementation Tasks section is properly structured. The tool applies strict 1-3 bead sizing rules per task to ensure beads are self-contained for automated creation via bd create.
GeneralJerelGenerate .plan.md files with YAML frontmatter and structured markdown sections.
adiomasBreak down feature requests into atomic tasks with dependencies and parallelization guidance.
danabramsOrchestrate the Gromit pipeline from Claude Code with backlog, specs, plans, and beads.
BedaBeda-GrowthDecompose plan files into Jules-sized tasks and register them in the work ledger.
