yf-beads-authoring

Conventions for building Claude Code skills that orchestrate work through beads (bd): formula authoring (.formula.toml), `bd mol pour` lifecycle, dynamic fan-out, agent metadata wiring, the coordinator dispatch loop, the coordinator resilience contract (crash/resume recovery, stuck-bead sweep, completion handoff), and the `coordinate` subcommand with gate auto-detection.

At a glance

• Category: beads
• Invocation: auto (fires from its description conditions when relevant work appears)
• Requires tools: bd
• Depends on skills: yf-beads-extra
• Depended on by: yf-plan, yf-research
• Source: SKILL.md · README.md

When it fires

creating or modifying a beads-backed skill, authoring a `.formula.toml`, wiring `bd mol pour` into a SKILL.md, implementing a coordinator agent, designing crash-recovery/resume for a re-invokable coordinator, or designing gate-resolution flow for a multi-session skill.

When to skip it

routine `bd` CLI use (use `beads`), direct-CLI gotchas (use `yf-beads-extra`), or non-beads skills.

---

Prerequisites

The conventions assume the tooling every beads-backed skill needs:

Tool	Version	Install
bd	>= 1.1.0	https://github.com/gastownhall/beads
uv	any	https://docs.astral.sh/uv/
git	any	system package manager

No init step — this skill ships no protocols/ rule and writes no config or state.

Usage

Not user-invocable. Triggers automatically when creating or modifying a beads-backed skill, authoring a .formula.toml, wiring bd mol pour into a SKILL.md, implementing a coordinator agent, or designing gate-resolution flow. Skips routine bd CLI use (defer to beads) and non-beads skills.

After authoring or modifying a beads-backed skill, run the review checklist in agents/reviewer.md — it walks the anti-patterns read-only over the skill's SKILL.md + agents/*.md + spec/*.md + formulas/*.toml and returns findings for the caller to fix.

Phase model

None. This is an instruction-only reference skill with no phases or state transitions.