Create Adr
A Claude skill from Karthick-Ramachandran/persist-os.
Install
$ agentstack add skill-karthick-ramachandran-persist-os-create-adr ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Links to your public security report.[](https://agentstack.voostack.com/security/report/skill-karthick-ramachandran-persist-os-create-adr) Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →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.mddocs/10-architecture/FILE_WRITE_POLICY.mddocs/20-security/SECURITY_MODEL.md- Relevant existing ADRs in
docs/adrs/
Output Files
docs/adrs/ADR-####-.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
Proposedunless 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.
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
- Source: Karthick-Ramachandran/persist-os
- License: MIT
- Homepage: https://persist-os.pages.dev
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.