# adr-skill

> Claude/Codex skill by [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 28k stars · Updated 2026-11-13

Create, update, or consult Architecture Decision Records (ADRs). Use when capturing an architecture decision and its rationale, maintaining its lifecycle, checking decisions that govern planned changes, or when a session leads to a new decision affecting future work across multiple layers. Do not use for routine bug fixes or features confined to API internals or a single provider or harness adapter.

Tags: anthropic, artificial-intelligence, gemini, generative-ai, generative-ui, javascript, language-model, llm, nextjs, openai, react, svelte, typescript, vercel, vue

## Install

```sh
git clone https://github.com/vercel/ai /tmp/ai && ln -s /tmp/ai/skills/adr-skill ~/.claude/skills/adr-skill
```

## From README

ADR Skill An ADR records what we decided and why. Keep it concise and self-contained so future contributors and coding agents can understand the decision without the original conversation. Implementation plans and verification belong in issues and pull requests. When to Write an ADR Write an ADR for decisions that change how the system is built or operated, have meaningful alternatives, and affect future work: architecture patterns, dependencies, infrastructure, or API design. Routine implementation choices, bug fixes, and style preferences usually do not need an ADR. If a decision is already covered, update or reference the existing record. When an architectural choice comes up during implementation, propose capturing it if its rationale would help future contributors. If the user did not explicitly ask you to write an ADR, confirm with them first before writing or editing one. Respect the user's requested scope.

## Links

- HTML page: https://omgskills.com/library/vercel-labs/ai/adr-skill/
- GitHub: https://github.com/vercel/ai
- Author: [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md)

## More from this repo

- [add-provider-package](https://omgskills.com/library/vercel/ai/add-provider-package/index.md) — Guide for adding first-party AI provider packages to the AI SDK.
   - [@vercel](https://omgskills.com/library/vercel/index.md) · 27k stars

## More skills by this author

- [agent-browser](https://omgskills.com/library/vercel-labs/agent-browser/agent-browser/index.md) — Browser automation CLI for AI agents.
   - [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 51k stars
- [core](https://omgskills.com/library/vercel-labs/agent-browser/core/index.md) — Core agent-browser usage guide.
   - [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 45k stars