{"id":"77aafa94-2df0-4ebd-a795-000e0cccb011","shortId":"EsDRV8","kind":"skill","title":"flow","tagline":"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.","description":"# Flow Router\n\nFlow 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.\n\n## Workflow\n\n1. Check hook-provided Flow context first; otherwise detect `.agents/`, Beads (`bd`), git branch, and repo-native commands.\n2. Route the request:\n   - Setup, validation, install, context initialization: use `flow-setup`.\n   - PRD, research, plan, refine, revise, task creation: use `flow-planning`.\n   - Implement, claim ready tasks, TDD, commit, task close: use `flow-execution`.\n   - Sync, status, refresh, cleanup, context drift: use `flow-sync-status`.\n   - Review, finish, archive, revert, docs, phase completion: use `flow-completion`.\n3. Record durable discoveries and task state in Beads. Markdown files are synchronized views.\n4. Prefer repo-native commands from `.agents/workflow.md` or hook context for validation.\n\n## Guardrails\n\n- Never edit task markers (`[ ]`, `[~]`, `[x]`, `[!]`, `[-]`) manually in `spec.md`.\n- Do not run backend export, auto-stage, Dolt push, or git operations through Beads unless `.agents/beads.json` allows it or the user asks.\n- Store Flow specs and planning artifacts under `.agents/specs/<flow_id>/`.\n- Make minimal targeted changes and record findings with `bd note <id> \"...\"` when work exceeds a quick fix.\n\n## Validation\n\n- For planning: verify the plan is decision-complete before presenting it.\n- For implementation: verify red-green-refactor evidence, full relevant tests, and Beads task closure before claiming completion.\n- For sync/status: read backend state first and report drift instead of guessing.\n- For this repository: run `make validate-skills` and `make validate-codex-manifest` after skill or command changes.\n\n## References Index\n\n- [Setup](../flow-setup/SKILL.md)\n- [Planning](../flow-planning/SKILL.md)\n- [Execution](../flow-execution/SKILL.md)\n- [Sync and Status](../flow-sync-status/SKILL.md)\n- [Completion](../flow-completion/SKILL.md)\n- [Discipline](references/discipline.md)\n\n## Example\n\nUser: \"Use Flow to implement the current spec.\"\n\nAction: load `flow-execution`, claim a ready Beads task, add investigation notes, follow TDD, close the task with evidence, then sync according to policy.","tags":["flow","cofin","agent-skills","ai-agents","beads","claude-code","codex","cursor","developer-tools","gemini-cli","opencode","plugin"],"capabilities":["skill","source-cofin","skill-flow","topic-agent-skills","topic-ai-agents","topic-beads","topic-claude-code","topic-codex","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-opencode","topic-plugin","topic-slash-commands","topic-spec-driven-development"],"categories":["flow"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/cofin/flow/flow","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add cofin/flow","source_repo":"https://github.com/cofin/flow","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 11 github stars · SKILL.md body (2,307 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:37.112Z","embedding":null,"createdAt":"2026-04-23T13:03:59.237Z","updatedAt":"2026-05-18T19:07:37.112Z","lastSeenAt":"2026-05-18T19:07:37.112Z","tsv":"'/flow':32 '/flow-completion/skill.md':306 '/flow-execution/skill.md':300 '/flow-planning/skill.md':298 '/flow-setup/skill.md':296 '/flow-sync-status/skill.md':304 '1':70 '2':90 '3':148 '4':162 'accord':340 'action':318 'activ':54 'add':328 'agent':7,43,80 'agents/beads.json':200 'agents/specs':214 'agents/workflow.md':169 'allow':201 'archiv':30,139 'artifact':212 'ask':11,206 'auto':190 'auto-stag':189 'back':18 'backend':187,265 'bd':82,223 'bead':17,60,81,156,198,256,326 'beads-back':16 'beads-first':59 'branch':84 'chang':218,292 'check':71 'claim':115,260,323 'cleanup':129 'close':121,333 'closur':258 'codex':286 'command':89,167,291 'commit':119 'complet':143,147,240,261,305 'context':39,76,97,130,172 'context-driven':38 'coordin':37 'creation':109 'current':316 'decis':239 'decision-complet':238 'detect':79 'develop':41 'disciplin':307 'discoveri':151 'doc':141 'dolt':192 'drift':131,270 'driven':40 'durabl':150 'edit':177 'enforc':57 'evid':251,337 'exampl':309 'exceed':227 'execut':125,299,322 'export':188 'file':158 'find':221 'finish':29,138 'first':23,61,77,267 'fix':230 'flow':1,13,34,36,75,101,112,124,134,146,208,312,321 'flow-complet':145 'flow-execut':123,320 'flow-plan':111 'flow-setup':100 'flow-sync-status':133 'follow':331 'full':252 'git':83,195 'green':249 'guardrail':175 'guess':273 'help':33 'hook':73,171 'hook-provid':72 'identifi':52 'implement':26,114,245,314 'index':294 'initi':98 'instal':96 'instead':271 'invari':62 'investig':329 'keep':45 'lifecycl':14,55,67 'load':64,319 'make':215,278,283 'manifest':287 'manual':181 'markdown':157 'marker':179 'match':66 'memori':20 'minim':216 'nativ':88,166 'never':176 'note':224,330 'oper':196 'otherwis':78 'phase':56,142 'plan':24,105,113,211,233,236,297 'polici':342 'prd':103 'prefer':163 'present':242 'provid':74 'push':193 'quick':229 'read':264 'readi':116,325 'record':149,220 'red':248 'red-green-refactor':247 'refactor':250 'refer':293 'references/discipline.md':308 'refin':106 'refresh':128 'relev':253 'repo':87,165 'repo-n':86,164 'report':269 'repositori':5,44,276 'request':93 'research':104 'revert':140 'review':28,137 'revis':107 'rout':15,91 'router':35 'run':186,277 'setup':94,102,295 'skill':47,68,281,289 'skill-flow' 'small':48 'source-cofin' 'spec':22,209,317 'spec-first':21 'spec.md':183 'stage':191 'state':154,266 'status':127,136,303 'store':207 'sync':126,135,301,339 'sync/status':27,263 'synchron':160 'target':217 'task':19,108,117,120,153,178,257,327,335 'tdd':25,118,332 'test':254 'topic-agent-skills' 'topic-ai-agents' 'topic-beads' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-opencode' 'topic-plugin' 'topic-slash-commands' 'topic-spec-driven-development' 'unless':199 'use':2,49,99,110,122,132,144,311 'user':10,205,310 'valid':95,174,231,280,285 'validate-codex-manifest':284 'validate-skil':279 'verifi':234,246 'view':161 'work':226 'workflow':69 'x':180","prices":[{"id":"96511d73-a90c-4205-bfca-e38ef0e5b215","listingId":"77aafa94-2df0-4ebd-a795-000e0cccb011","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"cofin","category":"flow","install_from":"skills.sh"},"createdAt":"2026-04-23T13:03:59.237Z"}],"sources":[{"listingId":"77aafa94-2df0-4ebd-a795-000e0cccb011","source":"github","sourceId":"cofin/flow/flow","sourceUrl":"https://github.com/cofin/flow/tree/main/skills/flow","isPrimary":false,"firstSeenAt":"2026-04-23T13:03:59.237Z","lastSeenAt":"2026-05-18T19:07:37.112Z"}],"details":{"listingId":"77aafa94-2df0-4ebd-a795-000e0cccb011","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cofin","slug":"flow","github":{"repo":"cofin/flow","stars":11,"topics":["agent-skills","ai-agents","beads","claude-code","codex","context-driven-development","cursor","developer-tools","gemini-cli","opencode","plugin","slash-commands","spec-driven-development","subagents","tdd","workflow"],"license":"apache-2.0","html_url":"https://github.com/cofin/flow","pushed_at":"2026-04-27T19:07:26Z","description":"Context-Driven Development toolkit for AI agents — spec-first planning, TDD workflow, and Beads integration.","skill_md_sha":"2a12987e7ee6121ae7ee966a1066203a43359262","skill_md_path":"skills/flow/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cofin/flow/tree/main/skills/flow"},"layout":"multi","source":"github","category":"flow","frontmatter":{"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."},"skills_sh_url":"https://skills.sh/cofin/flow/flow"},"updatedAt":"2026-05-18T19:07:37.112Z"}}