Writing fragments
Contract
| Field |
Bound contract |
| Trigger |
Exploration needs heterogeneous noticings captured before structure. |
| Authority |
Reversible local: write only the named fragment file; rollback is undoing the last append. |
| Side effect |
Fragments appended under one working title; no other file touched. |
| Done |
Useful noticings preserved without premature synthesis. |
Inputs
Must be supplied: a working title (the human's intent or the opening prompt). Optionally: a file path; if absent, ask once and remember for the session.
Procedure
- Confirm the working title with the human if not yet established. Done when: the working title is confirmed.
- Locate the fragment file at the given path. If no path was provided, ask once where to save and record the answer. Done when: the fragment file path is known.
- Re-read the file from disk before every write. The human may have edited, reordered, or deleted fragments between turns; preserve their changes. Done when: the file is re-read from its current disk state.
- On first write, create the file with a single H1 heading containing the working title and nothing else: no metadata, no table of contents, no date. Done when: the file is created with only the H1 heading.
- When the human or model produces a fragment, append it to the file. Separate fragments with a horizontal rule (
\n---\n). Never write a heading, tag, or metadata inside the body. Done when: the fragment is appended with a horizontal rule separator and no heading or metadata.
- Never overwrite the file. Only append new fragments, or edit in place a specific fragment the human names. Done when: the write is append-only or a named in-place edit is applied.
- Execute user instructions such as "cut the last one", "merge those two", or "rewrite that sharper", then confirm. Done when: the user instruction is executed and confirmed.
- If the human changes the working title, update the H1 silently on the next write. Done when: the H1 is updated to the new working title.
- Capture the very first thing the human says, including the initial prompt itself, as the opening fragment. Done when: the opening fragment is captured.
- When the conversation circles a recurring idea, push the human to coin one leading word that names the concept; that word is load-bearing for all later structure. Done when: the human coins a leading word or declines.
Failure and recovery
If no working title is provided, the skill cannot route; return blocked with the reason. If the file write fails, return write-failed with the file path and error class; do not append or guess. If the user deletes or rewrites the file between turns, the next write resumes from the file's current disk state; no rollback of user edits occurs. On an append collision, re-read and retry once; if the file changed again, return non-converged. Fragments written before a failure remain on disk; the skill ends and reports what was written.
Output
A markdown file: first line # Working title, remaining content fragments separated by ---; no heading inside the body, no tags, no metadata.
1---2name: writing-fragments3description: Use when exploration needs heterogeneous noticings captured before structure. Not for beat-by-beat assembly: use writing-beats. Not for paragraph-by-paragraph shaping: use writing-shape.4---56# Writing fragments78## Contract910| Field | Bound contract |11|---|---|12| Trigger | Exploration needs heterogeneous noticings captured before structure. |13| Authority | Reversible local: write only the named fragment file; rollback is undoing the last append. |14| Side effect | Fragments appended under one working title; no other file touched. |15| Done | Useful noticings preserved without premature synthesis. |1617## Inputs1819Must be supplied: a working title (the human's intent or the opening prompt). Optionally: a file path; if absent, ask once and remember for the session.2021## Procedure22231. Confirm the working title with the human if not yet established. Done when: the working title is confirmed.242. Locate the fragment file at the given path. If no path was provided, ask once where to save and record the answer. Done when: the fragment file path is known.253. Re-read the file from disk before every write. The human may have edited, reordered, or deleted fragments between turns; preserve their changes. Done when: the file is re-read from its current disk state.264. On first write, create the file with a single H1 heading containing the working title and nothing else: no metadata, no table of contents, no date. Done when: the file is created with only the H1 heading.275. When the human or model produces a fragment, append it to the file. Separate fragments with a horizontal rule (`\n---\n`). Never write a heading, tag, or metadata inside the body. Done when: the fragment is appended with a horizontal rule separator and no heading or metadata.286. Never overwrite the file. Only append new fragments, or edit in place a specific fragment the human names. Done when: the write is append-only or a named in-place edit is applied.297. Execute user instructions such as "cut the last one", "merge those two", or "rewrite that sharper", then confirm. Done when: the user instruction is executed and confirmed.308. If the human changes the working title, update the H1 silently on the next write. Done when: the H1 is updated to the new working title.319. Capture the very first thing the human says, including the initial prompt itself, as the opening fragment. Done when: the opening fragment is captured.3210. When the conversation circles a recurring idea, push the human to coin one leading word that names the concept; that word is load-bearing for all later structure. Done when: the human coins a leading word or declines.3334## Failure and recovery35If no working title is provided, the skill cannot route; return blocked with the reason. If the file write fails, return write-failed with the file path and error class; do not append or guess. If the user deletes or rewrites the file between turns, the next write resumes from the file's current disk state; no rollback of user edits occurs. On an append collision, re-read and retry once; if the file changed again, return non-converged. Fragments written before a failure remain on disk; the skill ends and reports what was written.3637## Output38A markdown file: first line `# Working title`, remaining content fragments separated by `---`; no heading inside the body, no tags, no metadata.
OutlineDriven