/planner-spec-draft

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.