Skip to content

Add an AI checkbox - #83

Merged
jsf9k merged 4 commits into
developfrom
add-ai-checkbox
Oct 5, 2026
Merged

jsf9k merged 4 commits into
developfrom
add-ai-checkbox

Conversation

@jsf9k

@jsf9k jsf9k commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

🗣 Description

This pull request adds an AI checkbox to the pre-approval checklist.

💭 Motivation and context

This forces the pull request creator to indicate if AI was used to generate code, and if so attest that he or she understands the generated code and is comfortable answering questions about it.

🧪 Testing

All automated tests pass. I also viewed the pull request template and verified that it appears correct.

✅ Pre-approval checklist

  • This PR has an informative and human-readable title.
  • Changes are limited to a single goal - eschew scope creep!
  • All relevant type-of-change labels have been added.
  • I have read the CONTRIBUTING document.
  • These code changes follow cisagov code standards.
  • All new and existing tests pass.
  • Bump major, minor, patch, pre-release, and/or build versions as appropriate via the bump_version script if this repository is versioned and the changes in this PR warrant a version bump.

✅ Pre-merge checklist

  • Finalize version.

✅ Post-merge checklist

  • Create a release (necessary if and only if the version was bumped).

@jsf9k jsf9k self-assigned this Oct 1, 2026
@github-actions github-actions Bot added documentation This issue or pull request improves or adds to documentation version bump This issue or pull request increments the version number labels Oct 1, 2026
@jsf9k
jsf9k marked this pull request as ready for review October 1, 2026 14:49
jsf9k added 2 commits October 1, 2026 10:57
This forces the pull request creator to indicate if AI was used to
generate code, and if so attest that he or she understands the
generated code and is comfortable answering questions about it.

@dav3r dav3r left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I human-approve this addition! 🤖

@felddy

felddy commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

I like it. But... what if it was generated by AI and I'm not comfortable explaining it?
Or if it was generated by AI, but I have no idea how it works, but am more than happy to talk about that.

I think this should either be separated into a bullet and a sub-bullet, or we update the contributing guide to enforce this relationship. Probably the former.

  • AI was used to generate code in this PR (in part or in full).
    • I understand the generated code and can explain its functionality.
    • I am comfortable answering questions regarding its implementation.

I didn't want to have a single bullet under the first, since the nuns would find me and beat me. But seeing the "comfort" bullet makes me realize this probably should apply to any code in a PR regardless if AI generated it.

I'm going to go dig up some examples I've seen on other projects.

@felddy

felddy commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

I like the idea of adding an AI label:

We could auto apply it if the commit message had AI identifiers in it:

More examples of PR templates with AI checkboxes:

This has some cool ideas but is beyond adding checkboxes to the template. I think we should consider adding agent guidance that can help ensure the checkboxes are checked by humans:

Co-authored-by: Felddy <markf@geekpad.com>
@jsf9k

jsf9k commented Oct 2, 2026 •

Copy link
Copy Markdown
Member Author

I like it. But... what if it was generated by AI and I'm not comfortable explaining it? Or if it was generated by AI, but I have no idea how it works, but am more than happy to talk about that.

I think this should either be separated into a bullet and a sub-bullet, or we update the contributing guide to enforce this relationship. Probably the former.

  • AI was used to generate code in this PR (in part or in full).

    • I understand the generated code and can explain its functionality.
    • I am comfortable answering questions regarding its implementation.

I didn't want to have a single bullet under the first, since the nuns would find me and beat me. But seeing the "comfort" bullet makes me realize this probably should apply to any code in a PR regardless if AI generated it.

I'm going to go dig up some examples I've seen on other projects.

Please see commits 9c4793f and 945c1c4.

@jsf9k

jsf9k commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

I like the idea of adding an AI label:

Please see cisagov/skeleton-generic#289.

Co-authored-by: Felddy <markf+github@geekpad.com>

@felddy felddy left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very nice! Even better than I came up with.

@dav3r dav3r left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good improvements! 👍 🤖

@jsf9k
jsf9k merged commit eeeec70 into develop Oct 5, 2026
13 checks passed
@jsf9k
jsf9k deleted the add-ai-checkbox branch October 5, 2026 14:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation This issue or pull request improves or adds to documentation version bump This issue or pull request increments the version number

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants