Skip to content

Latest commit

 

History

History
124 lines (81 loc) · 3.45 KB

File metadata and controls

124 lines (81 loc) · 3.45 KB

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