draft-piece

What problem does it solve? Writing technical articles from a brief often drifts from the agreed thesis, ships unverified code examples, and loses confirmed style feedback between sessions. This Skill drafts or corrects a piece strictly against its brief contract, executes every embedded command, and preserves reusable writing criteria in shared repository files. ## Core Features & Use Cases - Brief-driven drafting: Writes section by section from a docs/briefs/SLUG/ brief, honoring the publication file's location, voice, and scope boundaries, and stops when a change would alter the thesis. - Two-layer verification: Hands the draft and reader questions to a fresh-context agent, and reruns every marked code block in the repository to confirm stated outputs match real results. - Feedback preservation: Records confirmed reusable writing rules in docs/decisions/ with rationale, scope, and accepted examples, while keeping one-piece exceptions local. - Use Case: Run it on docs/briefs/monorepo-move/ to produce the article at the publication's content path, verify its shell commands actually run, preview the rendered page locally, and hand off without committing. ## Quick Start Use the draft-piece skill to write the article from docs/briefs/my-topic/ and preview it locally.