Create adr

Skill Karthick-Ramachandran/persist-os/.agents/skills/create-adr

Local-first CLI that gives your repo durable, AI-ready memory - features, ADRs, modules, architecture, standards & tests and a deterministic doctor that validates health, evidence & drift.

Install

npx -y skills add Karthick-Ramachandran/persist-os --skill create-adr

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.5 KB, as published. Nobody here has run it

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-####-<slug>.md

Process

Determine whether the change needs an ADR.
Find the next ADR number without reusing existing numbers.
Write context, decision, alternatives, consequences, and related docs.
Mark the status as Proposed unless the human has accepted the decision.
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.