docs(contributing): clarifying and expanding AI requirements
Introduce stricter requirements regarding AI-powered contributions, as inspired by the Linux Kernel's guidelines.
This commit is contained in:
37
AGENTS.md
37
AGENTS.md
@@ -47,7 +47,8 @@ accepted, provided you
|
|||||||
assistance);
|
assistance);
|
||||||
3. are prepared to discuss it directly with human reviewers.
|
3. are prepared to discuss it directly with human reviewers.
|
||||||
|
|
||||||
**All AI usage requires explicit disclosure**, except in these cases:
|
**All AI usage requires explicit disclosure** (see Attribution section
|
||||||
|
for commit message requirements), except in these cases:
|
||||||
- Trivial tab autocompletion, but only for completion that you have
|
- Trivial tab autocompletion, but only for completion that you have
|
||||||
already conceptualized in your mind.
|
already conceptualized in your mind.
|
||||||
- Asking the AI about knowledge that is not directly related to your
|
- Asking the AI about knowledge that is not directly related to your
|
||||||
@@ -62,6 +63,40 @@ the AI **MUST** be included in the repository. AI **MAY** generate the
|
|||||||
initial output, but the final specification **MUST** be entirely
|
initial output, but the final specification **MUST** be entirely
|
||||||
reviewed and understood by a human.
|
reviewed and understood by a human.
|
||||||
|
|
||||||
|
### Attribution
|
||||||
|
<!-- Inspired by the Linux Kernel AI Coding Assistants guidelines -->
|
||||||
|
|
||||||
|
When using AI assistance in contributions:
|
||||||
|
|
||||||
|
- **AI cannot be a commit author.** All commits must be authored by a
|
||||||
|
human contributor.
|
||||||
|
- **AI cannot sign off commits.** Only humans can legally certify
|
||||||
|
commits by adding a `Signed-off-by:` tag. AI tools MUST NOT add
|
||||||
|
`Signed-off-by` tags.
|
||||||
|
- **The human author bears full responsibility.** The human
|
||||||
|
contributor is responsible for:
|
||||||
|
- Reviewing all AI-generated or AI-assisted code
|
||||||
|
- Ensuring compliance with licensing requirements
|
||||||
|
- Taking full responsibility for the contribution
|
||||||
|
- **AI-assisted commits must include an `Assisted-by:` footer**. The
|
||||||
|
format is:
|
||||||
|
|
||||||
|
```
|
||||||
|
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
|
||||||
|
(not basic tools like git, cargo, Nix, editors)
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```
|
||||||
|
Assisted-by: Claude:claude-3-sonnet
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Guidelines for AI Agents
|
## Guidelines for AI Agents
|
||||||
|
|||||||
@@ -73,7 +73,44 @@ adhere to the following requirements:
|
|||||||
(bug reports, feature requests, pull request descriptions,
|
(bug reports, feature requests, pull request descriptions,
|
||||||
responding to humans, ...).
|
responding to humans, ...).
|
||||||
|
|
||||||
For more info, please refer to the [AGENTS.md](AGENTS.md) file.
|
### Attribution
|
||||||
|
|
||||||
|
When using AI assistance in contributions:
|
||||||
|
|
||||||
|
- **AI cannot be a commit author.** All commits must be authored by a
|
||||||
|
human contributor.
|
||||||
|
- **AI cannot sign off commits.** Only humans can legally certify
|
||||||
|
commits by adding a `Signed-off-by:` tag. AI tools MUST NOT add
|
||||||
|
`Signed-off-by` tags.
|
||||||
|
- **The human author bears full responsibility.** The human
|
||||||
|
contributor is responsible for:
|
||||||
|
- Reviewing all AI-generated or AI-assisted code
|
||||||
|
- Ensuring compliance with licensing requirements
|
||||||
|
- Taking full responsibility for the contribution
|
||||||
|
- **AI-assisted commits must include an `Assisted-by:` footer**. The
|
||||||
|
format is:
|
||||||
|
|
||||||
|
```
|
||||||
|
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
|
||||||
|
(not basic tools like git, cargo, Nix, editors)
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```
|
||||||
|
Assisted-by: Claude:claude-3-sonnet
|
||||||
|
```
|
||||||
|
|
||||||
|
See the [AGENTS.md](AGENTS.md#attribution) file for the full format
|
||||||
|
specification.
|
||||||
|
|
||||||
|
For more info, please refer to the [AGENTS.md](AGENTS.md)
|
||||||
|
file.
|
||||||
|
|
||||||
## Code of Conduct
|
## Code of Conduct
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user