From f72807c36ea12d4c6006f70d289f2bfc901b16af Mon Sep 17 00:00:00 2001 From: Tim Nunamaker Date: Mon, 27 Jul 2026 17:06:21 -0500 Subject: [PATCH] docs: align AI disclosure policy Assisted-by: AI Signed-off-by: Tim Nunamaker --- AGENTS.md | 2 +- CONTRIBUTING.md | 11 ++++++----- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b01dbbc2b..ae6956573 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,7 +7,7 @@ Policy: [CONTRIBUTING.md](./CONTRIBUTING.md). - Sign off commits (`git commit -s`); unsigned are blocked. -- Disclose AI assistance: `Assisted-by: AI` trailer (opt-in hook: `PDPP_AI_ASSISTED=1`). +- Disclose meaningful AI assistance: `Assisted-by: AI` on each assisted commit and as the final standalone PR-description line. - Prose (PRs, issues, comments): technical, no filler, no emojis. What changed and why, briefly. - Reject verbose summaries. Concise unless the change is a refactor, break, or architecture. - Claims about the code need a file path or a reason. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 13cd1a746..4a156a51d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -33,11 +33,12 @@ contract changes, test expectations, and pull-request conventions. ## AI assistance -Building with AI is welcome. If AI helped meaningfully, add an `Assisted-by: AI` -trailer to the commit so reviewers can calibrate their scrutiny; a local hook can -add it for you (`.github/hooks/prepare-commit-msg`). It is vendor-neutral and sits -alongside your DCO sign-off. We review contributions on whether they are good, not -how they were made. +Building with AI is welcome. If AI helped meaningfully, add `Assisted-by: AI` +to each assisted commit and as a standalone final line in the pull request +description so reviewers can calibrate their scrutiny; a local hook can add the +commit trailer for you (`.github/hooks/prepare-commit-msg`). It is +vendor-neutral and sits alongside your DCO sign-off. We review contributions on +whether they are good, not how they were made. ## Spec-first workflow (OpenSpec)