From e8ad435ccb7643b106a052ef82f07ea355a5a4a2 Mon Sep 17 00:00:00 2001 From: Grant Date: Tue, 14 Jul 2026 00:17:46 -0600 Subject: [PATCH 1/2] docs: add ai policy --- AI_POLICY.md | 49 +++++++++++++++++++++++++++++ CONTRIBUTING.md | 2 ++ doc/contributing/getting-started.md | 2 ++ 3 files changed, 53 insertions(+) create mode 100644 AI_POLICY.md diff --git a/AI_POLICY.md b/AI_POLICY.md new file mode 100644 index 0000000..c7aa924 --- /dev/null +++ b/AI_POLICY.md @@ -0,0 +1,49 @@ + + + +# AI Usage Policy + +The Canvas project has strict rules for AI usage: + +- **All AI usage in any form must be disclosed.** You must state + the tool you used (e.g. Claude Code, Cursor, Amp) along with + the extent that the work was AI-assisted. + +- **The human-in-the-loop must fully understand all code.** If you + can't explain what your changes do and how they interact with the + greater system without the aid of AI tools, do not contribute + to this project. + +- **Issues and discussions can use AI assistance but must have a full + human-in-the-loop.** This means that any content generated with AI + must have been reviewed _and edited_ by a human before submission. + AI is very good at being overly verbose and including noise that + distracts from the main point. Humans must do their research and + trim this down. + +- **No AI-generated media is allowed (art, images, videos, audio, etc.).** + Text and code are the only acceptable AI-generated content, per the + other rules in this policy. + +## There are Humans Here + +Please remember that Canvas is maintained by humans. + +Every discussion, issue, and pull request is read and reviewed by +humans. It is a boundary point at which people interact with each +other and the work done. It is rude and disrespectful to approach +this boundary with low-effort, unqualified work, since it puts +the burden of validation on the maintainer. + +In a perfect world, AI would produce high-quality, accurate work +every time. But today, that reality depends on the driver of the AI. +And today, most drivers of AI are just not good enough. So, until either +the people get better, the AI gets better, or both, we have to have +strict rules to protect maintainers. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index aeadbbe..a89fd57 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -21,6 +21,8 @@ Feature requests & general questions can also be [put in the issue tracker][issu Information on how to setup a development environment & project structure can be found [on the wiki][wiki] or in the `/doc/contributing` folder +If you are planning on utilizing an AI model/agent in your contributions, review [our AI policy](./AI_POLICY.md). + ## sc07.dev At time of writing [sc07.dev](https://sc07.dev) has registration approvals enabled. After creating an account an admin will have to approve the account. To accelerate the process, send a message in the mailing list/Matrix/Discord to grab grant's attention. diff --git a/doc/contributing/getting-started.md b/doc/contributing/getting-started.md index c5070da..51041db 100644 --- a/doc/contributing/getting-started.md +++ b/doc/contributing/getting-started.md @@ -35,6 +35,8 @@ Have a suggestion or modification that you need feedback on? Send it [to the mai The project is setup as a monorepo, with the frontend, backend and admin interface all in one place. +If you are planning on utilizing an AI model/agent in your contributions, review our AI policy (located in the project root at `/AI_POLICY.md`). + ### Prerequisites - [Docker](https://www.docker.com/) -- GitLab From 08ef9006ad2d89c61b2fefa96529a09e3f4789ea Mon Sep 17 00:00:00 2001 From: Grant Date: Tue, 14 Jul 2026 00:32:00 -0600 Subject: [PATCH 2/2] fix lint --- CONTRIBUTING.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a89fd57..8ad65e7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,19 +1,21 @@ +# Contributing + Thank you for considering contributing to the Canvas project! > [!note] > This is a shortened version of `/doc/contributing` (also viewable [on the wiki][wiki]) -# Reporting Issues +## Reporting Issues **If your issue is a security issue,** look at [SECURITY.md](./SECURITY.md) Otherwise, [create an issue in the tracker][issue] or send an email to the mailing list ([canvas@sc07.dev][mailing]) -## Feature Requests / General Questions +### Feature Requests / General Questions Feature requests & general questions can also be [put in the issue tracker][issue] or [in the mailing list][mailing] -# Development +## Development [![Development Mailing List](https://img.shields.io/badge/mailing_list-development-orangered)](https://lists.sc07.com/postorius/lists/canvas.sc07.dev/) [![Matrix](https://img.shields.io/matrix/canvas-meta%3Aaftermath.gg?style=flat&logo=matrix)](https://matrix.to/#/#canvas-meta:aftermath.gg) @@ -23,7 +25,7 @@ Information on how to setup a development environment & project structure can be If you are planning on utilizing an AI model/agent in your contributions, review [our AI policy](./AI_POLICY.md). -## sc07.dev +### sc07.dev At time of writing [sc07.dev](https://sc07.dev) has registration approvals enabled. After creating an account an admin will have to approve the account. To accelerate the process, send a message in the mailing list/Matrix/Discord to grab grant's attention. -- GitLab