---
title: "Voice and tone"
url: /voice-and-tone
description: "Voice and Tone, my open-source plugin for Claude Code that turns a voice guide into rules an agent can follow, and the rules it made for this site."
---

## §0 · plugin

# Voice and tone

Voice and Tone is a plugin for Claude Code that I wrote. You install it in your repository, and it turns a voice guide into rules that an agent can follow. This page shows the plugin first, then the rules that it made for this site.

### A brand voice guide your tooling can prove

Most voice guides say "warm, but professional". Nobody can tell who set that rule, what it rests on, or whether the copy still follows it. Voice and Tone is my open-source plugin for Claude that makes each rule traceable.

It is for teams that publish a lot of copy, often with agents writing part of it.

### What it does

- **Discovery.** It reads the copy you already have, measures it per language and turns what it cannot tell into questions.
- **Forced choice.** Instead of asking you to rate yourself, it shows two or three rewrites of your own copy and asks which one sounds like you.
- **A tone model.** Voice stays fixed; tone moves with the context and the reader's state. It stores a few numbers and computes the rest: 80 tone cells from 18 stored rows [claim plugin-cells: The plugin's public pages, read 2026-11-16; source: https://pavolhudran.github.io/ai-voice-and-tone/; confirmed]. Humor is off where a reader is upset.
- **Learning with a brake.** Your edits become evidence. A rule forms only after two independent confirmations, and you approve it.
- **An independent critic.** A separate agent reviews each draft without seeing the reasoning that produced it.

Everything lives as Markdown in your repository. No database, no account.

### Where it comes from

It is built on Mailchimp's Voice and Tone framework and is not affiliated with Mailchimp. It is not a design-system tool. It shares this site's method: evidence before authority, a confidence level on every rule, and checks in code.

[Read about the plugin](https://pavolhudran.github.io/ai-voice-and-tone/) [Source code](https://github.com/pavolhudran/ai-voice-and-tone)

## §1 · patterns

### How it follows the patterns

| Pattern | In the plugin |
|---|---|
| Honest gaps | Every rule records its evidence and a confidence level: `confirmed`, `derived`, `assumed` or `disputed` |
| Report, do not block | A `disputed` rule is never enforced until a person decides |
| Deterministic first | Tone is computed. 80 tone cells from 18 stored rows (10 contexts × 8 reader states) [claim plugin-cells: The plugin's public pages, read 2026-11-16; source: https://pavolhudran.github.io/ai-voice-and-tone/; confirmed] Gates are functions in code, not instructions in a document |
| Deterministic first | Humor forced to zero for 3 reader states [claim plugin-humor-zero: The plugin's public pages; implemented as functions in code; source: https://pavolhudran.github.io/ai-voice-and-tone/; confirmed] |
| Evidence, not authority | One critic agent in a fresh context judges the copy. It sees the draft, not the reasoning that produced it |
| Honest gaps | Metrics with no method for Czech show `n/a` |

> "The failure mode of a computed cell must be 'a bit flat', never 'joked at someone whose payment just failed'."

11 commands, 6 skills, 1 critic agent, zero npm dependencies [claim plugin-parts: The plugin's public pages, read 2026-11-16; source: https://ai-voice-and-tone-9125a0.gitlab.io/; confirmed]

## §2 · this site

### The rules of this site

I made the voice of this site with the plugin. These are its rules, with their confidence levels.

