# Flow Execution

> Use when implementing Flow tasks from Beads or spec.md, claiming ready work, applying TDD, recording task notes, committing, and syncing after task state changes.

- **Type:** Skill
- **Install:** `agentstack add skill-cofin-flow-flow-execution`
- **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-execution

## Install

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

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

## About

# Flow Execution

Use this lifecycle skill when implementation starts after a Flow plan or ready Beads task exists.

> **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. Select ready work from `bd ready` and claim it before editing.
2. Read the relevant spec, notes, patterns, affected files, and validation commands.
3. Record investigation findings with `bd note`.
4. Follow red-green-refactor: write the failing test, verify the failure, implement minimally, verify green, then refactor.
5. Commit targeted changes, close the Beads task with evidence, and sync markdown when policy requires it.

## Guardrails

- Do not manually edit task status markers in markdown.
- Do not skip failing-test evidence for behavior changes.
- Do not silently descope messy tasks; refine or ask how to prioritize.
- Preserve unrelated user changes and keep edits scoped to the claimed task.

## Validation

- Verify the new test failed for the intended reason before implementation.
- Run focused tests after each task and the repo’s aggregate verification before phase completion.
- Record test output, commit reference, and closure reason in Beads.

## References Index

- [Implement](../flow/references/implement.md)
- [Discipline](../flow/references/discipline.md)

## Example

User: "Implement auth flow."

Action: claim the next ready Beads task, add code-path notes, write a failing auth test, implement the minimal behavior, verify, commit, close the task, and sync.

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