docs: fix agent name casing in documentation (#117)

* docs: fix agent name casing in documentation

- Update all instances of 'openagent' to 'OpenAgent'
- Update all instances of 'opencoder' to 'OpenCoder'
- Fixes #115: --agent flag is case-sensitive

The --agent flag requires capitalized agent names (OpenAgent, OpenCoder)
but documentation showed lowercase versions, causing confusion for users.
Updated README.md and all docs/ files to use correct casing.

* refactor: migrate from grok-code to big-pickle model

- Remove model specification from contextscout.md subagent
- Update eval YAML files to use opencode/big-pickle
- Update documentation to reference big-pickle as default
- Fixes compatibility as grok-code-fast is no longer available

Files updated:
- .opencode/agent/subagents/core/contextscout.md
- evals/agents/shared/tests/golden/00-smoke-test.yaml
- evals/agents/shared/tests/golden/02-delegation-test.yaml
- evals/README.md
- evals/EVAL_FRAMEWORK_GUIDE.md
This commit is contained in:
Darren Hinde 2026-01-25 03:40:21 +00:00 committed by GitHub
parent 2dd76571f3
commit 041e3238bc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
9 changed files with 18 additions and 19 deletions

View file

@ -7,7 +7,6 @@ category: subagents/core
type: subagent
version: 4.0.0
author: darrenhinde
model: "opencode/grok-code"
# Agent Configuration£
mode: subagent

View file

@ -165,7 +165,7 @@ cp -r .opencode/context ~/.opencode/
### Step 3: Start Building
```bash
# Start the universal agent (recommended for new users)
opencode --agent openagent
opencode --agent OpenAgent
# Ask questions or request tasks
> "Create a React todo list with TypeScript"
@ -265,7 +265,7 @@ User Request
### Build a Feature
```bash
opencode --agent openagent
opencode --agent OpenAgent
> "Create a user authentication system with email/password"
# OpenAgent will:
@ -476,7 +476,7 @@ cd /path/to/opencode-agents/integrations/claude-code
## Common Questions
**Q: What's the main way to use this?**
A: Use `opencode --agent openagent` as your default for general tasks and questions. For complex multi-file coding work, use `opencode --agent opencoder`. Both coordinate with specialists as needed.
A: Use `opencode --agent OpenAgent` as your default for general tasks and questions. For complex multi-file coding work, use `opencode --agent OpenCoder`. Both coordinate with specialists as needed.
**Q: Does this work on Windows?**
A: Yes! Use Git Bash (recommended) or WSL. See [Platform Compatibility Guide](docs/getting-started/platform-compatibility.md) for details.
@ -646,10 +646,10 @@ This project is licensed under the MIT License.
## Recommended for New Users
**Start with `openagent`** - your universal coordinator for general tasks, questions, and workflows. It follows a systematic 6-stage workflow (Analyze → Approve → Execute → Validate → Summarize → Confirm) and automatically delegates to specialized subagents when needed.
**Start with `OpenAgent`** - your universal coordinator for general tasks, questions, and workflows. It follows a systematic 6-stage workflow (Analyze → Approve → Execute → Validate → Summarize → Confirm) and automatically delegates to specialized subagents when needed.
```bash
opencode --agent openagent
opencode --agent OpenAgent
> "How do I implement authentication in Next.js?" # Questions
> "Create a user authentication system" # Simple tasks
> "Create a README for this project" # Documentation
@ -657,10 +657,10 @@ opencode --agent openagent
OpenAgent will guide you through with a plan-first, approval-based approach. For questions, you get direct answers. For tasks, you see the plan before execution.
**For complex coding work**, use `opencoder`:
**For complex coding work**, use `OpenCoder`:
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Refactor this codebase to use dependency injection" # Multi-file refactoring
> "Analyze the architecture and suggest improvements" # Architecture analysis
```

View file

@ -30,7 +30,7 @@ Welcome to the OpenAgents Control documentation! This directory contains all doc
### For New Users
- Start with the main [README](../README.md) in the repository root
- Follow the [Installation Guide](getting-started/installation.md)
- Use `opencode --agent openagent` to start building
- Use `opencode --agent OpenAgent` to start building
- Read the [OpenAgent Guide](agents/openagent.md) to understand the workflow
### For Contributors

View file

@ -264,7 +264,7 @@ OpenCoder coordinates with specialized subagents:
### Example 1: Multi-File Refactoring
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Refactor the authentication module to use dependency injection across all 8 files"
# OpenCoder will:
@ -282,7 +282,7 @@ opencode --agent opencoder
### Example 2: Architecture Analysis
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Analyze the architecture of this codebase and suggest improvements"
# OpenCoder will:
@ -299,7 +299,7 @@ opencode --agent opencoder
### Example 3: Pattern Implementation
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Implement the repository pattern for all database access across the data layer"
# OpenCoder will:
@ -319,7 +319,7 @@ opencode --agent opencoder
### Example 4: Complex Feature
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Implement user authentication with JWT, refresh tokens, and role-based access control"
# OpenCoder will:
@ -429,7 +429,7 @@ OpenCoder is your **specialized development partner** for:
**Start here:**
```bash
opencode --agent opencoder
opencode --agent OpenCoder
> "Your complex coding task..."
```

View file

@ -21,7 +21,7 @@ _Build Intelligent Workflow Systems with Context-Aware AI_
## ⚡ TL;DR - Quick Reference
**For New Users:**
- Start with `opencode --agent openagent` for all questions and tasks
- Start with `opencode --agent OpenAgent` for all questions and tasks
- The agent handles planning, implementation, testing, and review automatically
- Add your coding patterns to `.opencode/context/project/project-context.md`
- Let the agent delegate to specialized subagents when needed

View file

@ -147,7 +147,7 @@ description: What this test validates
category: developer # developer, business, creative, edge-case
agent: openagent # openagent, opencoder
model: opencode/grok-code # Optional, defaults to free tier
model: opencode/big-pickle # Optional, defaults to free tier
# Single prompt (simple tests)
prompt: |

View file

@ -159,7 +159,7 @@ Options:
--debug Enable debug output, keep sessions for inspection
--verbose Show full conversation (prompts + responses) after each test
(automatically enables --debug)
--model=PROVIDER/MODEL Override model (default: opencode/grok-code-fast)
--model=PROVIDER/MODEL Override model (default: opencode/big-pickle)
--timeout=MS Test timeout (default: 60000)
--prompt-variant=NAME Use specific prompt variant (gpt, gemini, grok, llama)
Auto-detects recommended model from prompt metadata

View file

@ -34,7 +34,7 @@ behavior:
maxToolCalls: 0
requiresApproval: false
expectedAgent: "openagent"
expectedModel: "opencode/grok-code"
expectedModel: "opencode/big-pickle"
expectedResponse:
contains:
- "Test infrastructure is working correctly"

View file

@ -35,7 +35,7 @@ behavior:
maxToolCalls: 10
requiresApproval: false # This is a simple test, no approval ceremony needed
expectedAgent: "openagent" # Validate correct agent is loaded
expectedModel: "opencode/grok-code" # Validate correct model is used
expectedModel: "opencode/big-pickle" # Validate correct model is used
expectedResponse:
contains:
- "AWESOME TESTING"