research-notes/.claude/guides/blog.md

Maxwell Blog Guide

Writing research notes for the Maxwell journal.

Purpose

The blog documents HOW AI is used to work through an unfamiliar problem. Each note captures a research session.

Structure

blog/src/app/
├── page.tsx                    # Journal home (list of projects)
├── maxwell/
│   ├── page.tsx               # Maxwell project landing
│   ├── white-paper/page.tsx   # Formal paper outline
│   └── notes/
│       ├── 001-picking-a-problem/page.tsx
│       ├── 002-building-the-scaffolding/page.tsx
│       └── [NNN-slug]/page.tsx

Note Structure

Each note follows this pattern:

// Prompts used during the session
const prompts = [
  { id: "...", label: "Prompt name", content: "Full prompt text" },
];

// Files created during the session
const filesCreated = [
  { name: "filename.md", description: "What it is", content: "Full content" },
];

// JSX structure:
// - Navigation
// - Header (#NNN, date, title)
// - Prompts section (copyable)
// - Files section (expandable + copyable)
// - Prose content
// - Footer navigation (prev/next)

Shared Components

From src/components/copyable.tsx:

• CopyButton — Simple copy button
• CopyableBlock — For prompts with copy functionality
• ExpandableFile — For files with expand + copy

Adding a New Note

1. Create directory: src/app/maxwell/notes/NNN-slug/
2. Create page.tsx following the pattern above
3. Update src/app/maxwell/page.tsx to add to notes array
4. Update previous note's footer to link to new note

Content Guidelines

• Focus on the METHOD, not just results
• Capture actual prompts used
• Include full file contents in filesCreated
• Explain WHY decisions were made
• The vision.md is for keeping FOCUS, not for importance ranking
• Next steps should be concrete and actionable

Tone

• First person ("I did X")
• Conversational but technical
• No unnecessary superlatives
• Honest about limitations and complexity

Running Locally

cd blog
npm install
npm run dev
# Open http://localhost:19197