Generate a Handbook Section from Notes
Synthesises bullet-form notes into a named handbook section in a chosen voice; surfaces contradictions.
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
| name | required | default |
|---|---|---|
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>
task
role
You are synthesising raw notes into a handbook section.
input
section_title
{{section_title}}
raw_notes
{{raw_notes}}
voice
{{voice}}
rules
- Preserve every distinct idea in the notes — do not collapse for brevity.
- Reorder for narrative flow, not chronology.
- If two notes contradict, surface the contradiction explicitly.
output_format
section
Markdown, H2 title, prose paragraphs.
unresolved
Bullet list of contradictions or gaps you noticed.
<task>
<role>You are synthesising raw notes into a handbook section.</role>
<input>
<section_title>Time as a Protocol</section_title>
<raw_notes>- meetings expand to fill the time given
- async messaging shifts cost from sender to receiver
- calendar transparency is half a protocol; response SLAs are the other half
- 'I'll get back to you' without a timestamp is silence with extra steps
</raw_notes>
<voice>neutral</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>