DevelopmentAI
AI
Agent routing and execution documentation for Próx OS. AGENTS.md at the repo root remains the **strong rule source**; this section is the navigable index for wo
Agent routing and execution documentation for Próx OS. AGENTS.md at the repo root remains the strong rule source; this section is the navigable index for workflow docs under docs/development/ai/.
Default development uses Direct Implementation Mode. RFC, ADR, slicing, phase planning, and proceed-gated workflows are manual opt-in only.
Start here
| Order | Document | Use |
|---|---|---|
| 1 | context-pack.md | Lightweight routing index; read first for most tasks. |
| 2 | ai-execution-protocol.md | Default direct mode plus manual opt-in governance modes. |
| 3 | cost-gate.md | Task size and risk hints, not automatic slicing. |
| 4 | task-splitting-protocol.md | Manual opt-in slicing only. |
| 5 | codex-prompt-batching.md | Triage large prompts into serial or parallel tasks. |
| 6 | github-issues-prs-agent-workflow.md | Future issue-to-agent and PR workflow direction. |
| 7 | ../ai-control-plane/README.md | Optional Architect AI, agent scopes, task graphs, run logs, integration reports, and release plans. |
Reference
| Topic | Document |
|---|---|
| OS action contracts | os-action-contract.md |
| Model and provider cost posture | cost-and-provider-strategy.md |
| Artifact promotion | artifact-to-app-pipeline.md |
| Prompt templates | prompt-templates.md |
| AI Control Plane templates | ../ai-control-plane/prompt-templates/README.md |
| Development workflow | ../development/README.md |
| Governance | ../governance/index.md |
| Roles | ../roles/index.md |
| MCP catalog | mcp-catalog.md |
| Agent rules | agent-rules.md |
| OS startup flow | os-startup-flow.md |
| Context index | context.md |
| Repository map | repo-map.md |