Lucas WintherandClaude Opus 5
d83edccc79
ARCHITECTURE, PRODUCT and TODO move out of the repository root, and
docs/superpowers/{specs,plans} flattens to docs/{specs,plans}:
"superpowers" names the tool that wrote those documents, not a kind of
document.
No content changes. This commit is the move, plus the roughly thirty
cross-references the move invalidated.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.2 KiB
Executable File
1.2 KiB
Executable File
Agent guide
This repository's agent instructions live in CLAUDE.md — read it first.
It carries the project invariants, the gotchas that cost real bugs, and the
validation this codebase deliberately does not perform.
Then, depending on what you are doing:
- Changing anything structural →
docs/ARCHITECTURE.md(layers, data flow, and why the non-obvious choices are what they are). - Picking up queued work →
docs/TODO.md(ordered, each item carrying the reasoning already settled). - Making a product decision →
docs/PRODUCT.md(who this is for, what must never break, and what must not be invented). - Wondering why something is the way it is →
docs/specs/records the decisions and the alternatives that were rejected.
Two rules worth knowing before your first edit:
- Bun only.
bun test,bun run,bunx. Never npm, jest, vitest or vite. - There IS a browser here —
bun scripts/screenshot.ts <url> <out.png>drives headless Chrome and hands you a PNG to look at. Read CLAUDE.md's "Verification limits" first: the container's fonts lie, and offline, the install prompt, the.odsin a spreadsheet, and how anything feels still need a human. Say so rather than claiming it works.