Vague Goal To Clear Plan — Development skill for Claude Code

scope

Turn a big, vague wish into a task you can finish. Start a message with `scope`:

scope build me a website for my bakery

The assistant asks at most five short questions, each with a default so you can reply `ok`, then writes a one-screen brief with a definition of done. It pauses for your approval before doing any work.

Vague wishes fail because nobody decided what "done" means. `scope` decides it in about two minutes.

What you get

**Wish:** build me a website for my bakery
**Scoped as:** a one-page website for walk-in customers showing the menu, hours and location.

**For:** local walk-in customers
**Done when:**
- The page shows the menu, opening hours and a map link
- It reads correctly on a phone
- It is live on a free host with a shareable link

**Limits:** free hosting, no payments, this week
**Start from:** existing photos and PDF menu
**Out of scope (for now):** online ordering, blog, multiple languages
**Assumed:** Chinese and English are not both needed

**First step:** extract the menu text from the PDF and lay out the page sections.

Run it? (ok / change X / just the brief)

Reply `ok` to start the first step, describe a change to revise the brief, or say `just the brief` to take it elsewhere. See [`examples/`](examples/) for more, including a task `scope` refuses to scope.

What is in this repo?

File	Use it for
`scope/SKILL.md`	The complete skill, written for Claude Code.
`PORTABLE.md`	A short, model-neutral version for custom or project instructions.
`examples/`	Worked runs: a vague wish, a wish that is really three projects, and a small task.
`assets/`	The banner and its HTML source.

Install

Claude Code

1. Download this repository or copy `scope/SKILL.md`.
2. Put it at `~