Prompts · a working file

From voice note to published page

22 August 2026 · for Claude Code

Every page on this site ends with the same line: spoken by Sree, shaped into pages with ❤️. This is the prompt behind that line — the working instructions for turning a rambling voice note into a finished page that still sounds like the person who spoke it.

The hard part is not the shaping. It is the restraint: an agent that writes well will, unsupervised, replace your voice with its own — smooth away the hedges, upgrade the plain phrases, add a rhetorical flourish you would never say. This prompt is mostly a list of things not to do to a transcript, learned by watching what happens without them.

The step that earns the most is the fact-check. Spoken memory is confidently wrong: dictating the piece that became Languages have passports, I called Python "very German." Its creator is Dutch — and the Zen of Python itself jokes about it. The correction did not weaken the piece; woven in honestly, it became the best paragraph in it. That move — correct me, and when the correction is interesting, let it show — is written into the prompt as a rule.

  • Read the site's conventions and two existing pieces before writing a word — match the voice on the page, not a default house style.
  • Find the spine (usually said mid-ramble, not at the start), keep my phrases and my hedges, cut only transcript noise.
  • Fact-check every checkable claim; correct errors in the piece and list every correction separately.
  • Build and register the page the way the site actually does it — sitemap, indexes, feeds, generated surfaces, share card.
  • Present the rendered page, the corrections table, and the two or three lines it is least sure sound like me. Then stop — publishing is mine.

Copy it, paste it into Claude Code inside your site's repository, and put your transcript at the bottom where marked. It assumes your site has conventions worth following — if it doesn't yet, that is the first thing to fix.

voice-note-to-page.md
Below this prompt is a raw voice-note transcript — spoken, unedited, with all
the "uh"s, repetitions and half-finished sentences of real dictation. Shape it
into a publishable page on this site. You are shaping my words, not writing
your own: the finished piece must sound like me on a good day, not like you.

## Step 0 — learn the house before adding a room

Before writing a word, read how this site already does things:

- The conventions file if one exists (`CLAUDE.md` or similar): design tokens,
  page chrome, registration steps, build scripts.
- Two or three existing pieces of the kind this might become. Note the voice:
  sentence rhythm, how personal it gets, how pieces open and close, what the
  metadata and structure look like.

Then decide **what this piece is** — a short dated note, a longer essay, a
standalone page — and say why. The transcript's length is not the answer; its
weight is. A two-minute note carrying one clear thought is a short piece, no
matter how much I rambled around it.

## Step 1 — find the spine, keep the voice

Extract the one thing the piece is about — usually said most clearly somewhere
in the middle of the dictation, not the start. Build the arc around it using
my sequence of thought where it works, reordering only where spoken order
fights written clarity.

What to keep and what to cut:

- **Keep my phrases.** If I said "it never judged me", that is the line — do
  not upgrade it to something more literary. Distinctive phrasing is voice;
  filler is not. Learn the difference.
- **Keep my hedges.** "I could be wrong" stays. Spoken humility is part of the
  argument, not a weakness to edit out.
- **Cut transcript noise**: false starts, repeated words, dictation artifacts,
  the "right?"s — unless one is doing real work.
- **Add nothing of your own.** No invented anecdotes, no examples I didn't
  give, no conclusions I didn't reach. If the piece needs a fact to work, find
  a real one and attribute the finding (see step 2) — never decorate.

## Step 2 — fact-check me, and let good corrections show

Check every checkable claim in the transcript: names, nationalities, dates,
origins, quotes, numbers, attributions. Spoken memory is wrong more often
than written drafts are.

When a claim is wrong:

- **Correct it in the piece.** Never publish the error because it was mine.
- **If the correction is interesting, weave it in** rather than hiding it.
  "I would have sworn it was X — it turns out Y" is often better material
  than either the error or the bare fact. The piece can own its corrections;
  that honesty reads as strength.
- **List every correction for me** separately: claim → what I said → what is
  true → what the piece now says.

Anything you could not verify: flag it, soften the claim, or cut it. Never
let an unverified assertion stand because it sounds confident.

## Step 3 — build the page the way this site builds pages

Copy the structure of an existing piece of the same kind — chrome, styles,
meta, all of it. Then complete every registration the conventions require:
the sitemap, the section index, the feed, any generated surfaces, the share
card made with the site's own tooling. A page that exists but is registered
nowhere is a draft, not a publication.

Run whatever validation the repo provides and fix what it reports.

## Step 4 — show me the piece and the seams

Present, in this order:

1. A rendered screenshot of the page — I read the piece as a reader first.
2. The corrections table from step 2.
3. The two or three lines you are least sure sound like me, called out — I
   will retune those, not re-read everything with suspicion.
4. What was registered where, and any build steps still to run.

Then stop. Publication is my call, after I have read it.

## Rules

- The transcript is source material with an owner. Shaping is allowed;
  ghost-writing is not. When in doubt whether a sentence is mine or yours,
  it is yours — cut it.
- Do not import a "house style" the site does not have. Match the voice that
  is actually on the page, not the one writing assistants default to.
- Dates, weekdays, and any calendrical details are computed, never assumed —
  a wrong weekday in a dated piece is the kind of small error that quietly
  discredits the true things around it.
- If the transcript contains names of private people or details that read as
  shared-in-confidence, ask before including them.

## Traps that cost time

- Titles hide late: the phrase that names the piece is usually in the last
  third of the dictation, said in passing.
- Dictation punctuation lies — commas and sentence breaks in transcripts are
  artifacts of pause length, not grammar. Re-punctuate from meaning.
- The most quotable-sounding line in a transcript is the one most worth
  fact-checking; confidence and accuracy are uncorrelated in speech.
- Registering the page but forgetting the generated surfaces (feeds, recent
  lists, library pages) leaves the site disagreeing with itself about what
  exists. Re-run every generator the conventions name.

## Report back

1. Where the page lives and what kind of piece you judged it to be, and why
2. The corrections table
3. The least-confident lines
4. Registrations completed and validations run

---

TRANSCRIPT:

[paste the voice note transcript here]
Same text, plain file: voice-note-to-page.md — for curl, or for pasting without the page around it.

Dictate badly, on purpose. The prompt is built for real speech — repetitions, wrong turns, the idea arriving halfway through. A cleaned-up transcript gives the shaping step nothing to work with and the fact-check step false confidence. And read the least-confident lines it flags before anything else; that is where your voice either survived or didn't.

If a piece comes out sounding more like the machine than like you, tell me what it flattened — the list of things not to do is meant to keep growing.

spoken by Sree, shaped into pages with ❤️