{"id":"a64cc98a-f64d-497a-a451-274a99ac55d3","shortId":"J9Rm7h","kind":"skill","title":"writing-plans","tagline":"Structured implementation planning for multi-step development tasks. Use when you have a spec or requirements and need to break work into executable steps.","description":"# Writing Plans\n\n## Overview\n\nCreate implementation plans for an engineer with zero codebase context.\n\nEach plan includes:\n- Exact file paths for every operation\n- Complete code (not \"add validation here\")\n- Test-first approach with verification commands\n- Bite-sized steps (2-5 min each)\n\nPrinciples: DRY, YAGNI, TDD, frequent commits.\n\n**Announce at start:** \"I'm using the `writing-plans` skill to create the implementation plan.\"\n\n**Context:** Run in dedicated worktree. If none exists, use `using-git-worktrees` skill first.\n\n**Save plans to:** `docs/plans/YYYY-MM-DD-<feature-name>.md`\n\n## Before Writing\n\n1. Read spec/requirements completely\n2. Explore project structure (`view .`)\n3. Identify tech stack (package.json, pyproject.toml, etc.)\n4. Note existing patterns in similar files\n5. Check docs/ for existing conventions\n\n## Bite-Sized Task Granularity\n\nEach step is one action (2-5 minutes), independently verifiable:\n\n- \"Write the failing test\" — step\n- \"Run it to confirm failure\" — step\n- \"Implement minimal code to pass\" — step\n- \"Run tests to confirm pass\" — step\n- \"Commit\" — step\n\n## Plan Document Header\n\nEvery plan MUST start with this header:\n\n~~~markdown\n# [Feature Name] Implementation Plan\n\n**Goal:** [One sentence describing what this builds]\n\n**Architecture:** [2-3 sentences about approach]\n\n**Tech Stack:** [Key technologies/libraries]\n\n---\n~~~\n\n## Task Structure\n\n~~~markdown\n### Task N: [Component Name]\n\n**Files:**\n- Create: `exact/path/to/file.py`\n- Modify: `exact/path/to/existing.py:123-145`\n- Test: `tests/exact/path/to/test.py`\n\n**Step 1: Write the failing test**\n\n```python\ndef test_specific_behavior():\n    result = function(input)\n    assert result == expected\n```\n\n**Step 2: Run test to verify it fails**\n\nRun: `pytest tests/path/test.py::test_name -v`\nExpected: FAIL with \"function not defined\"\n\n**Step 3: Write minimal implementation**\n\n```python\ndef function(input):\n    return expected\n```\n\n**Step 4: Run test to verify it passes**\n\nRun: `pytest tests/path/test.py::test_name -v`\nExpected: PASS\n\n**Step 5: Commit**\n\n```bash\ngit add tests/path/test.py src/path/file.py\ngit commit -m \"feat: add specific feature\"\n```\n~~~\n\n## Before Handoff\n\nVerify plan completeness:\n\n- Every file path exists or will be created\n- Every command can be run exactly as written\n- No TODO/placeholder text remains\n- Tests cover all acceptance criteria from spec\n- Include exact test code, not descriptions\n\n## Execution Handoff\n\nAfter saving plan, present:\n\n**\"Plan saved to `docs/plans/<filename>.md`. Choose execution mode:**\n\n1. **Subagent-Driven** — same session, fresh subagent per task, fast iteration\n2. **Parallel Session** — new session, batched execution with checkpoints\n\n**Which approach?\"**\n\n### If Subagent-Driven chosen\n\n- Stay in this session\n- **REQUIRED SUB-SKILL:** `subagent-driven-development`\n- Fresh subagent per task + two-stage review\n\n### If Parallel Session chosen\n\n- Guide user to open new session in worktree\n- **REQUIRED SUB-SKILL:** New session uses `executing-plans`","tags":["writing","plans","agent","skills","library","codingcossack","agent-framework","agent-skills","agent-system","agent-workflow","agentic-workflow","ai-agents"],"capabilities":["skill","source-codingcossack","skill-writing-plans","topic-agent-framework","topic-agent-skills","topic-agent-system","topic-agent-workflow","topic-agentic-workflow","topic-ai-agents","topic-anthropic","topic-claude","topic-claude-code","topic-claude-skills","topic-claude-skills-hub","topic-claude-skills-libary"],"categories":["agent-skills-library"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/CodingCossack/agent-skills-library/writing-plans","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add CodingCossack/agent-skills-library","source_repo":"https://github.com/CodingCossack/agent-skills-library","install_from":"skills.sh"}},"qualityScore":"0.458","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 17 github stars · SKILL.md body (3,020 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-04-23T01:02:08.383Z","embedding":null,"createdAt":"2026-04-18T23:06:43.597Z","updatedAt":"2026-04-23T01:02:08.383Z","lastSeenAt":"2026-04-23T01:02:08.383Z","tsv":"'-145':230 '-3':209 '-5':69,156 '1':116,234,364 '123':229 '2':68,120,155,208,251,376 '3':125,271 '4':132,282 '5':139,298 'accept':340 'action':154 'add':54,302,309 'announc':78 'approach':60,212,386 'architectur':207 'assert':247 'bash':300 'batch':381 'behavior':243 'bite':65,146 'bite-s':64,145 'break':24 'build':206 'check':140 'checkpoint':384 'choos':361 'chosen':391,415 'code':52,173,347 'codebas':40 'command':63,326 'commit':77,183,299,306 'complet':51,119,316 'compon':222 'confirm':168,180 'context':41,94 'convent':144 'cover':338 'creat':32,90,225,324 'criteria':341 'dedic':97 'def':240,276 'defin':269 'describ':203 'descript':349 'develop':11,403 'doc':141 'docs/plans':359 'docs/plans/yyyy-mm-dd-':112 'document':186 'dri':73 'driven':367,390,402 'engin':37 'etc':131 'everi':49,188,317,325 'exact':45,330,345 'exact/path/to/existing.py':228 'exact/path/to/file.py':226 'execut':27,350,362,382,432 'executing-plan':431 'exist':101,134,143,320 'expect':249,264,280,295 'explor':121 'fail':162,237,257,265 'failur':169 'fast':374 'feat':308 'featur':196,311 'file':46,138,224,318 'first':59,108 'frequent':76 'fresh':370,404 'function':245,267,277 'git':105,301,305 'goal':200 'granular':149 'guid':416 'handoff':313,351 'header':187,194 'identifi':126 'implement':5,33,92,171,198,274 'includ':44,344 'independ':158 'input':246,278 'iter':375 'key':215 'm':82,307 'markdown':195,219 'md':113,360 'min':70 'minim':172,273 'minut':157 'mode':363 'modifi':227 'multi':9 'multi-step':8 'must':190 'n':221 'name':197,223,262,293 'need':22 'new':379,420,428 'none':100 'note':133 'one':153,201 'open':419 'oper':50 'overview':31 'package.json':129 'parallel':377,413 'pass':175,181,288,296 'path':47,319 'pattern':135 'per':372,406 'plan':3,6,30,34,43,87,93,110,185,189,199,315,354,356,433 'present':355 'principl':72 'project':122 'pyproject.toml':130 'pytest':259,290 'python':239,275 'read':117 'remain':336 'requir':20,396,424 'result':244,248 'return':279 'review':411 'run':95,165,177,252,258,283,289,329 'save':109,353,357 'sentenc':202,210 'session':369,378,380,395,414,421,429 'similar':137 'size':66,147 'skill':88,107,399,427 'skill-writing-plans' 'source-codingcossack' 'spec':18,343 'spec/requirements':118 'specif':242,310 'src/path/file.py':304 'stack':128,214 'stage':410 'start':80,191 'stay':392 'step':10,28,67,151,164,170,176,182,184,233,250,270,281,297 'structur':4,123,218 'sub':398,426 'sub-skil':397,425 'subag':366,371,389,401,405 'subagent-driven':365,388 'subagent-driven-develop':400 'task':12,148,217,220,373,407 'tdd':75 'tech':127,213 'technologies/libraries':216 'test':58,163,178,231,238,241,253,261,284,292,337,346 'test-first':57 'tests/exact/path/to/test.py':232 'tests/path/test.py':260,291,303 'text':335 'todo/placeholder':334 'topic-agent-framework' 'topic-agent-skills' 'topic-agent-system' 'topic-agent-workflow' 'topic-agentic-workflow' 'topic-ai-agents' 'topic-anthropic' 'topic-claude' 'topic-claude-code' 'topic-claude-skills' 'topic-claude-skills-hub' 'topic-claude-skills-libary' 'two':409 'two-stag':408 'use':13,83,102,104,430 'user':417 'using-git-worktre':103 'v':263,294 'valid':55 'verif':62 'verifi':159,255,286,314 'view':124 'work':25 'worktre':98,106,423 'write':2,29,86,115,160,235,272 'writing-plan':1,85 'written':332 'yagni':74 'zero':39","prices":[{"id":"06918e4d-0b18-47fd-87a9-d06bc4161062","listingId":"a64cc98a-f64d-497a-a451-274a99ac55d3","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"CodingCossack","category":"agent-skills-library","install_from":"skills.sh"},"createdAt":"2026-04-18T23:06:43.597Z"}],"sources":[{"listingId":"a64cc98a-f64d-497a-a451-274a99ac55d3","source":"github","sourceId":"CodingCossack/agent-skills-library/writing-plans","sourceUrl":"https://github.com/CodingCossack/agent-skills-library/tree/main/skills/writing-plans","isPrimary":false,"firstSeenAt":"2026-04-18T23:06:43.597Z","lastSeenAt":"2026-04-23T01:02:08.383Z"}],"details":{"listingId":"a64cc98a-f64d-497a-a451-274a99ac55d3","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"CodingCossack","slug":"writing-plans","github":{"repo":"CodingCossack/agent-skills-library","stars":17,"topics":["agent-framework","agent-skills","agent-system","agent-workflow","agentic-workflow","ai-agents","anthropic","claude","claude-code","claude-skills","claude-skills-hub","claude-skills-libary","code-review","codex","context-engineering","debugging","developer-workflow"],"license":null,"html_url":"https://github.com/CodingCossack/agent-skills-library","pushed_at":"2026-01-03T20:02:38Z","description":"Coding agent skills library for programming workflows | Claude Skills, Codex Skills | Forked from obra/superpower","skill_md_sha":"ae90333e7d2ca3270d01ed80fdefe2ca0710ec62","skill_md_path":"skills/writing-plans/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/CodingCossack/agent-skills-library/tree/main/skills/writing-plans"},"layout":"multi","source":"github","category":"agent-skills-library","frontmatter":{"name":"writing-plans","description":"Structured implementation planning for multi-step development tasks. Use when you have a spec or requirements and need to break work into executable steps."},"skills_sh_url":"https://skills.sh/CodingCossack/agent-skills-library/writing-plans"},"updatedAt":"2026-04-23T01:02:08.383Z"}}