Browse Source

docs: OliveTin now uses up to Level 2 of 5 AI autonomy.

jamesread 1 month ago
parent
commit
8f059778ce
2 changed files with 8 additions and 4 deletions
  1. 7 3
      AI.md
  2. 1 1
      README.md

+ 7 - 3
AI.md

@@ -5,14 +5,18 @@
 - [x] The project does not include any AI functionality at runtime.
 - [x] No data, usage, or similar is sent to, or analyized by AI.
 
+## Development - Autonomy level
+
+OliveTin development uses up to **Level 2 of 5 (pair programmer)** on the [AI Levels of Autonomy in Software Engineering](https://blog.jread.com/posts/ai-levels-of-autonomy-in-software-engineering/) scale: AI may generate suggestions and non-trivial changes, but humans review and decide what lands in the project.
+
 ## Development - Contributions
 
 - [x] The project **does accept** contributions that were written with AI help. **However**:
-  - The contribution must be attributed to a human username who takes responsibility for the code as if they wrote it themselves. 
-  - AI often generates very unmaintainable code as it gets longer - loads of duplication, very little function re-use amd very poor at following style guides / idiomatic design. All code contributions (AI or not) are scrutinized hard for **maintainability** and **clean merging**. Please follow the CONTRIBUTORS guide. 
+  - The contribution must be attributed to a human username who takes responsibility for the code as if they wrote it themselves.
+  - AI often generates very unmaintainable code as it gets longer - loads of duplication, very little function re-use amd very poor at following style guides / idiomatic design. All code contributions (AI or not) are scrutinized hard for **maintainability** and **clean merging**. Please follow the CONTRIBUTORS guide.
   - AI that helps with short tab completion is generally fine.
   - AI that writes lots of new code across lots of files, or makes lots of superfluous changes is generally less likely to be accepted.
-  - Vibe coding is not a suitable way to contribute to this project. 
+  - Vibe coding is generally not a suitable way to contribute to this project.
 - [x] Contributors should declare when AI has been used to help write contributions in the pull request body message.
 - [x] The project uses AI as an **optional** part of the PR process (coderabbitai). Please raise any concerns about usage within the PR.
   - [x] Suggestions from coderabbitai can be accepted verbaitem, but ideally it should be the PR author that uses coderabbitai as a guide, who then re-writes the contribution.

+ 1 - 1
README.md

@@ -10,7 +10,7 @@
 [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/5050/badge)](https://bestpractices.coreinfrastructure.org/projects/5050)
 
 [![Go Report Card](https://goreportcard.com/badge/github.com/Olivetin/OliveTin)](https://goreportcard.com/report/github.com/OliveTin/OliveTin)
-[![AI Autonomy Level](https://img.shields.io/badge/AI%20Autonomy-Level%201%20of%205%20(assistance--only)-blue)](https://blog.jread.com/posts/ai-levels-of-autonomy-in-software-engineering/)
+[![AI Autonomy Level](https://img.shields.io/badge/AI%20Autonomy-Level%202%20of%205%20(pair--programmer)-blue)](https://blog.jread.com/posts/ai-levels-of-autonomy-in-software-engineering/)
 
 [OliveTin 2k to 3k upgrade guide](https://docs.olivetin.app/upgrade/2k3k.html)
 </div>