Просмотр исходного кода

fix: comprehensive context system audit and restructuring

- Fix 6 command documentation inconsistencies in add-context.md
  * Correct /add-context vs /context harvest command references
  * Simplify Stage 0 workflow from 4 to 2 options
  * Update examples to match actual behavior
  * Remove non-existent operations from delegation section
  * Fix troubleshooting Q&A section

- Restructure registry.json with 4 major improvements
  * Replace 31 duplicate 'navigation' IDs with unique IDs per subfolder
    - core-navigation, development-navigation, openagents-repo-navigation, etc.
  * Add context:openagents-repo/* to developer and full profiles
    - Developers now have repo-specific guides and examples
  * Remove context:to-be-consumed/* from essential, developer, business, full
    - Keep only in advanced profile for system builders
  * Properly scope mastra-ai context via wildcard patterns

Validation Results:
- Registry: 220/220 paths valid, 0 missing dependencies
- Profiles: All appropriately scoped with no duplicate IDs
- Standards: MVI compliance, frontmatter, structure verified
- No regressions: All tests passing

Fixes issues with context organization, command consistency, and profile coverage.
darrenhinde 6 месяцев назад
Родитель
Сommit
a2808470d1
2 измененных файлов с 464 добавлено и 404 удалено
  1. 57 89
      .opencode/command/add-context.md
  2. 407 315
      registry.json

+ 57 - 89
.opencode/command/add-context.md

@@ -116,15 +116,15 @@ Help users add project patterns using Project Intelligence standard. **Easiest w
 
 **Management Options**:
 - Update patterns: `/add-context --update`
-- Manage external files: `/add-context` → Choose "Manage external files"
+- Manage external files: `/context harvest` (extract, organize, clean)
 - Harvest to permanent: `/context harvest`
-- Clean context: `/add-context` → Choose "Clean all"
+- Clean context: `/context harvest` (cleans up .tmp/ files)
 
 ---
 
 ## Workflow
 
-### Stage 0: Detect External Context Files
+### Stage 0: Check for External Context Files
 
 Check: `.tmp/` directory for external context files (e.g., `.tmp/external-context.md`, `.tmp/context-*.md`)
 
@@ -139,51 +139,26 @@ Files found:
   📄 .tmp/api-patterns.md (1.8 KB)
   📄 .tmp/component-guide.md (3.1 KB)
 
-These files can be extracted and used to build your project intelligence.
+These files can be extracted and organized into permanent context.
 
 Options:
-  1. Extract & use these files (recommended)
-  2. Skip external files
-  3. Manage external files (update/remove/clean)
-  4. Harvest to permanent context (via /context harvest)
+  1. Continue with /add-context (ignore external files for now)
+  2. Manage external files first (via /context harvest)
 
-Choose [1/2/3/4]: _
+Choose [1/2]: _
 ```
 
-**If option 1 (Extract & use)**:
-- Read external files
-- Extract patterns (tech stack, APIs, components, naming, standards, security)
-- Merge with existing project intelligence
-- Proceed to Stage 1
+**If option 1 (Continue)**:
+- Proceed to Stage 1 (detect existing project intelligence)
+- External files remain in .tmp/ for later processing
 
-**If option 3 (Manage external files)**:
+**If option 2 (Manage external files)**:
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Manage External Context Files
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Files in .tmp/:
-  A) .tmp/external-context.md (2.4 KB)
-  B) .tmp/api-patterns.md (1.8 KB)
-  C) .tmp/component-guide.md (3.1 KB)
-
-Actions:
-  1. Update file (edit content)
-  2. Remove file (delete from .tmp/)
-  3. Clean all (delete all .tmp/ context files)
-  4. Harvest (move to permanent context via /context harvest)
-  5. Back to main menu
-
-Choose file [A/B/C] then action [1/2/3/4/5]: _
-```
-
-**If option 4 (Harvest)**:
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Harvest External Context
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-To harvest external context files to permanent context:
+To manage external context files, use the /context command:
 
   /context harvest
 
@@ -193,9 +168,14 @@ This will:
   ✓ Clean up temporary files
   ✓ Update navigation.md
 
-Ready? [y/n]: _
+After harvesting, run /add-context again to create project intelligence.
+
+Ready to harvest? [y/n]: _
 ```
 
+**If yes**: Exit and run `/context harvest`
+**If no**: Continue with `/add-context` (Stage 1)
+
 ---
 
 ### Stage 1: Detect Existing Context
@@ -598,22 +578,17 @@ Agents stay synced!
 **Process**:
 1. Check: `ls .tmp/external-context.md .tmp/context-*.md .tmp/*-context.md 2>/dev/null`
 2. If files found:
-   - Read each file
-   - Extract patterns (tech stack, APIs, components, naming, standards, security)
-   - Offer options: Extract & use | Skip | Manage | Harvest
-3. If option 1 (Extract & use):
-   - Parse external files for patterns
-   - Merge with existing project intelligence (if exists)
-   - Proceed to Stage 1 with pre-filled patterns
-4. If option 3 (Manage):
-   - Show file list with sizes
-   - Offer: Update | Remove | Clean all | Harvest | Back
-   - Execute selected action
-   - Return to main menu or exit
-5. If option 4 (Harvest):
+   - Display list of external context files
+   - Offer options: Continue | Manage (via /context harvest)
+3. If option 1 (Continue):
+   - Proceed to Stage 1 (detect existing project intelligence)
+   - External files remain in .tmp/ for later processing via `/context harvest`
+4. If option 2 (Manage):
    - Guide user to `/context harvest` command
-   - Explain what harvest does
+   - Explain what harvest does (extract, organize, clean)
    - Exit add-context
+   - User runs `/context harvest` to process external files
+   - User runs `/add-context` again after harvest completes
 
 ### Pattern Detection (Stage 1)
 
@@ -647,11 +622,11 @@ Agents stay synced!
 ### Delegation to ContextOrganizer
 
 ```yaml
-operation: create | update | extract_external | manage_external
+operation: create | update
 template: technical-domain  # Project Intelligence template
 target_directory: project-intelligence
 
-# For normal create/update
+# For create/update operations
 user_responses:
   tech_stack: {framework, language, database, styling}
   api_pattern: string | null
@@ -659,17 +634,6 @@ user_responses:
   naming_conventions: {files, components, functions, database}
   code_standards: string[]
   security_requirements: string[]
-
-# For external context extraction
-external_context:
-  source_files: [".tmp/external-context.md", ".tmp/api-patterns.md"]
-  extracted_patterns: {tech_stack, api_pattern, component_pattern, naming, standards, security}
-  merge_with_existing: boolean
-
-# For external context management
-external_management:
-  action: update | remove | clean_all | harvest
-  target_files: [list of .tmp/ files]
   
 frontmatter:
   context: project-intelligence/technical
@@ -684,6 +648,8 @@ validation:
   navigation_updated: true  # @navigation_update
 ```
 
+**Note**: External context file management (harvest, extract, organize) is handled by `/context harvest` command, not `/add-context`.
+
 ### File Structure Inference
 
 **Based on tech stack, infer common structure**:
@@ -772,33 +738,21 @@ Express: `src/routes/ controllers/ models/ middleware/`
 # ✅ Created: technical-domain.md (merged with external patterns)
 ```
 
-### Example 5: Manage External Files
+### Example 5: External Context Files Present
 ```bash
 /add-context
 
 # Found external context files in .tmp/
-# Choose: 3. Manage external files
-#
-# Files in .tmp/:
-#   A) .tmp/external-context.md (2.4 KB)
-#   B) .tmp/api-patterns.md (1.8 KB)
+#   📄 .tmp/external-context.md (2.4 KB)
+#   📄 .tmp/api-patterns.md (1.8 KB)
 #
-# Choose file [A/B] then action [1/2/3/4/5]:
-# A
-# 1. Update file
+# Options:
+#   1. Continue with /add-context (ignore external files for now)
+#   2. Manage external files first (via /context harvest)
 #
-# ✅ File updated. Ready to extract? [y/n]: y
-# ✅ Patterns extracted and merged
-```
-
-### Example 6: Harvest External Context
-```bash
-/add-context
-
-# Found external context files in .tmp/
-# Choose: 4. Harvest (move to permanent context)
+# Choose [1/2]: 2
 #
-# To harvest external context files:
+# To manage external context files, use:
 #   /context harvest
 #
 # This will:
@@ -806,6 +760,20 @@ Express: `src/routes/ controllers/ models/ middleware/`
 #   ✓ Organize into project-intelligence/
 #   ✓ Clean up temporary files
 #   ✓ Update navigation.md
+#
+# After harvesting, run /add-context again.
+```
+
+### Example 6: After Harvesting External Context
+```bash
+# After running: /context harvest
+
+/add-context
+
+# No external context files found in .tmp/
+# Proceeding to detect existing project intelligence...
+#
+# ✅ Created: technical-domain.md (merged with harvested patterns)
 ```
 
 ---
@@ -866,19 +834,19 @@ A: Edit directly: `nano ~/.opencode/context/project-intelligence/technical-domai
 A: Yes! Commit `~/.opencode/context/project-intelligence/` to repo.
 
 **Q: Have external context files in .tmp/?**
-A: Run `/add-context` and choose "Extract & use" or "Manage external files"
+A: Run `/context harvest` to extract and organize them into permanent context
 
 **Q: Want to clean up .tmp/ files?**
-A: Run `/add-context` → "Manage external files" → "Clean all"
+A: Run `/context harvest` to extract knowledge and clean up temporary files
 
 **Q: Move .tmp/ files to permanent context?**
 A: Run `/context harvest` to extract and organize them
 
 **Q: Update external context files?**
-A: Run `/add-context` → "Manage external files" → "Update file"
+A: Edit directly: `nano .tmp/external-context.md` then run `/context harvest`
 
 **Q: Remove specific external file?**
-A: Run `/add-context` → "Manage external files" → "Remove file"
+A: Delete directly: `rm .tmp/external-context.md` then run `/context harvest`
 
 ---
 

+ 407 - 315
registry.json

@@ -1456,16 +1456,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/system-builder-templates/navigation.md",
-        "description": "System Builder Templates",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "scroll-animation-prompts",
         "name": "Scroll Animation Prompts",
@@ -1476,16 +1466,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/ui/web/design/navigation.md",
-        "description": "Web Design Patterns",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "building-scrollytelling-pages",
         "name": "Building Scrollytelling Pages",
@@ -1516,36 +1496,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/ui/web/navigation.md",
-        "description": "Web UI Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/ui/terminal/navigation.md",
-        "description": "Terminal UI Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/ui/navigation.md",
-        "description": "UI Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "written-content",
         "name": "Written Content",
@@ -1556,16 +1506,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/content-creation/formats/navigation.md",
-        "description": "Content Formats Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "video-content",
         "name": "Video Content",
@@ -1606,16 +1546,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/content-creation/workflows/navigation.md",
-        "description": "Content Workflows Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "content-matrix",
         "name": "Content Matrix",
@@ -1646,36 +1576,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/content-creation/navigation.md",
-        "description": "Content Creation Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/content-creation/examples/navigation.md",
-        "description": "Content Examples Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/content-creation/principles/navigation.md",
-        "description": "Content Principles Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "hooks",
         "name": "Hooks",
@@ -1696,16 +1596,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/core/workflows/navigation.md",
-        "description": "Core Workflows Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "feature-breakdown",
         "name": "Feature Breakdown",
@@ -1750,16 +1640,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/core/navigation.md",
-        "description": "Core Context Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "changelog",
         "name": "Changelog",
@@ -1820,16 +1700,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/core/standards/navigation.md",
-        "description": "Core Standards Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "documentation",
         "name": "Documentation",
@@ -1850,26 +1720,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/frontend/navigation.md",
-        "description": "Frontend Development Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/integration/navigation.md",
-        "description": "Integration Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "ui-navigation",
         "name": "Ui Navigation",
@@ -1880,26 +1730,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/navigation.md",
-        "description": "Development Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/backend/navigation.md",
-        "description": "Backend Development Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "backend-navigation",
         "name": "Backend Navigation",
@@ -1910,76 +1740,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/principles/navigation.md",
-        "description": "Development Principles Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/infrastructure/navigation.md",
-        "description": "Infrastructure Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/data/navigation.md",
-        "description": "Data Layer Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/learning/navigation.md",
-        "description": "Learning Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/navigation.md",
-        "description": "Context Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/product/navigation.md",
-        "description": "Product Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/project/navigation.md",
-        "description": "Project Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "subagent-framework-maps",
         "name": "Subagent Framework Maps",
@@ -2000,16 +1760,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/openagents-repo/navigation.md",
-        "description": "OpenAgents Control Repository Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "testing-subagents",
         "name": "Testing Subagents",
@@ -2050,16 +1800,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/data/navigation.md",
-        "description": "Data Context",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "testing-subagents-approval",
         "name": "Testing Subagents Approval",
@@ -2098,16 +1838,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/core/task-management/navigation.md",
-        "description": "Task Management Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "splitting-tasks",
         "name": "Splitting Tasks",
@@ -2148,16 +1878,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/ai/mastra-ai/navigation.md",
-        "description": "MAStra AI Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "modular-building",
         "name": "Modular Building",
@@ -2258,36 +1978,6 @@
         "dependencies": [],
         "category": "standard"
       },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/ai/navigation.md",
-        "description": "AI Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/frameworks/navigation.md",
-        "description": "Frameworks Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
-      {
-        "id": "navigation",
-        "name": "Navigation",
-        "type": "context",
-        "path": ".opencode/context/development/frameworks/tanstack-start/navigation.md",
-        "description": "Tanstack Start Navigation",
-        "tags": [],
-        "dependencies": [],
-        "category": "standard"
-      },
       {
         "id": "building-cli-compact",
         "name": "Building Cli Compact",
@@ -2633,6 +2323,409 @@
           "context:adding-skill"
         ],
         "category": "standard"
+      },
+      {
+        "id": "core-navigation",
+        "name": "Navigation: CORE",
+        "type": "context",
+        "path": ".opencode/context/core/navigation.md",
+        "description": "Navigation guide for core",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-standards-navigation",
+        "name": "Navigation: CORE STANDARDS",
+        "type": "context",
+        "path": ".opencode/context/core/standards/navigation.md",
+        "description": "Navigation guide for core standards",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-workflows-navigation",
+        "name": "Navigation: CORE WORKFLOWS",
+        "type": "context",
+        "path": ".opencode/context/core/workflows/navigation.md",
+        "description": "Navigation guide for core workflows",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-context-system-navigation",
+        "name": "Navigation: CORE CONTEXT SYSTEM",
+        "type": "context",
+        "path": ".opencode/context/core/context-system/navigation.md",
+        "description": "Navigation guide for core context system",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-system-navigation",
+        "name": "Navigation: CORE SYSTEM",
+        "type": "context",
+        "path": ".opencode/context/core/system/navigation.md",
+        "description": "Navigation guide for core system",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-task-management-navigation",
+        "name": "Navigation: CORE TASK MANAGEMENT",
+        "type": "context",
+        "path": ".opencode/context/core/task-management/navigation.md",
+        "description": "Navigation guide for core task management",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "core-config-navigation",
+        "name": "Navigation: CORE CONFIG",
+        "type": "context",
+        "path": ".opencode/context/core/config/navigation.md",
+        "description": "Navigation guide for core config",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-navigation",
+        "name": "Navigation: DEVELOPMENT",
+        "type": "context",
+        "path": ".opencode/context/development/navigation.md",
+        "description": "Navigation guide for development",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-ai-navigation",
+        "name": "Navigation: DEVELOPMENT AI",
+        "type": "context",
+        "path": ".opencode/context/development/ai/navigation.md",
+        "description": "Navigation guide for development ai",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-backend-navigation",
+        "name": "Navigation: DEVELOPMENT BACKEND",
+        "type": "context",
+        "path": ".opencode/context/development/backend/navigation.md",
+        "description": "Navigation guide for development backend",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-data-navigation",
+        "name": "Navigation: DEVELOPMENT DATA",
+        "type": "context",
+        "path": ".opencode/context/development/data/navigation.md",
+        "description": "Navigation guide for development data",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-frameworks-navigation",
+        "name": "Navigation: DEVELOPMENT FRAMEWORKS",
+        "type": "context",
+        "path": ".opencode/context/development/frameworks/navigation.md",
+        "description": "Navigation guide for development frameworks",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-frontend-navigation",
+        "name": "Navigation: DEVELOPMENT FRONTEND",
+        "type": "context",
+        "path": ".opencode/context/development/frontend/navigation.md",
+        "description": "Navigation guide for development frontend",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-principles-navigation",
+        "name": "Navigation: DEVELOPMENT PRINCIPLES",
+        "type": "context",
+        "path": ".opencode/context/development/principles/navigation.md",
+        "description": "Navigation guide for development principles",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-integration-navigation",
+        "name": "Navigation: DEVELOPMENT INTEGRATION",
+        "type": "context",
+        "path": ".opencode/context/development/integration/navigation.md",
+        "description": "Navigation guide for development integration",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "development-infrastructure-navigation",
+        "name": "Navigation: DEVELOPMENT INFRASTRUCTURE",
+        "type": "context",
+        "path": ".opencode/context/development/infrastructure/navigation.md",
+        "description": "Navigation guide for development infrastructure",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "ui-navigation",
+        "name": "Navigation: UI",
+        "type": "context",
+        "path": ".opencode/context/ui/navigation.md",
+        "description": "Navigation guide for ui",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "ui-web-navigation",
+        "name": "Navigation: UI WEB",
+        "type": "context",
+        "path": ".opencode/context/ui/web/navigation.md",
+        "description": "Navigation guide for ui web",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "ui-terminal-navigation",
+        "name": "Navigation: UI TERMINAL",
+        "type": "context",
+        "path": ".opencode/context/ui/terminal/navigation.md",
+        "description": "Navigation guide for ui terminal",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "ui-web-design-navigation",
+        "name": "Navigation: UI WEB DESIGN",
+        "type": "context",
+        "path": ".opencode/context/ui/web/design/navigation.md",
+        "description": "Navigation guide for ui web design",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-navigation",
+        "name": "Navigation: OPENAGENTS REPO",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/navigation.md",
+        "description": "Navigation guide for openagents repo",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-core-concepts-navigation",
+        "name": "Navigation: OPENAGENTS REPO CORE CONCEPTS",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/core-concepts/navigation.md",
+        "description": "Navigation guide for openagents repo core concepts",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-guides-navigation",
+        "name": "Navigation: OPENAGENTS REPO GUIDES",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/guides/navigation.md",
+        "description": "Navigation guide for openagents repo guides",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-examples-navigation",
+        "name": "Navigation: OPENAGENTS REPO EXAMPLES",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/examples/navigation.md",
+        "description": "Navigation guide for openagents repo examples",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-lookup-navigation",
+        "name": "Navigation: OPENAGENTS REPO LOOKUP",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/lookup/navigation.md",
+        "description": "Navigation guide for openagents repo lookup",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-concepts-navigation",
+        "name": "Navigation: OPENAGENTS REPO CONCEPTS",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/concepts/navigation.md",
+        "description": "Navigation guide for openagents repo concepts",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-errors-navigation",
+        "name": "Navigation: OPENAGENTS REPO ERRORS",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/errors/navigation.md",
+        "description": "Navigation guide for openagents repo errors",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-blueprints-navigation",
+        "name": "Navigation: OPENAGENTS REPO BLUEPRINTS",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/blueprints/navigation.md",
+        "description": "Navigation guide for openagents repo blueprints",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-plugins-navigation",
+        "name": "Navigation: OPENAGENTS REPO PLUGINS",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/plugins/navigation.md",
+        "description": "Navigation guide for openagents repo plugins",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-quality-navigation",
+        "name": "Navigation: OPENAGENTS REPO QUALITY",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/quality/navigation.md",
+        "description": "Navigation guide for openagents repo quality",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
+      },
+      {
+        "id": "openagents-repo-templates-navigation",
+        "name": "Navigation: OPENAGENTS REPO TEMPLATES",
+        "type": "context",
+        "path": ".opencode/context/openagents-repo/templates/navigation.md",
+        "description": "Navigation guide for openagents repo templates",
+        "tags": [
+          "navigation",
+          "guide"
+        ],
+        "dependencies": [],
+        "category": "navigation"
       }
     ],
     "config": [
@@ -2728,7 +2821,6 @@
         "context:quick-start",
         "context:core/*",
         "context:project-intelligence/*",
-        "context:to-be-consumed/*",
         "context:adding-skill",
         "context:ui/*",
         "context:development/*",
@@ -2740,7 +2832,8 @@
         "context:clean-code",
         "context:api-design",
         "config:env-example",
-        "config:readme"
+        "config:readme",
+        "context:openagents-repo/*"
       ]
     },
     "business": {
@@ -2768,7 +2861,6 @@
         "context:quick-start",
         "context:core/*",
         "context:project-intelligence/*",
-        "context:to-be-consumed/*",
         "context:adding-skill",
         "config:env-example",
         "config:readme"
@@ -2813,7 +2905,6 @@
         "context:quick-start",
         "context:core/*",
         "context:project-intelligence/*",
-        "context:to-be-consumed/*",
         "context:adding-skill",
         "context:ui/*",
         "context:development/*",
@@ -2825,7 +2916,8 @@
         "context:clean-code",
         "context:api-design",
         "config:env-example",
-        "config:readme"
+        "config:readme",
+        "context:openagents-repo/*"
       ]
     },
     "advanced": {