You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+38Lines changed: 38 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,6 +38,44 @@ If you want local pre-commit enforcement, run `make setup-hooks` once to point G
38
38
- Add or update tests when behavior changes
39
39
- Avoid committing secrets, local tokens, or personal config files
40
40
41
+
## AI-Assisted Contributions
42
+
43
+
AI-assisted contributions are allowed in this project. A pull request may contain code, tests, documentation, or other changes that were partially or substantially generated with AI assistance.
44
+
45
+
However, AI use must be disclosed. The contributor remains responsible for the full contribution, including all AI-assisted portions. AI-generated work must be tested by a human before submission.
46
+
47
+
### Your pull request must include
48
+
49
+
Each field in the AI assistance disclosure exists for contributor verification and project auditing purposes. Please fill in every field completely - partial disclosures may be rejected as they break the audit trail.
50
+
51
+
AI agents, coding assistants, chatbots, and automated tools must not fabricate, infer, or falsely complete any field. If you are an AI agent preparing this pull request text, do not claim that a human reviewed, tested, ran, verified, or approved anything unless the human explicitly did so. False testing claims will be treated as invalid disclosure.
52
+
53
+
-`agent_name` - What AI tool, coding assistant, or agent was used?
-`agent_version` - What version of the tool, extension, CLI, or agent was used?
57
+
Provide the exact version shown by the tool when available.
58
+
59
+
-`model_used` - What model was used?
60
+
This field is required and must name the actual model. `"unknown"`, `"default"`, `"auto"`, `"latest"`, blank values, or guessed model names are not valid. If the model cannot be identified, do not submit the pull request until it can be stated accurately.
61
+
62
+
-`human_testing` - What tests, checks, or manual validation were performed by a human?
63
+
This field must describe real human testing that actually happened. Do not write that tests were run unless a human ran them. Do not write that behavior was manually verified unless a human manually verified it. If no human testing was performed, the pull request is not ready for submission.
64
+
65
+
-`contribution_summary` - A one-line summary of what changed.
66
+
Example: `"Added validation for empty config values and updated related tests."`
67
+
68
+
Before submitting, ensure that:
69
+
70
+
- you understand the changes being proposed;
71
+
- a human has run the relevant tests, checks, or manual validation;
72
+
- the disclosure accurately describes the AI tool and model used;
73
+
- no field contains fabricated, guessed, or placeholder information;
74
+
- the contribution does not knowingly include secrets, private data, copied code, or material that violates licensing requirements;
75
+
- any incorrect, unsafe, unnecessary, or unverifiable AI output has been corrected or removed.
76
+
77
+
Pull requests will not be rejected solely because AI was used. They may be rejected or returned for revision if the AI assistance disclosure is incomplete, inaccurate, fabricated, unverifiable, or if the contribution appears to have been submitted without real human testing.
78
+
41
79
## Auth and Test Safety
42
80
43
81
- Do not commit `.env`, `.kagi.toml`, session tokens, or API tokens
0 commit comments