# 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:

```tsx
// 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

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