Skill

flow-setup

Initializes Flow in repos: detects root, sets up .agents/, checks/installs Beads (bd), configures local-only sync policy, creates context files, validates setup.

Git

Markdown

developer-tools

git-workflow

npx claudepluginhub cofin/flow --plugin flow

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Use this lifecycle skill for project initialization, installation checks, setup validation, and first context files.

Supporting Assets

agents/openai.yaml

SKILL.md

Similar Skills

flow

Routes Flow lifecycle phases in .agents/ repositories: detects context, enforces Beads invariants, loads skills for setup, planning, TDD execution, sync/status, review, and completion.

20 files

flow

setup

Sets up CWF environment: selects hook groups, detects external tools, bootstraps setup-contract and project config, enables optional Agent Teams, Codex integration, git hooks, capability and repo indexes.

18 files

cwf

repo-setup

Detects single-project or monorepo structure, creates .groundwork.yml config for monorepos, updates .gitignore, and persists project selection for Groundwork.

groundwork

Stats

Stars11

Forks4

Last CommitApr 26, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Flow Setup

Use this lifecycle skill for project initialization, installation checks, setup validation, and first context files.

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.

Guardrails

Prefer .git/info/exclude for local-only ignores.

Do not edit .gitignore unless the user wants shared repository policy.

Do not run bd dolt push, export, or auto-stage unless policy explicitly allows it.

Keep setup idempotent; preserve existing user context files and merge rather than overwrite.

Validation

Confirm .agents/ root, workflow.md, patterns.md, knowledge/index.md, and Beads config existence when setup is expected.

Confirm Beads config defaults are local-only: no git ops, no auto export, and no auto git add.

Run repository validation commands documented in .agents/workflow.md or hook context.

References Index

Example

User: "Use Flow to set up this repo."

Action: detect the repo root, initialize .agents/, configure local-only Beads, capture setup notes, validate files, then hand off to flow-planning for the first flow.

Flow Setup

Use this lifecycle skill for project initialization, installation checks, setup validation, and first context files.

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.

Guardrails

Prefer .git/info/exclude for local-only ignores.
Do not edit .gitignore unless the user wants shared repository policy.
Do not run bd dolt push, export, or auto-stage unless policy explicitly allows it.
Keep setup idempotent; preserve existing user context files and merge rather than overwrite.

Validation

Confirm .agents/ root, workflow.md, patterns.md, knowledge/index.md, and Beads config existence when setup is expected.
Confirm Beads config defaults are local-only: no git ops, no auto export, and no auto git add.
Run repository validation commands documented in .agents/workflow.md or hook context.

References Index

Example

User: "Use Flow to set up this repo."

Action: detect the repo root, initialize .agents/, configure local-only Beads, capture setup notes, validate files, then hand off to flow-planning for the first flow.