index.md 5.0 KB

Context Index

Core Context (Universal)

Path: .opencode/context/core/{category}/{file}

Quick Map

code        → standards/code.md       [critical] implement, refactor, architecture
docs        → standards/docs.md       [critical] write docs, README, documentation
tests       → standards/tests.md      [critical] write tests, testing, TDD → deps: code
patterns    → standards/patterns.md   [high]     error handling, security, validation
analysis    → standards/analysis.md   [high]     analyze, investigate, debug

delegation  → workflows/delegation.md [high]     delegate, task tool, subagent
review      → workflows/review.md     [high]     review code, audit → deps: code, patterns
breakdown   → workflows/task-breakdown.md [high] break down, 4+ files → deps: delegation
sessions    → workflows/sessions.md   [medium]   session management, cleanup

Categories

Standards - Code quality, testing, documentation standards (critical priority) Workflows - Process templates for delegation, review, task breakdown (high priority) System - Documentation and guides (medium priority)


Category-Specific Context

Development

Path: .opencode/context/development/{file}

clean-code      → development/clean-code.md      [high] coding standards, best practices
react-patterns  → development/react-patterns.md  [high] React, hooks, components
api-design      → development/api-design.md      [high] REST, GraphQL, API versioning

Used by: frontend-specialist, backend-specialist, devops-specialist, codebase-agent

Content

Path: .opencode/context/content/{file}

copywriting     → content/copywriting-frameworks.md [high] AIDA, PAS, persuasive writing
tone-voice      → content/tone-voice.md             [high] brand voice, tone guidelines

Used by: copywriter, technical-writer

Product

Path: .opencode/context/product/{file}

No context files yet. Category ready for product-related context.

Data

Path: .opencode/context/data/{file}

No context files yet. Category ready for data-related context.

Learning

Path: .opencode/context/learning/{file}

No context files yet. Category ready for learning-related context.


OpenAgents Repository Context

Path: .opencode/context/openagents-repo/{file}

Purpose: Context for working on the OpenAgents repository itself (not user projects)

Quick Start (Load First)

quick-start     → openagents-repo/quick-start.md     [critical] orientation, common commands

Core Concepts (Load Before Working)

agents          → openagents-repo/core-concepts/agents.md     [critical] how agents work
evals           → openagents-repo/core-concepts/evals.md      [critical] how testing works
registry        → openagents-repo/core-concepts/registry.md   [critical] how registry works
categories      → openagents-repo/core-concepts/categories.md [high]     how organization works

Guides (Task-Specific Workflows)

adding-agent    → openagents-repo/guides/adding-agent.md      [high] step-by-step agent creation
testing-agent   → openagents-repo/guides/testing-agent.md     [high] testing workflow
updating-registry → openagents-repo/guides/updating-registry.md [medium] registry workflow
creating-release → openagents-repo/guides/creating-release.md [medium] release workflow
debugging       → openagents-repo/guides/debugging.md         [medium] troubleshooting

Lookup (Quick Reference)

file-locations  → openagents-repo/lookup/file-locations.md    [medium] where everything is
commands        → openagents-repo/lookup/commands.md          [medium] command reference

Templates (For Subagent Coordination)

context-bundle  → openagents-repo/templates/context-bundle-template.md [high] template for delegating to subagents

Examples (Reference Implementations)

bundle-example  → openagents-repo/examples/context-bundle-example.md [medium] example context bundle

Loading Strategy:

  • First time: Load quick-start.md
  • Add agent: Load quick-start.md + core-concepts/agents.md + guides/adding-agent.md
  • Test agent: Load quick-start.md + core-concepts/evals.md + guides/testing-agent.md
  • Fix registry: Load quick-start.md + core-concepts/registry.md + guides/updating-registry.md
  • Find files: Load quick-start.md + lookup/file-locations.md

Use When:

  • Adding new agents, commands, or tools to OpenAgents
  • Modifying eval framework or registry system
  • Working on OpenAgents infrastructure
  • Fixing bugs in the framework
  • Writing OpenAgents documentation

Don't Use When:

  • Working on user projects (use project-specific context)
  • General coding tasks (use core/standards/)

Loading Instructions

For common tasks, use quick map above. For keyword matching, scan triggers.

Format: id → path [priority] triggers → deps: dependencies

Dependencies: Load dependent contexts alongside main context for complete guidelines.