Skip to content

Simplify AI policy to tool-neutral expectations - #152

Merged
BenWestgate merged 2 commits into
reviewability-v1from
claude/project-thread-wn08u4
Oct 20, 2026
Merged

BenWestgate merged 2 commits into
reviewability-v1from
claude/project-thread-wn08u4

Conversation

@BenWestgate

Copy link
Copy Markdown
Owner

Requested by Ben · project thread

Before: docs/developer/AI_POLICY.md (adapted from ripgrep/uv) banned AI-written comments and agent-driven PRs, required that you "could have written the code yourself", sent questions to bitcoin-core/meta, and CONTRIBUTING.md linked it at a path that doesn't exist (/doc/AI_POLICY.md).

After: a short, tool-neutral policy. Use any tools; do your best; understand and be able to defend what you submit; a human is the responsible author (no tools as authors/co-authors); unverified or low-effort submissions may be closed. Saying which tools you used is welcome, not required. Security-critical changes still get a security review. Questions go to this repo's issues. CONTRIBUTING.md links the right path.

This follows Linus Torvalds' 13 Oct 2026 reply to Laurent Pinchart ("no rules that say you can't use tools for X"; expect people to understand what they submit) and the kernel's generated-content.rst / coding-assistants.rst (only humans sign off; you must understand and defend everything you submit). The kernel is deprecating its Assisted-by tag, so disclosure here is optional.

How: rewrite of one doc plus a one-line link fix. Docs only; no code or tests touched.


Generated by Claude Code

Drop the "don't use AI for X" rules (no AI-written comments, no
agent-driven pull requests, "could have written it yourself") in favour
of the expectations Linus Torvalds set out on 13 October 2026: do your
best and understand what you submit, whatever tools you use. Keep the
rule that a human is the responsible author, matching the kernel's rule
that only humans add Signed-off-by. Disclosure becomes optional, as the
kernel is deprecating its Assisted-by tag.

Also point questions at this repository instead of bitcoin-core/meta and
fix the broken policy link in CONTRIBUTING.md.

Claude-Session: https://claude.ai/code/session_01CyYhzPMXTLB9GFMVWHDhtv
@BenWestgate BenWestgate self-assigned this Oct 19, 2026
@BenWestgate
BenWestgate marked this pull request as ready for review October 19, 2026 21:16
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-20T04:35:18.633663Z 447554e New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@BenWestgate
BenWestgate force-pushed the claude/project-thread-wn08u4 branch from 71481e7 to a028b3c Compare October 20, 2026 04:08

@BenWestgate BenWestgate left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a few questions before I can merge.

Comment thread docs/developer/AI_POLICY.md Resolved
Comment thread docs/developer/AI_POLICY.md Resolved
Comment thread docs/developer/AI_POLICY.md Resolved
Comment thread docs/developer/AI_POLICY.md Resolved
Comment thread docs/developer/AI_POLICY.md Resolved
Per review: keep "should be able to describe the problem in your own
words" for issues and "must be able to explain the changes" for pull
requests (without requiring a hand-written body), restore the human
author who chooses the work and answers for it, and say understanding
means being able to defend the change, not knowing every detail.

Claude-Session: https://claude.ai/code/session_01CyYhzPMXTLB9GFMVWHDhtv

@BenWestgate BenWestgate left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@BenWestgate
BenWestgate merged commit e418548 into reviewability-v1 Oct 20, 2026
23 checks passed
@BenWestgate
BenWestgate deleted the claude/project-thread-wn08u4 branch October 20, 2026 05:37
BenWestgate added a commit that referenced this pull request Oct 20, 2026
Old topic branches can retain superseded contribution rules, as happened while addressing PR #144 after #152 merged. Require agents to consult the current target-branch contributor guide and AI policy before acting on a PR.

State that the tool-neutral policy permits AI-written descriptions and review replies while keeping publication within the user-authorized scope. The maintainer explicitly approved this AGENTS.md patch.

Validation: reviewed the exact approved patch, checked referenced local paths, and ran git diff --check. Documentation only; application tests are not applicable. Refs #144 and #152.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants