skills/notion-spec-to-implementation/examples/ui-component.md

# Example: UI Component Implementation

**User Request**: "Implement the new search component from the design spec"

## Workflow

### 1. Find Spec
```
Notion:search
query: "search component design spec"
query_type: "internal"
filters: {}
```
Found: "Global Search Redesign Spec"

### 2. Fetch & Parse Spec
```
Notion:fetch
id: "global-search-redesign-spec-page-id"
```

**Requirements**:
- Instant search with debounced API calls
- Keyboard navigation (↑↓ arrows, Enter, Esc)
- Recent searches history
- Result categories (pages, people, files)
- Mobile responsive
- Accessibility (ARIA labels, screen reader)

### 3. Create Implementation Plan
```
Notion:notion-create-pages
parent: { page_id: "engineering-plans-parent-id" }
pages: [{
  properties: {
    "title": "Implementation Plan: Global Search Redesign"
  },
  content: "[Implementation plan]"
}]
```

**Plan phases**:
- Phase 1: Base component structure
- Phase 2: API integration & debouncing
- Phase 3: Keyboard navigation
- Phase 4: Recent searches
- Phase 5: Polish & accessibility

### 4. Create Tasks
```
Notion:notion-create-pages
parent: { data_source_id: "collection://engineering-tasks-data-source-id" }
pages: [{
  properties: {
    "Task": "Create SearchInput component",
    "Status": "To Do",
    "Priority": "High"
  },
  content: "[Task description and acceptance criteria]"
}]
```

**Tasks**:
1. Create SearchInput component
2. Implement useDebounce hook
3. Add keyboard navigation
4. LocalStorage for recent searches
5. Result categorization UI
6. Accessibility audit
7. Mobile responsive styling

### 5. Implement & Track
As each task completed, updated status and added progress notes with screenshots and implementation details.

## Key Outputs

**Implementation Plan** (linked to design spec)
**7 Component Tasks** (in Engineering Tasks database)
**Progress Updates** (with code snippets and demo links)

## Success Factors
- Clear component breakdown
- Separated concerns (logic, UI, accessibility)
- Each task had acceptance criteria
- Referenced design spec throughout
- Included accessibility from start, not afterthought
- Tracked progress with visual updates