DimwitLabs

DimwitLabs / AI-DECLARATION.md

Public

An open standard for declaring AI usage in software projects.

ai-declaration.md ai ai-declaration ai-governance ai-transparency candor
18
0
100% credibility
Found Apr 13, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
HTML
AI Summary

A standard for adding a simple file to software projects that clearly discloses the extent of AI assistance used in development.

How It Works

1
🔍 Discover the Idea

You stumble upon a helpful guide on GitHub that suggests adding a special note to projects to show how AI helped make the code.

2
💡 Understand the Purpose

You learn it's all about being open and honest, so others know exactly how much AI was involved in creating your work, building trust.

3
📝 Pick Your Level

You choose a simple level that matches your experience, like 'a little help' or 'AI did most,' to describe the AI's role.

4
✨ Create Your Note

You write a short, clear note in a file, adding details about what parts of your project got AI assistance, feeling proud of your transparency.

5
🏷️ Add a Badge

You grab a colorful badge to put on your project's main page, so everyone sees at a glance that you're upfront about AI use.

6
📁 Place It in Your Project

You save the note file right in your project folder, making it easy for anyone to find and read.

🎉 Build Trust

Now, when you share your project, people appreciate your honesty, trust your work more, and collaborate happily.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is AI-DECLARATION.md?

AI-DECLARATION.md proposes an open standard for declaring AI usage in software projects through a simple YAML-frontmatter Markdown file added to your repo root. It lets you specify involvement levels like "none," "copilot," or "auto" globally, per development process (design, testing, deployment), or per component, solving the transparency gap around AI-generated code. Developers get badges for their README, a YAML schema for validation tools, and a social contract for trust, much like a standard GitHub license or README.

Why is it gaining traction?

It stands out by mirroring familiar GitHub conventions—think standard GitHub branch names, commit messages, workflows, or hosted runners specs—making adoption dead simple without new tooling. The hook is granular disclosure that spotlights human skills while letting skeptics audit AI-heavy parts, plus easy badges that signal compliance at a glance. In an era of AI tools like Copilot, it normalizes declaring usage like you do for licenses or actions standards.

Who should use this?

Open-source maintainers building trust with contributors wary of AI slop, teams standardizing AI in GitHub workflows for audits, or enterprises tracking Copilot usage across projects. It's ideal for devs declaring levels in documentation, testing, or deployment phases, especially when pairing with standard GitHub runners or actions.

Verdict

Worth adding to new projects as a low-effort transparency win, despite 18 stars and 1.0% credibility score signaling early-stage maturity with thin docs and no tests yet. Fork and contribute to evolve it into a true standard for AI declaration in software.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.