New project

Creating a new entry takes about thirty seconds. Here's the recipe.

1. Make the file

   Create a new markdown file in site/src/content/projects/. The filename (without .md) becomes the URL slug. tts-mcp-server.md → /projects/tts-mcp-server.

2. Paste the template

   Copy the frontmatter from project-template.md at the repo root. Fill in title, mode, state, summary. Leave publish: draft while you're writing — drafts don't appear on the site or get a URL.

3. Write the four sections

   The convention is What I was trying to do, How Opus helped, What went sideways, Result. Not mandatory, just where the sweet spot lives.

4. Credit the acc0mplices

   Anyone (or any model) that materially helped goes in the accomplices frontmatter array. They show up at the bottom of the project page as Knotable Mentions, and aggregated on the acc0mplices page.

5. Flip the flag

   When the entry is ready, change publish: draft to publish: published. Save. The dev server picks it up immediately; a git push triggers a Cloudflare Pages rebuild.

The frontmatter cheat sheet

Required: title, mode, state, publish, date_started, date_updated, summary.

Recommended: tags, opus_models, tools, repo_external, accomplices, verdict.

Optional: slug (only if you want a URL different from the filename), hero_image, hero_video, repo_internal, pinned.

The schema in src/content/config.ts is the authoritative list. The build will fail loudly if you miss a required field — that's the point. We never publish a half-filled card.