Skip to content

thoughtbot/atomic-commits-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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.

About

Claude Code plugin for atomic commit workflow and small PR nudges

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages