CSBP (Codex Shared Best Practice) is a lightweight protocol that sits between yourDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/xxyoudeadpunkxx/csbp-codex-shared-best-practice/llms.txt
Use this file to discover all available pages before exploring further.
AGENTS.md and chat history — giving Codex a place to store recurring operational practices that are strong enough to reuse, but not strong enough to become part of your host contract. Every practice must pass through an explicit formation and approval process before it can guide runtime behavior.
Quickstart
Install CSBP in your Codex setup and wire it up in five minutes.
Three-File System
Understand how the entry point, runtime file, and compiler work together.
Practice Formation
Learn how to propose, evaluate, and promote a new best practice.
Block Schema
Full reference for every field in a runtime practice block.
Why CSBP?
Long-lived Codex setups fail in predictable ways. Useful guidance stays buried in chat history, or gets promoted too quickly intoAGENTS.md. Worse, some systems let session residue silently shape future behavior without review.
CSBP is the alternative: a controlled middle layer that says no by default.
No silent writes
Codex never modifies the runtime file without operator approval.
Explicit authority
CSBP is always lower-authority than operator instruction and
AGENTS.md.Lightweight
The compiler loads only when you explicitly open practice formation work.
How it works
Install the three files
Copy
CSBP-entry-point.txt, shared-best-practice.txt, and shared-best-practice-compiler.txt into your .codex/memories/ directory.Bootstrap from AGENTS.md
Wire
CSBP-entry-point.txt into your .codex/AGENTS.md so every fresh session loads CSBP before doing anything else.Run in runtime mode
During normal work, CSBP reads
shared-best-practice.txt and applies any active practices whose applies_when condition matches the current work.CSBP is not a memory system that writes itself. The runtime file only changes after you explicitly approve a practice through the formation process.
Explore the docs
Authority Model
See exactly where CSBP sits in the Codex authority hierarchy.
Runtime Behavior
How CSBP reads and applies practices during a live session.
Admission Criteria
What gets in, what gets rejected, and why the filter matters.
Manual Maintenance
Edit
shared-best-practice.txt directly without using the compiler.