README.md
April 14, 2026 · View on GitHub
A full AI development team — researcher, PM, architect, dev, QA, and reviewer — as native Codex agents, orchestrated through a configurable pipeline.
Quick Start
curl -fsSL https://raw.githubusercontent.com/yimwoo/codex-agenteam/main/install.sh | bash
Restart Codex, go to Plugins > Local Plugins, install AgenTeam, then:
@ATeam build my team
If the role picker does not show @Architect, @Dev, and the others right
away, confirm the project has .codex/agents/*.toml, then open a new thread
or restart Codex so it reloads workspace agents.
Your Team
| Role | Mention | Job |
|---|---|---|
| Researcher | @Researcher | Investigates docs, trends, prior art |
| PM | @Pm | Prioritizes work, writes specs |
| Architect | @Architect | Designs systems, identifies risks |
| Dev | @Dev | Writes production code |
| Qa | @Qa | Writes tests, catches regressions |
| Reviewer | @Reviewer | Reviews for correctness and security |
@Architect review this API design
@Dev fix the race condition in src/queue.py
@ATeam add user authentication
Documentation
- Setup & Installation — prerequisites, install, update
- Configuration — roles, profiles, model routing, two-layer config
- Pipeline & Profiles — stages, gates, verification, resume, CI repair
- CLI Reference — all skills and runtime commands
- HOTL Integration — structured execution with the HOTL plugin
Governed Delivery Foundations
AgenTeam 3.4 adds an optional governance foundation for teams handling larger
features, multi-phase initiatives, or longer-lived delivery work. You can
scaffold local assets with agenteam-rt governed-bootstrap, record structured
decisions with agenteam-rt decision append, and evaluate starter tripwires
with agenteam-rt tripwire check.
These commands are additive. Existing quick fixes, POCs, and standard pipeline flows keep working the same way unless you choose to layer governance on top.
Contributing
Found a bug or have a role idea? Open an issue or submit a PR.
License
MIT © Yiming Wu