[Scummvm-git-logs] scummvm master -> a2a882d8266e89d16e6dbccdff19b972157e85f7
sev-
noreply at scummvm.org
Sun Nov 1 13:06:37 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:
a2a882d826 DOCS: Update AI-GUIDELINES with section about the engines, drop hard attribution requirement
Commit: a2a882d8266e89d16e6dbccdff19b972157e85f7
https://github.com/scummvm/scummvm/commit/a2a882d8266e89d16e6dbccdff19b972157e85f7
Author: Eugene Sandulenko (sev at scummvm.org)
Date: 2026-11-01T14:06:18+01:00
Commit Message:
DOCS: Update AI-GUIDELINES with section about the engines, drop hard attribution requirement
Changed paths:
AI-GUIDELINES.md
diff --git a/AI-GUIDELINES.md b/AI-GUIDELINES.md
index 8a9b099aaf2..cb63d7fabfc 100644
--- a/AI-GUIDELINES.md
+++ b/AI-GUIDELINES.md
@@ -10,7 +10,7 @@ assistance when contributing to the ScummVM project.
- 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.
+ - 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
@@ -18,7 +18,7 @@ assistance when contributing to the ScummVM project.
- AI must be restrained to write the appropriate amount of code comments. Lengthy LLM-oriented explanations are forbidden.
- - AI assistance MUST be disclosed in the commit message. See "Attribution".
+ - AI assistance MUST be disclosed at least in the PR description.
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.
@@ -42,34 +42,27 @@ is responsible for:
- 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:
+## Submitting Whole Engines
-```
-Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]
-```
+We, as a project mostly interested in game preservation and portability. Thus, an engine supporting
+particular game or games, is not adding value by itself.
-Where:
+The expectation, is that when you submit an engine, then:
-- `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)
+- You join the ScummVM Team and become this engine primary maintainer
+- Meaning, you do understand the engine internals well
+- Meaning, when a bugreport is submitted, you *know* which parts of the engine are involved and can work on fixing
+- Meaning, that in general, you would be able to work with the engine even without AI
-Basic development tools (git, gcc, make, editors) should not be listed.
+In essence, if you used AI in your engine development, you used it as a tool to speed up things, not to replace your reasoning and thinking.
-Example:
+Engines, fully reversed by swarm of agents are of no value to us. Save your tokens and run the game in DosBox, Wine, or some kind of an emulator or a VM.
-```
-Assisted-by: Claude:claude-3-opus coccinelle sparse [OR]
-Assisted-by: Claude:claude-opus-4.6
+## Attribution
-```
+When AI tools contribute to the projectâs development, we require disclosure. In the past, we required attirbution in
+the commit log messages, but we dropped this as a hard requirement.
## 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