media-write

/media-write — Guided Writing & Variant Generation

Write content collaboratively, then generate platform-specific variants.

Prerequisites

Before starting, read these shared library files:

• Read lib/adapter-discovery.md for adapter format.md location
• Read lib/manifest-ops.md for manifest creation
• Read lib/humanize.md for de-AI writing rules (MUST read before any writing)

Step 1: Get the Brief

Check if a brief exists from /media-idea:

ls -t content/posts/*/brief.yaml 2>/dev/null | head -1

If a brief exists, read it and show the user:

• Topic, angle, outline, target platforms

If no brief exists, ask the user via AskUserQuestion:

1. "What do you want to write about?"
2. "Who is the audience?" (developers, beginners, specific community)
3. "Which platforms should we target?" (show configured platforms)

Step 2: Create Post Directory

SLUG=$(echo "<title>" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//' | sed 's/-$//')
DATE=$(date +%Y-%m-%d)
POST_DIR="content/posts/${DATE}-${SLUG}"
mkdir -p "$POST_DIR/assets" "$POST_DIR/variants"

Step 3: Guided Section-by-Section Writing

Work through the article section by section:

Interaction model

1. Propose an outline based on the brief/topic. Use AskUserQuestion: "Here's my proposed outline for ''. Approve or suggest changes?" Show 4-7 sections with one-line descriptions.

2. For each section:

   • Propose the section content in chat (2-4 paragraphs)
   • Use AskUserQuestion: "How does this section look?"
     • A) Approve — move to next section
     • B) Shorter / more concise
     • C) More technical / add code examples
     • D) Different angle (provide feedback)
   • On approval, append the section to source.md using the Write or Edit tool
   • User can say "go back to section N" to revise earlier sections

3. The file is the source of truth. All approved content lives in source.md. Chat is the collaboration channel for drafting and feedback.