docs(context): add frontend delegation guide

- Create when-to-delegate.md with clear decision criteria
- Decision matrix for when to delegate vs. handle directly
- Common patterns and examples
- Red flags and green flags
- Frontend-specialist capabilities reference
- Update frontend and development navigation files

Helps orchestrators decide when to delegate UI work to frontend-specialist subagent.

.opencode/context/development/EXECUTION_CHECKLIST.md

@@ -1,502 +0,0 @@
-# Development Context Reorganization - Execution Checklist
-
-**Date**: 2026-01-30  
-**Estimated Time**: 50 minutes  
-**Status**: ⏳ AWAITING APPROVAL
-
----
-
-## Pre-Execution Checklist
-
-- [ ] Review `REORGANIZATION_SUMMARY.md`
-- [ ] Review `REORGANIZATION_PLAN.md`
-- [ ] Review `VISUAL_COMPARISON.md`
-- [ ] Approval obtained
-- [ ] Backup plan understood
-- [ ] All team members notified
-
----
-
-## Execution Steps
-
-### Step 1: Create Backup (1 min)
-
-```bash
-cd /Users/darrenhinde/Documents/GitHub/MYBUSINESS/OpenAgentsControl
-
-# Create backup commit
-git add .opencode/context/development/
-git commit -m "backup: development context before reorganization"
-
-# Note the commit hash for rollback
-git log -1 --oneline
-```
-
-**Validation**: ✅ Commit created successfully
-
----
-
-### Step 2: Create New Directory Structure (1 min)
-
-```bash
-# Create frontend/react directory
-mkdir -p .opencode/context/development/frontend/react
-```
-
-**Validation**: ✅ Directory exists
-
----
-
-### Step 3: Move react-patterns.md (1 min)
-
-```bash
-# Move file
-mv .opencode/context/development/react-patterns.md \
-   .opencode/context/development/frontend/react/react-patterns.md
-```
-
-**Validation**: 
-- [ ] File moved successfully
-- [ ] Old location empty
-- [ ] New location contains file
-
----
-
-### Step 4: Delete Duplicate UI Files (1 min)
-
-```bash
-# Delete 4 UI duplicate files
-rm .opencode/context/development/animation-patterns.md
-rm .opencode/context/development/design-systems.md
-rm .opencode/context/development/ui-styling-standards.md
-rm .opencode/context/development/design-assets.md
-```
-
-**Validation**: 
-- [ ] 4 files deleted
-- [ ] Canonical versions still exist in ui/web/
-
----
-
-### Step 5: Delete Duplicate Principle Files (1 min)
-
-```bash
-# Delete 2 principle duplicate files
-rm .opencode/context/development/clean-code.md
-rm .opencode/context/development/api-design.md
-```
-
-**Validation**: 
-- [ ] 2 files deleted
-- [ ] Canonical versions still exist in principles/
-
----
-
-### Step 6: Delete Redundant READMEs (1 min)
-
-```bash
-# Delete redundant READMEs
-rm .opencode/context/development/README.md
-rm .opencode/context/development/ai/mastra-ai/README.md
-```
-
-**Validation**: 
-- [ ] 2 files deleted
-- [ ] navigation.md files still exist
-
----
-
-### Step 7: Create New Navigation File (5 min)
-
-Create: `.opencode/context/development/frontend/react/navigation.md`
-
-```markdown
-# React Development
-
-**Purpose**: Modern React patterns, hooks, and component design
-
----
-
-## Files
-
-| File | Description | Priority |
-|------|-------------|----------|
-| [react-patterns.md](react-patterns.md) | React hooks, components, state management | high |
-
----
-
-## Related Context
-
-- **UI Styling** → `../../../ui/web/ui-styling-standards.md`
-- **Animations** → `../../../ui/web/animation-patterns.md`
-- **Clean Code** → `../../principles/clean-code.md`
-```
-
-**Validation**: 
-- [ ] File created
-- [ ] Content correct
-- [ ] Links work
-
----
-
-### Step 8: Update development/navigation.md (3 min)
-
-**File**: `.opencode/context/development/navigation.md`
-
-**Changes**:
-1. Remove deleted files from structure tree
-2. Update frontend/ from "[future]" to active
-3. Add react/ subdirectory
-
-**Key sections to update**:
-- Structure tree (lines 9-58)
-- Remove references to deleted files
-
-**Validation**: 
-- [ ] Structure tree updated
-- [ ] No references to deleted files
-- [ ] frontend/ marked as active
-
----
-
-### Step 9: Update development/ui-navigation.md (2 min)
-
-**File**: `.opencode/context/development/ui-navigation.md`
-
-**Changes**:
-1. Update React patterns path from "[future]" to actual path
-
-**Find and replace**:
-```diff
-- | **React patterns** | `frontend/react/hooks-patterns.md` [future] |
-+ | **React patterns** | `frontend/react/react-patterns.md` |
-```
-
-**Validation**: 
-- [ ] React patterns path updated
-- [ ] All UI routes point to ui/web/
-
----
-
-### Step 10: Update development/frontend/navigation.md (3 min)
-
-**File**: `.opencode/context/development/frontend/navigation.md`
-
-**Changes**:
-1. Add react/ subdirectory to structure
-2. Add Quick Routes section
-3. Update from placeholder to active
-
-**Validation**: 
-- [ ] Structure updated
-- [ ] Quick Routes added
-- [ ] No longer marked as "[future]"
-
----
-
-### Step 11: Update Developer Profile (5 min)
-
-**File**: `.opencode/profiles/developer/profile.json`
-
-**Find and replace** (4 updates):
-
-```diff
-- "context:development/ui-styling-standards",
-+ "context:ui/web/ui-styling-standards",
-
-- "context:development/design-systems",
-+ "context:ui/web/design-systems",
-
-- "context:development/design-assets",
-+ "context:ui/web/design-assets",
-
-- "context:development/animation-patterns",
-+ "context:ui/web/animation-patterns",
-```
-
-**Validation**: 
-- [ ] All 4 paths updated
-- [ ] JSON still valid
-- [ ] Profile loads successfully
-
----
-
-### Step 12: Update core/visual-development.md (5 min)
-
-**File**: `.opencode/context/core/visual-development.md`
-
-**Find and replace** (6 updates):
-
-```diff
-- | **Animation patterns** | `development/animation-patterns.md` | - | - |
-+ | **Animation patterns** | `ui/web/animation-patterns.md` | - | - |
-
-- | **Design system** | `development/design-systems.md` | - | - |
-+ | **Design system** | `ui/web/design-systems.md` | - | - |
-
-- | **UI standards** | `development/ui-styling-standards.md` | - | - |
-+ | **UI standards** | `ui/web/ui-styling-standards.md` | - | - |
-
-- - **Animation Patterns**: `.opencode/context/development/animation-patterns.md`
-+ - **Animation Patterns**: `.opencode/context/ui/web/animation-patterns.md`
-
-- - **Design Systems**: `.opencode/context/development/design-systems.md`
-+ - **Design Systems**: `.opencode/context/ui/web/design-systems.md`
-
-- - **UI Styling Standards**: `.opencode/context/development/ui-styling-standards.md`
-+ - **UI Styling Standards**: `.opencode/context/ui/web/ui-styling-standards.md`
-```
-
-**Validation**: 
-- [ ] All 6 paths updated
-- [ ] File still valid
-
----
-
-### Step 13: Update core/workflows/design-iteration.md (5 min)
-
-**File**: `.opencode/context/core/workflows/design-iteration.md`
-
-**Find and replace** (4 updates):
-
-```diff
-- - [Animation Patterns](../development/animation-patterns.md)
-+ - [Animation Patterns](../ui/web/animation-patterns.md)
-
-- - [Design Systems Context](../development/design-systems.md)
-+ - [Design Systems Context](../ui/web/design-systems.md)
-
-- - [UI Styling Standards](../development/ui-styling-standards.md)
-+ - [UI Styling Standards](../ui/web/ui-styling-standards.md)
-
-- - [Design Assets](../development/design-assets.md)
-+ - [Design Assets](../ui/web/design-assets.md)
-```
-
-**Validation**: 
-- [ ] All 4 paths updated
-- [ ] Links work
-
----
-
-### Step 14: Update openagents-repo/lookup/file-locations.md (2 min)
-
-**File**: `.opencode/context/openagents-repo/lookup/file-locations.md`
-
-**Find and replace** (1 update):
-
-```diff
-- - `.opencode/context/development/react-patterns.md`
-+ - `.opencode/context/development/frontend/react/react-patterns.md`
-```
-
-**Validation**: 
-- [ ] Path updated
-- [ ] File still valid
-
----
-
-### Step 15: Validate File Count (2 min)
-
-```bash
-# Count files
-find .opencode/context/development -type f -name "*.md" | wc -l
-```
-
-**Expected**: 26 files
-
-**Validation**: 
-- [ ] File count is 26 (down from 36)
-
----
-
-### Step 16: Validate No Duplicates (2 min)
-
-```bash
-# Check that deleted files are gone
-ls .opencode/context/development/animation-patterns.md 2>/dev/null
-ls .opencode/context/development/design-systems.md 2>/dev/null
-ls .opencode/context/development/ui-styling-standards.md 2>/dev/null
-ls .opencode/context/development/design-assets.md 2>/dev/null
-ls .opencode/context/development/clean-code.md 2>/dev/null
-ls .opencode/context/development/api-design.md 2>/dev/null
-ls .opencode/context/development/README.md 2>/dev/null
-ls .opencode/context/development/ai/mastra-ai/README.md 2>/dev/null
-```
-
-**Expected**: All commands should return "No such file or directory"
-
-**Validation**: 
-- [ ] All 8 files deleted
-- [ ] No duplicates exist
-
----
-
-### Step 17: Validate Moved File (1 min)
-
-```bash
-# Check that react-patterns.md moved
-ls .opencode/context/development/react-patterns.md 2>/dev/null
-ls .opencode/context/development/frontend/react/react-patterns.md
-```
-
-**Expected**: 
-- First command: "No such file or directory"
-- Second command: File exists
-
-**Validation**: 
-- [ ] Old location empty
-- [ ] New location has file
-
----
-
-### Step 18: Test Developer Profile (3 min)
-
-```bash
-# Validate JSON syntax
-cat .opencode/profiles/developer/profile.json | jq . > /dev/null
-```
-
-**Expected**: No errors
-
-**Validation**: 
-- [ ] JSON valid
-- [ ] All 4 paths updated
-- [ ] Profile loads successfully
-
----
-
-### Step 19: Test Navigation Links (3 min)
-
-Manually check:
-1. `.opencode/context/development/navigation.md` - All links work
-2. `.opencode/context/development/ui-navigation.md` - All links work
-3. `.opencode/context/development/frontend/navigation.md` - All links work
-4. `.opencode/context/development/frontend/react/navigation.md` - All links work
-
-**Validation**: 
-- [ ] All navigation links work
-- [ ] No broken references
-
----
-
-### Step 20: Commit Changes (2 min)
-
-```bash
-# Stage all changes
-git add .opencode/
-
-# Commit with descriptive message
-git commit -m "refactor(context): reorganize development folder
-
-- Remove 7 duplicate files (ui/design files exist in ui/web/)
-- Remove 2 redundant READMEs (use navigation.md instead)
-- Move react-patterns.md to frontend/react/
-- Update 4 navigation files
-- Update developer profile (4 path changes)
-- Update 3 core context files (11 path changes)
-
-Result: 26 files (down from 36), no duplicates, clean structure
-
-Refs: REORGANIZATION_PLAN.md, REORGANIZATION_SUMMARY.md"
-```
-
-**Validation**: 
-- [ ] Commit successful
-- [ ] All changes included
-
----
-
-## Post-Execution Validation
-
-### Final Checklist
-
-- [ ] File count: 26 (down from 36)
-- [ ] Root level: 4 files (all navigation)
-- [ ] No duplicate files exist
-- [ ] react-patterns.md in frontend/react/
-- [ ] Developer profile works (4 paths updated)
-- [ ] Core context files work (11 paths updated)
-- [ ] All navigation links work
-- [ ] No broken references
-- [ ] frontend/ directory is active (not placeholder)
-- [ ] All README.md files removed
-- [ ] Git commit created
-- [ ] No errors in validation
-
----
-
-## Rollback Instructions
-
-If issues are discovered:
-
-```bash
-# Find backup commit
-git log --oneline | head -5
-
-# Rollback to backup (replace <hash> with actual commit hash)
-git reset --hard <backup-commit-hash>
-
-# Or restore specific files
-git checkout <backup-commit-hash> -- .opencode/context/development/
-git checkout <backup-commit-hash> -- .opencode/profiles/developer/profile.json
-git checkout <backup-commit-hash> -- .opencode/context/core/
-git checkout <backup-commit-hash> -- .opencode/context/openagents-repo/lookup/
-```
-
----
-
-## Success Criteria
-
-✅ All steps completed without errors  
-✅ All validations passed  
-✅ File count correct (26 files)  
-✅ No duplicate files  
-✅ All references updated  
-✅ Developer profile works  
-✅ Navigation links work  
-✅ Git commit created  
-
----
-
-## Time Tracking
-
-| Step | Estimated | Actual | Notes |
-|------|-----------|--------|-------|
-| 1. Backup | 1 min | | |
-| 2. Create dirs | 1 min | | |
-| 3. Move file | 1 min | | |
-| 4. Delete UI dupes | 1 min | | |
-| 5. Delete principle dupes | 1 min | | |
-| 6. Delete READMEs | 1 min | | |
-| 7. Create nav file | 5 min | | |
-| 8. Update dev nav | 3 min | | |
-| 9. Update ui nav | 2 min | | |
-| 10. Update frontend nav | 3 min | | |
-| 11. Update profile | 5 min | | |
-| 12. Update visual-dev | 5 min | | |
-| 13. Update design-iteration | 5 min | | |
-| 14. Update file-locations | 2 min | | |
-| 15. Validate count | 2 min | | |
-| 16. Validate dupes | 2 min | | |
-| 17. Validate move | 1 min | | |
-| 18. Test profile | 3 min | | |
-| 19. Test nav | 3 min | | |
-| 20. Commit | 2 min | | |
-| **TOTAL** | **50 min** | | |
-
----
-
-## Notes
-
-Use this space to record any issues, deviations, or observations during execution:
-
-```
-[Add notes here]
-```
-
----
-
-**Status**: ⏳ Ready for execution after approval
-
-**Next Step**: Obtain approval, then execute steps 1-20 in order

.opencode/context/development/REORGANIZATION_INDEX.md

@@ -1,396 +0,0 @@
-# Development Context Reorganization - Document Index
-
-**Date**: 2026-01-30  
-**Status**: ✅ ANALYSIS COMPLETE - AWAITING APPROVAL
-
----
-
-## 📋 Quick Start
-
-**New to this reorganization?** Start here:
-
-1. **Read**: `REORGANIZATION_SUMMARY.md` (5 min) - Executive summary
-2. **Review**: `VISUAL_COMPARISON.md` (10 min) - See before/after
-3. **Approve**: Decision needed
-4. **Execute**: `EXECUTION_CHECKLIST.md` (50 min) - Step-by-step
-
----
-
-## 📚 Document Overview
-
-### 1. REORGANIZATION_SUMMARY.md
-**Purpose**: Executive summary for decision-makers  
-**Length**: ~5 pages  
-**Read time**: 5 minutes  
-**Audience**: Anyone who needs to approve the reorganization
-
-**Contains**:
-- Quick overview of the problem and solution
-- What changes (files to delete, move, update)
-- Impact summary (benefits and breaking changes)
-- Before/after structure comparison
-- Risk assessment
-- Recommendation
-
-**When to read**: First document to read
-
----
-
-### 2. REORGANIZATION_PLAN.md
-**Purpose**: Comprehensive detailed plan  
-**Length**: ~50 pages  
-**Read time**: 30 minutes  
-**Audience**: Technical implementers, reviewers
-
-**Contains**:
-- Current state analysis (detailed)
-- Issues identified (critical, medium, minor)
-- Proposed clean structure
-- Detailed reorganization plan (all phases)
-- Before/after comparison (detailed)
-- Impact assessment (positive, neutral, breaking)
-- Risk analysis (high, medium, low)
-- Validation checklist
-- Execution plan (step-by-step)
-- Rollback plan
-- Appendices (file details, standards compliance, search commands)
-
-**When to read**: After summary, before execution
-
----
-
-### 3. VISUAL_COMPARISON.md
-**Purpose**: Visual before/after comparison  
-**Length**: ~15 pages  
-**Read time**: 10 minutes  
-**Audience**: Visual learners, reviewers
-
-**Contains**:
-- File count comparison
-- Directory tree comparison (before/after)
-- File operations summary (delete/move/create/update)
-- Root level files comparison
-- Duplicate files visualization
-- Reference updates required (with diffs)
-- Navigation updates required (with diffs)
-- Impact visualization (token savings, maintenance burden)
-- Validation checklist
-- Summary
-
-**When to read**: After summary, for visual understanding
-
----
-
-### 4. EXECUTION_CHECKLIST.md
-**Purpose**: Step-by-step execution guide  
-**Length**: ~10 pages  
-**Read time**: 5 minutes (reference during execution)  
-**Audience**: Person executing the reorganization
-
-**Contains**:
-- Pre-execution checklist
-- 20 execution steps with validation
-- Bash commands for each step
-- Post-execution validation
-- Final checklist
-- Rollback instructions
-- Success criteria
-- Time tracking table
-
-**When to read**: During execution (reference guide)
-
----
-
-### 5. REORGANIZATION_INDEX.md
-**Purpose**: Navigation guide for all documents  
-**Length**: This document  
-**Read time**: 3 minutes  
-**Audience**: Everyone
-
-**Contains**:
-- Document overview
-- Reading order recommendations
-- Quick reference
-- Decision tree
-
-**When to read**: First (to understand what to read)
-
----
-
-## 🗺️ Reading Order by Role
-
-### Decision Maker / Approver
-1. `REORGANIZATION_INDEX.md` (this file) - 3 min
-2. `REORGANIZATION_SUMMARY.md` - 5 min
-3. `VISUAL_COMPARISON.md` - 10 min
-4. **Decision**: Approve or request changes
-
-**Total time**: 18 minutes
-
----
-
-### Technical Reviewer
-1. `REORGANIZATION_INDEX.md` (this file) - 3 min
-2. `REORGANIZATION_SUMMARY.md` - 5 min
-3. `REORGANIZATION_PLAN.md` - 30 min
-4. `VISUAL_COMPARISON.md` - 10 min
-5. **Decision**: Approve or request changes
-
-**Total time**: 48 minutes
-
----
-
-### Executor / Implementer
-1. `REORGANIZATION_INDEX.md` (this file) - 3 min
-2. `REORGANIZATION_SUMMARY.md` - 5 min
-3. `REORGANIZATION_PLAN.md` (skim) - 10 min
-4. `EXECUTION_CHECKLIST.md` (detailed) - 5 min
-5. **Execute**: Follow checklist - 50 min
-
-**Total time**: 73 minutes (23 min prep + 50 min execution)
-
----
-
-### Stakeholder / Observer
-1. `REORGANIZATION_INDEX.md` (this file) - 3 min
-2. `REORGANIZATION_SUMMARY.md` - 5 min
-3. `VISUAL_COMPARISON.md` (optional) - 10 min
-
-**Total time**: 8-18 minutes
-
----
-
-## 🎯 Quick Reference
-
-### The Problem (in 30 seconds)
-
-Development context folder has:
-- 36 files (too many)
-- 7 duplicate files (confusion)
-- 7 misplaced files at root (disorganized)
-- 2 redundant READMEs (non-standard)
-
-### The Solution (in 30 seconds)
-
-Reorganize to:
-- 26 files (10 fewer)
-- 0 duplicates (single source of truth)
-- 0 misplaced files (clean structure)
-- 0 READMEs (use navigation.md)
-
-### The Impact (in 30 seconds)
-
-**Benefits**:
-- Eliminates confusion
-- Reduces maintenance
-- Saves tokens
-- Aligns with standards
-
-**Breaking Changes**:
-- 8 files need updates (all identified)
-- Developer profile needs 4 path changes
-- 3 core context files need 11 path changes
-
-### The Risk (in 30 seconds)
-
-**Risk Level**: 🟡 Medium (manageable)
-
-**Mitigation**:
-- All references identified
-- Backup created before execution
-- Rollback plan ready
-- Validation at each step
-
----
-
-## 📊 Key Metrics
-
-| Metric | Before | After | Change |
-|--------|--------|-------|--------|
-| **Total files** | 36 | 26 | -10 (-27%) |
-| **Root files** | 11 | 4 | -7 (-64%) |
-| **Duplicate files** | 7 | 0 | -7 (-100%) |
-| **Misplaced files** | 7 | 0 | -7 (-100%) |
-| **Redundant READMEs** | 2 | 0 | -2 (-100%) |
-| **Duplicate lines** | 2,902 | 0 | -2,902 (-100%) |
-| **Token waste** | ~3,773 | 0 | -3,773 (-100%) |
-
----
-
-## 🚦 Decision Tree
-
-### Should we proceed with this reorganization?
-
-**Question 1**: Do we have duplicate files causing confusion?  
-✅ **YES** - 7 duplicate files identified
-
-**Question 2**: Do we have misplaced files?  
-✅ **YES** - 7 files at root should be in subdirectories
-
-**Question 3**: Does current structure follow standards?  
-❌ **NO** - Mixing flat files with organized subdirectories
-
-**Question 4**: Are all breaking changes identified?  
-✅ **YES** - 8 files need updates (all documented)
-
-**Question 5**: Is there a rollback plan?  
-✅ **YES** - Git backup + rollback instructions
-
-**Question 6**: Are benefits worth the effort?  
-✅ **YES** - Eliminates confusion, reduces maintenance, saves tokens
-
-**Recommendation**: ✅ **PROCEED WITH REORGANIZATION**
-
----
-
-## 📝 Files Affected Summary
-
-### Files to Delete (9)
-- `animation-patterns.md` (duplicate)
-- `design-systems.md` (duplicate)
-- `ui-styling-standards.md` (duplicate)
-- `design-assets.md` (duplicate)
-- `clean-code.md` (duplicate)
-- `api-design.md` (duplicate)
-- `README.md` (redundant)
-- `ai/mastra-ai/README.md` (redundant)
-
-### Files to Move (1)
-- `react-patterns.md` → `frontend/react/react-patterns.md`
-
-### Files to Create (1)
-- `frontend/react/navigation.md` (new)
-
-### Files to Update (8)
-- `development/navigation.md`
-- `development/ui-navigation.md`
-- `development/frontend/navigation.md`
-- `frontend/react/navigation.md` (new)
-- `.opencode/profiles/developer/profile.json`
-- `.opencode/context/core/visual-development.md`
-- `.opencode/context/core/workflows/design-iteration.md`
-- `.opencode/context/openagents-repo/lookup/file-locations.md`
-
----
-
-## ⏱️ Time Estimates
-
-| Activity | Time | Who |
-|----------|------|-----|
-| **Review** (decision maker) | 18 min | Approver |
-| **Review** (technical) | 48 min | Reviewer |
-| **Preparation** | 23 min | Executor |
-| **Execution** | 50 min | Executor |
-| **Validation** | Included | Executor |
-| **Total** | 73 min | Executor |
-
----
-
-## ✅ Approval Checklist
-
-Before approving, ensure:
-
-- [ ] Summary reviewed (`REORGANIZATION_SUMMARY.md`)
-- [ ] Visual comparison reviewed (`VISUAL_COMPARISON.md`)
-- [ ] Full plan reviewed (optional: `REORGANIZATION_PLAN.md`)
-- [ ] Breaking changes understood (8 files need updates)
-- [ ] Risk level acceptable (🟡 Medium - manageable)
-- [ ] Executor identified
-- [ ] Time allocated (73 minutes)
-- [ ] Rollback plan understood
-- [ ] Team notified
-
----
-
-## 🚀 Next Steps
-
-### If Approved
-
-1. **Assign executor** - Who will perform the reorganization?
-2. **Schedule time** - Block 73 minutes (23 prep + 50 execution)
-3. **Notify team** - Inform stakeholders of upcoming changes
-4. **Execute** - Follow `EXECUTION_CHECKLIST.md`
-5. **Validate** - Run all validation checks
-6. **Monitor** - Watch for issues in next few days
-
-### If Not Approved
-
-1. **Document concerns** - What needs to change?
-2. **Revise plan** - Address concerns
-3. **Re-submit** - Request approval again
-
-### If Deferred
-
-1. **Document reason** - Why deferred?
-2. **Set review date** - When to revisit?
-3. **Track issues** - Monitor duplicate file problems
-
----
-
-## 📞 Questions?
-
-### Common Questions
-
-**Q: Will this break anything?**  
-A: Yes, temporarily. 8 files need updates, but all are identified and will be updated in the same commit.
-
-**Q: Can we rollback if needed?**  
-A: Yes, git backup will be created before any changes.
-
-**Q: How long will it take?**  
-A: ~73 minutes total (23 min prep + 50 min execution).
-
-**Q: What if we find more references later?**  
-A: Unlikely - comprehensive search completed. But if found, easy to update (just path changes).
-
-**Q: Why not keep duplicates?**  
-A: Duplicates cause confusion, maintenance burden, and waste tokens. Single source of truth is better.
-
-**Q: Why move react-patterns.md?**  
-A: React-specific patterns belong in frontend/react/, not at root level. Follows concern-based organization.
-
-**Q: What about the empty placeholder directories?**  
-A: Keeping them - they document intended structure and are referenced in main navigation.
-
-**Q: Who should execute this?**  
-A: Someone familiar with the context system and comfortable with git/bash commands.
-
-**Q: When should we do this?**  
-A: Anytime - low risk, manageable changes, clear rollback plan.
-
----
-
-## 📚 Additional Resources
-
-### Context System Standards
-- `.opencode/context/core/context-system/guides/organizing-context.md`
-- `.opencode/context/core/context-system/standards/structure.md`
-- `.opencode/context/core/context-system/guides/navigation-design.md`
-
-### Related Documentation
-- `.opencode/context/development/navigation.md` (current)
-- `.opencode/context/ui/web/navigation.md` (canonical UI location)
-
----
-
-## 📊 Status Tracking
-
-| Date | Status | Notes |
-|------|--------|-------|
-| 2026-01-30 | ✅ Analysis Complete | All documents created |
-| 2026-01-30 | ⏳ Awaiting Approval | Pending decision |
-| TBD | ⏳ Execution Scheduled | After approval |
-| TBD | ⏳ Execution Complete | After execution |
-| TBD | ✅ Validated | After validation |
-
----
-
-**Current Status**: ✅ ANALYSIS COMPLETE - AWAITING APPROVAL
-
-**Next Action**: Review `REORGANIZATION_SUMMARY.md` and decide to approve or request changes
-
-**Contact**: Context system owner, developer profile maintainers
-
----
-
-**End of Index**

.opencode/context/development/REORGANIZATION_PLAN.md

@@ -1,924 +0,0 @@
-# Development Context Reorganization Plan
-
-**Date**: 2026-01-30  
-**Target**: `.opencode/context/development/`  
-**Status**: PROPOSAL - Awaiting Approval
-
----
-
-## Executive Summary
-
-The development context folder contains **36 markdown files** with significant organizational issues:
-- **5 duplicate files** (exact copies exist in `ui/web/`)
-- **Misplaced UI/design files** in development folder
-- **Multiple navigation files** that need consolidation
-- **Inconsistent structure** mixing flat files with subdirectories
-- **Outdated README** that doesn't reflect current structure
-
-**Recommendation**: Reorganize to follow **Pattern B (Concern-Based)** structure as defined in context system standards, eliminate duplicates, and move UI-specific files to appropriate location.
-
----
-
-## Current State Analysis
-
-### Directory Structure
-
-```
-development/
-├── navigation.md                          # ✅ Main navigation
-├── README.md                              # ⚠️ Outdated
-├── ui-navigation.md                       # ✅ Specialized navigation
-├── backend-navigation.md                  # ✅ Specialized navigation
-├── fullstack-navigation.md                # ✅ Specialized navigation
-│
-├── [ROOT LEVEL FILES - MISPLACED]
-├── clean-code.md                          # ❌ DUPLICATE (exists in principles/)
-├── api-design.md                          # ❌ DUPLICATE (exists in principles/)
-├── react-patterns.md                      # ⚠️ Should be in frontend/react/
-├── animation-patterns.md                  # ❌ DUPLICATE (exists in ui/web/)
-├── design-systems.md                      # ❌ DUPLICATE (exists in ui/web/)
-├── ui-styling-standards.md                # ❌ DUPLICATE (exists in ui/web/)
-├── design-assets.md                       # ❌ DUPLICATE (exists in ui/web/)
-│
-├── principles/                            # ✅ Good structure
-│   ├── navigation.md
-│   ├── clean-code.md                      # 176 lines
-│   └── api-design.md                      # 415 lines (31 lines longer than root version)
-│
-├── ai/                                    # ✅ Good structure
-│   ├── navigation.md
-│   └── mastra-ai/                         # ✅ Function-based (concepts/examples/guides/lookup/errors)
-│       ├── navigation.md
-│       ├── README.md                      # ⚠️ Redundant with navigation.md
-│       ├── concepts/ (5 files)
-│       ├── examples/ (1 file)
-│       ├── guides/ (3 files)
-│       ├── lookup/ (1 file)
-│       └── errors/ (1 file)
-│
-├── frameworks/                            # ✅ Good structure
-│   ├── navigation.md
-│   └── tanstack-start/
-│       └── navigation.md
-│
-├── frontend/                              # ⚠️ Empty placeholder
-│   └── navigation.md
-│
-├── backend/                               # ⚠️ Empty placeholder
-│   └── navigation.md
-│
-├── data/                                  # ⚠️ Empty placeholder
-│   └── navigation.md
-│
-├── integration/                           # ⚠️ Empty placeholder
-│   └── navigation.md
-│
-└── infrastructure/                        # ⚠️ Empty placeholder
-    └── navigation.md
-```
-
-### File Inventory (36 files)
-
-| Location | Files | Status |
-|----------|-------|--------|
-| Root level | 11 files | 7 misplaced, 5 duplicates |
-| principles/ | 3 files | ✅ Good |
-| ai/mastra-ai/ | 13 files | ✅ Good (1 redundant README) |
-| frameworks/ | 2 files | ✅ Good |
-| frontend/ | 1 file | Empty placeholder |
-| backend/ | 1 file | Empty placeholder |
-| data/ | 1 file | Empty placeholder |
-| integration/ | 1 file | Empty placeholder |
-| infrastructure/ | 1 file | Empty placeholder |
-
----
-
-## Issues Identified
-
-### 🔴 Critical Issues
-
-#### 1. Duplicate Files (5 exact duplicates)
-
-| File | Root Location | Duplicate Location | Action |
-|------|---------------|-------------------|--------|
-| `animation-patterns.md` | `development/` | `ui/web/` | DELETE from development |
-| `design-systems.md` | `development/` | `ui/web/` | DELETE from development |
-| `ui-styling-standards.md` | `development/` | `ui/web/` | DELETE from development |
-| `design-assets.md` | `development/` | `ui/web/` | DELETE from development |
-| `clean-code.md` | `development/` | `development/principles/` | DELETE from root |
-| `api-design.md` | `development/` | `development/principles/` | DELETE from root (keep principles/ version - it's more complete) |
-
-**Impact**: 
-- Causes confusion about canonical source
-- Maintenance burden (updates needed in 2 places)
-- Wastes tokens when loading context
-- Developer profile currently references 4 UI duplicates
-
-#### 2. Misplaced Files
-
-| File | Current Location | Should Be | Reason |
-|------|-----------------|-----------|--------|
-| `react-patterns.md` | `development/` (root) | `development/frontend/react/` | React-specific, not universal |
-| `animation-patterns.md` | `development/` (root) | Already in `ui/web/` | UI/visual concern, not code |
-| `design-systems.md` | `development/` (root) | Already in `ui/web/` | UI/visual concern, not code |
-| `ui-styling-standards.md` | `development/` (root) | Already in `ui/web/` | UI/visual concern, not code |
-| `design-assets.md` | `development/` (root) | Already in `ui/web/` | UI/visual concern, not code |
-
-#### 3. Inconsistent Structure
-
-**Problem**: Mixing flat files at root with organized subdirectories
-
-**Current**:
-```
-development/
-├── clean-code.md              # Flat
-├── api-design.md              # Flat
-├── react-patterns.md          # Flat
-├── principles/                # Organized
-│   ├── clean-code.md
-│   └── api-design.md
-```
-
-**Should be**: All content in organized subdirectories
-
-### ⚠️ Medium Issues
-
-#### 4. Empty Placeholder Directories (5 directories)
-
-These directories only contain `navigation.md` with no actual content:
-- `frontend/` - Marked as "[future]" in main navigation
-- `backend/` - Marked as "[future]" in main navigation
-- `data/` - Marked as "[future]" in main navigation
-- `integration/` - Marked as "[future]" in main navigation
-- `infrastructure/` - Marked as "[future]" in main navigation
-
-**Decision needed**: Keep as placeholders or remove until content exists?
-
-#### 5. Redundant README Files
-
-- `development/README.md` - Outdated, doesn't reflect current structure
-- `ai/mastra-ai/README.md` - Redundant with `navigation.md`
-
-**Standard**: Context system uses `navigation.md`, not `README.md`
-
-### 🟡 Minor Issues
-
-#### 6. Navigation File Proliferation
-
-**Current**: 4 navigation files at root level
-- `navigation.md` - Main navigation
-- `ui-navigation.md` - Specialized (cross-category)
-- `backend-navigation.md` - Specialized
-- `fullstack-navigation.md` - Specialized
-
-**Assessment**: This is actually correct per context system standards (specialized navigation for cross-cutting concerns). No action needed.
-
----
-
-## Proposed Clean Structure
-
-### Target Structure (Pattern B: Concern-Based)
-
-```
-development/
-├── navigation.md                          # Main navigation
-├── ui-navigation.md                       # Specialized (points to ui/web/)
-├── backend-navigation.md                  # Specialized
-├── fullstack-navigation.md                # Specialized
-│
-├── principles/                            # ✅ Universal patterns
-│   ├── navigation.md
-│   ├── clean-code.md
-│   └── api-design.md
-│
-├── ai/                                    # ✅ AI frameworks
-│   ├── navigation.md
-│   └── mastra-ai/
-│       ├── navigation.md
-│       ├── concepts/ (5 files)
-│       ├── examples/ (1 file)
-│       ├── guides/ (3 files)
-│       ├── lookup/ (1 file)
-│       └── errors/ (1 file)
-│
-├── frameworks/                            # ✅ Full-stack frameworks
-│   ├── navigation.md
-│   └── tanstack-start/
-│       └── navigation.md
-│
-├── frontend/                              # 🆕 React patterns moved here
-│   ├── navigation.md
-│   └── react/
-│       └── react-patterns.md
-│
-├── backend/                               # Future: API patterns, Node.js, etc.
-│   └── navigation.md
-│
-├── data/                                  # Future: SQL, NoSQL, ORMs
-│   └── navigation.md
-│
-├── integration/                           # Future: Package management, APIs
-│   └── navigation.md
-│
-└── infrastructure/                        # Future: Docker, CI/CD
-    └── navigation.md
-```
-
-**Total files after cleanup**: 26 files (down from 36)
-- Removed: 5 duplicates from root
-- Removed: 2 duplicate principle files from root
-- Removed: 2 redundant READMEs
-- Moved: 1 file (react-patterns.md)
-
----
-
-## Detailed Reorganization Plan
-
-### Phase 1: Delete Duplicate Files (7 files)
-
-#### Step 1.1: Delete UI Duplicates from Development Root
-
-**Rationale**: These files are UI/visual design concerns, not development code patterns. Canonical versions exist in `ui/web/`.
-
-```bash
-# Delete 4 UI duplicate files
-rm .opencode/context/development/animation-patterns.md
-rm .opencode/context/development/design-systems.md
-rm .opencode/context/development/ui-styling-standards.md
-rm .opencode/context/development/design-assets.md
-```
-
-**Impact**: 
-- ✅ Eliminates confusion about canonical source
-- ✅ Reduces development folder from 36 to 32 files
-- ⚠️ **BREAKS developer profile** - currently references these 4 files
-- ⚠️ Requires profile update to point to `ui/web/` versions
-
-#### Step 1.2: Delete Principle Duplicates from Development Root
-
-**Rationale**: Canonical versions exist in `principles/` subdirectory. The `principles/api-design.md` version is more complete (31 lines longer).
-
-```bash
-# Delete 2 principle duplicate files
-rm .opencode/context/development/clean-code.md
-rm .opencode/context/development/api-design.md
-```
-
-**Impact**:
-- ✅ Eliminates confusion about canonical source
-- ✅ Reduces development folder from 32 to 30 files
-- ✅ No profile impact (developer profile doesn't reference these)
-
-#### Step 1.3: Delete Redundant README Files
-
-**Rationale**: Context system standard is `navigation.md`, not `README.md`.
-
-```bash
-# Delete redundant READMEs
-rm .opencode/context/development/README.md
-rm .opencode/context/development/ai/mastra-ai/README.md
-```
-
-**Impact**:
-- ✅ Aligns with context system standards
-- ✅ Reduces development folder from 30 to 28 files
-- ✅ No functional impact (navigation.md provides same info)
-
----
-
-### Phase 2: Move Misplaced Files (1 file)
-
-#### Step 2.1: Move react-patterns.md to frontend/react/
-
-**Rationale**: React-specific patterns belong in frontend concern, not at root level.
-
-```bash
-# Create directory structure
-mkdir -p .opencode/context/development/frontend/react
-
-# Move file
-mv .opencode/context/development/react-patterns.md \
-   .opencode/context/development/frontend/react/react-patterns.md
-```
-
-**Impact**:
-- ✅ Follows concern-based organization
-- ✅ Makes frontend/ directory functional (not just placeholder)
-- ⚠️ Requires navigation.md updates
-- ⚠️ May require profile updates if referenced
-
----
-
-### Phase 3: Update Navigation Files
-
-#### Step 3.1: Update development/navigation.md
-
-**Changes needed**:
-1. Remove references to deleted duplicate files
-2. Update structure tree to reflect new organization
-3. Update quick routes table
-4. Mark frontend/ as active (not "[future]")
-
-**Before**:
-```markdown
-## Structure
-
-```
-development/
-├── clean-code.md              # ❌ Delete
-├── api-design.md              # ❌ Delete
-├── react-patterns.md          # ❌ Move
-├── animation-patterns.md      # ❌ Delete
-├── design-systems.md          # ❌ Delete
-├── ui-styling-standards.md    # ❌ Delete
-├── design-assets.md           # ❌ Delete
-├── frontend/                  # [future]
-```
-```
-
-**After**:
-```markdown
-## Structure
-
-```
-development/
-├── principles/
-│   ├── clean-code.md
-│   └── api-design.md
-├── frontend/
-│   └── react/
-│       └── react-patterns.md
-```
-```
-
-#### Step 3.2: Update development/ui-navigation.md
-
-**Changes needed**:
-1. Remove references to deleted files in development/
-2. Point all UI routes to `../../ui/web/`
-3. Update React patterns path to `frontend/react/react-patterns.md`
-
-**Before**:
-```markdown
-| **Animations** | `../../ui/web/animation-patterns.md` |
-| **React patterns** | `frontend/react/hooks-patterns.md` [future] |
-```
-
-**After**:
-```markdown
-| **Animations** | `../../ui/web/animation-patterns.md` |
-| **React patterns** | `frontend/react/react-patterns.md` |
-```
-
-#### Step 3.3: Update development/frontend/navigation.md
-
-**Changes needed**:
-1. Add react/ subdirectory to structure
-2. Add react-patterns.md to file listing
-3. Update from placeholder to active
-
-**Before**:
-```markdown
-## Structure
-
-```
-frontend/                      # [future]
-├── navigation.md
-├── react/                     # [future]
-```
-```
-
-**After**:
-```markdown
-## Structure
-
-```
-frontend/
-├── navigation.md
-└── react/
-    └── react-patterns.md
-```
-
-## Quick Routes
-
-| Task | Path |
-|------|------|
-| **React patterns** | `react/react-patterns.md` |
-```
-
-#### Step 3.4: Create development/frontend/react/navigation.md (NEW)
-
-**New file needed** to follow context system standards (navigation at each level).
-
-**Content**:
-```markdown
-# React Development
-
-**Purpose**: Modern React patterns, hooks, and component design
-
----
-
-## Files
-
-| File | Description | Priority |
-|------|-------------|----------|
-| [react-patterns.md](react-patterns.md) | React hooks, components, state management | high |
-
----
-
-## Related Context
-
-- **UI Styling** → `../../../ui/web/ui-styling-standards.md`
-- **Animations** → `../../../ui/web/animation-patterns.md`
-- **Clean Code** → `../../principles/clean-code.md`
-```
-
----
-
-### Phase 4: Update Developer Profile
-
-#### Step 4.1: Update .opencode/profiles/developer/profile.json
-
-**Current references** (4 files to update):
-```json
-{
-  "context": [
-    "context:development/ui-styling-standards",      // ❌ File deleted
-    "context:development/design-systems",            // ❌ File deleted
-    "context:development/design-assets",             // ❌ File deleted
-    "context:development/animation-patterns"         // ❌ File deleted
-  ]
-}
-```
-
-**Updated references**:
-```json
-{
-  "context": [
-    "context:ui/web/ui-styling-standards",           // ✅ Canonical location
-    "context:ui/web/design-systems",                 // ✅ Canonical location
-    "context:ui/web/design-assets",                  // ✅ Canonical location
-    "context:ui/web/animation-patterns"              // ✅ Canonical location
-  ]
-}
-```
-
-**Impact**:
-- ✅ Profile continues to work (same files, new paths)
-- ✅ Points to canonical source of truth
-- ✅ No functional change for developer profile users
-
----
-
-### Phase 5: Handle Empty Placeholder Directories
-
-**Decision needed**: Keep or remove?
-
-#### Option A: Keep Placeholders (RECOMMENDED)
-
-**Rationale**:
-- Shows intended structure
-- Navigation files document future plans
-- Easy to add content later
-- Aligns with main navigation.md (marks as "[future]")
-
-**Action**: No changes needed
-
-#### Option B: Remove Placeholders
-
-**Rationale**:
-- Cleaner structure (only active content)
-- Reduces file count
-- Can recreate when needed
-
-**Action**:
-```bash
-# Remove empty placeholder directories
-rm -r .opencode/context/development/backend
-rm -r .opencode/context/development/data
-rm -r .opencode/context/development/integration
-rm -r .opencode/context/development/infrastructure
-```
-
-**Recommendation**: **Keep placeholders (Option A)** - they document the intended structure and are referenced in main navigation.
-
----
-
-## Before/After Comparison
-
-### File Count
-
-| Metric | Before | After | Change |
-|--------|--------|-------|--------|
-| Total files | 36 | 26 | -10 files |
-| Root level files | 11 | 4 | -7 files |
-| Duplicate files | 7 | 0 | -7 files |
-| Redundant READMEs | 2 | 0 | -2 files |
-| Navigation files | 15 | 16 | +1 file |
-| Content files | 19 | 19 | 0 (moved, not deleted) |
-
-### Structure Clarity
-
-| Aspect | Before | After |
-|--------|--------|-------|
-| Flat files at root | 7 misplaced | 0 |
-| Duplicate content | 7 files | 0 |
-| Organized subdirectories | 8 | 8 |
-| Function-based structure | 1 (mastra-ai) | 1 (mastra-ai) |
-| Concern-based structure | Partial | Complete |
-| Empty placeholders | 5 | 5 (kept) |
-
-### Directory Tree
-
-#### Before (36 files)
-```
-development/
-├── navigation.md
-├── README.md                              ❌ Redundant
-├── ui-navigation.md
-├── backend-navigation.md
-├── fullstack-navigation.md
-├── clean-code.md                          ❌ Duplicate
-├── api-design.md                          ❌ Duplicate
-├── react-patterns.md                      ⚠️ Misplaced
-├── animation-patterns.md                  ❌ Duplicate
-├── design-systems.md                      ❌ Duplicate
-├── ui-styling-standards.md                ❌ Duplicate
-├── design-assets.md                       ❌ Duplicate
-├── principles/ (3 files)
-├── ai/mastra-ai/ (13 files, 1 redundant README)
-├── frameworks/ (2 files)
-├── frontend/ (1 file - empty)
-├── backend/ (1 file - empty)
-├── data/ (1 file - empty)
-├── integration/ (1 file - empty)
-└── infrastructure/ (1 file - empty)
-```
-
-#### After (26 files)
-```
-development/
-├── navigation.md                          ✅ Updated
-├── ui-navigation.md                       ✅ Updated
-├── backend-navigation.md                  ✅ Kept
-├── fullstack-navigation.md                ✅ Kept
-├── principles/ (3 files)                  ✅ Canonical source
-├── ai/mastra-ai/ (12 files)               ✅ README removed
-├── frameworks/ (2 files)                  ✅ Kept
-├── frontend/                              ✅ Now active
-│   ├── navigation.md                      ✅ Updated
-│   └── react/
-│       ├── navigation.md                  🆕 New file
-│       └── react-patterns.md              ✅ Moved here
-├── backend/ (1 file)                      ✅ Placeholder
-├── data/ (1 file)                         ✅ Placeholder
-├── integration/ (1 file)                  ✅ Placeholder
-└── infrastructure/ (1 file)               ✅ Placeholder
-```
-
----
-
-## Impact Assessment
-
-### 🟢 Positive Impacts
-
-1. **Eliminates Confusion**
-   - Single source of truth for each piece of content
-   - Clear separation: development code patterns vs. UI visual design
-   - Consistent with context system standards
-
-2. **Reduces Maintenance Burden**
-   - No need to update content in multiple locations
-   - Easier to find and update files
-   - Clearer ownership (development vs. ui categories)
-
-3. **Improves Token Efficiency**
-   - Removes duplicate content from context loading
-   - Cleaner navigation (less clutter)
-   - Faster AI decision-making
-
-4. **Better Organization**
-   - Follows Pattern B (Concern-Based) consistently
-   - React patterns in appropriate location (frontend/react/)
-   - Principles clearly separated from implementations
-
-5. **Aligns with Standards**
-   - Follows context system organizing guide
-   - Uses navigation.md (not README.md)
-   - Proper concern-based structure
-
-### 🟡 Neutral Impacts
-
-1. **File Count Reduction**
-   - 36 → 26 files (10 fewer files)
-   - Same content, better organized
-   - No loss of information
-
-2. **Placeholder Directories**
-   - Kept for future expansion
-   - Documents intended structure
-   - No functional impact
-
-### 🔴 Breaking Changes
-
-1. **Developer Profile References** (4 files)
-   - Current: `context:development/ui-styling-standards`
-   - New: `context:ui/web/ui-styling-standards`
-   - **Action required**: Update profile.json
-   - **Impact**: Profile will break until updated
-
-2. **External References** (unknown)
-   - Any agents/profiles referencing deleted files will break
-   - Need to search for references before executing
-   - **Action required**: Audit all profiles and agent files
-
-3. **Navigation Updates** (4 files)
-   - `development/navigation.md` - Update structure tree
-   - `development/ui-navigation.md` - Update paths
-   - `development/frontend/navigation.md` - Update from placeholder
-   - `development/frontend/react/navigation.md` - Create new file
-   - **Action required**: Update all navigation files
-
----
-
-## Risk Analysis
-
-### High Risk
-
-**Risk**: Breaking developer profile and unknown references
-
-**Mitigation**:
-1. Search all profiles for references to deleted files
-2. Search all agent files for references to deleted files
-3. Update all references before deleting files
-4. Test developer profile after changes
-
-**Search commands**:
-```bash
-# Find all references to files being deleted
-grep -r "development/animation-patterns" .opencode/
-grep -r "development/design-systems" .opencode/
-grep -r "development/ui-styling-standards" .opencode/
-grep -r "development/design-assets" .opencode/
-grep -r "development/clean-code" .opencode/
-grep -r "development/api-design" .opencode/
-grep -r "development/react-patterns" .opencode/
-```
-
-### Medium Risk
-
-**Risk**: Navigation files out of sync
-
-**Mitigation**:
-1. Update all navigation files in single commit
-2. Validate navigation paths after changes
-3. Test navigation flow manually
-
-### Low Risk
-
-**Risk**: Empty placeholder directories cause confusion
-
-**Mitigation**:
-1. Keep placeholders (they're documented in main navigation)
-2. Mark clearly as "[future]" in navigation
-3. Add content when ready (structure already exists)
-
----
-
-## Validation Checklist
-
-### Pre-Execution Validation
-
-- [ ] Search for all references to files being deleted
-- [ ] Identify all profiles that need updates
-- [ ] Identify all agents that need updates
-- [ ] Backup current state (git commit)
-
-### Post-Execution Validation
-
-- [ ] All duplicate files removed
-- [ ] react-patterns.md moved to frontend/react/
-- [ ] All navigation files updated
-- [ ] Developer profile updated and tested
-- [ ] All external references updated
-- [ ] No broken links in navigation
-- [ ] File count: 26 files (down from 36)
-- [ ] Structure follows Pattern B (Concern-Based)
-- [ ] All content still accessible
-- [ ] No loss of information
-
----
-
-## Execution Plan
-
-### Step-by-Step Execution
-
-**Prerequisites**:
-1. ✅ Audit complete
-2. ✅ Plan reviewed and approved
-3. ⏳ All references identified
-4. ⏳ Backup created (git commit)
-
-**Execution Order**:
-
-1. **Search for references** (5 min)
-   ```bash
-   # Run search commands from Risk Analysis section
-   # Document all findings
-   ```
-
-2. **Create backup** (1 min)
-   ```bash
-   git add .opencode/context/development/
-   git commit -m "backup: development context before reorganization"
-   ```
-
-3. **Create new directory structure** (1 min)
-   ```bash
-   mkdir -p .opencode/context/development/frontend/react
-   ```
-
-4. **Move files** (1 min)
-   ```bash
-   mv .opencode/context/development/react-patterns.md \
-      .opencode/context/development/frontend/react/react-patterns.md
-   ```
-
-5. **Delete duplicate files** (1 min)
-   ```bash
-   rm .opencode/context/development/animation-patterns.md
-   rm .opencode/context/development/design-systems.md
-   rm .opencode/context/development/ui-styling-standards.md
-   rm .opencode/context/development/design-assets.md
-   rm .opencode/context/development/clean-code.md
-   rm .opencode/context/development/api-design.md
-   ```
-
-6. **Delete redundant READMEs** (1 min)
-   ```bash
-   rm .opencode/context/development/README.md
-   rm .opencode/context/development/ai/mastra-ai/README.md
-   ```
-
-7. **Create new navigation file** (5 min)
-   - Create `development/frontend/react/navigation.md`
-
-8. **Update existing navigation files** (10 min)
-   - Update `development/navigation.md`
-   - Update `development/ui-navigation.md`
-   - Update `development/frontend/navigation.md`
-
-9. **Update developer profile** (5 min)
-   - Update `.opencode/profiles/developer/profile.json`
-
-10. **Update any other references** (10 min)
-    - Update all identified references from step 1
-
-11. **Validate changes** (10 min)
-    - Run validation checklist
-    - Test developer profile
-    - Check navigation flow
-
-12. **Commit changes** (2 min)
-    ```bash
-    git add .opencode/
-    git commit -m "refactor: reorganize development context - remove duplicates, move react patterns"
-    ```
-
-**Total estimated time**: 50 minutes
-
----
-
-## Rollback Plan
-
-If issues are discovered after execution:
-
-```bash
-# Rollback to backup commit
-git log --oneline | head -5  # Find backup commit hash
-git reset --hard <backup-commit-hash>
-
-# Or restore specific files
-git checkout <backup-commit-hash> -- .opencode/context/development/
-git checkout <backup-commit-hash> -- .opencode/profiles/developer/profile.json
-```
-
----
-
-## Recommendation
-
-**Proceed with reorganization**: ✅ **APPROVED**
-
-**Rationale**:
-1. Clear benefits (eliminates duplicates, improves organization)
-2. Manageable risks (can be mitigated with proper search and backup)
-3. Aligns with context system standards
-4. Improves long-term maintainability
-5. Reduces confusion and token waste
-
-**Next Steps**:
-1. **Review this plan** - Ensure all stakeholders agree
-2. **Search for references** - Identify all files that need updates
-3. **Execute plan** - Follow step-by-step execution order
-4. **Validate changes** - Run validation checklist
-5. **Monitor for issues** - Watch for broken references in next few days
-
-**Approval needed from**: Context system owner, developer profile maintainers
-
----
-
-## Appendix A: File Details
-
-### Files to Delete (9 files)
-
-| File | Size | Reason | Canonical Location |
-|------|------|--------|-------------------|
-| `development/animation-patterns.md` | 753 lines | Duplicate | `ui/web/animation-patterns.md` |
-| `development/design-systems.md` | 381 lines | Duplicate | `ui/web/design-systems.md` |
-| `development/ui-styling-standards.md` | 552 lines | Duplicate | `ui/web/ui-styling-standards.md` |
-| `development/design-assets.md` | 567 lines | Duplicate | `ui/web/design-assets.md` |
-| `development/clean-code.md` | 176 lines | Duplicate | `development/principles/clean-code.md` |
-| `development/api-design.md` | 384 lines | Duplicate (shorter) | `development/principles/api-design.md` (415 lines) |
-| `development/README.md` | 46 lines | Redundant | `development/navigation.md` |
-| `development/ai/mastra-ai/README.md` | 43 lines | Redundant | `development/ai/mastra-ai/navigation.md` |
-
-**Total lines deleted**: 2,902 lines (all duplicate content)
-
-### Files to Move (1 file)
-
-| File | From | To | Size |
-|------|------|----|----|
-| `react-patterns.md` | `development/` | `development/frontend/react/` | 328 lines |
-
-### Files to Create (1 file)
-
-| File | Location | Purpose |
-|------|----------|---------|
-| `navigation.md` | `development/frontend/react/` | Navigation for React subcategory |
-
-### Files to Update (4 files)
-
-| File | Changes |
-|------|---------|
-| `development/navigation.md` | Update structure tree, remove deleted files, mark frontend as active |
-| `development/ui-navigation.md` | Update paths, remove deleted file references |
-| `development/frontend/navigation.md` | Add react/ subdirectory, update from placeholder |
-| `.opencode/profiles/developer/profile.json` | Update 4 file paths to ui/web/ |
-
----
-
-## Appendix B: Context System Standards Compliance
-
-### Pattern B (Concern-Based) Compliance
-
-✅ **Organized by concern** (frontend, backend, principles, ai, frameworks)  
-✅ **Then by approach/tech** (react, mastra-ai, tanstack-start)  
-✅ **Universal principles separated** (principles/ folder)  
-✅ **Specialized navigation for cross-cutting concerns** (ui-navigation.md, backend-navigation.md)  
-✅ **Function-based within tech** (mastra-ai uses concepts/examples/guides/lookup/errors)  
-
-### Navigation Design Compliance
-
-✅ **navigation.md at each level** (category, subcategory)  
-✅ **Token-efficient** (200-300 tokens per navigation file)  
-✅ **Scannable structure** (ASCII trees, tables)  
-✅ **Quick routes** (task-based navigation)  
-⚠️ **README.md removed** (replaced with navigation.md per standards)  
-
-### Structure Standards Compliance
-
-✅ **No flat files at root** (after reorganization)  
-✅ **Clear hierarchy** (concern → approach/tech → files)  
-✅ **Consistent naming** (kebab-case)  
-✅ **No duplicates** (after reorganization)  
-
----
-
-## Appendix C: Search Commands Reference
-
-```bash
-# Find all references to files being deleted
-grep -r "development/animation-patterns" .opencode/ 2>/dev/null
-grep -r "development/design-systems" .opencode/ 2>/dev/null
-grep -r "development/ui-styling-standards" .opencode/ 2>/dev/null
-grep -r "development/design-assets" .opencode/ 2>/dev/null
-grep -r "development/clean-code" .opencode/ 2>/dev/null
-grep -r "development/api-design" .opencode/ 2>/dev/null
-grep -r "development/react-patterns" .opencode/ 2>/dev/null
-
-# Find all profile files
-find .opencode/profiles -name "*.json" -type f
-
-# Find all agent files
-find .opencode/agents -name "*.md" -type f 2>/dev/null
-
-# Count files before
-find .opencode/context/development -type f -name "*.md" | wc -l
-
-# Count files after (should be 26)
-find .opencode/context/development -type f -name "*.md" | wc -l
-```
-
----
-
-**End of Reorganization Plan**

.opencode/context/development/REORGANIZATION_SUMMARY.md

@@ -1,267 +0,0 @@
-# Development Context Reorganization - Executive Summary
-
-**Date**: 2026-01-30  
-**Status**: ✅ READY FOR APPROVAL  
-**Estimated Time**: 50 minutes  
-**Risk Level**: 🟡 Medium (manageable with proper execution)
-
----
-
-## Quick Overview
-
-### The Problem
-
-The `.opencode/context/development/` folder has **36 files** with significant organizational issues:
-
-- **7 duplicate files** (exact copies exist elsewhere)
-- **5 UI/design files** misplaced in development folder
-- **2 redundant README files** (should use navigation.md)
-- **Inconsistent structure** (flat files mixed with organized subdirectories)
-
-### The Solution
-
-**Reorganize to follow Pattern B (Concern-Based)** structure:
-- ✅ Delete 7 duplicate files
-- ✅ Delete 2 redundant READMEs  
-- ✅ Move 1 misplaced file (react-patterns.md)
-- ✅ Update 4 navigation files
-- ✅ Update 1 profile file
-- ✅ Update 3 core context files
-
-**Result**: Clean, standards-compliant structure with **26 files** (down from 36)
-
----
-
-## What Changes
-
-### Files to Delete (9 files)
-
-| File | Reason | Canonical Location |
-|------|--------|-------------------|
-| `animation-patterns.md` | Duplicate | `ui/web/animation-patterns.md` |
-| `design-systems.md` | Duplicate | `ui/web/design-systems.md` |
-| `ui-styling-standards.md` | Duplicate | `ui/web/ui-styling-standards.md` |
-| `design-assets.md` | Duplicate | `ui/web/design-assets.md` |
-| `clean-code.md` | Duplicate | `principles/clean-code.md` |
-| `api-design.md` | Duplicate (shorter) | `principles/api-design.md` |
-| `README.md` | Redundant | Use `navigation.md` instead |
-| `ai/mastra-ai/README.md` | Redundant | Use `navigation.md` instead |
-
-### Files to Move (1 file)
-
-| File | From | To |
-|------|------|-----|
-| `react-patterns.md` | `development/` (root) | `development/frontend/react/` |
-
-### Files to Update (8 files)
-
-**Navigation files** (4):
-- `development/navigation.md` - Update structure tree
-- `development/ui-navigation.md` - Update paths
-- `development/frontend/navigation.md` - Add react subdirectory
-- `development/frontend/react/navigation.md` - **NEW FILE**
-
-**Profile files** (1):
-- `.opencode/profiles/developer/profile.json` - Update 4 paths
-
-**Core context files** (3):
-- `.opencode/context/core/visual-development.md` - Update 4 paths
-- `.opencode/context/core/workflows/design-iteration.md` - Update 4 paths
-- `.opencode/context/openagents-repo/lookup/file-locations.md` - Update 1 path
-
----
-
-## Impact Summary
-
-### ✅ Benefits
-
-1. **Eliminates Confusion** - Single source of truth for each file
-2. **Reduces Maintenance** - No duplicate content to update
-3. **Improves Organization** - Follows Pattern B (Concern-Based) consistently
-4. **Saves Tokens** - Removes duplicate content from context loading
-5. **Aligns with Standards** - Follows context system organizing guide
-
-### ⚠️ Breaking Changes
-
-**8 files need updates** to maintain functionality:
-
-| File | Current Reference | New Reference |
-|------|------------------|---------------|
-| `developer/profile.json` | `development/animation-patterns` | `ui/web/animation-patterns` |
-| `developer/profile.json` | `development/design-systems` | `ui/web/design-systems` |
-| `developer/profile.json` | `development/ui-styling-standards` | `ui/web/ui-styling-standards` |
-| `developer/profile.json` | `development/design-assets` | `ui/web/design-assets` |
-| `core/visual-development.md` | `development/animation-patterns.md` | `ui/web/animation-patterns.md` |
-| `core/visual-development.md` | `development/design-systems.md` | `ui/web/design-systems.md` |
-| `core/visual-development.md` | `development/ui-styling-standards.md` | `ui/web/ui-styling-standards.md` |
-| `core/workflows/design-iteration.md` | `../development/animation-patterns.md` | `../ui/web/animation-patterns.md` |
-| `core/workflows/design-iteration.md` | `../development/design-systems.md` | `../ui/web/design-systems.md` |
-| `core/workflows/design-iteration.md` | `../development/ui-styling-standards.md` | `../ui/web/ui-styling-standards.md` |
-| `core/workflows/design-iteration.md` | `../development/design-assets.md` | `../ui/web/design-assets.md` |
-| `openagents-repo/lookup/file-locations.md` | `development/react-patterns.md` | `development/frontend/react/react-patterns.md` |
-
-**All references identified** - No unknown breaking changes
-
----
-
-## Before/After Structure
-
-### Before (36 files)
-```
-development/
-├── [11 ROOT FILES - 7 MISPLACED]
-│   ├── navigation.md
-│   ├── README.md                      ❌ Redundant
-│   ├── ui-navigation.md
-│   ├── backend-navigation.md
-│   ├── fullstack-navigation.md
-│   ├── clean-code.md                  ❌ Duplicate
-│   ├── api-design.md                  ❌ Duplicate
-│   ├── react-patterns.md              ⚠️ Misplaced
-│   ├── animation-patterns.md          ❌ Duplicate
-│   ├── design-systems.md              ❌ Duplicate
-│   ├── ui-styling-standards.md        ❌ Duplicate
-│   └── design-assets.md               ❌ Duplicate
-├── principles/ (3 files)
-├── ai/mastra-ai/ (13 files)
-├── frameworks/ (2 files)
-├── frontend/ (1 file - empty)
-├── backend/ (1 file - empty)
-├── data/ (1 file - empty)
-├── integration/ (1 file - empty)
-└── infrastructure/ (1 file - empty)
-```
-
-### After (26 files)
-```
-development/
-├── [4 ROOT FILES - ALL NAVIGATION]
-│   ├── navigation.md                  ✅ Updated
-│   ├── ui-navigation.md               ✅ Updated
-│   ├── backend-navigation.md          ✅ Kept
-│   └── fullstack-navigation.md        ✅ Kept
-├── principles/ (3 files)              ✅ Canonical source
-├── ai/mastra-ai/ (12 files)           ✅ README removed
-├── frameworks/ (2 files)              ✅ Kept
-├── frontend/                          ✅ Now active
-│   ├── navigation.md                  ✅ Updated
-│   └── react/
-│       ├── navigation.md              🆕 New
-│       └── react-patterns.md          ✅ Moved
-├── backend/ (1 file)                  ✅ Placeholder
-├── data/ (1 file)                     ✅ Placeholder
-├── integration/ (1 file)              ✅ Placeholder
-└── infrastructure/ (1 file)           ✅ Placeholder
-```
-
-**Key improvements**:
-- ✅ No flat files at root (except navigation)
-- ✅ No duplicate content
-- ✅ Clear concern-based organization
-- ✅ React patterns in appropriate location
-- ✅ Follows context system standards
-
----
-
-## Execution Plan
-
-### Prerequisites
-1. ✅ Audit complete
-2. ✅ All references identified (8 files)
-3. ⏳ Plan approved
-4. ⏳ Backup created
-
-### Steps (50 minutes)
-
-1. **Create backup** (1 min)
-2. **Create new directories** (1 min)
-3. **Move react-patterns.md** (1 min)
-4. **Delete 7 duplicate files** (1 min)
-5. **Delete 2 redundant READMEs** (1 min)
-6. **Create new navigation file** (5 min)
-7. **Update 3 existing navigation files** (10 min)
-8. **Update developer profile** (5 min)
-9. **Update 3 core context files** (15 min)
-10. **Validate changes** (10 min)
-
-### Validation Checklist
-
-- [ ] File count: 26 (down from 36)
-- [ ] No duplicate files
-- [ ] react-patterns.md in frontend/react/
-- [ ] All 8 references updated
-- [ ] Developer profile works
-- [ ] Navigation links work
-- [ ] No broken references
-
----
-
-## Risk Assessment
-
-### 🟢 Low Risk
-- All references identified (no unknowns)
-- Changes are reversible (git backup)
-- No loss of information (moves, not deletes)
-
-### 🟡 Medium Risk
-- 8 files need updates (manageable)
-- Developer profile temporarily broken during execution
-- Navigation needs careful updating
-
-### 🔴 High Risk
-- None identified
-
-**Mitigation**: Execute all updates in single commit, test immediately after
-
----
-
-## Recommendation
-
-### ✅ PROCEED WITH REORGANIZATION
-
-**Why**:
-1. Clear benefits (eliminates duplicates, improves organization)
-2. All risks identified and manageable
-3. Aligns with context system standards
-4. Improves long-term maintainability
-5. No loss of information
-
-**Next Steps**:
-1. ✅ Review this summary
-2. ⏳ Approve reorganization plan
-3. ⏳ Execute step-by-step plan
-4. ⏳ Validate all changes
-5. ⏳ Monitor for issues
-
----
-
-## Files to Review
-
-1. **Full Plan**: `REORGANIZATION_PLAN.md` (detailed 50-page plan)
-2. **This Summary**: `REORGANIZATION_SUMMARY.md` (you are here)
-
----
-
-## Questions?
-
-**Q: Will this break anything?**  
-A: Yes, temporarily. 8 files need updates, but all are identified and will be updated in the same commit.
-
-**Q: Can we rollback if needed?**  
-A: Yes, git backup will be created before any changes.
-
-**Q: How long will it take?**  
-A: ~50 minutes for complete execution and validation.
-
-**Q: What if we find more references later?**  
-A: Unlikely - comprehensive search completed. But if found, easy to update (just path changes).
-
-**Q: Why not keep duplicates?**  
-A: Duplicates cause confusion, maintenance burden, and waste tokens. Single source of truth is better.
-
-**Q: Why move react-patterns.md?**  
-A: React-specific patterns belong in frontend/react/, not at root level. Follows concern-based organization.
-
----
-
-**Ready to proceed?** Review the full plan in `REORGANIZATION_PLAN.md` and approve for execution.

.opencode/context/development/VISUAL_COMPARISON.md

@@ -1,529 +0,0 @@
-# Development Context - Visual Before/After Comparison
-
-**Date**: 2026-01-30
-
----
-
-## File Count Comparison
-
-```
-BEFORE: 36 files
-AFTER:  26 files
-CHANGE: -10 files (27% reduction)
-```
-
----
-
-## Directory Tree Comparison
-
-### BEFORE (Current State)
-
-```
-development/                                    [36 files total]
-│
-├── 📄 navigation.md                            ✅ Keep
-├── 📄 README.md                                ❌ DELETE (redundant)
-├── 📄 ui-navigation.md                         ✅ Keep (update paths)
-├── 📄 backend-navigation.md                    ✅ Keep
-├── 📄 fullstack-navigation.md                  ✅ Keep
-│
-├── 📄 clean-code.md                            ❌ DELETE (duplicate of principles/)
-├── 📄 api-design.md                            ❌ DELETE (duplicate of principles/)
-├── 📄 react-patterns.md                        ⚠️  MOVE to frontend/react/
-├── 📄 animation-patterns.md                    ❌ DELETE (duplicate of ui/web/)
-├── 📄 design-systems.md                        ❌ DELETE (duplicate of ui/web/)
-├── 📄 ui-styling-standards.md                  ❌ DELETE (duplicate of ui/web/)
-├── 📄 design-assets.md                         ❌ DELETE (duplicate of ui/web/)
-│
-├── 📁 principles/                              ✅ Keep (canonical source)
-│   ├── 📄 navigation.md
-│   ├── 📄 clean-code.md                        [176 lines]
-│   └── 📄 api-design.md                        [415 lines - more complete]
-│
-├── 📁 ai/
-│   ├── 📄 navigation.md
-│   └── 📁 mastra-ai/
-│       ├── 📄 navigation.md
-│       ├── 📄 README.md                        ❌ DELETE (redundant)
-│       ├── 📁 concepts/                        [5 files]
-│       ├── 📁 examples/                        [1 file]
-│       ├── 📁 guides/                          [3 files]
-│       ├── 📁 lookup/                          [1 file]
-│       └── 📁 errors/                          [1 file]
-│
-├── 📁 frameworks/
-│   ├── 📄 navigation.md
-│   └── 📁 tanstack-start/
-│       └── 📄 navigation.md
-│
-├── 📁 frontend/                                ⚠️  Empty placeholder
-│   └── 📄 navigation.md
-│
-├── 📁 backend/                                 ⚠️  Empty placeholder
-│   └── 📄 navigation.md
-│
-├── 📁 data/                                    ⚠️  Empty placeholder
-│   └── 📄 navigation.md
-│
-├── 📁 integration/                             ⚠️  Empty placeholder
-│   └── 📄 navigation.md
-│
-└── 📁 infrastructure/                          ⚠️  Empty placeholder
-    └── 📄 navigation.md
-```
-
----
-
-### AFTER (Proposed State)
-
-```
-development/                                    [26 files total]
-│
-├── 📄 navigation.md                            ✅ Updated (structure tree)
-├── 📄 ui-navigation.md                         ✅ Updated (paths to ui/web/)
-├── 📄 backend-navigation.md                    ✅ Kept
-├── 📄 fullstack-navigation.md                  ✅ Kept
-│
-├── 📁 principles/                              ✅ Canonical source
-│   ├── 📄 navigation.md
-│   ├── 📄 clean-code.md                        [176 lines]
-│   └── 📄 api-design.md                        [415 lines]
-│
-├── 📁 ai/
-│   ├── 📄 navigation.md
-│   └── 📁 mastra-ai/
-│       ├── 📄 navigation.md
-│       ├── 📁 concepts/                        [5 files]
-│       ├── 📁 examples/                        [1 file]
-│       ├── 📁 guides/                          [3 files]
-│       ├── 📁 lookup/                          [1 file]
-│       └── 📁 errors/                          [1 file]
-│
-├── 📁 frameworks/
-│   ├── 📄 navigation.md
-│   └── 📁 tanstack-start/
-│       └── 📄 navigation.md
-│
-├── 📁 frontend/                                ✅ Now active!
-│   ├── 📄 navigation.md                        ✅ Updated
-│   └── 📁 react/
-│       ├── 📄 navigation.md                    🆕 NEW FILE
-│       └── 📄 react-patterns.md                ✅ Moved here
-│
-├── 📁 backend/                                 ⚠️  Placeholder (future)
-│   └── 📄 navigation.md
-│
-├── 📁 data/                                    ⚠️  Placeholder (future)
-│   └── 📄 navigation.md
-│
-├── 📁 integration/                             ⚠️  Placeholder (future)
-│   └── 📄 navigation.md
-│
-└── 📁 infrastructure/                          ⚠️  Placeholder (future)
-    └── 📄 navigation.md
-```
-
----
-
-## File Operations Summary
-
-### 🗑️ DELETE (9 files)
-
-```
-❌ development/README.md                        → Use navigation.md instead
-❌ development/clean-code.md                    → Use principles/clean-code.md
-❌ development/api-design.md                    → Use principles/api-design.md
-❌ development/animation-patterns.md            → Use ui/web/animation-patterns.md
-❌ development/design-systems.md                → Use ui/web/design-systems.md
-❌ development/ui-styling-standards.md          → Use ui/web/ui-styling-standards.md
-❌ development/design-assets.md                 → Use ui/web/design-assets.md
-❌ development/ai/mastra-ai/README.md           → Use navigation.md instead
-```
-
-### 📦 MOVE (1 file)
-
-```
-📦 development/react-patterns.md
-   → development/frontend/react/react-patterns.md
-```
-
-### 🆕 CREATE (1 file)
-
-```
-🆕 development/frontend/react/navigation.md     → New navigation file
-```
-
-### ✏️ UPDATE (7 files)
-
-```
-✏️ development/navigation.md                    → Update structure tree
-✏️ development/ui-navigation.md                 → Update paths
-✏️ development/frontend/navigation.md           → Add react subdirectory
-✏️ .opencode/profiles/developer/profile.json   → Update 4 paths
-✏️ .opencode/context/core/visual-development.md → Update 4 paths
-✏️ .opencode/context/core/workflows/design-iteration.md → Update 4 paths
-✏️ .opencode/context/openagents-repo/lookup/file-locations.md → Update 1 path
-```
-
----
-
-## Root Level Files Comparison
-
-### BEFORE: 11 files at root (7 misplaced)
-
-```
-development/
-├── navigation.md                   ✅ Navigation (correct)
-├── README.md                       ❌ Redundant
-├── ui-navigation.md                ✅ Navigation (correct)
-├── backend-navigation.md           ✅ Navigation (correct)
-├── fullstack-navigation.md         ✅ Navigation (correct)
-├── clean-code.md                   ❌ Should be in principles/
-├── api-design.md                   ❌ Should be in principles/
-├── react-patterns.md               ❌ Should be in frontend/react/
-├── animation-patterns.md           ❌ Should be in ui/web/
-├── design-systems.md               ❌ Should be in ui/web/
-├── ui-styling-standards.md         ❌ Should be in ui/web/
-└── design-assets.md                ❌ Should be in ui/web/
-```
-
-### AFTER: 4 files at root (all navigation)
-
-```
-development/
-├── navigation.md                   ✅ Main navigation
-├── ui-navigation.md                ✅ Specialized navigation
-├── backend-navigation.md           ✅ Specialized navigation
-└── fullstack-navigation.md         ✅ Specialized navigation
-```
-
-**Result**: Clean root level with only navigation files
-
----
-
-## Duplicate Files Visualization
-
-### Duplicate Set 1: UI/Design Files (4 files)
-
-```
-❌ development/animation-patterns.md     [753 lines]
-   ↓ EXACT DUPLICATE ↓
-✅ ui/web/animation-patterns.md          [753 lines] ← KEEP THIS
-
-❌ development/design-systems.md         [381 lines]
-   ↓ EXACT DUPLICATE ↓
-✅ ui/web/design-systems.md              [381 lines] ← KEEP THIS
-
-❌ development/ui-styling-standards.md   [552 lines]
-   ↓ EXACT DUPLICATE ↓
-✅ ui/web/ui-styling-standards.md        [552 lines] ← KEEP THIS
-
-❌ development/design-assets.md          [567 lines]
-   ↓ EXACT DUPLICATE ↓
-✅ ui/web/design-assets.md               [567 lines] ← KEEP THIS
-```
-
-**Total duplicate lines**: 2,253 lines
-
-### Duplicate Set 2: Principle Files (2 files)
-
-```
-❌ development/clean-code.md             [176 lines]
-   ↓ EXACT DUPLICATE ↓
-✅ development/principles/clean-code.md  [176 lines] ← KEEP THIS
-
-❌ development/api-design.md             [384 lines]
-   ↓ SIMILAR BUT SHORTER ↓
-✅ development/principles/api-design.md  [415 lines] ← KEEP THIS (more complete)
-```
-
-**Total duplicate lines**: 560 lines
-
-### Duplicate Set 3: README Files (2 files)
-
-```
-❌ development/README.md                 [46 lines]
-   ↓ REDUNDANT WITH ↓
-✅ development/navigation.md             [90 lines] ← KEEP THIS
-
-❌ development/ai/mastra-ai/README.md    [43 lines]
-   ↓ REDUNDANT WITH ↓
-✅ development/ai/mastra-ai/navigation.md [33 lines] ← KEEP THIS
-```
-
-**Total redundant lines**: 89 lines
-
----
-
-## Reference Updates Required
-
-### Developer Profile (4 updates)
-
-```diff
-  {
-    "context": [
--     "context:development/ui-styling-standards",
-+     "context:ui/web/ui-styling-standards",
-
--     "context:development/design-systems",
-+     "context:ui/web/design-systems",
-
--     "context:development/design-assets",
-+     "context:ui/web/design-assets",
-
--     "context:development/animation-patterns"
-+     "context:ui/web/animation-patterns"
-    ]
-  }
-```
-
-### Core Context Files (3 files, 11 updates)
-
-**File 1**: `.opencode/context/core/visual-development.md`
-
-```diff
-- | **Animation patterns** | `development/animation-patterns.md` | - | - |
-+ | **Animation patterns** | `ui/web/animation-patterns.md` | - | - |
-
-- | **Design system** | `development/design-systems.md` | - | - |
-+ | **Design system** | `ui/web/design-systems.md` | - | - |
-
-- | **UI standards** | `development/ui-styling-standards.md` | - | - |
-+ | **UI standards** | `ui/web/ui-styling-standards.md` | - | - |
-
-- - **Animation Patterns**: `.opencode/context/development/animation-patterns.md`
-+ - **Animation Patterns**: `.opencode/context/ui/web/animation-patterns.md`
-
-- - **Design Systems**: `.opencode/context/development/design-systems.md`
-+ - **Design Systems**: `.opencode/context/ui/web/design-systems.md`
-
-- - **UI Styling Standards**: `.opencode/context/development/ui-styling-standards.md`
-+ - **UI Styling Standards**: `.opencode/context/ui/web/ui-styling-standards.md`
-```
-
-**File 2**: `.opencode/context/core/workflows/design-iteration.md`
-
-```diff
-- - [Animation Patterns](../development/animation-patterns.md)
-+ - [Animation Patterns](../ui/web/animation-patterns.md)
-
-- - [Design Systems Context](../development/design-systems.md)
-+ - [Design Systems Context](../ui/web/design-systems.md)
-
-- - [UI Styling Standards](../development/ui-styling-standards.md)
-+ - [UI Styling Standards](../ui/web/ui-styling-standards.md)
-
-- - [Design Assets](../development/design-assets.md)
-+ - [Design Assets](../ui/web/design-assets.md)
-```
-
-**File 3**: `.opencode/context/openagents-repo/lookup/file-locations.md`
-
-```diff
-- - `.opencode/context/development/react-patterns.md`
-+ - `.opencode/context/development/frontend/react/react-patterns.md`
-```
-
----
-
-## Navigation Updates Required
-
-### Update 1: development/navigation.md
-
-**Changes**:
-- Remove 7 deleted files from structure tree
-- Update frontend/ from "[future]" to active
-- Add react/ subdirectory
-
-```diff
-  ## Structure
-  
-  ```
-  development/
-  ├── navigation.md
-- ├── README.md
-  ├── ui-navigation.md
-  ├── backend-navigation.md
-  ├── fullstack-navigation.md
-- ├── clean-code.md
-- ├── api-design.md
-- ├── react-patterns.md
-- ├── animation-patterns.md
-- ├── design-systems.md
-- ├── ui-styling-standards.md
-- ├── design-assets.md
-  │
-  ├── principles/
-  │   ├── navigation.md
-  │   ├── clean-code.md
-  │   └── api-design.md
-  │
-- ├── frontend/                  # [future]
-+ ├── frontend/
-  │   ├── navigation.md
-- │   ├── react/
-- │   ├── vue/
-- │   └── state-management/
-+ │   └── react/
-+ │       ├── navigation.md
-+ │       └── react-patterns.md
-  ```
-```
-
-### Update 2: development/ui-navigation.md
-
-**Changes**:
-- Update React patterns path
-- Confirm all UI routes point to ui/web/
-
-```diff
-  | Task | Path |
-  |------|------|
-- | **React patterns** | `frontend/react/hooks-patterns.md` [future] |
-+ | **React patterns** | `frontend/react/react-patterns.md` |
-  | **TanStack Query** | `frontend/react/tanstack/query-patterns.md` [future] |
-  | **Animations** | `../../ui/web/animation-patterns.md` |
-  | **Styling** | `../../ui/web/ui-styling-standards.md` |
-  | **Design systems** | `../../ui/web/design-systems.md` |
-```
-
-### Update 3: development/frontend/navigation.md
-
-**Changes**:
-- Add react/ subdirectory
-- Update from placeholder to active
-
-```diff
-  ## Structure
-  
-  ```
-  frontend/
-  ├── navigation.md
-- ├── react/                     # [future]
-- ├── vue/                       # [future]
-- └── state-management/          # [future]
-+ └── react/
-+     ├── navigation.md
-+     └── react-patterns.md
-  ```
-  
-+ ---
-+ 
-+ ## Quick Routes
-+ 
-+ | Task | Path |
-+ |------|------|
-+ | **React patterns** | `react/react-patterns.md` |
-```
-
-### Create 4: development/frontend/react/navigation.md (NEW)
-
-**New file**:
-
-```markdown
-# React Development
-
-**Purpose**: Modern React patterns, hooks, and component design
-
----
-
-## Files
-
-| File | Description | Priority |
-|------|-------------|----------|
-| [react-patterns.md](react-patterns.md) | React hooks, components, state management | high |
-
----
-
-## Related Context
-
-- **UI Styling** → `../../../ui/web/ui-styling-standards.md`
-- **Animations** → `../../../ui/web/animation-patterns.md`
-- **Clean Code** → `../../principles/clean-code.md`
-```
-
----
-
-## Impact Visualization
-
-### Token Savings
-
-```
-BEFORE: 2,902 lines of duplicate content
-AFTER:  0 lines of duplicate content
-SAVED:  2,902 lines (~3,773 tokens)
-```
-
-### Maintenance Burden
-
-```
-BEFORE: Update content in 2-3 places
-AFTER:  Update content in 1 place
-SAVED:  50-66% maintenance time
-```
-
-### Confusion Factor
-
-```
-BEFORE: "Which file is canonical?"
-AFTER:  "Single source of truth"
-RESULT: Clear ownership
-```
-
-### Organization Score
-
-```
-BEFORE: 7/11 root files misplaced (64% misplaced)
-AFTER:  0/4 root files misplaced (0% misplaced)
-IMPROVEMENT: 100% improvement
-```
-
----
-
-## Validation Checklist
-
-After execution, verify:
-
-- [ ] File count: 26 (down from 36)
-- [ ] Root level: 4 files (all navigation)
-- [ ] No duplicate files exist
-- [ ] react-patterns.md in frontend/react/
-- [ ] Developer profile works (4 paths updated)
-- [ ] Core context files work (11 paths updated)
-- [ ] All navigation links work
-- [ ] No broken references
-- [ ] frontend/ directory is active (not placeholder)
-- [ ] All README.md files removed
-
----
-
-## Summary
-
-### What We're Doing
-
-1. **Deleting** 9 files (7 duplicates, 2 redundant READMEs)
-2. **Moving** 1 file (react-patterns.md to frontend/react/)
-3. **Creating** 1 file (frontend/react/navigation.md)
-4. **Updating** 7 files (4 navigation, 1 profile, 3 core context)
-
-### Why We're Doing It
-
-1. **Eliminate duplicates** - Single source of truth
-2. **Improve organization** - Concern-based structure
-3. **Align with standards** - Context system compliance
-4. **Reduce maintenance** - Update once, not 2-3 times
-5. **Save tokens** - No duplicate content loading
-
-### Result
-
-Clean, standards-compliant development context folder with:
-- ✅ 26 files (down from 36)
-- ✅ No duplicates
-- ✅ Clear organization
-- ✅ Pattern B (Concern-Based) structure
-- ✅ All content accessible
-- ✅ No loss of information
-
----
-
-**Ready to proceed?** See `REORGANIZATION_PLAN.md` for detailed execution steps.

.opencode/context/development/frontend/navigation.md

@@ -9,6 +9,7 @@
 ```
 frontend/
 ├── navigation.md
+├── when-to-delegate.md
 └── react/
     ├── navigation.md
     └── react-patterns.md
@@ -20,6 +21,7 @@ frontend/
 
 | Task | Path |
 |------|------|
+| **When to delegate** | `when-to-delegate.md` |
 | **React patterns** | `react/react-patterns.md` |
 | **React navigation** | `react/navigation.md` |
 

.opencode/context/development/frontend/when-to-delegate.md

@@ -0,0 +1,468 @@
+<!-- Context: development/frontend/when-to-delegate | Priority: high | Version: 1.0 | Updated: 2026-01-30 -->
+# When to Delegate to Frontend Specialist
+
+## Overview
+
+Clear decision criteria for when to delegate frontend/UI work to the **frontend-specialist** subagent vs. handling it directly.
+
+## Quick Reference
+
+**Delegate to frontend-specialist when**:
+- UI/UX design work (wireframes, themes, animations)
+- Design system implementation
+- Complex responsive layouts
+- Animation and micro-interactions
+- Visual design iterations
+
+**Handle directly when**:
+- Simple HTML/CSS edits
+- Single component updates
+- Bug fixes in existing UI
+- Minor styling tweaks
+
+---
+
+## Decision Matrix
+
+### ✅ DELEGATE to Frontend-Specialist
+
+| Scenario | Why Delegate | Example |
+|----------|--------------|---------|
+| **New UI design from scratch** | Needs staged workflow (layout → theme → animation → implement) | "Create a landing page for our product" |
+| **Design system work** | Requires ContextScout for standards, ExternalScout for UI libs | "Implement our design system with Tailwind + Shadcn" |
+| **Complex responsive layouts** | Needs mobile-first approach across breakpoints | "Build a dashboard with sidebar, cards, and responsive grid" |
+| **Animation implementation** | Requires animation patterns, performance optimization | "Add smooth transitions and micro-interactions to the UI" |
+| **Multi-stage design iterations** | Needs versioning (design_iterations/ folder) | "Design a checkout flow with 3 steps" |
+| **Theme creation** | Requires OKLCH colors, CSS custom properties | "Create a dark mode theme for the app" |
+| **Component library integration** | Needs ExternalScout for current docs (Flowbite, Radix, etc.) | "Integrate Flowbite components into our app" |
+| **Accessibility-focused UI** | Requires WCAG compliance, ARIA attributes | "Build an accessible form with proper labels and validation" |
+
+### ⚠️ HANDLE DIRECTLY (Don't Delegate)
+
+| Scenario | Why Direct | Example |
+|----------|------------|---------|
+| **Simple HTML edits** | Single file, straightforward change | "Change the button text from 'Submit' to 'Send'" |
+| **Minor CSS tweaks** | Small styling adjustment | "Make the header padding 20px instead of 16px" |
+| **Bug fixes** | Fixing existing code, not creating new design | "Fix the broken link in the footer" |
+| **Content updates** | Changing text, images, or data | "Update the hero section copy" |
+| **Single component updates** | Modifying one existing component | "Add a new prop to the Button component" |
+| **Quick prototypes** | Throwaway code for testing | "Create a quick HTML mockup to test an idea" |
+
+---
+
+## Delegation Checklist
+
+Before delegating to frontend-specialist, ensure:
+
+- [ ] **Task is UI/design focused** (not backend, logic, or data)
+- [ ] **Task requires design expertise** (layout, theme, animations)
+- [ ] **Task benefits from staged workflow** (layout → theme → animation → implement)
+- [ ] **Task needs context discovery** (design systems, UI libraries, standards)
+- [ ] **User has approved the approach** (never delegate before approval)
+
+---
+
+## How to Delegate
+
+### Step 1: Discover Context (Optional but Recommended)
+
+If you're unsure what context the frontend-specialist will need:
+
+```javascript
+task(
+  subagent_type="ContextScout",
+  description="Find frontend design context",
+  prompt="Find design system standards, UI component patterns, animation guidelines, and responsive breakpoint conventions for frontend work."
+)
+```
+
+### Step 2: Propose Approach
+
+Present a plan to the user:
+
+```markdown
+## Implementation Plan
+
+**Task**: Create landing page with hero section, features grid, and CTA
+
+**Approach**: Delegate to frontend-specialist subagent
+
+**Why**: 
+- Requires design system implementation
+- Needs responsive layout across breakpoints
+- Includes animations and micro-interactions
+- Benefits from staged workflow (layout → theme → animation → implement)
+
+**Context Needed**:
+- Design system standards (ui/web/design-systems.md)
+- UI styling standards (ui/web/ui-styling-standards.md)
+- Animation patterns (ui/web/animation-patterns.md)
+
+**Approval needed before proceeding.**
+```
+
+### Step 3: Get Approval
+
+Wait for explicit user approval before delegating.
+
+### Step 4: Delegate with Context
+
+**For simple delegation** (no session needed):
+
+```javascript
+task(
+  subagent_type="frontend-specialist",
+  description="Create landing page design",
+  prompt="Context to load:
+  - .opencode/context/ui/web/design-systems.md
+  - .opencode/context/ui/web/ui-styling-standards.md
+  - .opencode/context/ui/web/animation-patterns.md
+  
+  Task: Create a landing page with:
+  - Hero section with headline, subheadline, CTA button
+  - Features grid (3 columns on desktop, 1 on mobile)
+  - Smooth scroll animations
+  
+  Requirements:
+  - Use Tailwind CSS + Flowbite
+  - Mobile-first responsive design
+  - Animations <400ms
+  - Save to design_iterations/landing_1.html
+  
+  Follow your staged workflow:
+  1. Layout (ASCII wireframe)
+  2. Theme (CSS theme file)
+  3. Animation (micro-interactions)
+  4. Implement (HTML file)
+  
+  Request approval between each stage."
+)
+```
+
+**For complex delegation** (with session):
+
+Create session context file first, then delegate with session path.
+
+---
+
+## Common Patterns
+
+### Pattern 1: New Landing Page
+
+**Trigger**: User asks for a new landing page, marketing page, or product page
+
+**Decision**: ✅ Delegate to frontend-specialist
+
+**Why**: Requires full design workflow (layout, theme, animations, implementation)
+
+**Example**:
+```
+User: "Create a landing page for our SaaS product"
+You: [Propose approach] → [Get approval] → [Delegate to frontend-specialist]
+```
+
+### Pattern 2: Design System Implementation
+
+**Trigger**: User wants to implement or update a design system
+
+**Decision**: ✅ Delegate to frontend-specialist
+
+**Why**: Needs ContextScout for standards, ExternalScout for UI library docs
+
+**Example**:
+```
+User: "Implement our design system using Tailwind and Shadcn"
+You: [Propose approach] → [Get approval] → [Delegate to frontend-specialist]
+```
+
+### Pattern 3: Component Library Integration
+
+**Trigger**: User wants to integrate a UI component library (Flowbite, Radix, etc.)
+
+**Decision**: ✅ Delegate to frontend-specialist
+
+**Why**: Requires ExternalScout for current docs, proper integration patterns
+
+**Example**:
+```
+User: "Add Flowbite components to our app"
+You: [Propose approach] → [Get approval] → [Delegate to frontend-specialist]
+```
+
+### Pattern 4: Animation Work
+
+**Trigger**: User wants animations, transitions, or micro-interactions
+
+**Decision**: ✅ Delegate to frontend-specialist
+
+**Why**: Requires animation patterns, performance optimization (<400ms)
+
+**Example**:
+```
+User: "Add smooth animations to the dashboard"
+You: [Propose approach] → [Get approval] → [Delegate to frontend-specialist]
+```
+
+### Pattern 5: Simple HTML Edit
+
+**Trigger**: User wants to change text, fix a link, or update content
+
+**Decision**: ⚠️ Handle directly (don't delegate)
+
+**Why**: Simple edit, no design work needed
+
+**Example**:
+```
+User: "Change the button text to 'Get Started'"
+You: [Edit the HTML file directly]
+```
+
+### Pattern 6: CSS Bug Fix
+
+**Trigger**: User reports a styling bug or broken layout
+
+**Decision**: ⚠️ Handle directly (don't delegate)
+
+**Why**: Bug fix, not new design work
+
+**Example**:
+```
+User: "The header is overlapping the content on mobile"
+You: [Read the CSS, fix the issue directly]
+```
+
+---
+
+## Red Flags (Don't Delegate)
+
+❌ **User just wants a quick fix** → Handle directly  
+❌ **Task is backend/logic focused** → Wrong subagent (use coder-agent or handle directly)  
+❌ **Task is a single line change** → Handle directly  
+❌ **Task is content update** → Handle directly  
+❌ **Task is testing/validation** → Wrong subagent (use tester)  
+❌ **Task is code review** → Wrong subagent (use reviewer)  
+
+---
+
+## Green Flags (Delegate)
+
+✅ **User wants a new UI design** → Delegate  
+✅ **Task involves design systems** → Delegate  
+✅ **Task requires responsive layouts** → Delegate  
+✅ **Task includes animations** → Delegate  
+✅ **Task needs UI library integration** → Delegate  
+✅ **Task benefits from staged workflow** → Delegate  
+✅ **Task requires design expertise** → Delegate  
+
+---
+
+## Frontend-Specialist Capabilities
+
+**What it does well**:
+- Create complete UI designs from scratch
+- Implement design systems (Tailwind, Shadcn, Flowbite)
+- Build responsive layouts (mobile-first)
+- Add animations and micro-interactions
+- Integrate UI component libraries
+- Create themes with OKLCH colors
+- Follow staged workflow (layout → theme → animation → implement)
+- Version designs (design_iterations/ folder)
+
+**What it doesn't do**:
+- Backend logic or API integration
+- Database queries or data processing
+- Testing or validation
+- Code review or refactoring
+- Simple HTML/CSS edits (overkill)
+- Content updates (just text changes)
+
+---
+
+## Context Files Frontend-Specialist Uses
+
+The frontend-specialist will automatically load these via ContextScout:
+
+**Design System**:
+- `ui/web/design-systems.md` - Theme templates, color systems
+- `ui/web/ui-styling-standards.md` - Tailwind, Flowbite, responsive design
+- `ui/web/design-assets.md` - Images, icons, fonts
+
+**Patterns**:
+- `ui/web/animation-patterns.md` - Animation syntax, micro-interactions
+- `development/frontend/react/react-patterns.md` - React patterns (if React project)
+
+**Workflows**:
+- `core/workflows/design-iteration.md` - Design iteration workflow
+
+---
+
+## Best Practices
+
+### Do's ✅
+
+- ✅ **Propose before delegating** - Show user the plan first
+- ✅ **Get approval** - Never delegate without user approval
+- ✅ **Provide context** - List context files the subagent should load
+- ✅ **Set clear requirements** - Specify design system, breakpoints, animations
+- ✅ **Use staged workflow** - Let frontend-specialist follow its process
+- ✅ **Trust the specialist** - It knows design patterns and best practices
+
+### Don'ts ❌
+
+- ❌ **Don't delegate simple edits** - Handle directly for efficiency
+- ❌ **Don't skip approval** - Always get user sign-off first
+- ❌ **Don't delegate backend work** - Wrong subagent
+- ❌ **Don't micromanage** - Let the specialist follow its workflow
+- ❌ **Don't delegate without context** - Provide context files to load
+- ❌ **Don't delegate bug fixes** - Handle directly unless it's a design issue
+
+---
+
+## Examples
+
+### Example 1: Landing Page (Delegate)
+
+**User Request**: "Create a landing page for our SaaS product with a hero section, features, and pricing"
+
+**Your Response**:
+```markdown
+## Implementation Plan
+
+**Task**: Create SaaS landing page
+
+**Approach**: Delegate to frontend-specialist subagent
+
+**Why**:
+- Requires full design workflow (layout, theme, animations)
+- Needs responsive design across breakpoints
+- Benefits from design system standards
+
+**Context Needed**:
+- Design system standards
+- UI styling standards
+- Animation patterns
+
+**Approval needed before proceeding.**
+```
+
+**After Approval**:
+```javascript
+task(
+  subagent_type="frontend-specialist",
+  description="Create SaaS landing page",
+  prompt="Context to load:
+  - .opencode/context/ui/web/design-systems.md
+  - .opencode/context/ui/web/ui-styling-standards.md
+  - .opencode/context/ui/web/animation-patterns.md
+  
+  Task: Create a SaaS landing page with:
+  - Hero section (headline, subheadline, CTA)
+  - Features section (3-column grid)
+  - Pricing section (3 tiers)
+  - Footer
+  
+  Requirements:
+  - Tailwind CSS + Flowbite
+  - Mobile-first responsive
+  - Smooth scroll animations
+  - Modern design system
+  
+  Follow staged workflow and request approval between stages."
+)
+```
+
+### Example 2: Button Text Change (Direct)
+
+**User Request**: "Change the 'Submit' button to say 'Send Message'"
+
+**Your Response**:
+```markdown
+I'll update the button text directly.
+```
+
+**Action**: Read the HTML file, edit the button text, done. No delegation needed.
+
+---
+
+### Example 3: Design System Implementation (Delegate)
+
+**User Request**: "Implement our design system using Tailwind and Shadcn components"
+
+**Your Response**:
+```markdown
+## Implementation Plan
+
+**Task**: Implement design system with Tailwind + Shadcn
+
+**Approach**: Delegate to frontend-specialist subagent
+
+**Why**:
+- Requires UI library integration (Shadcn)
+- Needs ExternalScout for current Shadcn docs
+- Benefits from design system standards
+
+**Context Needed**:
+- Design system standards
+- UI styling standards
+- External docs (Shadcn)
+
+**Approval needed before proceeding.**
+```
+
+**After Approval**:
+```javascript
+task(
+  subagent_type="frontend-specialist",
+  description="Implement Tailwind + Shadcn design system",
+  prompt="Context to load:
+  - .opencode/context/ui/web/design-systems.md
+  - .opencode/context/ui/web/ui-styling-standards.md
+  
+  Task: Implement design system using Tailwind CSS and Shadcn/ui
+  
+  Requirements:
+  - Call ExternalScout for current Shadcn docs
+  - Set up Tailwind config
+  - Integrate Shadcn components
+  - Create theme file with OKLCH colors
+  - Document component usage
+  
+  Follow staged workflow and request approval between stages."
+)
+```
+
+---
+
+## Summary
+
+**Delegate to frontend-specialist when**:
+- New UI designs from scratch
+- Design system implementation
+- Complex responsive layouts
+- Animation work
+- UI library integration
+- Multi-stage design iterations
+
+**Handle directly when**:
+- Simple HTML/CSS edits
+- Bug fixes
+- Content updates
+- Single component updates
+- Quick prototypes
+
+**Always**:
+- Propose approach first
+- Get user approval
+- Provide context files
+- Trust the specialist's workflow
+
+---
+
+## Related Context
+
+- **Frontend Specialist Agent** → `../../../agent/subagents/development/frontend-specialist.md`
+- **Design Systems** → `../../ui/web/design-systems.md`
+- **UI Styling Standards** → `../../ui/web/ui-styling-standards.md`
+- **Animation Patterns** → `../../ui/web/animation-patterns.md`
+- **Delegation Workflow** → `../../core/workflows/task-delegation.md`
+- **React Patterns** → `react/react-patterns.md`

.opencode/context/development/navigation.md

@@ -28,6 +28,7 @@ development/
 │
 ├── frontend/                  # Client-side
 │   ├── navigation.md
+│   ├── when-to-delegate.md    # When to use frontend-specialist
 │   └── react/
 │       ├── navigation.md
 │       └── react-patterns.md
@@ -64,6 +65,7 @@ development/
 | Task | Path |
 |------|------|
 | **UI/Frontend** | `ui-navigation.md` |
+| **When to delegate frontend** | `frontend/when-to-delegate.md` |
 | **Backend/API** | `backend-navigation.md` |
 | **Full-stack** | `fullstack-navigation.md` |
 | **Clean code** | `principles/clean-code.md` |