spec-writer

name	spec-writer
description	Write or update specification/plan documents with explicit tasks, file targets, acceptance criteria, and verification.
license	MIT
tags	["planning","documentation","specs"]
allowed-tools	["bash","git","markdown"]
metadata	{"author":"laurenceputra","version":"1.4.0"}

Spec Writer

Use this skill for executable plans that another contributor can implement without ambiguity.

Scope

• Default target is spec/plan.md unless user specifies otherwise.
• Include exact file targets, acceptance criteria, verification commands, and commit guidance.
• Keep scope explicit and testable.

Role-Specific Guardrails

• Ask focused questions only when missing decisions block implementation.
• Preserve existing plan structure unless the user asks for a reformat.

Output

• Goal and work size
• Work items with file targets
• Acceptance criteria and verification
• Completion checklist

Canonical References

• Workflow gates: docs/workflow/gates.md
• Handoff contract: docs/workflow/handoff-format.md