Human writing

Edit human-facing prose while preserving meaning, factual accuracy, and the writer's voice. User instructions and the intended audience outrank these style preferences. Editing a draft does not authorize posting it.

Modes

• Edit (default): produce corrected text. Add a changelog only when the caller asks for one; place it outside the returned text, never inside a delivered artifact such as a commit body, PR description, or comment.
• Detect: when asked to flag AI tells without rewriting, quote each observed pattern and give a brief fix. Do not rewrite, score, or infer authorship. Use Phase 1 of audit-workflow.md, then stop and offer an edit.
• Machine-facing text: tool descriptions, system prompts, skill/agent instructions, error strings, and inter-agent messages need precise specification language. Use ia-refine-prompt when appropriate; do not apply fragments, contractions, or invented personal voice mechanically.

Procedure

1. Identify the draft's core point and 3–5 concrete voice signals to preserve: vocabulary, cadence, bluntness, humor, uncertainty, digressions, and intended polish. Keep this working note out of the delivered text.
2. Match the requested surface and mode. Short commits, PR descriptions, comments, and posts need a quick audit. Long documents, essays, and reports use the two-phase audit-workflow.md.
3. Lead with a concrete fact or point. Use active voice, specific actors where relevant, simple words, stable terminology, and meaningful numbers. Keep related words together, one topic per paragraph, and tone appropriate to the audience.
4. Flag formulaic structures, vague claims, passive evasions, unnecessary qualifiers, artificial contrasts, synonym cycling, mechanical formatting, and fake-profound endings. A flag is a candidate, not a verdict.
5. Apply restraint: leave natural sentences intact, preserve useful uncertainty, and retain lists/tables that carry real structure. Match the tone problem, not a forbidden token. Do not invent opinions, feelings, facts, or actors to satisfy a stylistic pattern.
6. Read the result aloud. Check that edits remain proportional and that the writer would recognize the voice. Return the full corrected text when editing; add audit or changelog detail only when the caller asked for it, and keep it outside the delivered artifact.