dev-commit

1# Dev Commit
2 
3Make one intentional, verified commit without sweeping in unrelated work.
4 
5## Commit Contract
6 
71. Check repository state with `git status --short --branch`, `git diff --stat`, and `git diff`.
82. Identify the files that belong to the requested change. Treat pre-existing user edits, local config, generated artifacts, dependency caches, build outputs, and unrelated formatting churn as out of scope unless the user explicitly includes them.
93. Run appropriate validation before committing. Prefer the repo's targeted tests, lint, typecheck, build, or documented verification commands. Record skipped validation with the reason. In workspaces whose packages resolve against built artifacts, ensure install and build have run in that worktree (`npm ci`, `npm run build`) before full validation or commit hooks; a fresh worktree with stale artifacts fails hooks for environmental reasons.
104. Stage only intended paths. Prefer explicit pathspecs such as `git add path/to/file` over `git add .`.
115. Re-check with `git diff --cached --stat`, `git diff --cached`, and `git status --short`.
126. Write a concise conventional commit message: `<type>(optional-scope): <summary>`.
137. Commit, then report the commit SHA, final status, validation commands, and any unstaged/untracked files left behind.
14 
15## Guardrails
16 
17- Do not commit secrets, credentials, `.env` files, local machine config, caches, coverage, logs, screenshots, or generated files unless the change explicitly requires them.
18…