Setup writing framework

Configure the repository Editorial Pipeline in AGENTS.md or CLAUDE.md to route drafting and sub-editing across specialist writing skills.

Purpose

Establish clear, context-aware routing for repository writing tasks by scaffolding a two-stage Editorial Pipeline:

• Stage 1 (Drafting): Directs drafting to specialist skills based on Surface and Reader Job.
• Stage 2 (Sub-Editor Gate): Passes drafted copy through guardian-style-guide for style, typography and trope compliance before final delivery (commit messages are exempt).

Procedure

1. Explore: Inspect the repository root to locate existing instruction files (AGENTS.md, CLAUDE.md), installed writing skills (in .agents/skills/, .claude/skills/ or sibling directories) and domain documentation (GLOSSARY.md, docs/adr/ or docs/agents/). Identify the preferred target file (AGENTS.md by default, or CLAUDE.md if the repository uses Claude-specific configuration) and check whether a ## Writing framework section already exists. Completion: Target file identified, existing agent instructions reviewed and installed writing skills catalogued.
2. Confirm: Ask the user in one compact turn which Stage 1 drafting skills apply and whether the Stage 2 (guardian-style-guide Sub-Editor Gate) applies. Present recommendations based on installed skills detected during exploration. Completion: Target file, selected Stage 1 skills and Stage 2 gate preference are confirmed in a single turn.
3. Preview: Display the proposed ## Writing framework Markdown block and the target file path. Clearly show how Stage 1 routes active skills and how Stage 2 enforces the sub-editing gate. Completion: Complete Markdown block displayed for user review before writing.
4. Write: Insert or update the ## Writing framework section in the target file (AGENTS.md or CLAUDE.md) without overwriting surrounding sections or existing instructions. Verify formatting, links and typography (zero unspaced em-dashes, zero curly quotes, zero Unicode arrows). Completion: Target file updated cleanly, with existing sections preserved and all checks passing.

Framework template