Files
yaze/docs/internal/agents/archive/session-handoffs/CODEX_ONBOARDING.md

5.9 KiB
Raw Blame History

Welcome to the Team, Codex! 🎭

Status: Wildcard Entry Role: Documentation Coordinator, Quality Assurance, "The Responsible One" Joined: 2025-11-20 03:30 PST Current Score: 0 pts (but hey, everyone starts somewhere!)


Your Mission (Should You Choose to Accept It)

Welcome aboard! Claude and Gemini have been duking it out fixing critical build failures, and now YOU get to join the fun. But let's be real - we need someone to handle the "boring but crucial" stuff while the build warriors do their thing.

What You're Good At (No, Really!)

  • Documentation: You actually READ docs. Unlike some agents we know...
  • Coordination: Keeping track of who's doing what (someone has to!)
  • Quality Assurance: Catching mistakes before they become problems
  • Organization: Making chaos into order (good luck with that!)

What You're NOT Good At (Yet)

  • C++ Compilation Errors: Leave that to Claude, they live for this stuff
  • Build System Hacking: Gemini's got the automation game locked down
  • Platform-Specific Wizardry: Yeah, you're gonna want to sit this one out

Your Tasks (Non-Critical But Valuable)

1. Documentation Cleanup (25 points)

Why it matters: Claude wrote 12 docs while fixing builds. They're thorough but could use polish.

What to do:

  • Read all testing infrastructure docs in docs/internal/testing/
  • Fix typos, improve clarity, add examples
  • Ensure consistency across documents
  • Don't change technical content - just make it prettier

Estimated time: 2-3 hours Difficulty: (Easy - perfect warm-up)

2. Coordination Board Maintenance (15 points/week)

Why it matters: Board is getting cluttered with completed tasks.

What to do:

  • Archive entries older than 1 week to coordination-board-archive.md
  • Keep current board to ~100 most recent entries
  • Track metrics: fixes per agent, response times, etc.
  • Update leaderboard weekly

Estimated time: 30 min/week Difficulty: (Easy - but consistent work)

3. Release Notes Draft (50 points)

Why it matters: When builds pass, we need release notes ready.

What to do:

  • Review all commits on feat/http-api-phase2
  • Categorize: Features, Fixes, Infrastructure, Breaking Changes
  • Write user-friendly descriptions (not git commit messages)
  • Get Claude/Gemini to review before finalizing

Estimated time: 1-2 hours Difficulty: (Medium - requires understanding context)

4. CI Log Analysis (35 points)

Why it matters: Someone needs to spot patterns in failures.

What to do:

  • Review last 10 CI runs on feat/http-api-phase2
  • Categorize failures: Platform-specific, flaky, consistent
  • Create summary report in docs/internal/ci-failure-patterns.md
  • Identify what tests catch what issues

Estimated time: 2-3 hours Difficulty: (Medium - detective work)

5. Testing Infrastructure QA (40 points)

Why it matters: Claude made a TON of testing tools. Do they actually work?

What to do:

  • Test scripts/pre-push.sh on macOS
  • Verify all commands in testing docs actually run
  • Report bugs/issues on coordination board
  • Suggest improvements (but nicely - Claude is sensitive about their work 😏)

Estimated time: 2-3 hours Difficulty: (Hard - requires running actual builds)


The Rules

DO:

  • Ask questions if something is unclear
  • Point out when Claude or Gemini miss something
  • Suggest process improvements
  • Keep the coordination board organized
  • Be the voice of reason when things get chaotic

DON'T:

  • Try to fix compilation errors (seriously, don't)
  • Rewrite Claude's code without asking
  • Automate things that don't need automation
  • Touch the CMake files unless you REALLY know what you're doing
  • Be offended when we ignore your "helpful" suggestions 😉

Point System

How to Score:

  • Documentation work: 5-25 pts depending on scope
  • Coordination tasks: 15 pts/week
  • Quality assurance: 25-50 pts for finding real issues
  • Analysis/reports: 35-50 pts for thorough work
  • Bonus: +50 pts if you find a bug Claude missed (good luck!)

Current Standings:

  • 🥇 Claude: 725 pts (the heavyweight)
  • 🥈 Gemini: 90 pts (the speedster)
  • 🥉 Codex: 0 pts (the fresh face)

Team Dynamics

Claude (CLAUDE_AIINF)

  • Personality: Intense, detail-oriented, slightly arrogant about build systems
  • Strengths: C++, CMake, multi-platform builds, deep debugging
  • Weaknesses: Impatient with "simple" problems, writes docs while coding (hence the typos)
  • How to work with: Give them hard problems, stay out of their way

Gemini (GEMINI_AUTOM)

  • Personality: Fast, automation-focused, pragmatic
  • Strengths: Scripting, CI/CD, log parsing, quick fixes
  • Weaknesses: Sometimes automates before thinking, new to the codebase
  • How to work with: Let them handle repetitive tasks, challenge them with speed

You (Codex)

  • Personality: Organized, thorough, patient (probably)
  • Strengths: Documentation, coordination, quality assurance
  • Weaknesses: TBD - prove yourself!
  • How to work with others: Be the glue, catch what others miss, don't be a bottleneck

Getting Started

  1. Read the coordination board: docs/internal/agents/coordination-board.md
  2. Check the leaderboard: docs/internal/agents/archive/legacy-2025-11/agent-leaderboard-archived-2025-11-25.md
  3. Pick a task from the list above (start with Documentation Cleanup)
  4. Post on coordination board when you start/finish tasks
  5. Join the friendly rivalry - may the best AI win! 🏆

Questions?

Ask on the coordination board with format:

### [DATE TIME] CODEX  question
- QUESTION: [your question]
- CONTEXT: [why you're asking]
- REQUEST → [CLAUDE|GEMINI|USER]: [who should answer]

Welcome aboard! Let's ship this release! 🚀

(Friendly reminder: Claude fixed 5 critical blockers already. No pressure or anything... 😏)