{"id":"fefcc347-a4a4-4e1d-b8d0-3c6336dd5024","shortId":"SwcBFZ","kind":"skill","title":"speckit-plan","tagline":"Execute the implementation planning workflow using the plan template to generate design artifacts.","description":"# Spec Kit Plan Skill\n\n## When to Use\n\n- The feature spec is ready and you need a technical implementation plan.\n\n## Inputs\n\n- `specs/<feature>/spec.md`\n- Repo context and `.specify/` templates\n- User-provided constraints or tech preferences (if any)\n\nIf the spec is missing, ask the user to run speckit-specify first.\n\n## Workflow\n\n1. **Setup**: Run `.specify/scripts/bash/setup-plan.sh --json` from repo root and parse JSON for FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH. For single quotes in args like \"I'm Groot\", use escape syntax: e.g 'I'\\''m Groot' (or double-quote if possible: \"I'm Groot\").\n\n2. **Load context**: Read FEATURE_SPEC and `.specify/memory/constitution.md`. Load IMPL_PLAN template (already copied).\n\n3. **Execute plan workflow**: Follow the structure in IMPL_PLAN template to:\n   - Fill Technical Context (mark unknowns as \"NEEDS CLARIFICATION\")\n   - Fill Constitution Check section from constitution\n   - Evaluate gates (ERROR if violations unjustified)\n   - Phase 0: Generate research.md (resolve all NEEDS CLARIFICATION)\n   - Phase 1: Generate data-model.md, contracts/, quickstart.md\n   - Phase 1: Update agent context by running the agent script\n   - Re-evaluate Constitution Check post-design\n\n4. **Stop and report**: Command ends after Phase 2 planning. Report branch, IMPL_PLAN path, and generated artifacts.\n\n## Phases\n\n### Phase 0: Outline & Research\n\n1. **Extract unknowns from Technical Context** above:\n   - For each NEEDS CLARIFICATION → research task\n   - For each dependency → best practices task\n   - For each integration → patterns task\n\n2. **Generate and dispatch research agents**:\n\n   ```text\n   For each unknown in Technical Context:\n     Task: \"Research {unknown} for {feature context}\"\n   For each technology choice:\n     Task: \"Find best practices for {tech} in {domain}\"\n   ```\n\n3. **Consolidate findings** in `research.md` using format:\n   - Decision: [what was chosen]\n   - Rationale: [why chosen]\n   - Alternatives considered: [what else evaluated]\n\n**Output**: research.md with all NEEDS CLARIFICATION resolved\n\n### Phase 1: Design & Contracts\n\n**Prerequisites:** `research.md` complete\n\n1. **Extract entities from feature spec** → `data-model.md`:\n   - Entity name, fields, relationships\n   - Validation rules from requirements\n   - State transitions if applicable\n\n2. **Generate API contracts** from functional requirements:\n   - For each user action → endpoint\n   - Use standard REST/GraphQL patterns\n   - Output OpenAPI/GraphQL schema to `/contracts/`\n\n3. **Agent context update**:\n   - Run `.specify/scripts/bash/update-agent-context.sh <agent_type>`\n   - Use the current runtime agent type (e.g., claude, codex, copilot, gemini). Leave empty to update all existing agent files.\n   - Update the appropriate agent-specific context file\n   - Add only new technology from current plan\n   - Preserve manual additions between markers\n\n**Output**: data-model.md, /contracts/\\*, quickstart.md, agent-specific file\n\n## Key rules\n\n- Use absolute paths\n- ERROR on gate failures or unresolved clarifications\n\n## Outputs\n\n- `specs/<feature>/plan.md` (filled implementation plan)\n- `specs/<feature>/research.md`\n- `specs/<feature>/data-model.md`\n- `specs/<feature>/contracts/` (API schemas)\n- `specs/<feature>/quickstart.md`\n- Updated agent context file (runtime-specific)\n\n## Next Steps\n\nAfter planning:\n\n- **Generate tasks** with speckit-tasks.\n- **Create a checklist** with speckit-checklist when a quality gate is needed.","tags":["speckit","plan","agent","skills","dceoy","agent-skills","ai-agents","ai-coding","claude-code","codex-cli","developer-tools","gemini-cli"],"capabilities":["skill","source-dceoy","skill-speckit-plan","topic-agent-skills","topic-ai-agents","topic-ai-coding","topic-claude-code","topic-codex-cli","topic-developer-tools","topic-gemini-cli","topic-github-copilot","topic-spec-kit","topic-specifications","topic-workflow-automation"],"categories":["speckit-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/dceoy/speckit-agent-skills/speckit-plan","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add dceoy/speckit-agent-skills","source_repo":"https://github.com/dceoy/speckit-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.488","qualityRationale":"deterministic score 0.49 from registry signals: · indexed on github topic:agent-skills · 76 github stars · SKILL.md body (3,469 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-02T06:55:43.501Z","embedding":null,"createdAt":"2026-04-18T22:13:44.952Z","updatedAt":"2026-05-02T06:55:43.501Z","lastSeenAt":"2026-05-02T06:55:43.501Z","tsv":"'/contracts':340,388,417 '/data-model.md':415 '/plan.md':408 '/quickstart.md':421 '/research.md':413 '/spec.md':38 '0':159,210 '1':68,167,173,213,295,301 '2':112,198,237,320 '3':126,268,341 '4':190 'absolut':397 'action':330 'add':374 'addit':383 'agent':175,180,242,342,351,364,370,391,423 'agent-specif':369,390 'alreadi':124 'altern':282 'api':322,418 'applic':319 'appropri':368 'arg':91 'artifact':16,207 'ask':58 'best':229,262 'branch':86,201 'check':148,186 'checklist':441,445 'choic':259 'chosen':278,281 'clarif':145,165,223,292,405 'claud':354 'codex':355 'command':194 'complet':300 'consid':283 'consolid':269 'constitut':147,151,185 'constraint':47 'context':40,114,140,176,218,249,255,343,372,424 'contract':170,297,323 'copi':125 'copilot':356 'creat':439 'current':349,379 'data-model.md':169,307,387 'decis':275 'depend':228 'design':15,189,296 'dir':85 'dispatch':240 'domain':267 'doubl':105 'double-quot':104 'e.g':99,353 'els':285 'empti':359 'end':195 'endpoint':331 'entiti':303,308 'error':154,399 'escap':97 'evalu':152,184,286 'execut':4,127 'exist':363 'extract':214,302 'failur':402 'featur':25,80,116,254,305 'field':310 'file':365,373,393,425 'fill':138,146,409 'find':261,270 'first':66 'follow':130 'format':274 'function':325 'gate':153,401,449 'gemini':357 'generat':14,160,168,206,238,321,433 'groot':95,102,111 'impl':82,121,134,202 'implement':6,34,410 'input':36 'integr':234 'json':72,78 'key':394 'kit':18 'leav':358 'like':92 'load':113,120 'm':94,101,110 'manual':382 'mark':141 'marker':385 'miss':57 'name':309 'need':31,144,164,222,291,451 'new':376 'next':429 'openapi/graphql':337 'outlin':211 'output':287,336,386,406 'pars':77 'path':204,398 'pattern':235,335 'phase':158,166,172,197,208,209,294 'plan':3,7,11,19,35,83,122,128,135,199,203,380,411,432 'possibl':108 'post':188 'post-design':187 'practic':230,263 'prefer':50 'prerequisit':298 'preserv':381 'provid':46 'qualiti':448 'quickstart.md':171,389 'quot':89,106 'rational':279 're':183 're-evalu':182 'read':115 'readi':28 'relationship':311 'repo':39,74 'report':193,200 'requir':315,326 'research':212,224,241,251 'research.md':161,272,288,299 'resolv':162,293 'rest/graphql':334 'root':75 'rule':313,395 'run':62,70,178,345 'runtim':350,427 'runtime-specif':426 'schema':338,419 'script':181 'section':149 'setup':69 'singl':88 'skill':20 'skill-speckit-plan' 'source-dceoy' 'spec':17,26,37,55,81,84,117,306,407,412,414,416,420 'specif':371,392,428 'specifi':42,65 'specify/memory/constitution.md':119 'specify/scripts/bash/setup-plan.sh':71 'specify/scripts/bash/update-agent-context.sh':346 'speckit':2,64,437,444 'speckit-checklist':443 'speckit-plan':1 'speckit-specifi':63 'speckit-task':436 'standard':333 'state':316 'step':430 'stop':191 'structur':132 'syntax':98 'task':225,231,236,250,260,434,438 'tech':49,265 'technic':33,139,217,248 'technolog':258,377 'templat':12,43,123,136 'text':243 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-claude-code' 'topic-codex-cli' 'topic-developer-tools' 'topic-gemini-cli' 'topic-github-copilot' 'topic-spec-kit' 'topic-specifications' 'topic-workflow-automation' 'transit':317 'type':352 'unjustifi':157 'unknown':142,215,246,252 'unresolv':404 'updat':174,344,361,366,422 'use':9,23,96,273,332,347,396 'user':45,60,329 'user-provid':44 'valid':312 'violat':156 'workflow':8,67,129","prices":[{"id":"093d1dd5-b366-4aeb-baf1-f2d8ee6afaff","listingId":"fefcc347-a4a4-4e1d-b8d0-3c6336dd5024","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"dceoy","category":"speckit-agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:13:44.952Z"}],"sources":[{"listingId":"fefcc347-a4a4-4e1d-b8d0-3c6336dd5024","source":"github","sourceId":"dceoy/speckit-agent-skills/speckit-plan","sourceUrl":"https://github.com/dceoy/speckit-agent-skills/tree/main/skills/speckit-plan","isPrimary":false,"firstSeenAt":"2026-04-18T22:13:44.952Z","lastSeenAt":"2026-05-02T06:55:43.501Z"}],"details":{"listingId":"fefcc347-a4a4-4e1d-b8d0-3c6336dd5024","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"dceoy","slug":"speckit-plan","github":{"repo":"dceoy/speckit-agent-skills","stars":76,"topics":["agent-skills","ai-agents","ai-coding","claude-code","codex-cli","developer-tools","gemini-cli","github-copilot","spec-kit","specifications","workflow-automation"],"license":"agpl-3.0","html_url":"https://github.com/dceoy/speckit-agent-skills","pushed_at":"2026-03-14T17:14:42Z","description":"Agent skills for Spec Kit","skill_md_sha":"7c6a8de7450d6164daf6882f9fcb7d982bdc04d1","skill_md_path":"skills/speckit-plan/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/dceoy/speckit-agent-skills/tree/main/skills/speckit-plan"},"layout":"multi","source":"github","category":"speckit-agent-skills","frontmatter":{"name":"speckit-plan","description":"Execute the implementation planning workflow using the plan template to generate design artifacts."},"skills_sh_url":"https://skills.sh/dceoy/speckit-agent-skills/speckit-plan"},"updatedAt":"2026-05-02T06:55:43.501Z"}}