---
title: Codex
description: Como o projeto expõe instruções para Codex.
context: AGENTS.md, `.codex/`, plugin de orquestração e skills compartilhadas.
---

# Codex

Codex usa `AGENTS.md` como superfície portátil principal. Agents especializados vivem em `.codex/agents/`, regras em `.codex/rules/` e roteamento em `.codex/sdd-model-routing.toml`.

## Arquivos

| Caminho | Uso |
|---|---|
| `AGENTS.md` | Instruções principais do workspace |
| `.codex/agents/*.toml` | Subagents por etapa e reviewers auxiliares |
| `.codex/rules/*.md` | Princípios, rastreabilidade e convenções |
| `.codex/config.toml` | Config local do client |
| `.codex/sdd-model-routing.toml` | Roteamento por etapa |
| `.agents/skills/*/SKILL.md` | Skills compartilhadas |
| `plugins/orchestration/` | Plugin repo-local de orquestração |

## Operação

```bash
sdd clients doctor --strict
sdd skills doctor --strict
sdd orchestration "minha demanda"
```

## Limites

Codex é o adapter com escrita de workspace permitido nesta versão para execução real. Ainda assim, PRD, Tech Spec, Refinement, merge e deploy exigem gate humano explícito.
