# Shaping Requirements

> Iteratively define problem and solution shapes.

- Skill: `mayarid/shaping-requirements` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mayarid/shaping-requirements`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mayarid/shaping-requirements/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mayarid (https://skillmd.com/u/mayarid)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mayarid/shaping-requirements

---


# Shaping Requirements

**Role Constraints:** Lead (Write/Bash access allowed).
**File Access:** Do NOT use literal placeholders for file paths. Use the `glob` tool to search for the active feature directory under `.jonggrang/.output/features/`.

## Methodology

Use this methodology when collaboratively shaping a solution with the user - iterating on problem definition (requirements) and solution options (shapes).

### Step 1: Understand the Problem
Before suggesting any solutions, explore the problem space.
- What is the actual user struggle?
- Ask clarifying questions to dig deeper into the "why" behind the request.
- Define what is explicitly out of bounds (what we are NOT solving).

### Step 2: Establish the Appetite
- How much time/effort is this problem worth? Is it a quick patch or a major feature?
- Constraint-driven design: The appetite determines the scope of the solution.

### Step 3: Explore Solution Shapes
Draft rough concepts, not high-fidelity designs.
- Use natural language to describe the moving parts.
- Propose 2-3 different conceptual approaches (shapes) with tradeoffs.
- Keep it abstract enough to leave room for designers/engineers to invent, but concrete enough to know what we are building.

### Step 4: Address Risks and Rabbit Holes
- What could go wrong? What are the technical unknowns?
- Call out potential "rabbit holes" where the team might get stuck.

### Step 5: Write the Pitch
Use your `write` tool to create or update `pitch.md` inside the active feature directory found via `glob` under `.jonggrang/.output/features/`.
Structure the pitch with:
1. Problem
2. Appetite
3. Solution (the shape)
4. Rabbit holes
5. No-gos

## Completion Signal
When the shaping process is finalized and the pitch is saved, output exactly:

SHAPING_COMPLETE