CLAUDE.md

Shiplog — Project Orchestration

This project uses Shiplog for automatic progress tracking and background quality agents.

Session Start

At the start of every session:

1. Read docs/PROGRESS.md to understand current project state
2. Display a one-line status: Shiplog: Sprint X | Feature FXXX (status) | N/M features done
3. Use the context from PROGRESS.md to pick up where the last session left off

During Work

• When creating a new feature, use /shiplog feature "<name>" to scaffold it
• Reference docs/SPECS.md for architecture decisions and code conventions
• Reference docs/PRD.md for the feature roadmap and status

After Task Completion

Background agents will run automatically via hooks to:

• Update docs/SPECS.md with any architecture decisions made
• Update docs/PRD.md feature statuses based on file changes
• Append security review findings to docs/SECURITY.md
• Update memory files with new patterns and conventions

Configuration

• Config: .shiplog/config.json
• Agent model: haiku
• Enabled agents: specs, prd, security, memory

---

Project Architecture

• Monorepo: Turborepo + pnpm workspaces
• Frontend: apps/web/ — Next.js 15 App Router
• CMS: Sanity.io embedded at /studio route (packages/sanity-studio/)
• Shared types: packages/types/ — TypeScript enums/interfaces
• Shared UI: packages/ui/ — React components (added incrementally)
• AI Pipeline: services/content-pipeline/ — Python, 7 agents + 2 guardians + voice

Theme

• Default: warm white (#FFFBF5) with vibrant accent colors (oranges, teals, purples, yellows)
• Dark mode toggle available (uses data-theme attribute via next-themes)
• Minimum font size: 16px (children 8-12 with varying reading abilities)