Agents#
The roles agents play across the MSX ecosystem, authored once as documentation. Each page describes one role — its job, when to use it, and the steps it follows — grounded in the Ways of Working rather than restating them.
These descriptions are the single source for agent behaviour. A repository does not carry its own copy; its AGENTS.md and CLAUDE.md are thin pointers to these pages (Agentic Development). Humans read the same pages a new teammate would.
The lifecycle runs Define → Implement → Review: capture and plan the work, build it in a pull request, then review it. Two supporting roles — Security Reviewer and Agent Author — run alongside.
Contents#
| Page | Description |
|---|---|
| Define | Capture, refine, and plan a change into an actionable issue ready for implementation. |
| Implement | Take a planned issue and deliver it as a review-ready pull request — branch, build, self-review, and finalize. |
| Reviewer | Review someone else's pull request for delivery, taste, security, and undiscussed decisions. |
| Security Reviewer | A structured, defensive security review that reports vulnerabilities as an actionable responsible-disclosure issue. |
| Agent Author | Create and maintain the agent role descriptions and the per-repository pointer files that reference them. |