commit

Commit — Gate → Stage → Commit

Quality gate runs FIRST. Do NOT commit if any gate fails. Do NOT ask for permission or skip the gate.

Phase 0 — Quality Gate (MANDATORY)

Check gate cache first — skip if it already passed for this exact tree state. The cache is keyed on a tree token (HEAD + tracked diff + untracked files), not a bare HEAD, so a dirty or rebased tree never reuses a stale pass:

TOKEN=$(python3 ~/100xprism/hooks/gate-pass.py --print 2>/dev/null)
CACHED=$(cat ~/.100xprism/gate-cache 2>/dev/null)
[ -n "$TOKEN" ] && [ "$CACHED" = "$TOKEN" ] && echo "Gate: skipped (already passed for this tree)" && GATE_DONE=true || GATE_DONE=false

If GATE_DONE=false: run the gate workflow. On pass, record it (same token the gate-on-commit hook checks):

python3 ~/100xprism/hooks/gate-pass.py

Do NOT proceed until gate reports ✅ ALL GATES PASSED. If any gate fails → STOP, fix, clear cache, re-run gate.

---

Phase 1 — Review changes

PROJECT_ROOT=$(git rev-parse --show-toplevel)
cd "$PROJECT_ROOT"
git status
git diff --stat
git diff --name-only HEAD 2>/dev/null || true

---

Phase 2 — Update docs (if needed)

Based on what changed, update corresponding documentation:

Changed files	Doc to update
API routes or handlers	API reference doc (README, project instruction file, or docs/)
CLI commands or flags	CLI reference doc
New features or config	README.md or project-equivalent
Removed files/features	Remove stale references from all docs
.claude/commands/**	No doc update needed

Read the project instruction file for specific doc file paths. Skip if no docs are affected.

---

Phase 3 — Stage files

Stage only task-related files. Never stage .env, dist/, node_modules/, venv/, unrelated work:

git add -u
# Or stage specific files if -u picks up unrelated changes:
# git add path/to/file1 path/to/file2
git diff --staged --stat