write-to-intent

Write to Intent

Overview

Multi-agent pipeline that turns a writing goal ("I want this paragraph to establish X") into 2-3 refined manuscript proposals — without touching the file until the user explicitly approves.

Differs from /technical-paragraph-rewrite (which checks accuracy and fixes an existing paragraph) and /address-reviewer-comment (which responds to a specific critique). This skill starts from what you want the paragraph to do.

When to Use

• You want a new paragraph or subsection intro with a specific framing
• You want to substantially rewrite an existing paragraph toward a new rhetorical goal
• You have rough notes or a sketch and want manuscript-ready prose
• You want to explore several ways of making the same argument

Not for: minor wording fixes, responding to a reviewer, or accuracy-checking an existing paragraph.

---

Inputs Required

Provide:

1. Goal: what should this passage establish, argue, or introduce? (one or two sentences is enough)
2. Target: file and line range (existing passage to rewrite, or insertion point for new text)
3. Context: the preceding and following paragraph(s) — paste text or give file:line
4. Constraints (optional): terminology to preserve, claims to avoid, mandatory content

---

Phase 0 — Clarifying Questions

Claude asks the user the following before any agent runs. Do not skip.

1. What is the rhetorical function of this passage? (e.g., motivate, define, bridge, summarize, introduce)
2. Who is the implied reader at this point in the paper? (expert in the subfield? broad audience?)
3. Are there specific terms, concepts, or examples from the manuscript that must appear?
4. Are there any claims this passage must NOT make (to avoid overstating or conflicting with elsewhere)?
5. Does the passage introduce new technical claims? (if yes, Phase 1a — implementation check — may be needed)

Wait for the user's answers before proceeding.

---

Phase 1a — Optional: Implementation Check