/rules

name: blueprint-style-rules
description: "Measure the models with chaff, then write the style twice: chaff.yaml for what a machine checks, STYLE.md for what the writer reads — with a reason for every decision."

Write the style

The style ends up in two places, and they do different jobs:

• **`chaff.yaml`** — what a machine checks on every document: the genre, the language, how strict each

rule is, the team's own words. chaff is a linter; it never judges meaning and never rewrites.

• **`STYLE.md`** — what the writer (you, in a later build, or a person) reads and follows: voice, sentence

endings, terms, structure. Everything a machine cannot measure goes here.

Read `.blueprint/answers.json` for the kind of document, the language, the audience and how strict to be. Run chaff from the folder as `sh <base pack>/checks/chaff.sh …` — the wrapper the checks use, so what you measure is what they will measure. Below it is written `chaff …` for short.

1. Measure

• **Genre**: `chaff genres` lists them, each with what it is for. Pick the one for the answer `kind` —

contracts (`legal/contract`), rules and regulations (`legal/statute`), manuals (`docs/manual`), FAQs, glossaries, papers and literature have genres of their own. Only when none fits, pick the closest and say so in the report. A genre chaff does not know stops every run, so copy it from the list.

• **Language**: from the answer, or what chaff detects on the sources.
• **Thresholds**: `chaff eval .blueprint/sources` sweeps each rule's limits over the models and

recommends one. Read it rule by rule.

• **What fires now**: `chaff .blueprint/sources --genre <genre>` with no config yet.

2. Decide, one rule at a time

For each rule that fires on the models, or that `eval` recommends changing:

• **The models do it on purpose** (a long sentence is how this author writes): relax it, or turn it off.
• **The models slip** and the person chose "少し厳しく": keep it, and write in STYLE.md why the models are

not the example there. The models must still pass, so this means a level they meet.

• **Never set a rule the models do not tell you about.** A style is measured, not imagined.

Write `chaff.yaml` with `genre`, `language` and `rules:` (`strict | normal | relaxed | off`). Add `jargon:` for the team's own words only if the models show them.

• **When even `relaxed` is too tight for the models**, give the rule its limit as a number instead of

turning it off: `max-sentence-length: 260` keeps checking at 260 where `off` would check nothing. The unit is the rule's own; `chaff rules --json` shows each rule's levels as numbers to start from.

• **Spellings the models settle on** (サーバ, not サーバー; email, not e-mail) go under `prefer:` as

`avoid: use` pairs, and `preferred-term: normal` turns the rule on. Only pairs the models actually show.

• **Spacing between Japanese and Latin letters or digits**: when the models are consistent, turn on

`latin-spacing: normal` (Japanese). It does not take a side: in a document that mixes both ways, it reports the less common one.

• **Consistency the models keep** in English: contractions (`contraction-consistency`), the Oxford comma

(`oxford-comma-consistency`) and heading case (`title-case-consistency`). Like `latin-spacing`, each takes no side: where one form clearly leads, it reports the other. Turn one on when the models keep that form.

• These, and `preferred-term`, are experimental rules (`chaff rules --json` marks them `experimental`): off

by default, and **on when named in `rules:` with a level** (or for every experimental rule, with `experimental: true` or `--experimental`). "Experimental, so it does not run" is true only while it is not named — name it, and prove it in the counter step.

• chaff reports a rule name it does not know and a value it cannot read on stderr, for `rules --json` and

lint alike. Read that output: an unknown name or an unreadable value is a setting that does nothing. A number on a rule that reads meaning (L4) is warned about too; that rule runs as `normal`. Record every level you set in `.blueprint/rule-decisions.json`:

{ "sentence-length": { "level": "relaxed", "why": "The models average long sentences on purpose: legal definitions run long." } }

chaff ignores a rule name it does not know. The check compares your decisions with what chaff actually applied, so a misspelt rule shows up there rather than doing nothing.

3. The guide

`STYLE.md`, in the documents' language, with these sections (either name works):

• `## 誰に・何のために` / `## Audience and purpose` — from the answer `audience`.
• `## 語調と文末` / `## Voice and tone` — です・ます or だ・である, person, how direct. Quote a line from

the models for each point.

• `## 用語と表記` / `## Terms and spelling` — preferred words and spellings, numerals, how English words

are written. Only what the models show.

• `## 構成` / `## Structure` — how a document opens, heading depth, lists vs. prose.
• `## 機械が確かめること` / `## What chaff checks` — the rules you set and what each catches, so a reader

knows which parts a machine enforces and which are theirs to keep.

Done when

`node <usecase pack>/checks/rules.mjs` (with `BLUEPRINT_BASE` and `BLUEPRINT_USECASE` set to the pack folders from your prompt) passes: the config loads, every setting has a reason and is in effect, the models raise no finding under their own style, and the guide has its sections. If a model still trips a rule, do not delete the model: relax the rule, or say in the guide why that model is not the example there and relax the rule to what it meets.