{"id":"cabb7a1f-3bd1-4648-9fbb-c5ce25288075","shortId":"mMJkQ7","kind":"skill","title":"flow-planning","tagline":"Use when drafting PRDs, researching, planning, refining, revising, or creating .agents/specs/<flow_id>/spec.md worksheets for Flow.","description":"# Flow Planning\n\nUse this lifecycle skill for PRDs, research, single-flow planning, refinement, revisions, and task creation.\n\n## Workflow\n\n1. Read project context, patterns, knowledge chapters, and relevant existing specs before asking questions.\n2. Research code paths and external APIs before locking implementation decisions.\n3. Create PRDs as roadmap epics and single-flow specs as implementation worksheets.\n4. Refine until tasks include concrete files, behavior, tests, commands, and acceptance criteria.\n5. Create Beads epics/tasks and sync markdown views according to policy.\n\n## Guardrails\n\n- Planning must be decision-complete; do not defer obvious research to implementation.\n- Ask only product or tradeoff questions that cannot be answered from the repo.\n- Store plans under `.agents/specs/<flow_id>/`, not ad hoc docs paths.\n- Do not modify production code during planning.\n\n## Validation\n\n- Confirm every requirement maps to an implementation task and test scenario.\n- Confirm tasks are small enough for a low-context executor to complete without guessing.\n- Run spec review or code-reviewer validation before presenting final planning artifacts when available.\n\n## References Index\n\n- [PRD](../flow/references/prd.md)\n- [Plan](../flow/references/plan.md)\n- [Research](../flow/references/research.md)\n- [Refine](../flow/references/refine.md)\n- [Revise](../flow/references/revise.md)\n- [Task](../flow/references/task.md)\n\n## Example\n\nUser: \"Plan skill trigger optimization.\"\n\nAction: inspect current skills and validators, ask unresolved product tradeoffs, create a Flow spec with Beads tasks, and refine until the implementation path is explicit.","tags":["flow","planning","cofin","agent-skills","ai-agents","beads","claude-code","codex","cursor","developer-tools","gemini-cli","opencode"],"capabilities":["skill","source-cofin","skill-flow-planning","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-planning","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 (1,661 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:36.819Z","embedding":null,"createdAt":"2026-04-27T01:03:21.944Z","updatedAt":"2026-05-18T19:07:36.819Z","lastSeenAt":"2026-05-18T19:07:36.819Z","tsv":"'/flow/references/plan.md':191 '/flow/references/prd.md':189 '/flow/references/refine.md':195 '/flow/references/research.md':193 '/flow/references/revise.md':197 '/flow/references/task.md':199 '/spec.md':15 '1':38 '2':52 '3':63 '4':77 '5':90 'accept':88 'accord':98 'action':206 'ad':133 'agents/specs':14,131 'answer':124 'api':58 'artifact':183 'ask':50,115,212 'avail':185 'bead':92,221 'behavior':84 'cannot':122 'chapter':44 'code':54,141,176 'code-review':175 'command':86 'complet':107,168 'concret':82 'confirm':145,156 'context':41,165 'creat':13,64,91,216 'creation':36 'criteria':89 'current':208 'decis':62,106 'decision-complet':105 'defer':110 'doc':135 'draft':6 'enough':160 'epic':68 'epics/tasks':93 'everi':146 'exampl':200 'executor':166 'exist':47 'explicit':230 'extern':57 'file':83 'final':181 'flow':2,18,19,30,72,218 'flow-plan':1 'guardrail':101 'guess':170 'hoc':134 'implement':61,75,114,151,227 'includ':81 'index':187 'inspect':207 'knowledg':43 'lifecycl':23 'lock':60 'low':164 'low-context':163 'map':148 'markdown':96 'modifi':139 'must':103 'obvious':111 'optim':205 'path':55,136,228 'pattern':42 'plan':3,9,20,31,102,129,143,182,190,202 'polici':100 'prd':188 'prds':7,26,65 'present':180 'product':117,140,214 'project':40 'question':51,120 'read':39 'refer':186 'refin':10,32,78,194,224 'relev':46 'repo':127 'requir':147 'research':8,27,53,112,192 'review':173,177 'revis':11,33,196 'roadmap':67 'run':171 'scenario':155 'singl':29,71 'single-flow':28,70 'skill':24,203,209 'skill-flow-planning' 'small':159 'source-cofin' 'spec':48,73,172,219 'store':128 'sync':95 'task':35,80,152,157,198,222 'test':85,154 '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' 'tradeoff':119,215 'trigger':204 'unresolv':213 'use':4,21 'user':201 'valid':144,178,211 'view':97 'without':169 'workflow':37 'worksheet':16,76","prices":[{"id":"529b0681-0154-4e93-86ff-0150e05602ea","listingId":"cabb7a1f-3bd1-4648-9fbb-c5ce25288075","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-27T01:03:21.944Z"}],"sources":[{"listingId":"cabb7a1f-3bd1-4648-9fbb-c5ce25288075","source":"github","sourceId":"cofin/flow/flow-planning","sourceUrl":"https://github.com/cofin/flow/tree/main/skills/flow-planning","isPrimary":false,"firstSeenAt":"2026-04-27T01:03:21.944Z","lastSeenAt":"2026-05-18T19:07:36.819Z"}],"details":{"listingId":"cabb7a1f-3bd1-4648-9fbb-c5ce25288075","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cofin","slug":"flow-planning","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":"e680c713afa2beadaa89898ba956d6be616b4b22","skill_md_path":"skills/flow-planning/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cofin/flow/tree/main/skills/flow-planning"},"layout":"multi","source":"github","category":"flow","frontmatter":{"name":"flow-planning","description":"Use when drafting PRDs, researching, planning, refining, revising, or creating .agents/specs/<flow_id>/spec.md worksheets for Flow."},"skills_sh_url":"https://skills.sh/cofin/flow/flow-planning"},"updatedAt":"2026-05-18T19:07:36.819Z"}}