dev-commit

Featured

AI DevKit · Safe git commit workflow for AI coding agents. Use when the user asks to commit, prepare a commit, stage changes, create a PR-ready checkpoint, or finish work with a conventional commit while avoiding unrelated user changes.

Code & Development 1,623 stars 250 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 91/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Dev Commit Make one intentional, verified commit without sweeping in unrelated work. ## Commit Contract 1. Check repository state with `git status --short --branch`, `git diff --stat`, and `git diff`. 2. 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. 3. 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. 4. Stage only intended paths. Prefer explicit pathspecs such as `git add path/to/file` over `git add .`. 5. Re-check with `git diff --cached --stat`, `git diff --cached`, and `git status --short`. 6. Write a concise conventional commit message: `<type>(optional-scope): <summary>`. 7. Commit, then report the commit SHA, final status, validation commands, and any unstaged/untracked files left behind. ## Guardrails - Do not commit secrets, credentials, `.env` files, local machine config, caches, coverage, logs, screenshots, or generated files unless the change explicitly requires them. - Do not ...

Details

Author
codeaholicguy
Repository
codeaholicguy/ai-devkit
Created
11 months ago
Last Updated
today
Language
TypeScript
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category