@checkmarkdevtools/commitlint-plugin-rai

src="https://raw.githubusercontent.com/ChecKMarKDevTools/admin-things/main/assets/logos/checkmark-rai-lint-logo.png"
alt="ChecKMarK RAI"
width="160"
/>

A commitlint plugin that enforces exactly one thing:

if AI touched the code, say so in the commit. ⚖️

That’s it. No philosophy, no negotiations. Pick a trailer and move on.

Installation 🔧

``bash
npm install --save-dev @checkmarkdevtools/commitlint-plugin-rai
`

Usage 🚦

Add the plugin to your commitlint.config.js:

`js
export default {
extends: ['@commitlint/config-conventional'],
plugins: ['@checkmarkdevtools/commitlint-plugin-rai'],
rules: {
'rai-footer-exists': [2, 'always'],
},
};
`

Once this is in place, commitlint will refuse to proceed until a valid RAI trailer is present.

Valid Trailers 📌

Pick exactly one.
Skip it and the commit fails.
Use more than one and the commit also fails.

No negotiations.

1. Authored-by: [Human] — all you, no AI involved
2. Commit-generated-by: [AI Tool] — AI wrote the commit message, you wrote the code
3. Assisted-by: [AI Tool] — AI helped some, you were still driving
4. Co-authored-by: [AI Tool] — roughly 50/50, like actual pair programming
5. Generated-by: [AI Tool] ` — AI did most of it, you supervised

All patterns are case-insensitive, because enforcing honesty does not require enforcing capitalization.

Why This Exists ⚖️

If two humans pair program, both names go on the commit.
If an AI helps and we pretend it didn’t happen, that’s a choice, but it’s a strange one.

Git already supports trailers. This plugin just closes the gap between “we could do this” and “we actually do this,” by making attribution a default instead of a discussion.

If you want the longer version of that reasoning, it’s written up at Did AI Erase Attribution?.

This plugin is the boring enforcement layer that follows.

Requirements ⚙️

- Node.js >= 20.0.0
- @commitlint/cli >= 19.0.0

License 📄

PolyForm Shield License 1.0.0