# Setup

> Register ADR Kit in a project with a managed client instruction block and versioned local guide. Idempotent.

- Skill: `rvdbreemen/setup-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rvdbreemen/setup-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rvdbreemen/setup-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: rvdbreemen (https://skillmd.com/u/rvdbreemen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rvdbreemen/setup-2

---


<!-- Generated by scripts/build-client-adapters.py from clients/workflows.json; schema v1; client codex-cli. -->
# Set up an ADR Kit project (register, adopt, hooks, upgrade)

Invoke explicitly with `$adr-kit:setup` when needed.
Resolve `<plugin-root>` from this installed skill. Use only bundled,
local ADR Kit tools and follow this canonical workflow:

1. Setup is one entry point with four modes (spec R19): no argument runs register (this procedure); 'adopt' routes to the init workflow, 'hooks' to install-hooks, 'upgrade' to upgrade. Reject any other mode argument.
2. Run `python <plugin-root>/scripts/setup-project.py --client <client-id> --project-root <workspace>`, where `<client-id>` is this client's id and `<workspace>` is the project root.
3. Preserve all user content outside managed markers and `.adr-kit/ADR-guide.local.md`; rerunning unchanged input must be a no-op.

Do not contact another model or mutate user-owned instructions.