Skip to main content

Voice

How the work reads. Writing standard, finding-sentence library, and where voice references live.

Applies to:

  • Writing standard — how assessment work is phrased (tone, register, two-part findings, deck voice).
  • Finding sentence library — the approved sentence shapes for findings.
  • Voice references — where the canonical voice files live (e.g. the PIP) and how to pull the current one.

Conventions:

  • The writing standard is generated, not hand-edited — corrections go to the source (PIP), then regenerate.
  • A file that is a generated copy carries a "do not edit" note and a regeneration command.
  • One voice document per file, slugged: writing-standard.md, finding-sentences.md.