cofin/flow
skills/flow/SKILL.md
Use when a repository has .agents, when the user asks for Flow lifecycle routing, Beads-backed task memory, spec-first planning, TDD implementation, sync/status, review, finish, archive, or /flow:* help.
$ install --global
skillsauthnpx skillsauth add cofin/flow flowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 5:34 AM174.2s21 files scanned
SKILL.md
- name:
- flow
- description:
- Use when a repository has .agents, when the user asks for Flow lifecycle routing, Beads-backed task memory, spec-first planning, TDD implementation, sync/status, review, finish, archive, or /flow:* help.
Flow Router
Flow coordinates Context-Driven Development in .agents/ repositories. Keep this skill small: use it to identify the active lifecycle phase, enforce the Beads-first invariants, and load the matching lifecycle skill.
Workflow
- Check hook-provided Flow context first; otherwise detect
.agents/, Beads (bd), git branch, and repo-native commands. - Route the request:
- Setup, validation, install, context initialization: use
flow-setup. - PRD, research, plan, refine, revise, task creation: use
flow-planning. - Implement, claim ready tasks, TDD, commit, task close: use
flow-execution. - Sync, status, refresh, cleanup, context drift: use
flow-sync-status. - Review, finish, archive, revert, docs, phase completion: use
flow-completion.
- Setup, validation, install, context initialization: use
- Record durable discoveries and task state in Beads. Markdown files are synchronized views.
- Prefer repo-native commands from
.agents/workflow.mdor hook context for validation.
Guardrails
- Never edit task markers (
[ ],[~],[x],[!],[-]) manually inspec.md. - Do not run backend export, auto-stage, Dolt push, or git operations through Beads unless
.agents/beads.jsonallows it or the user asks. - Store Flow specs and planning artifacts under
.agents/specs/<flow_id>/. - Make minimal targeted changes and record findings with
bd note <id> "..."when work exceeds a quick fix.
Validation
- For planning: verify the plan is decision-complete before presenting it.
- For implementation: verify red-green-refactor evidence, full relevant tests, and Beads task closure before claiming completion.
- For sync/status: read backend state first and report drift instead of guessing.
- For this repository: run
make validate-skillsandmake validate-codex-manifestafter skill or command changes.
References Index
- Setup
- Planning
- Execution
- Sync and Status
- Completion
- Discipline
Example
User: "Use Flow to implement the current spec."
Action: load flow-execution, claim a ready Beads task, add investigation notes, follow TDD, close the task with evidence, then sync according to policy.
Related Skills
cofin/flow-sync-status
testing
VerifiedTrustedCommunity
Use when syncing Beads state to markdown, checking Flow status, refreshing context docs, validating task markers, or reporting ready/blocked Flow work.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-setup
testing
VerifiedTrustedCommunity
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.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-planning
data-ai
VerifiedTrustedCommunity
Use when drafting PRDs, researching, planning, refining, revising, or creating .agents/specs/<flow_id>/spec.md worksheets for Flow.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-execution
testing
VerifiedTrustedCommunity
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.
11SKILL.mdUpdated Apr 27, 2026