01 / skills
Skills load only the phase you need
$adlc picks the phase, then a focused skill loads just that P0-P7 workflow.
- $adlc
- $adlc-init
- $adlc-spec
- $adlc-rail-build
- $adlc-prosecute
- $adlc-distill
Codex integration
ADLC as a Codex plugin
A native Codex plugin with phase routing, frozen-rail feedback, gate tools, and project review agents. Built for Codex directly. It is not a Claude compatibility shim.
Native pluginGit marketplace
- skills
- 6
- hook events
- 8
- MCP tools
- 2
- project agents
- 9
Marketplace plugin
npm install -g @adlc/cli@latest codex plugin marketplace add voodootikigod/adlc --ref main codex plugin add adlc-codex@adlc adlc init --root /absolute/path/to/project
Install @adlc/cli 1.4.2 or newer from npm, then install the native plugin from the Codex Git marketplace. Keep the CLI and plugin updated together, and start a new Codex thread after installation or upgrade.
Native surfaces
What the Codex plugin installs
adlc-codex/ ├─ .codex-plugin/plugin.json manifest ├─ skills/ 6 phase-aware workflows ├─ hooks/hooks.json 8 lifecycle events ├─ .mcp.json 2 allowlisted tools └─ agents/ 9 project role templates
02 / hook events
Hooks for context and rail feedback
Hooks restore context, block frozen-rail writes, watch for repeated failures, and check evidence at stop.
- SessionStart
- PreToolUse
- PostToolUse
- PreCompact
- PostCompact
- SubagentStart
- SubagentStop
- Stop
03 / MCP tools
Two MCP tools, tightly scoped
A local MCP server exposes allowlisted adlc_gate (no shell) and adlc_prosecute for evidence-producing review.
- adlc_gate
- adlc_prosecute
04 / project agents
Project roles for explore, review, verify, and the P5 fan-out
The initializer writes project-scoped Codex roles — explore/review/verify plus the five-lens P5 prosecution fan-out and its independent verifier — and leaves ~/.codex alone.
- explorer
- reviewer
- verifier
- prosecutor-correctness
- prosecutor-security
- prosecutor-contract
- prosecutor-diff
- prosecutor-tests
- prosecutor-verifier
Phase routing
Which skill to start with
Start with $adlc. It routes to a focused skill. Evidence lands under .adlc/ either way.
| Phase | Codex entry | Evidence produced |
|---|---|---|
| P0 | $adlc | preflight |
| P1-P2 | $adlc-spec | spec-lint · premortem · coldstart |
| P3-P4 | $adlc-rail-build | hollow-test · rails-guard · phase manifest |
| P5-P6 | $adlc-prosecute | prosecution · behavior diff · acceptance |
| P7 | $adlc-distill | foundry · rejection mining · rot · ratchet |
Frozen rails
Hooks in session, rails-guard in CI
In the session
Session hook blocks frozen-rail edits
PreToolUse arms for the selected incomplete ticket. Conflicting or stale ticket state fails closed once enforcement is on.
In CI
CI decides what may merge
Hooks give fast feedback. They are not a full security boundary. Keep the rails-guard job required so the trusted base ref decides what merges.
Install
Install from npm and the Codex Git marketplace
Marketplace plugin
npm install -g @adlc/cli@latest codex plugin marketplace add voodootikigod/adlc --ref main codex plugin add adlc-codex@adlc adlc init --root /absolute/path/to/project
Install @adlc/cli 1.4.2 or newer from npm, then install the native plugin from the Codex Git marketplace. Keep the CLI and plugin updated together, and start a new Codex thread after installation or upgrade.
# Update the CLI and plugin together npm install -g @adlc/cli@latest codex plugin marketplace upgrade adlc codex plugin add adlc-codex@adlc codex plugin list --json --available # Replace the older compatibility install codex plugin remove adlc@plugins-cli codex plugin add adlc-codex@adlc # Start a new Codex thread to load the refreshed MCP transport