From 8f059778ce7d8f47e683e6fa46985acf31816c48 Mon Sep 17 00:00:00 2001 From: jamesread Date: Sun, 26 Jul 2026 00:11:47 +0100 Subject: [PATCH] docs: OliveTin now uses up to Level 2 of 5 AI autonomy. --- AI.md | 10 +++++++--- README.md | 2 +- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/AI.md b/AI.md index 2248078..6d6cd2c 100644 --- a/AI.md +++ b/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. diff --git a/README.md b/README.md index 2223621..1c7c510 100644 --- a/README.md +++ b/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)