⚠️ Design system CSS not found. Check the path in docs/docs.config.js → designSystemPath, then re-run npm run docgen.

Creating content

The workflow: from raw idea to published page

Admin / 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.** [pillar tag] the idea

Unpolished is fine. Each bullet becomes its own page in the Ideas section on the next build, so nothing gets lost.

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: platform, 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.

4. Series

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

  • File: docs/series/NN Name.md
  • Frontmatter: status, 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.

On this page
  • 1. Capture
  • 2. Shape
  • 3. Script
  • 4. Series
  • 5. Strategy
  • 6. Publish

© 2026 By Default