Skip to content

CLAUDE.md

Latest commit

 

History

History
40 lines (26 loc) · 2.68 KB

CLAUDE.md

File metadata and controls

40 lines (26 loc) · 2.68 KB
Raw

CLAUDE.md - Unrot (root)

See AGENTS.md for full context. This file points there and notes Claude-Code-specific behaviour.

Hierarchical merge

Claude Code automatically merges CLAUDE.md files from the repo root down to the file being edited. When you edit platform/quiz/src/components/QuestionCard.tsx, you get:

Plus the root AGENTS.md as the vendor-neutral source of truth. Per-area AGENTS.md files (e.g. platform/AGENTS.md, installers/AGENTS.md) cover area-local contracts that every AI vendor should honour.

Prefer updating AGENTS.md for anything a non-Claude agent would also need. This file is only for things that are genuinely Claude-Code-specific (for example, "the Skill tool can invoke our frontend-design skill against the quiz PWA").

Superpowers skills actively in use

These skills are how Claude Code contributes to Unrot. Invoke them explicitly when the situation calls for one:

  • superpowers:brainstorming - before any creative or architectural work (features, components, new installers). Explores intent and requirements before code.
  • superpowers:writing-plans - after a spec is agreed, before touching code, for any multi-step implementation. Produces a file-by-file plan with checkboxes.
  • frontend-design:frontend-design - for polish passes on the quiz PWA and marketing site. Avoids generic AI aesthetic (gradient slop, indigo-to-purple, stock hero patterns).
  • superpowers:systematic-debugging - first thing to invoke for any failing test or unexpected behaviour. Evidence before hypotheses.
  • superpowers:verification-before-completion - before claiming work is done, committing, or opening a PR. Run the commands, read the output, confirm.

If a skill's output contradicts AGENTS.md or the design spec, the written docs win.

Commit and push posture

  • Commit author is already configured as Tim Thomas <0800tim@gmail.com> in the local git config.
  • Commits use conventional-commit prefixes, see recent history.
  • Every commit body ends with Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>.
  • Do not push unless explicitly asked. Local commits only, unless the user says otherwise.
  • Do not skip hooks (--no-verify) unless Tim explicitly says so.

Daily rituals

"Close off for the day" → pnpm close-off "summary", per docs/workflows/end-of-day.md. "Kick off the day" → pnpm kick-off, per docs/workflows/start-of-day.md.