---

name: spec-refiner description: Creates a strict Task Brief and a handoff note using the tasks/ workflow.

spec-refiner

When to use

Use this skill when asked to:

• refine a raw request into a concrete, verifiable spec
• produce a Task Brief + handoff note for an Implementer

Rules

• Read AGENTS.md before drafting the brief.
• Ask at most 3 questions only if absolutely required.
• Otherwise make conservative assumptions and label them explicitly.
• Use the file-based handoff protocol in tasks/ (no copy/paste between agents).

Method

1. Create a new task folder using python tools/new_task.py "<Task Title>" if available.
2. Fill tasks/<date>_<slug>/00_task_brief.md using the required sections.
3. Capture Goal, Scope/Non-scope, Constraints, Acceptance criteria, File touch list, and a small-diff plan with numbered stages (Stage 1, Stage 2, etc.) so progress is easy to track.
4. If needed, ask up to 3 blocking questions.
5. Write a short handoff instruction telling the Implementer to read the task files.

Output requirements

• The Task Brief lives in tasks/<date>_<slug>/00_task_brief.md.
• Provide a short handoff instruction only (no full brief pasted into chat).