define-spec
Use when the user wants to turn a project idea, feature request, bug, or vague goal into a concise implementation-ready spec. Triggered by phrases like "create a spec", "write a spec", "define this pr
SKILL.mdskills/project-management/define-spec/SKILL.md
GitHubDefine Spec
Announce at start: Defining spec...
Create a short, decision-oriented spec that can be broken into tasks.
Process
- Read existing context before asking questions:
AGENTS.mdis already in context; read only the Context Map rows this task needs - the rows that match the idea, never the wholecontext/tree. If the harness has not already loadedAGENTS.md, read it once.README.md- any linked issue, ticket, note, or existing spec
- Ask only for missing product or behavior decisions. Keep questions concrete.
- Save the spec to:
~/.agents/specs/<repo>/YYYY-MM-DD-<slug>.md
- If the user explicitly asks for repo-local docs, save under the repo instead.
- After saving, show the path and a 3-5 bullet summary. Do not dump the full spec in chat.
Spec Format
# <Spec Title>
Date: YYYY-MM-DD
Repo: <repo>
## Goal
<What the user gets. One short paragraph.>
## Stakeholders / Systems
- <who or what uses, owns, or depends on this>
## Scope
- <included behavior>
## Out of Scope
- <explicit exclusions>
## Requirements
- <observable behavior or system rule>
## Acceptance Criteria
- <testable outcome>
## Open Questions
- <question or "None.">
Rules
- Keep the spec concise. Prefer bullets over prose.
- Omit sections that genuinely do not apply.
- Write observable behavior, not implementation plans.
- Do not invent future phases unless the user asked for them.
- Do not create tasks here. Use
breakdown-tasksafter the spec is accepted. - Do not include commit, push, or PR steps.