chore: install openagent opencode

Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>
2026-04-07 11:31:26 -04:00
parent b4c03ff25e
commit c2263602c4
204 changed files with 38010 additions and 0 deletions
--- a/.opencode/context/openagents-repo/guides/adding-agent-testing.md
+++ b/.opencode/context/openagents-repo/guides/adding-agent-testing.md
@@ -0,0 +1,145 @@
+<!-- Context: openagents-repo/guides | Priority: high | Version: 1.0 | Updated: 2026-02-15 -->
+
+# Guide: Adding Agent Tests
+
+**Prerequisites**: Load `adding-agent-basics.md` first  
+**Purpose**: Additional test patterns for agents
+
+---
+
+## Additional Test Types
+
+### Approval Gate Test
+
+```yaml
+# evals/agents/{category}/{agent-name}/tests/approval-gate.yaml
+name: Approval Gate Test
+description: Verify agent requests approval before execution
+agent: {category}/{agent-name}
+model: anthropic/claude-sonnet-4-5
+conversation:
+  - role: user
+    content: "Create a new file called test.js"
+expectations:
+  - type: specific_evaluator
+    evaluator: approval_gate
+    should_pass: true
+```
+
+### Context Loading Test
+
+```yaml
+# evals/agents/{category}/{agent-name}/tests/context-loading.yaml
+name: Context Loading Test
+description: Verify agent loads required context
+agent: {category}/{agent-name}
+model: anthropic/claude-sonnet-4-5
+conversation:
+  - role: user
+    content: "Write a new function"
+expectations:
+  - type: context_loaded
+    contexts: ["core/standards/code-quality.md"]
+```
+
+---
+
+## Complete Example: API Specialist
+
+```bash
+# 1. Create agent file
+cat > .opencode/agent/subagents/development/api-specialist.md << 'EOF'
+---
+description: "Expert in REST and GraphQL API design"
+category: "development"
+type: "agent"
+tags: ["api", "rest", "graphql"]
+dependencies: ["subagent:tester"]
+---
+
+# API Specialist
+
+**Purpose**: Design and implement robust APIs
+
+## Focus
+- REST API design
+- GraphQL schemas
+- API documentation
+- Authentication/authorization
+
+## Workflow
+1. Analyze requirements
+2. Design API structure
+3. Implement endpoints
+4. Add tests
+5. Document API
+
+## Constraints
+- Follow REST best practices
+- Use proper HTTP methods
+- Include error handling
+- Add comprehensive tests
+EOF
+
+# 2. Create test structure
+mkdir -p evals/agents/development/api-specialist/{config,tests}
+
+cat > evals/agents/development/api-specialist/config/config.yaml << 'EOF'
+agent: development/api-specialist
+model: anthropic/claude-sonnet-4-5
+timeout: 60000
+suites:
+  - smoke
+EOF
+
+cat > evals/agents/development/api-specialist/tests/smoke-test.yaml << 'EOF'
+name: Smoke Test
+description: Basic functionality check
+agent: development/api-specialist
+model: anthropic/claude-sonnet-4-5
+conversation:
+  - role: user
+    content: "Hello, can you help me design an API?"
+expectations:
+  - type: no_violations
+EOF
+
+# 3. Update registry
+./scripts/registry/auto-detect-components.sh --auto-add
+
+# 4. Validate
+./scripts/registry/validate-registry.sh
+cd evals/framework && bun --bun run eval:sdk -- --agent=development/api-specialist --pattern="smoke-test.yaml"
+```
+
+---
+
+## Common Issues
+
+| Problem | Solution |
+|---------|----------|
+| Auto-detect doesn't find agent | Check frontmatter is valid YAML |
+| Registry validation fails | Verify file path is correct |
+| Test fails unexpectedly | Load `debugging.md` for troubleshooting |
+
+---
+
+## Claude Code Subagent (Optional)
+
+For Claude Code-only helpers, create a project subagent:
+
+- **Path**: `.claude/agents/{subagent-name}.md`
+- **Required**: `name`, `description` frontmatter
+- **Optional**: `tools`, `disallowedTools`, `permissionMode`, `skills`, `hooks`
+- **Reload**: restart Claude Code or run `/agents`
+
+See `creating-subagents.md` for Claude Code subagent details.
+
+---
+
+## Related
+
+- `adding-agent-basics.md` - Basic agent creation
+- `testing-agent.md` - Testing guide
+- `debugging.md` - Troubleshooting
+- `creating-subagents.md` - Claude Code subagents