# Shared project instructions

Read [AGENTS.md](AGENTS.md) before development work and follow its instructions.
Then read [.ai/PROJECT.md](.ai/PROJECT.md) for lasting project knowledge and
[.ai/HANDOFF.md](.ai/HANDOFF.md) for the current state and next steps.

Use these shared files rather than maintaining separate Claude-only project notes.
Update the handoff after substantial completed work and before ending a session
when possible, following the checkpoint procedure in `AGENTS.md`.