Cursor integration

ADLC as a Cursor marketplace plugin

Marketplace plugin with sessionStart context, preToolUse rails, packaged prosecutor agents + MCP wrapper (channel unverified), /adlc-* commands, and CI as the backstop. A Cursor marketplace plugin with hooks, skills, rules, and commands. It is not a Claude shim.

Marketplace pluginCI rail backstop
hook events
9
commands
9
prosecutor agents
7
MCP tools
2
skills
2
rules
2
Marketplace plugin
install: Cursor
# Cursor → Settings → Plugins → Add marketplace:
#   https://github.com/voodootikigod/adlc
# Install plugin: adlc-cursor
npm install -g @adlc/cli
adlc init --harness cursor
# Scaffolder one-liner: npx adlc-cursor .

Prefer the marketplace install: it brings hooks, skills, and /adlc-* commands. Scaffolder one-liner: npx adlc-cursor . or npx @adlc/cursor . Wire docs/ci/rails-guard.yml as the unbypassable control.

Native surfaces

What the Cursor plugin installs

adlc-cursor / native bundle
adlc-cursor/
├─ .cursor-plugin/  marketplace manifest
├─ hooks/           9 Cursor hook events
├─ agents/          7 prosecutor agents
├─ mcp.json         2 Roots proxy MCP
├─ command/         9 /adlc-* commands
├─ skills/          2 skills
└─ rules/           2 phase-router rule

01 / hook events

Rails first, then audit hooks

sessionStart injects ticket context (best-effort). preToolUse runs rails first; Task spawn allowlist during P5. preCompact re-injects ticket context. subagentStart/Stop coordinate P5. stop/beforeSubmitPrompt surface evidence.

  • sessionStart
  • preToolUse
  • afterFileEdit
  • beforeShellExecution
  • stop
  • beforeSubmitPrompt
  • preCompact
  • subagentStart
  • subagentStop

02 / commands

/adlc-* commands in the palette

Covers init through maintain, including approve-spec, verify-build, and the sequential five-lens prosecute loop.

  • /adlc-init
  • /adlc-ticket
  • /adlc-spec
  • /adlc-approve-spec
  • /adlc-decompose
  • /adlc-verify-build
  • /adlc-prosecute
  • /adlc-distill
  • /adlc-maintain

03 / prosecutor agents

Packaged prosecutor agents (fan-out unverified)

Five readonly lenses plus verifier (+ optional orchestrator). Task fan-out is preferred; agents-backed claim waits on installed-Cursor proof.

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

04 / MCP tools

Wrapper landed / channel unverified

mcp.json runs a Roots proxy to adlc mcp-server. Do not claim MCP shipped until installed-Cursor Roots proof.

  • adlc_gate
  • adlc_prosecute

05 / skills

Two skills: router and init

The marketplace install includes the skills, so you do not copy them into the project by hand.

  • adlc
  • adlc-init

06 / rules

Phase routing + always-apply ticket context

adlc.mdc keeps phase routing in context; adlc-ticket-context.mdc alwaysApply fallback when sessionStart context is dropped.

  • adlc.mdc
  • adlc-ticket-context.mdc
Phase routing

Pick a phase command

Use the /adlc-* palette for each phase. Prefer Task fan-out for P5; sequential same-context is a degraded fallback. Pair with cross-model adversarial-review for the risk gate.

PhaseCursor entryEvidence produced
P0/adlc-ticketticket in .adlc/tickets.json
P1-P2/adlc-spec · /adlc-decomposespec-lint · premortem · coldstart
P3-P4preToolUse dispatcherrails deny · advisory buildgate · flail
P5-P6/adlc-prosecutefive-lens loop · hollow-test · behavior-diff
P7/adlc-distillfoundry · rejection mining · maintain
Frozen rails

Best-effort deny, required CI

In the session

Session deny is best-effort

preToolUse returns permission: deny on a frozen-rail edit, but Cursor deny reliability has open reports and failClosed is false so a hook bug cannot brick the editor. Shell writes are advisory-only.

In CI

Base-ref rails-guard is the control

docs/ci/rails-guard.yml is the unbypassable control. It reads rails from the trusted base ref. Freeze new rails in a separate merged commit before the build PR.

Install

Install from the Cursor marketplace

Marketplace plugin
install: Cursor
# Cursor → Settings → Plugins → Add marketplace:
#   https://github.com/voodootikigod/adlc
# Install plugin: adlc-cursor
npm install -g @adlc/cli
adlc init --harness cursor
# Scaffolder one-liner: npx adlc-cursor .

Prefer the marketplace install: it brings hooks, skills, and /adlc-* commands. Scaffolder one-liner: npx adlc-cursor . or npx @adlc/cursor . Wire docs/ci/rails-guard.yml as the unbypassable control.

operate: Cursor plugin
# Scaffolder one-liner
npx adlc-cursor .

# Offline contract smoke
node scripts/cursor-install-smoke.mjs .
ADLC began as an essay series. Read the original theory at voodootikigod.com ↗MIT · @adlc on npmPrivacy