How do I install the Adr New skill?

Run npx skillmds@latest add ansible/adr-new-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adr New safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adr New?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adr New free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adr New?

ansible (@ansible) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adr New by ansible — Agent Skill

Name: Adr New
Author: ansible

Adr New

Create an Architecture Decision Record for tox-ansible. Use when documenting an architecture decision, "record this choice", "we decided to use X", or major design choices affecting the matrix, config surfaces, or plugin behavior.

ansible Updated Sep 22, 2026

File contents

ADR New

Create an Architecture Decision Record.

Arguments

If $ARGUMENTS is provided, parse for:

Decision title in quotes → use as ADR title
--status X → set status (proposed / accepted)

Usage

/adr-new                            # Interactive mode
/adr-new "Decision Title"           # Quick mode with title
/adr-new "Title" --status accepted  # With status

Behavior

1. Check for Context

From conversation: If recent discussion contains a decision:

I see you decided [X] over [Y]. Create ADR from this? (Y/n)

2. Determine Next ADR Number

Scan .sdlc/adrs/ADR-*.md for highest number, increment by 1.

3. Gather Information (Streamlined)

Decision title?

Context — why is this decision needed?

Constraints and drivers? (bullet list, or included above)

Options considered (name: description, pros/cons):

Require at least 2 options for meaningful comparison.

Decision — which option and why?

Consequences? (use +/- prefix, or describe)

Status? (1=Proposed, 2=Accepted)

Implementation guidance? (or skip)

Related ADRs? (numbers, or skip)

4. Consistency and Invariant Check

Before creating the ADR file, verify consistency with tox-ansible conventions in AGENTS.md:

Convention	Status
ade installs ansible-core (plugin orchestrates tox envs)	Consistent / MODIFIES
Upstream matrix lives in `ENV_LIST` in `plugin.py`	Consistent / MODIFIES
Config via `[ansible]` INI and `[tool.tox-ansible]` TOML	Consistent / MODIFIES
No dual/competing matrix semantics without an ADR	Consistent / MODIFIES

Also read .sdlc/adrs/README.md for conflicts, duplicates, and related ADRs.

If this ADR contradicts an existing accepted ADR without superseding it:

Either add Supersedes: ADR-NNN, make it compatible, or explain coexistence under Related Decisions.

5. Create ADR File

Create .sdlc/adrs/ADR-NNN-title-slug.md using .sdlc/templates/adr.md.

Slug: 3-5 words, lowercase, hyphens.

Fill title, status, date, context, options (with why-not), decision, consequences, implementation notes, related decisions, references, and revision history.

6. Update Index

Run:

python scripts/generate_adr_index.py

Do not hand-edit .sdlc/adrs/README.md.

7. Summary

Done!
- Created: ADR-NNN-title-slug.md
- Status: [Proposed/Accepted]
- Updated: adrs/README.md (via generate_adr_index.py)

Next: [If Proposed] Share for review | [If Accepted] Implement

Quick Mode

Provided	Skip
Title in quotes	Title prompt
`--status X`	Status prompt

Edge Cases

Situation	Handling
<2 options provided	Ask for at least one more
No consequences listed	Note "To be determined"

---name: adr-new-2description: Create an Architecture Decision Record for tox-ansible. Use when documenting an architecture decision, "record this choice", "we decided to use X", or major design choices affecting the matrix, config surfaces, or plugin behavior.---# ADR NewCreate an Architecture Decision Record.## ArgumentsIf `$ARGUMENTS` is provided, parse for:- Decision title in quotes → use as ADR title- `--status X` → set status (`proposed` / `accepted`)## Usage```/adr-new # Interactive mode/adr-new "Decision Title" # Quick mode with title/adr-new "Title" --status accepted # With status```## Behavior### 1. Check for Context**From conversation:** If recent discussion contains a decision:```I see you decided [X] over [Y]. Create ADR from this? (Y/n)```### 2. Determine Next ADR NumberScan `.sdlc/adrs/ADR-*.md` for highest number, increment by 1.### 3. Gather Information (Streamlined)```Decision title?``````Context — why is this decision needed?``````Constraints and drivers? (bullet list, or included above)``````Options considered (name: description, pros/cons):```Require at least 2 options for meaningful comparison.```Decision — which option and why?``````Consequences? (use +/- prefix, or describe)``````Status? (1=Proposed, 2=Accepted)``````Implementation guidance? (or skip)``````Related ADRs? (numbers, or skip)```### 4. Consistency and Invariant Check**Before creating the ADR file**, verify consistency with tox-ansible conventionsin `AGENTS.md`:| Convention | Status ||------------|--------|| ade installs ansible-core (plugin orchestrates tox envs) | Consistent / MODIFIES || Upstream matrix lives in `ENV_LIST` in `plugin.py` | Consistent / MODIFIES || Config via `[ansible]` INI and `[tool.tox-ansible]` TOML | Consistent / MODIFIES || No dual/competing matrix semantics without an ADR | Consistent / MODIFIES |Also read `.sdlc/adrs/README.md` for conflicts, duplicates, and related ADRs.**If this ADR contradicts an existing accepted ADR without superseding it:**Either add `Supersedes: ADR-NNN`, make it compatible, or explain coexistence under Related Decisions.### 5. Create ADR FileCreate `.sdlc/adrs/ADR-NNN-title-slug.md` using `.sdlc/templates/adr.md`.**Slug:** 3-5 words, lowercase, hyphens.Fill title, status, date, context, options (with why-not), decision, consequences, implementation notes, related decisions, references, and revision history.### 6. Update IndexRun:```bashpython scripts/generate_adr_index.py```Do not hand-edit `.sdlc/adrs/README.md`.### 7. Summary```Done!- Created: ADR-NNN-title-slug.md- Status: [Proposed/Accepted]- Updated: adrs/README.md (via generate_adr_index.py)Next: [If Proposed] Share for review | [If Accepted] Implement```## Quick Mode| Provided | Skip ||----------|------|| Title in quotes | Title prompt || `--status X` | Status prompt |## Edge Cases| Situation | Handling ||-----------|----------|| <2 options provided | Ask for at least one more || No consequences listed | Note "To be determined" |

Frequently asked questions