Skip to content

Latest commit

 

History

History
24 lines (17 loc) · 927 Bytes

File metadata and controls

24 lines (17 loc) · 927 Bytes

Architecture

Codex Learning Loop is a file-based maintenance system for ~/.codex.

Components

  • codex-add-global-learning-note writes candidate notes to ~/.codex/learning-inbox/.
  • codex-global-learning-maintenance runs Codex against ~/.codex only.
  • The LaunchAgent schedules maintenance daily and at load.
  • Markdown files store durable rules, memories, workflows, and error patterns.
  • TSV files store run state and source-processing index data.

Data Flow

  1. A normal Codex session notices a reusable lesson.
  2. The helper creates a candidate note in the inbox.
  3. Daily maintenance reads allowed Codex-owned sources.
  4. The prompt rubric classifies the candidate.
  5. The note is promoted, kept, or archived.
  6. A report and log are written.

Boundaries

The system is global, not repo-specific. It is intentionally limited to ~/.codex and does not scan unrelated folders or project repositories.