From f450cdaf87a3349d67dd7e31266a4d6a0787ee5b Mon Sep 17 00:00:00 2001 From: ZDDC Date: Thu, 7 May 2026 08:19:06 -0500 Subject: [PATCH] docs(claude): commit freely, push needs explicit ask, no squashing The default "no commit without ask" guidance is too restrictive for this repo's small-commit workflow. Spell out the policy: commits are made as appropriate to the work, each push is a fresh approval, and granular history is preferred over squash-on-push. Co-Authored-By: Claude Opus 4.7 (1M context) --- CLAUDE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index fcf3ca1..64e4531 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -2,6 +2,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. +## Commits and pushes + +- **Commit freely** — make commits as appropriate for the work being performed. Each commit should be a coherent, reviewable unit (no WIP/checkpoint noise). The default rule "never commit without explicit ask" does NOT apply in this repo. +- **Push only when explicitly told** — `git push` requires a fresh request from the user every time. Approval to commit does not carry forward to push, and approval to push once does not carry forward to a later push. +- **No squashing on push** — keep granular history. Each commit should already be meaningful (per the rule above), so squashing erases useful detail rather than removing noise. Multi-commit branches with a clean history are preferred over force-pushed squash-merges. + ## Authoritative docs — read these first This repo already has two thorough agent-facing references. **Always consult them before working** — they cover details intentionally omitted here: