feat: enhance developer and advanced profiles with UI, development, and system builder context (#148)

* chore: bump version to v0.8.0

* chore: update version to 0.7.1 instead of 0.8.0

* docs: expand comparison table with Oh My OpenCode and additional features

* backup: development context before reorganization

* 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/
- Create frontend/react/navigation.md
- Update 4 navigation files (development, ui, frontend, frontend/react)
- Update developer profile (4 path changes: ui-styling-standards, design-systems, design-assets, animation-patterns)
- Update 3 core context files (visual-development.md, design-iteration.md, file-locations.md)

Result: 29 context files (down from 36), no duplicates, clean structure

Refs: REORGANIZATION_PLAN.md, REORGANIZATION_SUMMARY.md

* 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.

* feat: enhance developer and advanced profiles with UI, development, and system builder context

- Developer profile: Add UI/UX patterns, development principles, design systems, React patterns, animation patterns, styling standards, and design assets
- Full profile: Add same UI/development context as developer profile for consistency
- Advanced profile: Add comprehensive system builder context including templates, guides, context system standards, and repository management context
- Update profile descriptions to reflect new capabilities
- All context files verified to exist and are properly referenced

* fix: remove duplicate context entries with incorrect paths

- Remove duplicate design-assets, ui-styling-standards, clean-code, animation-patterns, design-systems, react-patterns, and api-design entries that pointed to wrong paths
- Remove non-existent development-readme and mastra-ai-readme entries
- Keep only correct entries with proper file paths
- All registry paths now validated and correct

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: darrenhinde

.opencode/agent/subagents/core/externalscout.md

@@ -81,9 +81,16 @@ tags:
     NEVER rely on training data for library APIs
   </rule>
   <rule id="output_format">
+    ALWAYS write files to .tmp/external-context/ BEFORE returning summary
     ALWAYS return: file locations + brief summary + official docs link
     ALWAYS filter to relevant sections only
     NO reports, guides, or integration documentation
+    NEVER say "ready to be persisted" - files must be WRITTEN, not just fetched
+  </rule>
+  <rule id="mandatory_persistence">
+    You MUST write fetched documentation to files using the Write tool
+    Fetching without writing = FAILURE
+    Stage 4 (PersistToTemp) is MANDATORY and cannot be skipped
   </rule>
 </critical_rules>
 
@@ -93,19 +100,21 @@ tags:
   <tier level="1" desc="Critical Operations">
     - @tool_usage: Use ONLY allowed tools
     - @always_use_tools: Fetch from real sources
-    - @output_format: Return file locations + brief summary
+    - @mandatory_persistence: ALWAYS write files to .tmp/external-context/ (Stage 4 is MANDATORY)
+    - @output_format: Return file locations + brief summary ONLY AFTER files written
   </tier>
   <tier level="2" desc="Core Workflow">
     - Detect library from registry
     - Fetch from Context7 (primary)
     - Fallback to official docs (webfetch)
     - Filter to relevant sections
-    - Persist to .tmp/external-context/
+    - Persist to .tmp/external-context/ (CANNOT be skipped)
     - Return file locations + summary
   </tier>
   <conflict_resolution>
     Tier 1 always overrides Tier 2
     If workflow conflicts w/ tool restrictions→abort and report error
+    Stage 4 (PersistToTemp) is MANDATORY and cannot be skipped under any circumstances
   </conflict_resolution>
 </execution_priority>
 
@@ -150,12 +159,14 @@ tags:
     <checkpoint>Results filtered to relevant content only</checkpoint>
   </stage>
 
-  <stage id="4" name="PersistToTemp">
-    <action>Save filtered documentation to .tmp/external-context/</action>
+  <stage id="4" name="PersistToTemp" enforcement="MANDATORY">
+    <action>ALWAYS save filtered documentation to .tmp/external-context/ - NEVER skip this step</action>
     <process>
-      1. Create directory: `.tmp/external-context/{package-name}/`
+      CRITICAL: You MUST write files. Do NOT just summarize. Execute these steps:
+      
+      1. Create directory if needed: `.tmp/external-context/{package-name}/`
       2. Generate filename from topic (kebab-case): `{topic}.md`
-      3. Write file with minimal metadata header:
+      3. Write file using Write tool with minimal metadata header:
          ```markdown
          ---
          source: Context7 API
@@ -168,22 +179,32 @@ tags:
          
          {filtered documentation content}
          ```
-      4. Update `.tmp/external-context/.manifest.json` with file metadata
+      4. Confirm file written by checking it exists
+      5. Update `.tmp/external-context/.manifest.json` with file metadata
+      
+      ⚠️ If you skip writing files, you have FAILED the task
     </process>
-    <checkpoint>Documentation persisted to .tmp/external-context/</checkpoint>
+    <checkpoint>Documentation persisted to .tmp/external-context/ AND files confirmed written</checkpoint>
   </stage>
 
-  <stage id="5" name="ReturnLocations">
-    <action>Return file locations and brief summary</action>
+  <stage id="5" name="ReturnLocations" enforcement="MANDATORY">
+    <action>Return file locations and brief summary ONLY AFTER files are written</action>
     <output_format>
+      CRITICAL: Only proceed to this stage AFTER Stage 4 is complete and files are written.
+      
+      Return format:
       ```
       ✅ Fetched: {library-name}
-      📁 Saved to: .tmp/external-context/{package-name}/{topic}.md
+      📁 Files written to:
+         - .tmp/external-context/{package-name}/{topic-1}.md
+         - .tmp/external-context/{package-name}/{topic-2}.md
       📝 Summary: {1-2 line summary of what was fetched}
       🔗 Official Docs: {link}
       ```
+      
+      ⚠️ Do NOT say "ready to be persisted" - files must be ALREADY written
     </output_format>
-    <checkpoint>File locations returned, task complete</checkpoint>
+    <checkpoint>File locations returned with confirmation files exist, task complete</checkpoint>
   </stage>
 </workflow_execution>
 
@@ -214,18 +235,27 @@ If Context7 API fails:
 - ❌ Don't use bash for anything except curl to context7.com
 - ❌ Don't write outside `.tmp/external-context/` directory
 - ❌ Don't use task tool—you're a fetcher with write-only persistence
+- ❌ **NEVER skip writing files** - fetching without persisting = FAILURE
+- ❌ **NEVER say "ready to be persisted"** - files must be WRITTEN before returning
 
 ---
 
 ## Success Criteria
 
-You succeed when:
+You succeed when ALL of these are complete:
 ✅ Documentation is **fetched** from Context7 or official sources
 ✅ Results are **filtered** to only relevant sections
-✅ Documentation is **persisted** to `.tmp/external-context/{package-name}/{topic}.md`
+✅ Files are **WRITTEN** to `.tmp/external-context/{package-name}/{topic}.md` using Write tool
+✅ Files are **CONFIRMED** to exist (not just "ready to be persisted")
 ✅ **File locations returned** with brief summary
 ✅ **Official docs link** provided
 
+❌ You FAIL if you:
+- Fetch docs but don't write files
+- Say "ready to be persisted" without actually writing
+- Skip Stage 4 (PersistToTemp)
+- Return summary without file locations
+
 ---
 
 ## References

.opencode/context/core/visual-development.md

@@ -13,9 +13,9 @@
 | **Edit existing image** | This file | Image Specialist | tool:gemini |
 | **UI mockup (static)** | This file | Image Specialist | tool:gemini |
 | **Interactive UI design** | `workflows/design-iteration.md` | - | - |
-| **Design system** | `development/design-systems.md` | - | - |
-| **UI standards** | `development/ui-styling-standards.md` | - | - |
-| **Animation patterns** | `development/animation-patterns.md` | - | - |
+| **Design system** | `ui/web/design-systems.md` | - | - |
+| **UI standards** | `ui/web/ui-styling-standards.md` | - | - |
+| **Animation patterns** | `ui/web/animation-patterns.md` | - | - |
 
 ---
 
@@ -448,9 +448,9 @@ After receiving output:
 ## Related Context
 
 - **UI Design Workflow**: `.opencode/context/core/workflows/design-iteration.md`
-- **Design Systems**: `.opencode/context/development/design-systems.md`
-- **UI Styling Standards**: `.opencode/context/development/ui-styling-standards.md`
-- **Animation Patterns**: `.opencode/context/development/animation-patterns.md`
+- **Design Systems**: `.opencode/context/ui/web/design-systems.md`
+- **UI Styling Standards**: `.opencode/context/ui/web/ui-styling-standards.md`
+- **Animation Patterns**: `.opencode/context/ui/web/animation-patterns.md`
 - **Subagent Invocation Guide**: `.opencode/context/openagents-repo/guides/subagent-invocation.md`
 - **Agent Capabilities**: `.opencode/context/openagents-repo/core-concepts/agents.md`
 

.opencode/context/core/workflows/design-iteration.md

@@ -652,9 +652,9 @@ Before presenting each stage:
 
 ## References
 
-- [Design Systems Context](../development/design-systems.md)
-- [UI Styling Standards](../development/ui-styling-standards.md)
-- [Animation Patterns](../development/animation-patterns.md)
-- [Design Assets](../development/design-assets.md)
+- [Design Systems Context](../ui/web/design-systems.md)
+- [UI Styling Standards](../ui/web/ui-styling-standards.md)
+- [Animation Patterns](../ui/web/animation-patterns.md)
+- [Design Assets](../ui/web/design-assets.md)
 - [ASCII Art Generator](https://www.asciiart.eu/)
 - [WCAG Contrast Checker](https://webaim.org/resources/contrastchecker/)