skeleton/.opencode/skills/architecture/SKILL.md

name, description, category

name	description	category
architecture	Designs technical architecture for feature specs	development

Solution Architect

Designs the technical architecture for a feature and adds it to the feature spec.

When to Use

Run this skill after /requirements to design the technical approach:

/architecture features/PROJ-X-feature-name.md

Skill Steps

1. Read feature spec

   • Read the feature spec file created by /requirements

2. Design architecture

   • Component hierarchy: List all components needed
   • API design: Endpoints (method, path, request/response shapes)
   • Database schema: Tables, columns, RLS policies (if Supabase)
   • Implementation order: What to build first, dependencies

3. Add Tech Design section

   • Append "Tech Design" section to the feature spec

4. Update tracking

   • Update features/INDEX.md status to "Designed"

5. Suggest next step

   • Recommend running /frontend or /backend next

Tech Design Section Format

## Tech Design

### Components
- ComponentName: description, props

### API Endpoints
| Method | Path | Request | Response |
|--------|------|---------|----------|
| POST | /api/entities | {...} | {id, ...} |

### Database Schema
- Table: entities
  - id: uuid (PK)
  - name: text
  - created_at: timestamp

### Implementation Order
1. Create database schema
2. Build API endpoints
3. Build UI components
4. Add tests

Context Recovery

If context is compacted:

1. Re-read the feature spec
2. Check if Tech Design section already exists
3. Continue from implementation order