How arguv/codex-ai-agents works
This repository is a Codex agent-workflow learning project, with a small word-count CLI as its first coding exercise. Its main collaboration workflow is a user request coordinated by the main agent across Planner, Developer, Tester, and Reviewer roles; the agent-workflow skill guides those handoffs, while project-check provides local verification. The separate CLI accepts text, file, or stdin input and counts whitespace-separated tokens. Agent and skill internals are represented by their configured paths; their interactions are based on README documentation, not inspected implementation excerpts.
Main entry points: agent-workflow/SKILL.md Agent workflow · word_count.py CLI input handling · tester.toml Tester agent · project-check/SKILL.md Project check
Components 15
Agent collaboration
- Planner agent
.codex/agents/planner.toml - Developer agent
.codex/agents/developer.toml - Tester agent
.codex/agents/tester.toml - Reviewer agent
.codex/agents/reviewer.toml
Reusable skills
- Agent workflow
.agents/skills/agent-workflow/SKILL.md - Project check
.agents/skills/project-check/SKILL.md - Collaboration exercise
WORKFLOW.md - Workflow evaluation
EVALUATION.md - Evaluation results
EVALUATION_RESULTS.md
Word-count CLI
- CLI input handling
word_count.py - Token counter
word_count.py
Other components
- User
- Main agent
- Text / file / stdin
- Printed count
Connections 18
- User → Main agent: requests work
README.md - Main agent → Planner agent: delegates planning
README.md - Main agent → Developer agent: delegates implementation
README.md - Main agent → Tester agent: delegates testing
README.md - Main agent → Reviewer agent: delegates review
README.md - Main agent → Agent workflow: uses workflow
README.md - Agent workflow → Planner agent: coordinates handoffs
README.md - Agent workflow → Developer agent: coordinates handoffs
README.md - Agent workflow → Tester agent: coordinates handoffs
README.md - Agent workflow → Reviewer agent: coordinates handoffs
README.md - User → Project check: requests verification
README.md - Project check → Tester agent: runs checks
- Collaboration exercise → Agent workflow: guides use
README.md - Workflow evaluation → Evaluation results: records evidence
README.md - User → CLI input handling: invokes
README.md - Text / file / stdin → CLI input handling: provides input
word_count.py - CLI input handling → Token counter: calls count_words
word_count.py - Token counter → Printed count: returns count
word_count.py