eva/prompts
tested v0.5.0 claude-opus-4-7 pattern · writing

Generate a Handbook Section from Notes

Synthesises bullet-form notes into a named handbook section in a chosen voice; surfaces contradictions.

  • writing
  • handbook
  • synthesis
  • pattern:iterative

notes

Works well when notes are bullet-form. Struggles with stream-of-consciousness input
— pre-cluster the notes first. Output tone matches Devarno voice when {{voice}}
is set; defaults to neutral.

description

Synthesises bullet-form notes into a named handbook section in a chosen voice
(defaults to neutral; "devarno" available). Use when the user supplies raw
bullet notes plus a section title and asks to "draft a handbook section",
"write up these notes", or "turn these bullets into prose". Preserves every
distinct idea, reorders for narrative flow, and surfaces contradictions
explicitly. Do NOT use for stream-of-consciousness input (pre-cluster first),
fresh long-form writing without source notes, or terse summaries.

examples

case · short-notes
{
  "section_title": "Time as a Protocol",
  "voice": "neutral",
  "raw_notes": "- meetings expand to fill the time given\n- async messaging shifts cost from sender to receiver\n- calendar transparency is half a protocol; response SLAs are the other half\n- 'I'll get back to you' without a timestamp is silence with extra steps\n"
}

inputs

namerequireddefault
raw_notes yes
section_title yes
voice no neutral

routing

triggers

  • draft a handbook section
  • write up these notes
  • turn these bullets into prose
  • synthesise these notes

not for

  • stream-of-consciousness or unstructured input
  • greenfield long-form writing without source notes
  • terse summaries / TL;DRs

prompt

<task>
  <role>You are synthesising raw notes into a handbook section.</role>

  <input>
    <section_title>{{section_title}}</section_title>
    <raw_notes>{{raw_notes}}</raw_notes>
    <voice>{{voice}}</voice>
  </input>

  <rules>
    <rule>Preserve every distinct idea in the notes — do not collapse for brevity.</rule>
    <rule>Reorder for narrative flow, not chronology.</rule>
    <rule>If two notes contradict, surface the contradiction explicitly.</rule>
  </rules>

  <output_format>
    <section>Markdown, H2 title, prose paragraphs.</section>
    <unresolved>Bullet list of contradictions or gaps you noticed.</unresolved>
  </output_format>
</task>