Working with Agents¶
Site-nine uses AI agents to assist with software development tasks. When we refer to agents in this documentation, we're talking about entities that are native to your agentic coding platform (like OpenCode, Cursor, or Windsurf) - the AI assistants built into your development environment.
Site-nine provides a structured system of missions, roles, and personas that helps organize how these agents work and track their progress.
The Agent System¶
The agent system has three core concepts that work together to organize your development workflow.
Missions¶
A mission is a discrete unit of work with a clear objective. When you start a mission, you're creating a tracked session where an agent works toward a specific goal. Each mission receives a unique codename (like "Operation silver-titan") and generates a markdown file that documents progress, decisions, and outcomes.
Missions provide structure and accountability. They track what work has been done, preserve decisions and context for future reference, help manage multiple concurrent work streams, and facilitate smooth handoffs between sessions.
Roles¶
A role defines the type of work an agent performs. Site-nine provides 9 specialized roles that cover the full spectrum of software development activities:
- Administrator - Coordinates projects and delegates tasks
- Architect - Designs system architecture and makes technical decisions
- Engineer - Implements features and writes code
- Tester - Creates tests and validates quality
- Documentarian - Writes documentation and guides
- Designer - Creates UI/UX and visual assets
- Inspector - Reviews code and audits security
- Operator - Handles deployment and infrastructure
- Historian - Documents project history and preserves institutional knowledge
Each role brings specialized expertise and best practices for its domain, ensuring that agents apply the right knowledge and approach for the task at hand.
Personas¶
A persona is a unique character from ancient mythology that an agent assumes for a mission. When you start a mission with a chosen role, the agent adopts a persona themed around that role's purpose. The system maintains a pool of 256+ personas drawn from mythologies worldwide, automatically selecting unused personas to add variety and make it easy to distinguish between concurrent missions.
Personas add personality to the system while serving practical purposes. They make concurrent missions easy to track, provide memorable identities for conversation history, and give each work session a distinctive character. A Documentarian might become Fukurokuju (Japanese god of wisdom) or Thoth (Egyptian god of writing), while an Engineer might adopt Hephaestus (Greek god of craftsmanship) or Kothar (Canaanite divine craftsman).
How It Works¶
When you summon an agent, you choose a role based on the type of work to be done. The agent then assumes a persona - a mythological character matching that role. A mission begins with a unique codename and tracking file. The agent applies role-specific expertise to accomplish your objectives, documenting progress along the way. When the work is complete, the mission ends with outcomes documented and handoffs created if needed.
This structure ensures every piece of work is organized, trackable, and contextual.
Benefits¶
For individuals, the agent system provides specialized expertise for different tasks, clear separation between types of work, easy context switching between projects, and built-in documentation of decisions.
For teams, it establishes shared vocabulary and conventions, enables trackable work assignments by role, facilitates smooth handoffs between specialists, and provides visibility into who's working on what.
Getting Started¶
Ready to work with agents? Start by understanding how missions structure your work sessions, then explore the nine specialized roles to see which fits your current task. Learn how personas add identity and personality to each mission, and finally jump into the quickstart guide to begin your first mission.
The agent system is designed to make your development workflow more organized, trackable, and effective. Let's get started!
Next steps:
- Understand missions - Learn the lifecycle and structure
- Choose a role - See what each role specializes in
- Explore personas - Understand how personas work
- Start your first mission - Follow the quickstart guide