Context Discovery

Overview

Discover project standards and patterns before implementing features. Context-scout resolves the context root using the OAC Context Discovery Protocol, then finds and ranks relevant files based on your request.

Announce at start: "I'm using the context-discovery skill to find relevant standards for [feature/task]."

The Process

Step 1: Invoke Context-Scout

Run the skill with your implementation topic:

/context-discovery [what you're implementing]

Examples:

• /context-discovery JWT authentication
• /context-discovery React form validation
• /context-discovery database migration workflow

Step 2: Load Critical Priority Files

Read EVERY file marked Critical Priority (paths returned by context-scout, relative to the resolved context root):

Read: {context_root}/core/standards/code-quality.md
Read: {context_root}/core/standards/security-patterns.md

These are mandatory—proceed only after loading.

Step 3: Load High Priority Files

Read files marked High Priority:

Read: {context_root}/core/workflows/approval-gates.md

These are strongly recommended for your implementation.

Step 4: Load Medium Priority (If Needed)

Read Medium Priority files for additional context:

Read: {context_root}/project-intelligence/architecture.md

These are optional but helpful.

Step 5: Apply to Implementation

• Follow standards from loaded files
• Apply patterns to your code
• Use naming conventions discovered
• Check workflows before executing

Delegation Pattern

When invoking subagents, pass discovered context files:

Invoke coder-agent:

Task: Implement JWT service

Context to load:
- .opencode/context/core/standards/code-quality.md
- .opencode/context/core/standards/security-patterns.md

Instructions: Follow functional patterns and security best practices.

Error Handling

"No context files found"

• Run /install-context to download context first

"Too many files returned"

• Be more specific (e.g., "TypeScript coding standards" not "coding")

"Which files do I load?"

• Always: Critical → High → Medium (if needed)

Remember

• Context FIRST, code SECOND—never skip discovery
• Critical priority files are MANDATORY, not optional
• Training data is outdated—context is current
• Pass context forward when delegating to subagents
• Only use file paths returned by context-scout

Related

• task-breakdown
• code-execution
• external-research

Task: Discover context files for $ARGUMENTS

Follow navigation-driven discovery and return ranked recommendations.