Claude Code integration

ADLC inside Claude Code

Phase-routing skill, slash-command gates, rails-guard and build-gate hooks, and a multi-lens prosecutor panel. Claude is the model via --prompt-only. No API keys for ADLC gates. Claude answers --prompt-only prompts in-session. Evidence stays under .adlc/.

Native pluginOne-line install
commands
5
hook events
8
MCP server
1
prosecutor agents
7
routing skill
1
One-line install
install: Claude Code
npx plugins add voodootikigod/adlc
npm install -g @adlc/cli
/adlc:adlc-init

The plugins installer auto-detects Claude Code and installs the native plugin. Prefer /adlc:adlc-init after the toolkit is on PATH. Native marketplace alternative: /plugin marketplace add voodootikigod/adlc then /plugin install adlc@adlc.

Native surfaces

What the Claude Code plugin installs

adlc-claude-code / native bundle
adlc-claude-code/
├─ .claude-plugin/  marketplace manifest
├─ skills/adlc/     phase-routing skill
├─ commands/        5 slash commands
├─ hooks/           8 lifecycle events
├─ .mcp.json        1 bundled MCP server
└─ agents/          7 prosecutor roles

01 / commands

Slash commands for each gate

Each of init, ticket, prosecute, distill, and maintain has its own /adlc:* command.

  • /adlc:adlc-init
  • /adlc:adlc-ticket
  • /adlc:adlc-prosecute
  • /adlc:adlc-distill
  • /adlc:adlc-maintain

02 / hook events

Hooks on session, edit, stop, and compaction

SessionStart warns if you are not ready and re-injects the active ticket. PreToolUse enforces rails and the build-gate. PostToolUse watches churn. Stop audits evidence and risk-gated review. PreCompact/PostCompact/SubagentStart/SubagentStop re-inject ticket context so a compaction or subagent boundary never drops rail-protection awareness.

  • SessionStart
  • PreToolUse
  • PostToolUse
  • Stop
  • PreCompact
  • PostCompact
  • SubagentStart
  • SubagentStop

03 / MCP server

The same gate tools, over MCP

A bundled MCP server, auto-discovered at the plugin root, shells to the globally-installed adlc binary and exposes the same allowlisted gate tools the Codex integration ships.

  • adlc

04 / prosecutor agents

Five lenses, then a verifier

/adlc:adlc-prosecute fans out five specialist lenses, dedupes findings, and keeps only what a sixth verifier confirms. It loops until two dry rounds.

  • prosecutor
  • correctness
  • security
  • contract
  • diff
  • tests
  • verifier

05 / routing skill

A skill that routes by phase

The adlc skill is a phase flowchart. Describe the work and it picks a gate so you do not have to memorize twenty tools.

  • adlc
Phase routing

Route by skill or slash command

Ask the adlc skill what you are doing, or call a slash command directly. Evidence stays under .adlc/.

PhaseClaude Code entryEvidence produced
P0/adlc:adlc-ticketschema-valid ticket · coldstart
P1-P2adlc skillspec-lint · premortem · parallax · router
P3-P4PreToolUse hooksrails-guard · build-gate · flail
P5-P6/adlc:adlc-prosecutemulti-lens loop · hollow-test · behavior-diff
P7/adlc:adlc-distillfoundry · rejection mining · maintain
Frozen rails

Session deny plus CI backstop

In the session

Frozen-rail edits are denied

PreToolUse rails-guard blocks Edit/Write/MultiEdit on frozen paths. Bash is not gated in-session (a shell cannot be reliably parsed), so pair the hook with CI.

In CI

Required check on the PR

docs/ci/rails-guard.yml reads rails from the trusted base ref and rejects any PR that touches them, including shell writes the hook never saw.

Install

Install with the plugins CLI

One-line install
install: Claude Code
npx plugins add voodootikigod/adlc
npm install -g @adlc/cli
/adlc:adlc-init

The plugins installer auto-detects Claude Code and installs the native plugin. Prefer /adlc:adlc-init after the toolkit is on PATH. Native marketplace alternative: /plugin marketplace add voodootikigod/adlc then /plugin install adlc@adlc.

operate: Claude Code plugin
# Offline manifest / hook / command contract
node scripts/claude-code-plugin-smoke.mjs .

# Native marketplace (same marketplace.json)
/plugin marketplace add voodootikigod/adlc
/plugin install adlc@adlc
ADLC began as an essay series. Read the original theory at voodootikigod.com ↗MIT · @adlc on npmPrivacy