# New Adr

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-omarsaleh506-skills-new-adr`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [OmarSaleh506](https://agentstack.voostack.com/s/omarsaleh506)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [OmarSaleh506](https://github.com/OmarSaleh506)
- **Source:** https://github.com/OmarSaleh506/skills/tree/main/skills/ai-os-init/templates/.claude/skills/new-adr
- **Website:** https://skills.sh/OmarSaleh506/skills

## Install

```sh
agentstack add skill-omarsaleh506-skills-new-adr
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# new-adr

Creates a properly-numbered ADR file in `docs/decisions/`.

## Steps

1. **Determine the next number**
   - List all files matching `docs/decisions/[0-9]*.md`
   - Extract the leading `NNNN` from each filename
   - Take the highest number and add 1 (pad to 4 digits)
   - If no files exist yet, start at `0002` (0001 is the bootstrap ADR)

2. **Build the filename**
   - Slugify the decision title: lowercase, spaces → hyphens, remove
     punctuation
   - Filename: `docs/decisions/NNNN-.md`

3. **Write the ADR** using the template below, filled in with the decision
   context the user provided. Leave `[date]` as today's ISO date and
   `[author]` as "Claude Code" unless the user specifies otherwise.

4. **Update the architecture doc** (optional)
   - If `docs/architecture.md` has a "Key Design Decisions" section,
     append a link row. If the section doesn't exist, skip this step.

5. **Report** the file path created and the ADR's title + number.

## ADR Template

```markdown
# ADR-NNNN: [Decision Title]

- **Status:** Draft
- **Date:** [YYYY-MM-DD]
- **Author:** [author]

## Context

_What situation or requirement forced this decision?_

## Decision

_What was decided, stated directly: "We will ..."_

## Consequences

- **Good:** ...
- **Trade-off:** ...
- **Risk:** ...
```

## Rules

- **Never overwrite** an existing ADR — create a new "Supersedes ADR-XXXX" one instead.
- **Status is "Draft"** unless the user explicitly says it's accepted.
- Keep ADRs short. If context needs more than 150 words, summarise.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OmarSaleh506](https://github.com/OmarSaleh506)
- **Source:** [OmarSaleh506/skills](https://github.com/OmarSaleh506/skills)
- **License:** MIT
- **Homepage:** https://skills.sh/OmarSaleh506/skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-omarsaleh506-skills-new-adr
- Seller: https://agentstack.voostack.com/s/omarsaleh506
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.