Skip to main content
Version: 0.49.0

XP-009: Codex Instruction Chain Exceeds project_doc_max_bytes

Summary​

  • Rule ID: XP-009
  • Severity: MEDIUM
  • Category: Cross-Platform
  • Normative Level: SHOULD
  • Auto-Fix: No
  • Verified On: 2026-07-31

Applicability​

  • Tool: codex
  • Version Range: unspecified
  • Spec Revision: unspecified

Evidence Sources​

Test Coverage Metadata​

  • Unit tests: true
  • Fixture tests: false
  • E2E tests: false

Examples​

The following examples demonstrate what triggers this rule and how to fix it.

Invalid​

# Root AGENTS.md (20 KB)\n\n# api/AGENTS.md (10 KB)\n\n# api/v2/AGENTS.md (8 KB)\n\nCombined 38 KB: Codex stops appending once the running total passes 32768, so api/v2 is silently dropped.

Valid​

# Root AGENTS.md (8 KB)\n\nProject conventions.\n\n# nested/AGENTS.md (6 KB)\n\nModule specifics. Combined 14 KB, under the 32768-byte cap.