adr-writing

adr-writing is a cursor rule for Cursor from prisma/prisma-next. It costs 0 tokens per session (402 once invoked), scanned A, a copy of adr-writing, Apache-2.0.

A writing guide for Architecture Decision Records (ADRs), documents that preserve important technical decisions and their reasoning. It recommends leading with the decision and a representative example.

In plain words
What is it for?
Use it to structure ADRs, explain responsibility boundaries, describe sequencing briefly, and avoid temporary project-history references.
Why use it?
It helps readers understand the chosen design quickly while keeping explanations, responsibilities, consequences, and rejected alternatives clear and lasting.

Cursor rule for Cursor ✓ vendor

Written for Cursor: a Cursor rule (.mdc). Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to structure ADRs, explain responsibility boundaries, describe sequencing briefly, and avoid temporary project-history references.

Compare 6 cursor rules from other repositories ↓
Install with agentmods
npx agentmods add rules/prisma/prisma-next/adr-writing
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.

Clone the repo
git clone --depth 1 https://github.com/prisma/prisma-next

Made for: Cursor.

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 adr-writing

README.md
[![agentmods](https://agentmods.dev/badge/rules/prisma/prisma-next/adr-writing/github.svg)](https://agentmods.dev/rules/prisma/prisma-next/adr-writing)
Your own site
<a href="https://agentmods.dev/rules/prisma/prisma-next/adr-writing"><img src="https://agentmods.dev/badge/rules/prisma/prisma-next/adr-writing/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for adr-writing

Your own site · 80×15
<a href="https://agentmods.dev/rules/prisma/prisma-next/adr-writing"><img src="https://agentmods.dev/badge/rules/prisma/prisma-next/adr-writing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 402 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 88% 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.00000 $0.00402
Opus 5.5 $0.00000 $0.00161
Sonnet 5.5 $0.00000 $0.00080
Haiku 4.5 $0.00000 $0.00040

Measured 1mo ago against content hash 596945d7ae8d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

adr-writing 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 1mo 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

88% identical to adr-writing — 1 line 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.

.agents/rules/adr-writing.mdc · 16 lines

What it actually says

  • Lead with the decision and a grounding example. Open with a representative code/usage sample and the decision itself, then build up why → how → consequences, and put alternatives considered last. Don't front-load context/problem/rejected designs — a reader should see what the decision is before the information being made irrelevant. (Context still belongs in the doc; it just doesn't lead.)
  • ADRs are long-lived — no transient references. No PR numbers, and no "before this refactor / earlier implementation / as-shipped / what we used to do" preceding-state framing. The shape you replaced is a legitimate alternative considered, stated timelessly — not narrated as a project event. (Ticket / milestone / task IDs are already banned in ADRs by no-transient-project-ids-in-code.mdc.)
  • Keep responsibility splits explicit (e.g. adapter lowering vs codec encode/decode vs driver transport/normalization)
  • If an ADR discusses capabilities, follow .cursor/rules/capabilities-ownership.mdc for wording
  • If you need to describe sequencing (order of operations), keep it short and place it near the responsibilities/decision; avoid long procedural sections that read out-of-place
  • Use fenced code blocks for SQL (```sql) and TS (```ts); avoid nested backticks inside inline code
  • Worked examples should be end-to-end and make it obvious which layer owns each step (lane, adapter, codec, driver, runtime)
  • If the decision instantiates a structural pattern recorded in docs/architecture docs/patterns/, link forward to the pattern entry from the ADR (existing ADRs are not retroactively edited)
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. 1mo ago First seen · 16 lines · 0 tokens per session scan A 596945d7ae8d

Subscribe to this mod's changes

adr-writing is a cursor rule published in the GitHub repository prisma/prisma-next (414 stars, last pushed 1mo ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 402 tokens. A static security scan graded it A with 0 findings. It is 88% identical to adr-writing, differing in 1 line, and is treated as a copy.