Draft Spec

Draft a review-ready Markdown product or implementation specification from the current conversation and repository context without publishing it. Use when the user asks to draft a spec, PRD, requirements summary, or design document for review; do not use for issue-tracker publication.

sciman-top a2384ad 2 files · 1.5 KB Updated

File contents

Draft Spec

Turn the context already available into a concise, reviewable Markdown draft.

Output

Return the draft in the response with these sections:

  1. Problem statement
  2. Goals and non-goals
  3. User stories or user-visible outcomes
  4. Requirements and implementation decisions
  5. Acceptance criteria and test strategy
  6. Risks, assumptions, and open questions
  7. Publication handoff (what still needs approval or tracker configuration)

Use repository terminology and existing ADRs when they are available. Separate facts, decisions, assumptions, and unanswered questions. Prefer observable behavior and seams over speculative file-by-file plans.

Side-effect boundary

This is a draft-only skill. Do not call an issue tracker, create labels or links, invoke to-spec/to-tickets, or create or modify repository files. If the user later asks to publish the draft, hand off to an explicit $to-spec invocation after the user has reviewed it.

sciman-top/skills-manager/tree/main/overrides/custom/draft-spec commit a2384addad

Frequently asked questions

npx skillmds@latest add sciman-top/draft-spec