| name | shape-spec |
| description | Research and gather requirements for a new feature spec. Use when you have a feature idea and need to understand scope, gather requirements, and document visuals before writing a spec. |
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
Initialize Spec Directory
amp-os/specs/[feature-name]/ ├── planning/ │ ├── requirements.md │ └── visuals/Research with Oracle
- Call
oracle: "Help me research and scope this feature: [description]" - Include: user goals, constraints, existing patterns
- Call
Codebase Analysis
- Use
finderto find related existing code - Identify reusable patterns and components
- Load
amp-os-code-analysisskill for structured analysis
- Use
Gather Requirements
- Document user stories
- Define acceptance criteria
- Note technical constraints
- Save to
planning/requirements.mdusing requirements-template.md
Collect Visuals
- Add mockups/screenshots to
planning/visuals/
- Add mockups/screenshots to
Resources
Amp Tools to Use
oracle- Scope analysis and feasibilityfinder- Find related code patternsRead- Analyze existing implementations