HANDBOOK.md

Team Handbook

This file is a companion to the AO configuration files in .agent/.

AO configuration files capture what an AI agent needs to generate conforming code and configuration. This handbook captures how the team works together — conventions that matter to humans but do not need to be machine-readable.

If you are looking for toolchain, style, or coding conventions, see .agent/ao-config.toml and its language and type layers instead.

What belongs here vs in AO config

AO config (.agent/)	Handbook (this file)
Toolchain and linter config	On-call rotation and escalation
Test conventions and coverage	Incident severity definitions
Docstring style	How to run a postmortem
Branch protection rules	Team meeting cadence
PR template requirements	How to request time off
Dependabot configuration	Budget approval process
Logging and exception conventions	Vendor relationships
Release workflow	Promotion and performance criteria

Team

Name	Role	GitHub	Areas

Communication

Channel	Purpose

Meetings

Meeting	Cadence	Purpose

On-Call and Incidents

Rotation

Severity Levels

Level	Definition	Response Time
P0		Immediate
P1
P2

Escalation Path

Postmortem Process

Development Workflow

Branching

Pull Requests

⭐ Code Review Culture

Definition of Done

Release Process

Environments

Name	Purpose	Access

Monitoring and Alerting

Dependencies and Vendors

Security and Compliance

New Team Member Checklist

• Access to repositories
• Access to communication channels
• Development environment set up
• .agent/ config files loaded and verified
• First PR submitted and reviewed
• On-call rotation added

Decisions and History