bf02ad0d5c
* refactor: Rename repository to OpenAgents Control Update all project references from "OpenAgents" to "OpenAgents Control": - Updated core config files (package.json, registry.json) - Updated documentation (README.md, docs/) - Updated scripts (install.sh, update.sh, test scripts) - Updated agent and command files - Updated integrations and packages - Updated all GitHub URLs to use OpenAgentsControl Naming convention: - Display name: "OpenAgents Control" - Repository URL: OpenAgentsControl * feat: Enable subagent-to-subagent delegation (ContextScout integration) Allow coding-related subagents to call ContextScout for context discovery: - CoderAgent: Can now discover coding standards on-demand - TestEngineer: Can now discover test coverage and TDD guidelines - CodeReviewer: Can now discover code review and security patterns - BuildAgent: Can now discover build validation standards - DocWriter: Can now discover documentation formatting guidelines Changes per subagent: - Added `task: true` to tools section - Added permission allowlist for ContextScout only (deny all other delegation) - Added Context Discovery workflow section with when-to-call guidance This enables subagents to be self-sufficient for finding relevant standards instead of relying on orchestrator to provide all context files. Benefits: - Subagents can discover what they need when context isn't explicit - Maintains security (only ContextScout allowed via task tool) - Follows existing patterns (uses task tool like main agents) * fix: Set OPENCODE_BRANCH in CI tests to use PR branch for downloads - Add OPENCODE_BRANCH environment variable to E2E tests - Add OPENCODE_BRANCH environment variable to profile smoke tests - Ensures tests download files from the PR branch instead of main - Fixes E2E test failures after repository rename to OpenAgentsControl
143 lines
4.1 KiB
Markdown
143 lines
4.1 KiB
Markdown
# OpenAgents Control Repository Context
|
|
|
|
**Purpose**: Context files specific to the OpenAgents Control repository
|
|
|
|
**Last Updated**: 2026-01-13
|
|
|
|
---
|
|
|
|
## Quick Navigation
|
|
|
|
| Function | Files | Purpose |
|
|
|----------|-------|---------|
|
|
| **Concepts** | 2 files | Core ideas and principles |
|
|
| **Examples** | 1 file | Working code samples |
|
|
| **Guides** | 8 files | Step-by-step workflows |
|
|
| **Lookup** | 4 files | Quick reference tables |
|
|
| **Errors** | 1 file | Common issues + solutions |
|
|
|
|
---
|
|
|
|
## Concepts (Core Ideas)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `concepts/subagent-testing-modes.md` | Standalone vs delegation testing | ⭐⭐⭐⭐⭐ |
|
|
|
|
**When to read**: Before testing any subagent
|
|
|
|
---
|
|
|
|
## Examples (Working Code)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `examples/subagent-prompt-structure.md` | Optimized subagent prompt template | ⭐⭐⭐⭐ |
|
|
|
|
**When to read**: When creating or optimizing subagent prompts
|
|
|
|
---
|
|
|
|
## Guides (Step-by-Step)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `guides/testing-subagents.md` | How to test subagents standalone | ⭐⭐⭐⭐⭐ |
|
|
| `guides/adding-agent.md` | How to add new agents | ⭐⭐⭐⭐ |
|
|
| `guides/testing-agent.md` | How to test agents | ⭐⭐⭐⭐ |
|
|
| `guides/updating-registry.md` | How to update registry | ⭐⭐⭐ |
|
|
| `guides/debugging.md` | How to debug issues | ⭐⭐⭐ |
|
|
| `guides/resolving-installer-wildcard-failures.md` | Fix wildcard context install failures | ⭐⭐⭐ |
|
|
| `guides/creating-release.md` | How to create releases | ⭐⭐ |
|
|
|
|
**When to read**: When performing specific tasks
|
|
|
|
---
|
|
|
|
## Lookup (Quick Reference)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `lookup/subagent-test-commands.md` | Subagent testing commands | ⭐⭐⭐⭐⭐ |
|
|
| `lookup/file-locations.md` | Where files are located | ⭐⭐⭐⭐ |
|
|
| `lookup/commands.md` | Available slash commands | ⭐⭐⭐ |
|
|
|
|
**When to read**: Quick command lookups
|
|
|
|
---
|
|
|
|
## Errors (Troubleshooting)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `errors/tool-permission-errors.md` | Tool permission issues | ⭐⭐⭐⭐⭐ |
|
|
|
|
**When to read**: When tests fail with permission errors
|
|
|
|
---
|
|
|
|
## Core Concepts (Foundational)
|
|
|
|
| File | Topic | Priority |
|
|
|------|-------|----------|
|
|
| `core-concepts/agents.md` | How agents work | ⭐⭐⭐⭐⭐ |
|
|
| `core-concepts/evals.md` | How testing works | ⭐⭐⭐⭐⭐ |
|
|
| `core-concepts/registry.md` | How registry works | ⭐⭐⭐⭐ |
|
|
| `core-concepts/categories.md` | How organization works | ⭐⭐⭐ |
|
|
|
|
**When to read**: First time working in this repo
|
|
|
|
---
|
|
|
|
## Loading Strategy
|
|
|
|
### For Subagent Testing:
|
|
1. Load `concepts/subagent-testing-modes.md` (understand modes)
|
|
2. Load `guides/testing-subagents.md` (step-by-step)
|
|
3. Reference `lookup/subagent-test-commands.md` (commands)
|
|
4. If errors: Load `errors/tool-permission-errors.md`
|
|
|
|
### For Agent Creation:
|
|
1. Load `core-concepts/agents.md` (understand structure)
|
|
2. Load `guides/adding-agent.md` (step-by-step)
|
|
3. Load `examples/subagent-prompt-structure.md` (if subagent)
|
|
4. Load `guides/testing-agent.md` (validate)
|
|
|
|
### For Debugging:
|
|
1. Load `guides/debugging.md` (general approach)
|
|
2. Load specific error file from `errors/`
|
|
3. Reference `lookup/file-locations.md` (find files)
|
|
|
|
---
|
|
|
|
## File Size Compliance
|
|
|
|
All files follow MVI principle (<200 lines):
|
|
|
|
- ✅ Concepts: <100 lines
|
|
- ✅ Examples: <100 lines
|
|
- ✅ Guides: <150 lines
|
|
- ✅ Lookup: <100 lines
|
|
- ✅ Errors: <150 lines
|
|
|
|
---
|
|
|
|
## Related Context
|
|
|
|
- `../core/` - Core system context (standards, patterns)
|
|
- `../core/context-system/` - Context management system
|
|
- `quick-start.md` - 2-minute repo orientation
|
|
- `../content-creation/navigation.md` - Content creation principles
|
|
- `../to-be-consumed/claude-code-docs/plugins.md` - Claude Code extension docs
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
When adding new context files:
|
|
|
|
1. Follow MVI principle (<200 lines)
|
|
2. Use function-based organization (concepts/, examples/, guides/, lookup/, errors/)
|
|
3. Update this README.md navigation
|
|
4. Add cross-references to related files
|
|
5. Validate with `/context validate`
|