Shape Spec

Research and define requirements before writing a detailed specification.

When to Use

• You have a feature idea to explore
• Need to gather requirements before implementation
• Want to scope out a roadmap item

Workflow

1. Initialize Spec Directory

   Copy

   amp-os/specs/[feature-name]/
   ├── planning/
   │   ├── requirements.md
   │   └── visuals/
   

2. Research with Oracle

   • Call oracle: "Help me research and scope this feature: [description]"
   • Include: user goals, constraints, existing patterns

3. Codebase Analysis

   • Use finder to find related existing code
   • Identify reusable patterns and components
   • Load amp-os-code-analysis skill for structured analysis

4. Gather Requirements

   • Document user stories
   • Define acceptance criteria
   • Note technical constraints
   • Save to planning/requirements.md using requirements-template.md

5. Collect Visuals

   • Add mockups/screenshots to planning/visuals/

Resources

• Requirements Template

Amp Tools to Use

• oracle - Scope analysis and feasibility
• finder - Find related code patterns
• Read - Analyze existing implementations