NodeJSmith Fragments
Pure explore: widen the space of what could be written without committing to structure. Interview the user relentlessly, in the style of mine-grill's multi-angle interrogation, about whatever they want to write about — then capture whatever survives as fragments in a single markdown file. Imposing phases, outlines, or article structure is out of scope here. Structure is the job of mine-shape or mine-beats, run later against the file this skill produces.
Arguments
$ARGUMENTS — optional path to the fragments file. If a path is provided, use it. If empty, run get-skill-tmpdir mine-fragments, write to <dir>/fragments.md, and tell the user where it's saved — do not ask once and rely on remembering the path for the rest of the session, since the session may not persist.
Getting Started
Capture fragments from the very first thing the user says, including the initial prompt — do not wait for a formal kickoff.
On first write, put a single H1 at the top with a working title (it can change later) and nothing else — no metadata, no table of contents, no date.
Then run the interview: ask questions that widen what the user is noticing, follow tangents, push on anything vague, and let the conversation range freely. As fragments emerge from either side of the conversation, append them to the file.
What Is a Fragment
A fragment is any piece of text that might survive into the final article. It must be readable by the author — the author can tell what it means — but it does not need to define its terms or be comprehensible to a cold reader. The bar is "is this a piece of good writing?", not "is this a self-contained argument?"
Fragments are deliberately heterogeneous. Examples of what could be a fragment:
- A sharp sentence you'd want to deploy somewhere but don't yet know where.
- A claim with a one-line justification.
- A vignette: a thing that happened, a code snippet, a scenario, an analogy.
- A half-thought: "something about how X feels like Y, work this out later."
- A quote, a piece of dialogue, an overheard line.
- A list of related observations that hang together by feel.
- A complaint, a confession, a punchline.
- A leading word — a compact metaphor or coinage the whole piece can hang on (one term that names the idea, the way tracer bullets or fog of war names a whole pattern).
Of these, the leading word is the most valuable fragment to land. It is load-bearing: name the right one in this exploration phase and it shapes the structure, the transitions, and the title later — paying dividends through the entire shaping phase. When the conversation circles a recurring idea, push to coin a word for it.
The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are noticings.
File Format
# Working title
A first fragment lives here.
It can be multiple paragraphs. It can include lists, code, quotes — whatever
shape the fragment naturally takes.
---
A second fragment.
---
> A quoted line that the user wants to keep around.
A reaction to it.
---
- A cluster of related observations
- That hang together by feel
- And want to be near each other
Fragments are separated by a horizontal rule (\n---\n). No headings inside the body. No tags. No order beyond the order they were added.
Writing Rhythm
Append silently. Don't ask permission for each fragment. Mention what you added in passing ("adding that"), but don't interrupt the conversation with save dialogs.
Before every write: re-read the file from disk. The user may have edited, reordered, or deleted fragments between turns — preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).
The user can say "cut the last one", "rewrite that one sharper", "merge those two" at any time. Treat those as first-class instructions.
Handoff
When the user is ready to commit to structure, point them at the next phase:
Fragments saved at
<path>. When ready to shape this into an article, run/mine-shape <path>for a paragraph-by-paragraph build, or/mine-beats <path>for a choose-your-own-adventure journey.