9a9e58c935
Moved from maxwell/blog to standalone repository. - Next.js research journal application - Notes 001-005 with YAML/MD content structure - Claude Code configuration for blog development Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
# 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
|
|
```
|