adr-writer

adr-writer is an agent for coding agents from FlorianBruniaux/claude-code-ultimate-guide. It costs 64 tokens per session (1,823 once invoked), scanned A, original, CC-BY-SA-4.0.

A read-only assistant that finds important architecture choices in code changes and writes Architecture Decision Records, or ADRs. An ADR is a short record of the context, decision, and consequences of a technical choice.

In plain words
What is it for?
Use it after major code changes or when an architectural decision needs to be documented and classified by importance.
Why use it?
It preserves the reasoning behind significant changes without modifying the code. This gives future developers a record of why the architecture looks the way it does.

Agent

About the project

Claude Code Ultimate Guide is a structured documentation project for learning how to build, operate, and govern coding agents with Claude Code. It serves developers and teams through guidance on agentic workflows, hooks, skills, MCP servers, security, and adoption. The catalogue entries are reusable skills, commands, agents, hooks, instructions, settings, and a plugin drawn from the guide's workflow materials.

FlorianBruniaux/claude-code-ultimate-guide · 5,899 stars · on GitHub

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 agents/florianbruniaux/claude-code-ultimate-guide/adr-writer
Clone the repo
git clone --depth 1 https://github.com/FlorianBruniaux/claude-code-ultimate-guide

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-writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/florianbruniaux/claude-code-ultimate-guide/adr-writer.svg)](https://agentmods.dev/agents/florianbruniaux/claude-code-ultimate-guide/adr-writer)
Your own site
<a href="https://agentmods.dev/agents/florianbruniaux/claude-code-ultimate-guide/adr-writer"><img src="https://agentmods.dev/badge/agents/florianbruniaux/claude-code-ultimate-guide/adr-writer.svg" alt="Measured on agentmods" height="20"></a>
Per session 64 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,823 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin unknown No closer match found 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 $0.00064 $0.01823
Opus 5 $0.00032 $0.00911
Sonnet 5 $0.00013 $0.00365
Haiku 4.5 $0.00006 $0.00182

Measured 5d ago against content hash 8a7c5293a3c3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

adr-writer 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.

examples/agents/adr-writer.md · 209 lines

The source is not reproduced here

Licensed CC-BY-SA-4.0

The repository is licensed CC-BY-SA-4.0, which this catalogue does not treat as permission to reproduce the file. Read it at the source.

Read it on GitHub

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 · 209 lines · 64 tokens per session scan A 8a7c5293a3c3

Subscribe to this mod's changes

adr-writer is an agent published in the GitHub repository FlorianBruniaux/claude-code-ultimate-guide (5,899 stars, last pushed today), licensed CC-BY-SA-4.0. It adds 64 tokens to every session and 1,823 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

code-reviewer

Performs deep code review checking architecture compliance, code quality, and security issues. Use PROACTIVELY after writing or modifying code. MUST BE USED for all significant code changes. user: "审查这次提交的代码变更" assistant: (invokes code-reviewer agent to perform comprehensive code review).

xiaobei930/cc-best · 74 tokens

backend-phase-4

You are the Repository Layer Agent. You build the data access layer using test-driven development. You write tests FIRST, then implement the repository to make them pass. You use Testcontainers for real PostgreSQL integration tests.

TouheedCode/claude-dev-workflow · 0 tokens

backend-phase-5

You are the Service Layer Agent. You build the business logic layer using test-driven development. You write tests FIRST with mocked repositories, then implement services to make them pass. Services orchestrate domain logic and transform data between domain and API types.

TouheedCode/claude-dev-workflow · 0 tokens

frontend-phase-3

You are the Smart Components Agent. You wire the presentational UI (Phase 1) to data-fetching hooks (Phase 2) and client-side state (Zustand stores). You build the page-level components that compose everything together.

TouheedCode/claude-dev-workflow · 0 tokens

planner

Analyzes task complexity, creates implementation plans, and breaks down into minimal executable units. Use PROACTIVELY when users request feature implementation, architectural changes, or complex refactoring. Automatically activated for planning tasks. user: "实现用户权限管理模块" assistant: (invokes planner agent to analyze…

xiaobei930/cc-best · 74 tokens

requirement-validator

Performs 'unit tests for requirements': validates completeness, clarity, and consistency of requirement documents. Use after /cc-best:pm completes REQ document or when validating requirement quality before design phase. user: "验证需求文档的完整性和一致性" assistant: (invokes requirement-validator agent to check requirement…

xiaobei930/cc-best · 76 tokens