sp.adr

sp.adr is a command for Claude Code from DilawarShafiq/unworldly. It costs 14 tokens per session (1,770 once invoked), scanned A, a copy of sp.adr, MIT.

A command that reviews planning documents for important architectural choices and records them as Architecture Decision Records, or ADRs. An ADR is a lasting note explaining a significant technical decision, its alternatives, and its tradeoffs.

In plain words
What is it for?
Use it after planning to identify decisions about software structure, technical approaches, alternatives, risks, and tradeoffs that deserve a permanent record.
Why use it?
It preserves the reasoning behind decisions so the team can understand or revisit them later.

Command for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/dilawarshafiq/unworldly/sp.adr
Clone the repo
git clone --depth 1 https://github.com/DilawarShafiq/unworldly

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for sp.adr

README.md
[![agentmods](https://agentmods.dev/badge/commands/dilawarshafiq/unworldly/sp.adr.svg)](https://agentmods.dev/commands/dilawarshafiq/unworldly/sp.adr)
Your own site
<a href="https://agentmods.dev/commands/dilawarshafiq/unworldly/sp.adr"><img src="https://agentmods.dev/badge/commands/dilawarshafiq/unworldly/sp.adr.svg" alt="Measured on agentmods" height="20"></a>
Per session 14 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,770 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00014 $0.01770
Opus 5 $0.00007 $0.00885
Sonnet 5 $0.00003 $0.00354
Haiku 4.5 $0.00001 $0.00177

Measured 5d ago against content hash 81fcbb36eeef, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

sp.adr scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to sp.adr — 414 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/commands/sp.adr.md · 208 lines

How it starts

The opening of the file, as written. The whole thing — 208 lines — stays where its author put it; the contents beside it link to each section on GitHub.

COMMAND: Analyze planning artifacts and document architecturally significant decisions as ADRs

CONTEXT

The user has completed feature planning and needs to:

  • Identify architecturally significant technical decisions from plan.md
  • Document these decisions as Architecture Decision Records (ADRs)
  • Ensure team alignment on technical approach before implementation
  • Create a permanent, reviewable record of why decisions were made

Architecture Decision Records capture decisions that:

  • Impact how engineers write or structure software
  • Have notable tradeoffs or alternatives
  • Will likely be questioned or revisited later

User's additional input:

$ARGUMENTS

YOUR ROLE

Act as a senior software architect with expertise in:

  • Technical decision analysis and evaluation
  • System design patterns and tradeoffs
  • Enterprise architecture documentation
  • Risk assessment and consequence analysis

OUTPUT STRUCTURE (with quick flywheel hooks)

Execute this workflow in 6 sequential steps. At Steps 2 and 4, apply lightweight Analyze→Measure checks:

  • Analyze: Identify likely failure modes, specifically:
    • Over-granular ADRs: ADRs that document decisions which are trivial, low-impact, or do not affect architectural direction (e.g., naming conventions, minor refactorings).
    • Missing alternatives: ADRs that do not list at least one alternative approach considered.
  • Measure: Apply the following checklist grader (PASS only if all are met):
    • The ADR documents a decision that clusters related changes or impacts multiple components (not a trivial/single-file change).
    • The ADR explicitly lists at least one alternative approach, with rationale.
    • The ADR includes clear pros and cons for the chosen approach and alternatives.
    • The ADR is concise but sufficiently detailed for future reference.

Step 1: Load Planning Context

Run .specify/scripts/powershell/check-prerequisites.ps1 -Json from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS.

Read the full file on GitHub · 208 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 208 lines · 14 tokens per session scan A 81fcbb36eeef

Subscribe to this mod's changes

sp.adr is a command published in the GitHub repository DilawarShafiq/unworldly (9 stars, last pushed 1mo ago), licensed MIT. It adds 14 tokens to every session and 1,770 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to sp.adr, differing in 414 lines, and is treated as a copy.