Contributor AI / Codex Guide

This page links to contributor and agent contracts used to keep SDK changes safe and reviewable.

Start Here

• AGENTS.md - repository-wide contributor rules
• LLM guidance index - architecture, testing, release, and API contracts

Key Contracts

• Public API Contract
• Release Contract
• Testing and Quality
• Change Playbook

Multi-Agent Roles

• Canonical role configs: .codex/agents
• Human-readable role summaries: agents/

Notes

• Core/adapters boundary is mandatory: src/core stays adapter-agnostic.
• API Gate applies to exports and entrypoint/type-surface changes.
• Generated files must be regenerated, not manually edited.