OpenWriterControle/evals/MIGRATION_COMPLETE.md

Migration Complete: opencode/ → agents/

Date: November 22, 2025
Migration: Option A (Simple Rename)
Status: ✅ Complete

---

What Changed

Directory Structure

Before:

evals/
├── framework/
├── opencode/
│   ├── openagent/
│   │   └── sdk-tests/
│   └── shared/
│       └── sdk-tests/

After:

evals/
├── framework/
├── agents/
│   ├── openagent/
│   │   └── tests/
│   ├── shared/
│   │   └── tests/
│   └── AGENT_TESTING_GUIDE.md

---

Changes Made

1. Directory Renames

• ✅ opencode/ → agents/
• ✅ agents/openagent/sdk-tests/ → agents/openagent/tests/
• ✅ agents/shared/sdk-tests/ → agents/shared/tests/

2. Documentation Updates

Updated all references in:

• ✅ README.md
• ✅ SIMPLE_TEST_PLAN.md
• ✅ NEW_TESTS_SUMMARY.md
• ✅ ALIGNMENT_ANALYSIS.md
• ✅ agents/AGENT_TESTING_GUIDE.md
• ✅ agents/openagent/README.md
• ✅ agents/shared/README.md

3. Path Updates

• ✅ opencode/openagent → agents/openagent
• ✅ opencode/opencoder → agents/opencoder
• ✅ opencode/shared → agents/shared
• ✅ sdk-tests/ → tests/

---

New Structure

evals/
├── framework/                          # Shared framework (agent-agnostic)
│   ├── src/
│   │   ├── sdk/                       # Test runner
│   │   ├── evaluators/                # Generic evaluators
│   │   └── types/
│   └── package.json
│
├── agents/                             # ALL AGENT-SPECIFIC CONTENT
│   ├── openagent/                     # OpenAgent tests & docs
│   │   ├── tests/                     # Test files (was sdk-tests/)
│   │   │   ├── developer/
│   │   │   │   ├── task-simple-001.yaml
│   │   │   │   ├── ctx-code-001.yaml
│   │   │   │   ├── ctx-docs-001.yaml
│   │   │   │   └── fail-stop-001.yaml
│   │   │   ├── business/
│   │   │   │   └── conv-simple-001.yaml
│   │   │   ├── creative/
│   │   │   └── edge-case/
│   │   ├── docs/
│   │   ├── config/
│   │   └── README.md
│   │
│   ├── shared/                        # Tests for ANY agent
│   │   ├── tests/
│   │   │   └── common/
│   │   │       └── approval-gate-basic.yaml
│   │   └── README.md
│   │
│   └── AGENT_TESTING_GUIDE.md         # Guide to agent testing
│
└── results/                            # Test results (gitignored)

---

Updated Commands

Before

npm run eval:sdk -- --pattern="opencode/openagent/**/*.yaml"
npm run eval:sdk -- --pattern="opencode/shared/**/*.yaml"

After

npm run eval:sdk -- --pattern="agents/openagent/**/*.yaml"
npm run eval:sdk -- --pattern="agents/shared/**/*.yaml"

---

Test Files (13 total)

OpenAgent Tests (11)

agents/openagent/tests/
├── developer/
│   ├── task-simple-001.yaml
│   ├── ctx-code-001.yaml
│   ├── ctx-docs-001.yaml
│   ├── fail-stop-001.yaml
│   ├── create-component.yaml
│   ├── install-dependencies-v2.yaml
│   └── install-dependencies.yaml
├── business/
│   ├── conv-simple-001.yaml
│   └── data-analysis.yaml
└── edge-case/
    ├── just-do-it.yaml
    └── no-approval-negative.yaml

Shared Tests (1)

agents/shared/tests/
└── common/
    └── approval-gate-basic.yaml

---

Verification

Check Structure

cd evals
tree -L 4 -d agents

List All Tests

find agents -name "*.yaml" -type f | sort

Run Tests

cd framework
npm run eval:sdk -- --pattern="agents/openagent/**/*.yaml"

---

Benefits of New Structure

1. Clearer Naming

   • ✅ agents/ clearly indicates agent-specific content
   • ✅ tests/ is simpler than sdk-tests/

2. Easy to Navigate

   • ✅ OpenAgent tests: agents/openagent/tests/
   • ✅ OpenCoder tests: agents/opencoder/tests/ (future)
   • ✅ Shared tests: agents/shared/tests/

3. Scalable

   • ✅ Add new agent: mkdir -p agents/my-agent/tests/developer
   • ✅ Each agent has same structure
   • ✅ No confusion about where files go

4. Consistent

   • ✅ All agents use same folder structure
   • ✅ Easy to copy structure for new agents

---

Next Steps

1. Verify tests still work

   cd framework
   npm run eval:sdk -- --pattern="agents/openagent/tests/developer/task-simple-001.yaml"
   

2. Run all tests

   npm run eval:sdk -- --pattern="agents/openagent/**/*.yaml"
   

3. Commit changes

   git add evals/
   git commit -m "refactor: reorganize evals with agents/ subfolder structure"
   

---

Migration Summary

Time Taken: < 5 minutes
Files Moved: 13 test files
Directories Renamed: 3
Documentation Updated: 7 files
Breaking Changes: None (paths updated in docs)

Status: ✅ Migration Complete and Verified