Copilot integration

ADLC as a GitHub Copilot plugin

A native Copilot CLI plugin: seven lifecycle hooks, six phase skills, allowlisted MCP gate tools, and six read-only prosecution agents. Built against Copilot's own plugin surfaces. The in-session rail hook is best-effort; CI is the guarantee.

Native pluginGit marketplace

skills: 6
hook events: 7
MCP tools: 2
prosecution agents: 6

Marketplace plugin

install: GitHub Copilot

npm install -g @adlc/cli
copilot plugin marketplace add voodootikigod/adlc
copilot plugin install adlc-copilot@adlc
adlc init --no-codex-agents

Installs from this repo's Git plugin marketplace, not npm — the @adlc/copilot npm package is not the install path. The universal installer performs these steps automatically when it detects the copilot CLI. adlc init --harness copilot is NOT available in the published @adlc/cli 1.6.0 (it exits: --harness must be codex or cursor); use --no-codex-agents until the next release. Either way it only scaffolds repository state and is not a substitute for installing the plugin.

Native surfaces

What the Copilot plugin installs

adlc-copilot / native bundle

adlc-copilot/
├─ plugin.json       manifest
├─ skills/           6 phase-aware workflows
├─ hooks/hooks.json  7 lifecycle events
├─ .mcp.json         2 allowlisted tools
└─ agents/           6 prosecution lenses

01 / skills

Skills load only the phase you need

The adlc skill routes to a phase, then a focused skill loads just that P0-P7 workflow instead of the whole lifecycle.

adlc
adlc-init
adlc-ticket
adlc-prosecute
adlc-distill
adlc-maintain

02 / hook events

Hooks for context, rails, and compaction

Hooks restore ticket context at session start, check frozen-rail writes before a tool runs, survive compaction, and coordinate subagents.

sessionStart
preToolUse
postToolUse
preCompact
subagentStart
subagentStop
agentStop

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 / prosecution agents

Five lenses plus an independent verifier

P5 fans out five read-only specialist lenses, then an independent verifier refutes findings before they gate the merge.

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

Phase routing

Skills route, CI enforces

The adlc skill picks the phase and a focused skill loads that workflow. The preToolUse hook is an in-session nudge; treat CI as the control you rely on.

Phase	Copilot entry	Evidence produced
P0	adlc-ticket	ticket in the canonical store
P1-P2	adlc skill	spec-lint · premortem · coldstart
P3-P4	preToolUse + CI	rail deny · rails-guard-ci
P5-P6	adlc-prosecute	hollow-test · behavior diff · manifest
P7	adlc-distill	foundry · rejection mining

Frozen rails

Best-effort in session, required in CI

In the session

Best-effort rail deny

The preToolUse hook denies edits to a frozen ticket's rails, then build-gate checks context fitness. Bash is not reliably parseable, so a shell write can still reach the diff — that is what the CI gate exists for.

In CI

The unbypassable control

scripts/rails-guard-ci.mjs rejects any PR whose diff touches a rail frozen on the base branch, in any spelling. Install docs/ci/rails-guard.yml as .github/workflows/adlc-rails-guard.yml and follow its bootstrap ceremony before making it required.

Install

Install from the Git plugin marketplace

Marketplace plugin

install: GitHub Copilot

npm install -g @adlc/cli
copilot plugin marketplace add voodootikigod/adlc
copilot plugin install adlc-copilot@adlc
adlc init --no-codex-agents

operate: Copilot plugin

# Or let the universal installer detect Copilot and do it for you
curl -fsSL https://www.agenticlifecycle.ai/install.sh | sh

# Scaffold repository state (NOT a plugin install)
adlc init --no-codex-agents