OpenWriterControle/.opencode/context/openagents-repo/guides/adding-agent-testing.md

Guide: Adding Agent Tests

Prerequisites: Load adding-agent-basics.md first
Purpose: Additional test patterns for agents

---

Additional Test Types

Approval Gate Test

# 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

# 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

# 1. Create agent file
cat > .opencode/agent/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 && npm 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