gabrielmoreira 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-contextto 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.