atomic-commits

atomic-commits-plugin

Claude Code plugin that guides agents to work in small, atomic commits and keep pull requests around ~200 lines. Inspired from this thoughtbot blog post.

What it does

• Skill (skills/atomic-commits/SKILL.md) — teaches agents to plan atomic steps before coding, commit after each step, and split large PRs at natural seams.
• Hook (hooks/check-diff-size.sh) — monitors diff size after Edit/Write operations and nudges when it's time to commit or open a PR.

Atomic Commit Criteria

Every commit must:

1. Pass CI — tests, linter, build all green
2. Be deployable — application is in a valid state
3. Introduce no dead code — no unreachable code, unused imports, or half-wired features

Installation

Install via the thoughtbot marketplace:

/plugin marketplace add thoughtbot/thoughtbot-plugins
/plugin install atomic-commits@thoughtbot-plugins

Or add directly:

/plugin install thoughtbot/atomic-commits-plugin

License

Copyright © 2026 thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.

About thoughtbot

This repo is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software! See our other projects. We are available for hire.