Christian Hood
83abac52f6
Sets up the full monorepo structure with: - Multi-stage Dockerfile (client-build + production stages) - docker-compose.yml for production, docker-compose.dev.yml overlay for development - Express server (port 3000) with pg pool, health route, and SPA static file serving - React 18 + Vite client with react-router-dom v6, nav bar, and placeholder page components - .env.example with PostgreSQL and app config - Empty db/migrations/ directory for future migrations - CLAUDE.md updated with development workflow commands Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Agent Workflow Rules
- Commit after every task: When a task is complete, stage all changed files and create a git commit before marking the task done.
- Keep documentation current: Update
CLAUDE.mdwith any new commands, architecture details, or setup steps introduced by your task. UpdatePRD.mdonly if scope/design decisions changed. - Mark tasks in td:
td start <id>when beginning,td close <id>when done.
Task Management
This project uses td (a local CLI) for task tracking. At the start of each session:
td usage --new-session # required at conversation start or after /clear
td usage -q # quick check for subsequent reads
Optional session labeling:
td session "name" # label the current session
td session --new # force a new session in the same terminal context
Task state is stored in .todos/issues.db (SQLite).
Development
Run production stack (Docker):
docker compose up
Run development stack with live reload (Docker):
docker compose -f docker-compose.yml -f docker-compose.dev.yml up
Frontend only (Vite dev server):
cd client && npm install && npm run dev
Backend only (nodemon):
cd server && npm install && npm run dev