smriti/CLAUDE.md

Smriti — project instructions for Claude Code

This project uses Smriti as the shared reasoning-state backend. A SessionStart hook injects smriti state smriti-dev --compact into your context automatically. Read it before doing anything else. Artifact content is omitted in compact mode — if the state brief lists artifacts that look relevant, inspect them with smriti checkpoint show <id> --full-artifacts.

Session start checklist

1. The state brief is already in your context (injected by the hook). Read it.
2. Check ## Active work — if another agent has an active claim on work you were about to start, pick different work or ask the human.
3. Reconcile against the repo: git log --oneline -10. Check whether tasks from the state brief are already done.
4. Create a work claim before starting substantial work: smriti_claim(space="smriti-dev", scope="...", agent="claude-code").

During work

• Checkpoint at inflection points only, not after every small step. Use --author-agent claude-code.
• If exploring an alternative direction, fork first.
• If state and repo disagree, stop and reconcile — do not guess.

Session end

• Mark your work claims done or abandoned.
• Push your branch if it should be visible.
• State the branch disposition: ready to merge, needs review, or exploratory.

Do not

• Write HANDOFF.md, NOTES.md, or similar files. The checkpoint is the handoff.
• Start, restart, or manage the backend or Docker. You are a client.
• Merge or push to main without human approval.
• Checkpoint noise (save-button commits, end-of-session dumps).

The full skill pack is at .claude/skills/smriti/SKILL.md. This file is the compact always-loaded version. Refer to the skill pack for detailed guidance on claims, branching, drift detection, and anti-patterns.