# Adrkit Init

> Use when initializing ADR Kit in a repository or when the agent cannot find an adr/ directory.

- Skill: `luochang212/adrkit-init` (Agent Skill)
- Install (CLI): `npx skillmds@latest add luochang212/adrkit-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luochang212/adrkit-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luochang212 (https://skillmd.com/u/luochang212)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/luochang212/adrkit-init

---


# ADR Kit Init

## Overview

Create an `adr/` repository in the target directory.

## Steps

1. Decide the target directory (default: current working directory).
2. Run:

```bash
adrkit init [path]
```

3. Confirm the output lists `adr/config.yaml`, `adr/decisions`, and
   `adr/.gitignore`. Proposals are not a separate folder: they are ephemeral
   drafts in `adr/.drafts/`, created by `adrkit propose`.

## Rules

- Never create `adr/` directories by hand; use the CLI so the config and
  README stay canonical.
- After init, the next action is usually `adrkit decide "<title>"`, or
  `adrkit propose "<title>"` when the decision still needs review.

