gastownhall__beads/examples/formulas

Starter Formulas

Example .formula.toml files you can use as starting points.

Usage

Copy formulas to your project or user-level directory:

# Project-level (available in this project only)
cp *.formula.toml /path/to/project/.beads/formulas/

# User-level (available in all projects)
cp *.formula.toml ~/.beads/formulas/

Then list and use them:

bd formula list        # See available formulas
bd mol pour release --var version=1.2.0   # Pour into a molecule

For advanced GitHub workflows like gh-issue-to-pr and gh-pr-review, customize repo variables (repo, remotes, base branch) and quality-gate commands to match your project before first use.

Included Formulas

Formula	Description	Use as
feature-workflow	Design, implement, review, merge	Molecule (persistent)
gh-issue-to-pr	Triage a GitHub issue through implementation and PR creation	Wisp (ephemeral)
gh-pr-review	Triage and review a GitHub PR using maintainer guidelines	Wisp (ephemeral)
release	Bump version, test, tag, publish	Molecule (persistent)
quick-check	Lint, test, build sanity check	Wisp (ephemeral)

Creating Your Own

See the Formulas documentation for the full reference.