GitHub - BobbyJohansen/AIDevelopmentIndicator

3 min read Original article ↗

AI Development Indicator

AI Contributions: Welcome

Simple, embeddable GitHub badges that allow repository owners to clearly communicate their project's stance on AI-assisted development contributions.

If youd like to see more badges here feel free to drop a note or https://buymeacoffee.com/bobbyjohansen

🎯 Purpose

As AI-assisted coding tools become increasingly prevalent, open source projects need a clear way to communicate their policies regarding AI-generated contributions. These badges provide a simple, standardized way to indicate whether your project welcomes or restricts code created with AI assistance.

🚀 Quick Start

Choose the badge that reflects your project's policy and add it to your README.md:

Option 1: AI Contributions Welcome

If your project fully welcomes contributions created with AI assistance:

AI Contributions: Welcome

![AI Contributions: Welcome](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/welcome.svg)

Option 2: AI Contributions - Bugs Only

If your project accepts AI contributions only for bug fixes:

AI Contributions: Bugs Only

![AI Contributions: Bugs Only](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/bugs-only.svg)

Option 3: AI Contributions Prohibited

If your project does not accept contributions created with AI assistance:

AI Contributions: Prohibited

![AI Contributions: Prohibited](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/prohibited.svg)

💡 Why Use These Badges?

  • Transparency: Set clear expectations for potential contributors upfront
  • Simplicity: No external services, APIs, or build steps required
  • Standardization: Provide a recognizable indicator across projects
  • Flexibility: Choose the stance that aligns with your project's values
  • No Dependencies: Static SVG files hosted directly on GitHub

📖 Usage Examples

Basic Usage

Add the badge at the top of your README for maximum visibility:

# My Awesome Project

![AI Contributions: Welcome](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/welcome.svg)

Welcome to my project...

With Link to Policy

Make the badge clickable to link to your contribution guidelines:

[![AI Contributions: Welcome](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/welcome.svg)](#ai-contribution-policy)

## AI Contribution Policy

This project welcomes contributions created with AI assistance. However, contributors are expected to...

Multiple Badges

Combine with other badges for a comprehensive status section:

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![AI Contributions: Welcome](https://raw.githubusercontent.com/bobby-johansen/AIDevelopmentIndicator/main/badges/welcome.svg)
![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)

🤔 Which Badge Should I Use?

Use "Welcome" if:

  • You fully welcome AI-assisted contributions for all types of changes
  • You believe AI tools enhance developer productivity
  • You focus on code quality regardless of creation method
  • You want to encourage contributions from developers using AI tools

Use "Bugs Only" if:

  • You accept AI contributions specifically for bug fixes
  • You want human-authored feature development but welcome AI help with debugging
  • You're taking a measured approach to AI contributions
  • You want to benefit from AI's debugging capabilities while maintaining human creativity for features

Use "Prohibited" if:

  • You want contributions written entirely by humans
  • Your project has specific policies against AI-generated code
  • You require contributors to write code manually
  • You have concerns about AI training on your codebase or code authenticity

🛠️ Technical Details

  • Format: SVG (Scalable Vector Graphics)
  • Hosting: GitHub raw content URLs
  • Style: Flat design similar to shields.io badges
  • Dimensions: ~220x20 pixels
  • Colors: Welcome (green), Bugs Only (yellow/gold), Prohibited (red)
  • Accessibility: Includes proper ARIA labels and title elements

🌐 GitHub Pages

Visit the project website for an interactive preview and easy copy-paste markdown snippets.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2026 Bobby Johansen

🤝 Contributing

Suggestions for improvements are welcome! Feel free to:

  • Open an issue for feature requests or bug reports
  • Submit a pull request with enhancements
  • Share feedback on badge design or additional variants

🙏 Acknowledgments

Inspired by the need for transparency in the age of AI-assisted development and the excellent work of shields.io in providing standardized badges for open source projects.

📮 Questions?

If you have questions about which badge to use or how to implement it, feel free to open an issue in this repository.


Note: This badge indicates your project's policy. It's recommended to also include details about your AI development stance in your CONTRIBUTING.md file.