From 1d414190c1cab59c3471451bfcacba00fe9d91b1 Mon Sep 17 00:00:00 2001 From: Erik van Sebille Date: Fri, 14 Nov 2025 09:19:51 +0100 Subject: [PATCH 1/3] Add a text on AI development policy --- docs/development/policies.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/development/policies.md b/docs/development/policies.md index eae4b3540..b8871f684 100644 --- a/docs/development/policies.md +++ b/docs/development/policies.md @@ -1,5 +1,17 @@ # Policies +## Use of AI in development + +Many developers use AI (and in particular Large Language Models) to help them in their work. These LLMs have received both praise and criticism when it comes to software development. + +We accept that Parcels developers have their own motivation for using (or not using) AI. However, we have one policy that we expect all Parcels developers to follow: + +> It is ultimately your responsibility to understand the code that you commit. + +Remember that reviews are done by human maintainers - asking us to review code that an AI wrote but you don't understand isn't kind to these maintainers. + +Furthermore, we also have an [AI agents policy](/CLAUDE.md) that states how we expect AI agents to engage with Parcels on GitHub. + ## Versioning Parcels follows [Intended Effort Versioning (EffVer)](https://jacobtomlinson.dev/effver/), where the version number (e.g., v2.1.0) is thought of as `MACRO.MESO.MICRO`. From c6bc115f0a8a0e2a9aebdae5782d81d368634987 Mon Sep 17 00:00:00 2001 From: Erik van Sebille Date: Fri, 14 Nov 2025 11:29:22 +0100 Subject: [PATCH 2/3] Update docs/development/policies.md Co-authored-by: Nick Hodgskin <36369090+VeckoTheGecko@users.noreply.github.com> --- docs/development/policies.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development/policies.md b/docs/development/policies.md index b8871f684..18496f989 100644 --- a/docs/development/policies.md +++ b/docs/development/policies.md @@ -2,7 +2,7 @@ ## Use of AI in development -Many developers use AI (and in particular Large Language Models) to help them in their work. These LLMs have received both praise and criticism when it comes to software development. +Many developers use AI Large Language Models to help them in their work. These LLMs have received both praise and criticism when it comes to software development. We accept that Parcels developers have their own motivation for using (or not using) AI. However, we have one policy that we expect all Parcels developers to follow: From c4fee284e48d85cac18071fe0bca31be32c8f326 Mon Sep 17 00:00:00 2001 From: Erik van Sebille Date: Fri, 14 Nov 2025 11:29:39 +0100 Subject: [PATCH 3/3] Update docs/development/policies.md Co-authored-by: Nick Hodgskin <36369090+VeckoTheGecko@users.noreply.github.com> --- docs/development/policies.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development/policies.md b/docs/development/policies.md index 18496f989..43d6b9c8d 100644 --- a/docs/development/policies.md +++ b/docs/development/policies.md @@ -10,7 +10,7 @@ We accept that Parcels developers have their own motivation for using (or not us Remember that reviews are done by human maintainers - asking us to review code that an AI wrote but you don't understand isn't kind to these maintainers. -Furthermore, we also have an [AI agents policy](/CLAUDE.md) that states how we expect AI agents to engage with Parcels on GitHub. +The [CLAUDE.md](/CLAUDE.md) file in the repository has additional instructions for AI agents to follow when contributing to Parcels. ## Versioning