define-overview

name	define-overview
description	Capture the high-level definition of a project — problem, target users, value proposition, scope boundaries, non-goals, and success criteria. Use when the project-builder agent is gathering overview information.

Purpose

Produce a crisp, shared understanding of what the project is and why it exists, before any technical discussion.

Questions to ask (in order)

1. Working name for the project.
2. One-sentence problem statement: what pain or opportunity does it address?
3. Primary users (persona + context of use). Allow up to three.
4. Value proposition: why would a user pick this over doing nothing or using an alternative?
5. Maturity target: Prototype, MVP, or Production.
6. In-scope: the 3–5 capabilities the project must deliver.
7. Non-goals: the 3–5 things it explicitly will not do (critical for boundary-setting).
8. Success criteria: how you will know it works (qualitative or quantitative).

Use AskUserQuestion for multi-choice items (maturity target, audience breadth, differentiation axis). Free-text the rest.

Solution space to present

When the user is unsure, offer these framings as prompts (not prescriptions):

• Maturity target: Prototype (proves the idea) / MVP (usable by early adopters) / Production (reliable, multi-user).
• Audience breadth: Personal or internal tool / Small team / Wider community / Commercial customers.
• Differentiation axis: Cheaper / Faster / Simpler / More capable / More private / More integrated.

Required schema (must be captured)

• name
• problem
• users (list)
• value_proposition
• maturity_target
• in_scope (list)
• non_goals (list)
• success_criteria (list)

Output

Write to PROJECT_BRIEF.md in the target folder under a ## Overview heading with these fields, one per line. Replace any prior ## Overview section when re-run.

Frontmatter contribution

Update these YAML frontmatter fields (see CLAUDE.md for the full schema). Leave every other field untouched:

• project.name — the working name
• project.maturity_target — prototype, mvp, or production