Skip to content

Commit 62ecf8c

Browse files
jcasimirclaude
andauthored
feat(ce-write): serve voice guide, exemplars, and lint from the rotunda voice service (#13)
The canonical guide now comes from the rotunda MCP voice_guide tool (local files demoted to cache/fallback), the draft stage injects per-register voice_exemplars pairs and gates on voice_lint, and prose-review adds a stylometric pre-pass whose fail blocks ship even when the panel is clean. The draft stage also stops restating guide rules that the compounding guide has since overturned — the fetched guide is the sole source of voice rules. Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent 44d2ecf commit 62ecf8c

3 files changed

Lines changed: 63 additions & 44 deletions

File tree

‎plugins/compound-engineering/skills/ce-prose-review/SKILL.md‎

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,17 +37,22 @@ If no `category: writing` reviewers are found, report: "No writing reviewers fou
3737

3838
## Step 3: Locate the voice guide
3939

40-
Same resolution the reviewers use, so the skill can confirm it exists and pass its path:
40+
The canonical guide is served live; local files are cache and fallback:
4141

42-
1. `docs/writing/voice-guide.md` (project override), else
43-
2. `$HOME/.config/compound-engineering/voice-guide.md` (the live guide).
42+
1. **Voice service (preferred).** If a `rotunda` MCP connection is available, call its `voice_guide` tool, write the body to `$HOME/.config/compound-engineering/voice-guide.md` (refreshing the cache), and use that path.
43+
2. `docs/writing/voice-guide.md` (project override), else
44+
3. `$HOME/.config/compound-engineering/voice-guide.md` (cache — possibly stale).
4445

45-
If neither exists, warn that the panel will fall back to first principles and be much weaker, then proceed (or stop in headless mode).
46+
If none resolves, warn that the panel will fall back to first principles and be much weaker, then proceed (or stop in headless mode).
4647

4748
## Step 4: Read the inputs
4849

4950
Read the target draft in full and the brief if provided. These are passed to every reviewer as content (the draft is the whole point of the review; pass it inline, not as a path the subagent must re-open).
5051

52+
## Step 4.5: Stylometric pre-pass
53+
54+
Before dispatching the panel, get the mechanical verdict. If a `rotunda` MCP connection is available, call `voice_lint` with the draft and its register band (inferred from the brief per the guide's register section). Keep the result for synthesis: the lint measures architecture (sentence mix, paragraph pacing, question and punctuation rates) that human-style review reliably misses — a panel can pass prose that the numbers expose as machine-shaped. Without the connection, skip and note it in the output.
55+
5156
## Step 5: Dispatch the panel
5257

5358
Read `references/prose-reviewer-template.md` for the subagent prompt template.
@@ -89,6 +94,9 @@ Collect the seven JSON responses. Then:
8994
### Reads-aloud check
9095
<Provost's rhythm verdict — clean, uneven, or monotone, with the worst passage.>
9196

97+
### Stylometric gate
98+
<voice_lint verdict (pass/borderline/fail) with the flagged metrics and their draft-vs-author values; "not run — no rotunda connection" when skipped. A fail here blocks ship even when the panel is clean.>
99+
92100
### Candidate voice-guide rules
93101
<Merged voice_guide_updates_needed — hand to the compound phase.>
94102
```

‎plugins/compound-engineering/skills/ce-write/SKILL.md‎

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -24,22 +24,15 @@ Extract from the input:
2424

2525
## Step 2: Locate the voice guide
2626

27-
The voice guide is the single source of truth for how Jeff writes. Find it in priority order:
28-
29-
```bash
30-
# 1. Project override, if this project has a house voice
31-
VOICE_GUIDE=""
32-
if [ -f "docs/writing/voice-guide.md" ]; then
33-
VOICE_GUIDE="docs/writing/voice-guide.md"
34-
# 2. The live, compounding guide
35-
elif [ -f "$HOME/.config/compound-engineering/voice-guide.md" ]; then
36-
VOICE_GUIDE="$HOME/.config/compound-engineering/voice-guide.md"
37-
fi
38-
```
39-
40-
If no guide is found, report: "No voice-guide.md found. Seed it from ce-reviewers-jsl's voice/voice-guide.md into ~/.config/compound-engineering/, or run the Perkins bootstrap. Proceeding will produce generic prose, not Jeff's voice." Then either stop (pipeline mode) or ask whether to proceed.
41-
42-
Read the voice guide in full before generating anything. It is loaded fresh every run so the latest compounded rules apply.
27+
The voice guide is the single source of truth for how the author writes. The canonical copy is served live; local files are cache and fallback. Resolve in priority order:
28+
29+
1. **The voice service (preferred).** If a `rotunda` MCP connection is available, call its `voice_guide` tool. Write the returned body to `$HOME/.config/compound-engineering/voice-guide.md` (refreshing the local cache) and use that path as `VOICE_GUIDE`. This guarantees the latest compounded rules on every machine.
30+
2. **Project override:** `docs/writing/voice-guide.md`, when this project has a house voice.
31+
3. **Local cache:** `$HOME/.config/compound-engineering/voice-guide.md` — possibly stale; note that in the run output.
32+
33+
If none resolves, report: "No voice guide available (no rotunda MCP connection, no local voice-guide.md). Proceeding will produce generic prose, not the author's voice." Then either stop (pipeline mode) or ask whether to proceed.
34+
35+
Read the voice guide in full before generating anything.
4336

4437
## Step 3: Determine the working directory
4538

‎plugins/compound-engineering/skills/ce-write/references/draft.md‎

Lines changed: 42 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,64 @@
11
# Stage: draft
22

3-
Write the piece. This is where the voice guide does its heaviest work — the draft should sound, read, and look like Jeff wrote it, not like a competent stranger did.
3+
Write the piece. This is where the voice guide does its heaviest work — the draft should sound, read, and look like the author wrote it, not like a competent stranger did.
44

55
## Read first
66

77
- The brief at `brief:<path>` — audience, purpose, one job, thesis, medium.
88
- The outline at `outline:<path>` — the section order and per-section ideas.
9-
- The **entire** voice guide. Every section applies now.
9+
- The **entire** voice guide. Every section applies now. The guide is the sole
10+
source of voice rules — do not rely on remembered rules from previous
11+
versions of this skill or from other drafts; the guide compounds and old
12+
rules get overturned.
1013

11-
## Draft against the guide, deliberately
14+
## Pull the exemplars
15+
16+
Identify the piece's register band from the brief using the guide's register
17+
section (expressive / analytical / formal / technical). If a `rotunda` MCP
18+
connection is available, call `voice_exemplars` with that register and keep the
19+
returned pairs in view while drafting: each pair shows the same content as a
20+
competent generic model wrote it and as the author actually wrote it. **Write
21+
like the author side of the pairs.** The pairs quote private documents — never
22+
copy them into the draft or into public files; they are reference only.
1223

13-
Do not write generically and hope it sounds like Jeff. Write *toward* the guide:
24+
Without the MCP connection, proceed on the guide alone and note the gap in the
25+
run output.
1426

15-
- **Lead with the governing idea** (§2.1, §6). The first lines state the thesis. No runway, no throat-clearing.
16-
- **Reach for Jeff's verbs** (§5): narrow, collapse, absorb, land, resolve, gate, ship, cut. Plain Anglo-Saxon over Latinate abstraction.
17-
- **Use the signature moves where they fit** (§3) — but earn them, don't sprinkle them:
18-
- the triad (group into threes),
19-
- the aphoristic clincher to close a section,
20-
- the em-dash sharpener with a concrete example,
21-
- the framing-question header with a stakes parenthetical,
22-
- the stakes sentence ("if no one owns it, X silently fails"),
23-
- the "X, not Y" reframe,
24-
- honesty markers (⚠, "ruled out:") instead of hedging.
25-
- **Vary sentence length hard** (§4). Long, clause-stacked sentence, then a short hammer. Deliberate fragments are allowed. Read each paragraph aloud in your head; if it drones or you run out of breath, re-cut before moving on.
26-
- **Match the medium profile** (§8): essay = voice-forward, a clincher per section; doc = Summary → Evidence → Why-it-matters skeleton, concrete numbers, minimal adjectives; email = open with the ask or answer, one screen, end with the single next action.
27-
- **Format for the skim** (§7): framing-question or noun-phrase headers, bold inline labels for category list items, short paragraphs, tables where data is parallel, ⚠ for uncertain claims, functional emoji only.
28-
- **Use the right term of art once** (§9), matched to the audience in the brief. Define on first use only if that reader might not know it.
27+
## Draft against the guide, deliberately
2928

30-
## Kill on sight while drafting (§5, §10)
29+
Do not write generically and hope it lands. Write *toward* the guide: identify
30+
the register band first and apply that band's rules, reach for the signature
31+
moves where they fit (and only where they fit — the guide's anti-pattern list
32+
names the manufactured versions), and honor the guide's rhythm and formatting
33+
sections. Read each paragraph aloud in your head; if it drones, re-cut before
34+
moving on.
3135

32-
Do not draft these in the first place: `delve`, `tapestry`, `realm`, `landscape`, `leverage` (verb), `utilize`, `robust` (as filler), `seamless`; the inflation construction **"not just X — it's Y"** (distinct from the *allowed* sharp "X, not Y"); throat-clearing openers; hedges (`honestly`, `arguably`, `somewhat`); empty intensifiers (`very`, `really`). The panel will catch these, but a clean first draft saves a review round.
36+
The architecture matters more than the words. The measured failure mode of
37+
model drafts is structural: sentences welded long, one-beat paragraphs merged
38+
away, questions answered instead of left standing, transitions announced
39+
("I bring this up because…") instead of made. Check the shape of what you
40+
just wrote, not only its vocabulary.
3341

3442
## Procedure
3543

36-
1. Read brief, outline, and the full voice guide.
44+
1. Read brief, outline, the full voice guide, and the register's exemplars.
3745
2. Write the complete draft — every section from the outline, no placeholders.
38-
3. Do one self-pass against §5 and §10 before handing off: cut the slop you can already see.
39-
4. Write `draft.md`. This file is revised in place during the review loop, so write it as the working copy.
46+
3. Self-pass against the guide's diction kill-list and anti-pattern section:
47+
cut the slop you can already see.
48+
4. **Lint the architecture.** If the `rotunda` MCP connection is available,
49+
call `voice_lint` with the draft and the register. `pass` or `borderline`
50+
hands off; on `fail`, restructure toward the flagged metrics (sentence mix,
51+
paragraph pacing, questions, punctuation habits — not word swaps) and lint
52+
once more. Include the final verdict in the run output. Without the
53+
connection, skip and note it.
54+
5. Write `draft.md`. This file is revised in place during the review loop, so
55+
write it as the working copy.
4056

4157
## Output: draft.md
4258

43-
The finished prose, in the target medium's format. No meta-commentary, no "here is the draft" preamble — the file is the piece. Lead with the governing idea on the first line.
59+
The finished prose, in the target medium's format. No meta-commentary, no
60+
"here is the draft" preamble — the file is the piece. Lead with the governing
61+
idea on the first line.
4462

4563
## Voice-guide sections this stage leans on
4664

0 commit comments

Comments
 (0)