Skip to content

Essk/ai-contribution-level

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

AI Contribution Level

AI Contribution

A simple badge to indicate how much AI was involved in creating a project's code.

This is a per-repo, self-reported badge. There is no backend, no verification, and no judgment implied — just transparency.

The Scale

Level Label Description Badge
0 None No AI involvement at all. All code was written by humans. AI Contribution: Level 0
1 Research Only AI was used for planning, research, or documentation, but did not write any code. AI Contribution: Level 1
2 Autocomplete AI-powered code completion (e.g. Copilot tab-complete) was used during development. The human drove the structure and logic. AI Contribution: Level 2
3 Interactive Code was written through interactive prompting with an AI assistant (e.g. ChatGPT, Claude, Copilot Chat). The human guided the AI through conversation. AI Contribution: Level 3
4 One Shot Code was generated in a single non-interactive prompt or fully autonomous AI session with minimal human editing. AI Contribution: Level 4

Usage

Pick the level that best describes your project overall, then add the badge to your README.

Markdown

<!-- Level 0: None -->
[![AI Contribution](https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-0.svg)](https://github.com/Essk/ai-contribution-level)

<!-- Level 1: Research Only -->
[![AI Contribution](https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-1.svg)](https://github.com/Essk/ai-contribution-level)

<!-- Level 2: Autocomplete -->
[![AI Contribution](https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-2.svg)](https://github.com/Essk/ai-contribution-level)

<!-- Level 3: Interactive -->
[![AI Contribution](https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-3.svg)](https://github.com/Essk/ai-contribution-level)

<!-- Level 4: One Shot -->
[![AI Contribution](https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-4.svg)](https://github.com/Essk/ai-contribution-level)

HTML

<!-- Level 3 example -->
<a href="https://github.com/Essk/ai-contribution-level">
  <img src="https://raw.githubusercontent.com/Essk/ai-contribution-level/main/badges/level-3.svg" alt="AI Contribution: Level 3 - Interactive">
</a>

Guidelines

  • Pick the highest level that applies. If most code was written by hand but one module was AI-generated via interactive prompting, that's Level 3.
  • This is self-reported. There's no enforcement. The value comes from honest, voluntary transparency.
  • This describes the repo as a whole. If your project has wildly different AI involvement across components, pick the level that best represents the overall picture, or note the details in your README.
  • AI-assisted refactoring counts. If AI restructured existing human-written code, that counts as AI contribution at the relevant level.

FAQ

What if I used AI for tests but not production code? Consider the overall project. If the production code is entirely human-written and only tests used AI, you might reasonably pick Level 2 or 3 depending on how the tests were generated.

What if I heavily edited AI-generated code? The badge reflects how the code was initially produced, not the final editing pass. If AI wrote the first draft via interactive prompting and you cleaned it up, that's still Level 3.

Does using AI-generated Stack Overflow answers count? No. Copying code from any source (AI, Stack Overflow, blogs) and adapting it is normal development. The badge is about direct AI tool usage in your workflow.

License

CC0 1.0 — the badges and this specification are public domain. Use them however you like.

About

A badge to indicate how much AI was involved in creating a project's code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors