Creating content

How a piece of content moves through this project. Six stages, each with one home. Nothing here is optional ceremony: every stage exists so the next one starts from something instead of nothing.

1. Capture

A raw idea gets one bullet in docs/ideas/idea-inbox.md:

- **Title.** [NN Pillar name] the idea

The tag is one of the four pillars (01 to 04, from docs/foundation/content-pillars.md), or nothing if unclear. Unpolished is fine. Each bullet becomes its own page in the Ideas section on the next build, so nothing gets lost. In Claude Code, the idea-capture skill does this whole stage in one prompt.

2. Shape

Open the Idea Studio (/docs/site/tools/idea-studio.html):

• Click through the workflow steps to turn the raw idea into a plan.
• Copy the hand-off brief at the end.

3. Script

Run the brief through the scriptwriting workflow (PROJECT-INSTRUCTIONS.md plus the 02 Skills/ systems), then save the script to:

• File: docs/scripts/NN Project Name - Presenter.md
• Frontmatter: subsection: "July 2026" (the month, drives the sidebar month accordion), platform, series (from the roster, or Standalone), and status: draft while it's not ready. Drafts stay off the built site.
• The build computes spoken length and word count into the page's At a glance table, alongside the platform and series.
• In Claude Code, the script-writer skill runs this whole stage in one prompt.

4. Series

A repeatable format that has earned its place gets a page of its own:

• File: docs/series/NN Name.md
• Frontmatter: status (Live renders under the Selected accordion, Experiment under Testing), format, pillar, role, platform, and order: <filename number + 1> - the +1 keeps the sidebar order intact because 00 content-series-system.md holds slot 1 (a bare order: 0 would be ignored by the generator).
• See docs/foundation/series.md for the bar it has to clear first.

5. Strategy

Changes to the intents, pillars, or series system are edits to the existing files in docs/foundation/, not new pages.

6. Publish

npm run docs:build

This regenerates docs/site/. Commit both the source files and the built site.