assessment-model/CLAUDE.md
2026-04-18 19:08:56 +00:00

1.1 KiB

Claude guidance for this project

React

  • Avoid useEffect and useMemo. Derive values inline, use Server Components + Route Handlers, event handlers, or useSyncExternalStore instead. If a hook is genuinely the only option, flag it and ask before using it.

Next.js 15 route handlers

  • params is a Promise — type as { params: Promise<{ ... }> } and await params before destructuring.

Task tracking — Backlog.md

  • Project uses Backlog.md for manual/human todos (CLI backlog, web UI on port 6420).
  • MCP server is wired via .mcp.json — tools exposed under the backlog server. Use those tools instead of shelling out when possible.
  • Tasks live as markdown under backlog/tasks/. Committed to git. Read them for context on outstanding manual work (env vars, IAM, infra) owed by humans.
  • To start the web UI during development: backlog browser (port 6420, forwarded by devcontainer).
  • Do NOT mirror Backlog.md tasks into Claude's internal todo system. Use one or the other — Backlog for durable cross-session work, internal todos for within-turn progress tracking.