# Create Adr

> A Claude skill from Karthick-Ramachandran/persist-os.

- **Type:** Skill
- **Install:** `agentstack add skill-karthick-ramachandran-persist-os-create-adr`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Karthick-Ramachandran](https://agentstack.voostack.com/s/karthick-ramachandran)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Karthick-Ramachandran](https://github.com/Karthick-Ramachandran)
- **Source:** https://github.com/Karthick-Ramachandran/persist-os/tree/main/.claude/skills/create-adr
- **Website:** https://persist-os.pages.dev

## Install

```sh
agentstack add skill-karthick-ramachandran-persist-os-create-adr
```

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

## About

# Skill: Create ADR

## Purpose

Record durable architecture decisions so future humans and agents do not rediscover or contradict
them.

## Inputs

- Decision topic.
- Context and constraints.
- Options considered.
- Recommended or selected decision.

## Required Reading

- `docs/10-architecture/ARCHITECTURE.md`
- `docs/10-architecture/FILE_WRITE_POLICY.md`
- `docs/20-security/SECURITY_MODEL.md`
- Relevant existing ADRs in `docs/adrs/`

## Output Files

- `docs/adrs/ADR-####-.md`

## Process

1. Determine whether the change needs an ADR.
2. Find the next ADR number without reusing existing numbers.
3. Write context, decision, alternatives, consequences, and related docs.
4. Mark the status as `Proposed` unless the human has accepted the decision.
5. Link to affected PRDs, architecture docs, feature docs, and security docs.

## Stop Conditions

Stop and request human decision if:

- The decision changes security posture, network behavior, telemetry, file writes, auth, secrets,
  cloud, or runtime MCP.
- The requested decision conflicts with an accepted ADR.
- The decision is not actually made yet and should remain a proposal.

## Quality Bar

- The ADR explains why the decision exists, not just what changed.
- Alternatives and consequences are honest.
- Status is clear.
- Related documents are linked.

## Source & license

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

- **Author:** [Karthick-Ramachandran](https://github.com/Karthick-Ramachandran)
- **Source:** [Karthick-Ramachandran/persist-os](https://github.com/Karthick-Ramachandran/persist-os)
- **License:** MIT
- **Homepage:** https://persist-os.pages.dev

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-karthick-ramachandran-persist-os-create-adr
- Seller: https://agentstack.voostack.com/s/karthick-ramachandran
- 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%.