A Claude Code subagent that reads your text as the person it is for

Today's file is a Claude Code subagent for texts that people will see: a letter, a post, a page, an offer to a client. You wrote the text and know what you meant, so you read what you meant. The client reads what is on the page, and learns that the invoice "is attached" when nothing is. The picky reader checks the finished text as the person it is addressed to, before it goes out.

How it works

First it picks a role: the one whose "no" costs the most for this text, for a letter with an invoice the client who has to pay, and names it in the first line of the report. Then it reads as that person and splits what it finds into two lists. Blocking: the text does not do what it was written for, says something untrue, harms the recipient or undermines the request. Optional: everything else. The verdict comes after the reasoning and is one of two: no remarks, or the two lists.

An empty blocking list is a valid answer, and its prompt forbids adding items to make the report heavier. It changes nothing in the text. Its only tools are Read, Grep and Glob, so read only is a lock here, not a rule in the prompt.

What to change

Write who your clients are and what matters most to them in one line at the end of the file. The line goes into the body, not into description: the description tells the main session when to call the reader, while the reader itself gets the body of its file and the prompt the session writes for it. In our test with the clients in the description, the reader never learned about them. With the same line at the end of the file, its report opened with the role of our test client, the owner of a small bakery in Hamburg.

Install

One file goes into ~/.claude/agents/. The note below then asks Claude for the line about your clients and for a rule in ~/.claude/CLAUDE.md: before any of your texts goes to people, call the reader and show you its report. Then restart Claude Code. The check is a letter that says the invoice is attached when it is not: the report names the role first and puts the missing invoice in the blocking list.