Iron Law

Never publish content without research and review.

Red Flags

• "I can write tests later" → STOP. Write them now.
• "This change is too small to review" → STOP. Small bugs become P0 incidents.
• "I don't need to check previous cycle insights" → STOP. You will repeat the same mistake.
• "This is good enough" → STOP. Check the checklist.
• "No time to follow every step" → STOP. Skipped steps cost 3x more later.

Write

Produce content with automatic research and review unless the caller explicitly skips those steps.

When to Use

• The user asks for a draft, article, newsletter, report, short-form script, or social post
• Another skill needs polished written output

Workflow

1. Run /second-claude-code:research UNLESS --skip-research flag is set OR source material is already provided via --input. Guard: If --skip-research is set but no --input is provided and no source material exists in the conversation, warn the user: "No source material provided. Output will rely on training knowledge only. Continue?" Do NOT silently fall back to training knowledge.
2. Load format spec AND voice guide: read references/formats/{format}.md (required — abort if missing) and references/voice-guides/{voice}.md (recommended). If the voice guide file doesn't exist, proceed using the default voice characteristics from the Voices table mapping below.
3. Draft content following loaded format spec and voice constraints.
4. Run /second-claude-code:review --preset quick UNLESS --skip-review flag is set. This step is MANDATORY by default.
5. Address all Critical and Major review findings. Re-read the review output and apply fixes.

Options

Flag	Values	Default
--format	newsletter|article|shorts|report|social|card-news	article
--voice	peer-mentor|expert|casual	format-specific
--publish	notion|file	file
--skip-research	flag	off
--skip-review	flag	off
--lang	ko|en	ko
--input	file path	none
--constraints	comma-separated strings	none

--constraints: Review findings injected as hard requirements for this draft. Each entry is enforced as a non-negotiable rule during drafting and is not open to negotiation with the user. Passed automatically by the PDCA Act→Do route; can also be supplied manually.

When --input is provided (or when called from a pipeline with input_from), the file content is injected as source context and --skip-research is implied.

Soul-Aware Voice Resolution

Voice is resolved in this priority order:

1. --voice flag (explicit override — always wins)
2. ## Tone Rules in .data/soul/SOUL.md (personal preferences — merge with voice guide)
3. .data/soul/templates/STYLE.md defaults (bilingual baseline)
4. Format voice guide from the Voices table below

If .data/soul/SOUL.md exists, read its ## Tone Rules section and treat those rules as non-negotiable constraints on top of the selected voice guide. Soul tone rules override format defaults but never override an explicit --voice flag.

Voices

Voice	Default For
peer-mentor	newsletter
expert	report, article
casual	shorts, social, card-news

Voice Checklist

Before finalizing, verify:

• At least one first-person example (peer-mentor) OR authoritative citation (expert) OR conversational aside (casual)
• Tone is consistent throughout — no voice mixing
• CTA present for shorts/social formats

Format Rules

• newsletter: 6-stage arc, minimum 2000 words, at least 2 research data points
• article: minimum 3000 words
• report: minimum 4000 words with numbered recommendations
• shorts: around 300 words with a mandatory CTA
• social: platform-optimized short post
• card-news: slide-by-slide narrative with visual direction

Length Negotiation

When user-specified length conflicts with format minimums:

1. Inform the user: "Article format minimum is 3000 words, you requested ~800."
2. Offer alternatives: switch to shorts or social format, OR keep article at full length.
3. If user insists on short article, respect user intent but note the override in output metadata.

Never silently truncate or silently exceed the user's request.

Auto-Save

After the review step (or after drafting if --skip-review), save the final content:

• Path: .captures/write-{format}-{slug}-{YYYY-MM-DD}.md
• {slug} = topic lowercased, spaces to hyphens, max 40 chars
• Write the full content using the Write tool. Do NOT skip this step.
• Tell the user the saved path.

When --publish notion is set: requires a configured Notion MCP connection (mcp__claude_ai_Notion__notion-create-pages). Create a Notion page with the content, then save the local .md file. If Notion MCP is not available, warn the user and save to file only.

Gotchas

• Do not skip research unless real sources are already supplied.
• Do not start writing before loading the format spec file.
• Do not output content without running the review step (unless --skip-review is explicitly set).
• Do not miss the CTA in shorts or conclusions.
• Do not ship the reviewed version without addressing Critical and Major issues. Minor issues may be deferred.
• Severity levels follow the shared taxonomy: Critical (ship-blocking), Major (significant gap), Minor (polish). Same as /second-claude-code:review.

Subagents

writer: { model: opus, constraint: "follow format rules, voice, and length minimums" }
editor: { model: opus, constraint: "address all Critical and Major review items" }