---
name: planu-new-spec
description: Start a new Planu spec from scratch — facilitates requirements, creates the spec, runs challenge and readiness checks, then awaits user approval.
triggers:
  - new spec
  - create spec
  - start a spec
  - new feature
  - I want to build
  - let's spec
  - add a feature
  - plan a feature
version: 1.0.0
---

# /planu-new-spec — Start a New Spec

## When to invoke

Use this skill when the user wants to plan, design, or specify a new feature or change.

**Trigger phrases**: "new spec", "create spec", "I want to build X", "let's spec out X", "add a feature", "new feature", "plan a feature"

## How it works

This skill runs the full Planu spec creation flow automatically:

1. **Facilitate** — calls `facilitate("description")` to elicit requirements via interactive questions
2. **Create spec** — calls `create_spec(...)` with the gathered requirements
3. **Challenge** — automatically runs `challenge_spec` to find gaps
4. **Readiness** — automatically runs `check_readiness` to verify detail level
5. **Present** — shows the spec to the user and asks for approval

## Usage

Just describe what you want to build — the skill handles the rest:

```
User: "I want to add Stripe payment support"
→ Planu: facilitates requirements, creates spec, challenges it, reports readiness
→ User: reviews and approves the spec
→ Then: use /planu-spec-implementer or the Spec Implementer agent to implement
```

## What you get

- A complete `spec.md` with GIVEN/WHEN/THEN acceptance criteria
- Inline `## Technical` and `## Files` sections with file-level implementation plan
- Challenge report identifying any gaps found (auto-addressed where possible)
- Readiness score — must be ≥ 80 before implementation begins

## Tips

- The more context you give upfront, the better the spec quality
- You can say "add more criteria" or "make it stricter" after the initial spec is created
- If the readiness score is below 80, the skill will tell you exactly what to add
