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 bd invocation when the SessionStart hook reports Beads Backend: Missing (None) or Disabled via plugin config (useBeads=false). Treat spec.md markers as fallback source of truth and skip /flow:sync. Never halt for missing Beads. See ../flow/references/discipline.md.

Workflow

  1. Detect project root, existing .agents/ state, Beads availability, and repo-native commands.
  2. If Beads is missing, offer official Beads (bd) installation or no-Beads degraded mode.
  3. Initialize Flow context files from templates and prefer local-only Beads settings.
  4. Store setup decisions in Beads notes when a backend exists.
  5. Re-run setup validation before handing off to planning.

Guardrails

Installs
2
Repository
cofin/flow
GitHub Stars
15
First Seen
Jun 26, 2026
flow-setup — cofin/flow