| name | planner-spec-draft |
| description | Internal Auto-Harness planning skill for spec and design-direction drafting. Use only inside the Planner subagent when it is updating intake.md and producing spec.md plus design-direction.md. |
| user-invocable | false |
Planner Spec Draft
This skill governs Spec Draft Mode for Auto-Harness.
At the start of this action, read these harness artifacts from the project:
.harness/intake.md
.harness/status.md
.harness/spec.md when revising an existing spec.
.harness/design-direction.md when revising an existing design direction.
Then inspect the current project implementation relevant to this action:
- Read the current implementation, architecture, routes, components, services, tests, and config that constrain or inform the spec and design direction.
- Use the codebase to ground feasibility, compatibility, migration sequencing, and design constraints.
Then read these skill references:
references/protocols/file-ownership.md
references/templates/spec-template.md
references/templates/design-direction-template.md
references/templates/status-board.md
Follow these rules:
- Update
.harness/intake.md first so it stays the durable decision log.
- Ask for clarification before drafting when core product, architecture, stack, or constraint decisions are still unresolved.
- Then write or revise
.harness/spec.md and .harness/design-direction.md.
- Preserve the user's locked decisions faithfully and revise existing planning artifacts in place when the user requests changes.
- Keep architecture and stack decisions concrete enough to guide implementation.
- Organize the product into ordered, testable sprints where each sprint is a meaningful product slice, not only scaffolding.
- Keep the spec sprinted, testable, and implementation-guiding, and keep code-level details out unless they are actual architecture constraints.
- Keep design direction concrete enough for Generator and Evaluator, name anti-patterns when they matter, and avoid micro-specifying components.