implement

Implement Feature

Implement the feature described: $ARGUMENTS

Implementation Process

Phase 0: Portfolio Gate

1. Check project constraints
   • Read ~/.claude/portfolio/PORTFOLIO.md
   • If Maintenance phase: ONLY bug fixes. Reject feature requests.
   • If Prototype phase: Skip tests, skip types, skip CI.
   • Match complexity to tier. T3/T4 = simplest possible implementation.

Phase 1: Planning (Types First)

1. Clarify Requirements

   • What is the expected behavior?
   • What are the acceptance criteria?
   • Are there edge cases to consider?
   • Who are the users of this feature?

2. Identify Scope

   • Which files need to be created/modified?
   • What new types/interfaces are needed?
   • What's the data flow?
   • Are there database changes needed?

3. Create Type Definitions

   // TypeScript: src/types/[feature].ts
   export interface FeatureName {
     id: string;
     // ... properties
   }
   

   # Python: src/models/[feature].py
   from pydantic import BaseModel
   
   class FeatureName(BaseModel):
       id: str
       # ... fields
   

Phase 2: Implementation (Backend First)

1. Database Layer (if applicable)

   • Create migrations
   • Add models/schemas
   • Update seed data if needed

2. Service Layer

   • Implement business logic
   • Use Result pattern for error handling
   • Add logging at key points

3. API Layer (if applicable)

   • Create endpoints following API patterns
   • Add input validation (Zod/Pydantic)
   • Implement proper error responses

Phase 3: Implementation (Frontend)

1. Components (if applicable)

   • Create React components
   • Add custom hooks for data fetching
   • Implement state management

2. Integration

   • Connect frontend to backend
   • Add loading/error states
   • Implement optimistic updates if needed

Phase 4: Testing

1. Write Tests

   # Unit tests for services
   # Integration tests for API
   # Component tests for UI