flow-setup
Installation
SKILL.md
Flow Setup
Use this lifecycle skill for project initialization, installation checks, setup validation, and first context files.
Beads mode: Skip every
bdinvocation when the SessionStart hook reportsBeads Backend: Missing (None)orDisabled via plugin config (useBeads=false). Treatspec.mdmarkers as fallback source of truth and skip/flow:sync. Never halt for missing Beads. See../flow/references/discipline.md.
Workflow
- Detect project root, existing
.agents/state, Beads availability, and repo-native commands. - If Beads is missing, offer official Beads (
bd) installation or no-Beads degraded mode. - Initialize Flow context files from templates and prefer local-only Beads settings.
- Store setup decisions in Beads notes when a backend exists.
- Re-run setup validation before handing off to planning.