Skip to content

Architecture

_codex_ combines an ML platform, repository automation, and a persistent decision-and-learning layer. New Python implementation lives under src/; application, configuration, test, documentation, and operational layers surround that boundary.

Start with the right map

  • Repository map provides the concise directory-level orientation.
  • Repository explanation describes the evidence-based five-layer architecture and component maturity.
  • Cognitive map focuses on cognitive, agent, ML, MCP, and delivery relationships.
  • Workflow map explains CI, security, coverage, self-healing, and governance entry points.
  • Session-state guide explains the operational intelligence that carries evidence and learning between agent sessions.

Use source, package manifests, and active workflow definitions as implementation authority. Treat dated reports and generated inventories as evidence for the state they recorded.