# Flow Setup

> Use when initializing Flow in a repo, configuring .agents, installing or checking Beads bd, setting local-only sync policy, or creating first project context files.

- **Type:** Skill
- **Install:** `agentstack add skill-cofin-flow-flow-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cofin](https://agentstack.voostack.com/s/cofin)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [cofin](https://github.com/cofin)
- **Source:** https://github.com/cofin/flow/tree/main/skills/flow-setup

## Install

```sh
agentstack add skill-cofin-flow-flow-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

- 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`, `bd 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

- [Setup command details](../flow/references/setup.md)
- [Validate command details](../flow/references/validate.md)
- [Refresh command details](../flow/references/refresh.md)

## 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cofin](https://github.com/cofin)
- **Source:** [cofin/flow](https://github.com/cofin/flow)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cofin-flow-flow-setup
- Seller: https://agentstack.voostack.com/s/cofin
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.