[Scummvm-git-logs] scummvm master -> 26b5505e115c3d15e1d8859ef9a70721d4c72f99
lotharsm
noreply at scummvm.org
Mon Apr 27 12:03:54 UTC 2026
This automated email contains information about 1 new commit which have been
pushed to the 'scummvm' repo located at https://api.github.com/repos/scummvm/scummvm .
Summary:
26b5505e11 DOCS: Add AI-GUIDELINES.md
Commit: 26b5505e115c3d15e1d8859ef9a70721d4c72f99
https://github.com/scummvm/scummvm/commit/26b5505e115c3d15e1d8859ef9a70721d4c72f99
Author: Lothar Serra Mari (mail at serra.me)
Date: 2026-04-27T14:03:47+02:00
Commit Message:
DOCS: Add AI-GUIDELINES.md
Changed paths:
A AI-GUIDELINES.md
diff --git a/AI-GUIDELINES.md b/AI-GUIDELINES.md
new file mode 100644
index 00000000000..cbbeb5706da
--- /dev/null
+++ b/AI-GUIDELINES.md
@@ -0,0 +1,69 @@
+# Guidelines for AI Usage in the ScummVM Project
+
+This document provides guidance for AI tools and developers using AI
+assistance when contributing to the ScummVM project.
+
+## General Guidelines
+
+ - ALL code, including AI-generated or assisted code, MUST comply with our code formatting conventions, code naming conventions, and commit guidelines.
+
+ - Know your personal limits.
+ AI assistance is a tool helping with development, not a replacement for development skills.
+
+ - Only use AI assistance in parts of the codebase you are familiar with.
+ You MUST test your changes to the best of your ability BEFORE submitting your code.
+
+ - No slop. Do not submit code changes that solely rely on "vibe coding" without
+ understanding the generated code.
+
+ - AI assistance MUST be disclosed in the commit message. See "Attribution".
+ Using AI assistance repeatedly without disclosure or with the goal of appearing
+ more capable than you actually are WILL have consequences, up to a permanent ban on the ScummVM project resources.
+
+ - Code MUST NOT be authored by an AI agent. Even with using AI assistance, you are the sole author of the code you submit. AI agents must never have (Co-) authorship of your code.
+
+## Licensing and Legal Requirements
+
+All contributions must comply with our licensing requirements.
+This means that all code must be compatible with GPLv3+.
+
+## Developer's Responsibilities
+
+AI agents cannot be used as an excuse for low quality. The human submitter
+is responsible for:
+
+- Reviewing all AI-generated code
+- Ensuring compliance with licensing requirements
+- Taking full responsibility for the contribution
+
+## Attribution
+
+When AI tools contribute to the projectâs development, proper attribution
+helps track the evolving role of AI in the development process.
+Contributions should include an Assisted-by tag in the following format:
+
+```
+Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]
+```
+
+Where:
+
+- `AGENT_NAME` is the name of the AI tool or framework
+- `MODEL_VERSION` is the specific model version used
+- `[TOOL1] [TOOL2]` are optional specialized analysis tools used
+ (e.g., coccinelle, sparse, smatch, clang-tidy)
+
+Basic development tools (git, gcc, make, editors) should not be listed.
+
+Example:
+
+```
+Assisted-by: Claude:claude-3-opus coccinelle sparse [OR]
+Assisted-by: Claude:claude-opus-4.6
+
+```
+
+## AI and Art
+
+Usage of AI is NOT allowed for creating media assets, such as logos, game icons, etc. We have very skilled artists working on the project. We believe that art is something truly human that must never be replaced by AI.
+
More information about the Scummvm-git-logs
mailing list