chore: add human voice ai policy from ai-policy.dev by DogPawHat · Pull Request #11641 · TanStack/query

DogPawHat · 2026-09-25T13:15:32Z

🎯 Changes

https://ai-policy.dev/policies/human-voice

Thanks to @43081j @danielroe @MatteoGabriele for the handy policy reference.

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested code changes locally with pnpm run test:pr, or these tests do not apply to this pull request.
I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

Documentation
- Added guidance for AI-assisted contributions, including expectations that contributors understand their submissions and describe them in their own voice.
- Updated the contribution guidelines to direct AI tool users to the AI contribution policy, which also advises against quoting AI-generated content in issues or pull requests.
- Updated the pull request checklist to require confirmation that contributors followed the policy and understand their submissions.

https://ai-policy.dev/policies/human-voice

coderabbitai · 2026-09-25T13:15:40Z

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository: TanStack/query/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 5c30d8a2-2cdd-480c-ba53-7121c9b03ba2

📥 Commits

Reviewing files that changed from the base of the PR and between 6ef3cda and be7edb1.

📒 Files selected for processing (2)

AI_POLICY.md
CONTRIBUTING.md

💤 Files with no reviewable changes (2)

AI_POLICY.md
CONTRIBUTING.md

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

📝 Walkthrough

Walkthrough

The PR adds an AI contribution policy, updates the contribution guidelines to reference it, and changes the pull request checklist to require confirmation of policy compliance and code understanding.

Changes

AI contribution guidance

Layer / File(s)	Summary
AI contribution policy `AI_POLICY.md`	The policy describes permitted AI use and contributor responsibilities for understanding and explaining contributions, and for writing comments, issues, and pull request descriptions in their own voice.
Contribution guideline integration `CONTRIBUTING.md`, `.github/pull_request_template.md`	The contribution guidelines direct contributors to the policy and retain the automated-agent fast-track note. The pull request checklist asks contributors to confirm policy compliance and understanding of the code.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~8 minutes

Change: Other

Suggested reviewers: kevinvandy

Merge Risk: ⚪ Minimal · up to be7ed

The policy and contribution guidance are consistent, with no identified issue blocking merge.

Architecture Summary

Architecture risk: 🔵 Low · up to 6ef3c

The change affects 2 systems.

Changed systems: AI_POLICY.md, CONTRIBUTING.md

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

observed — AI_POLICY.md (service) was modified; 1 changed file maps to changed impact.
observed — CONTRIBUTING.md (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

observed — Modified behavior in AI_POLICY.md: Added the project’s AI contribution policy: contributors may use AI for code generation and exploration, but must understand and explain their contributions; comments, issues, and pull request descriptions must be in their own voice, and contributors should not quote an LLM in those communications.
observed — Modified behavior in CONTRIBUTING.md: Adds an AI-assisted contributions section requiring contributors who use AI tools to follow AI_POLICY.md, and retains the automated-agent fast-track note.
observed — Modified behavior in CONTRIBUTING.md: Removes the previous AI-assisted contributions section’s two principles requiring contributors to write their own comments, issues, and PR descriptions and to fully understand contributions. Its automated-agent fast-track note is also removed from this former location.
observed — Modified behavior in .github/pull_request_template.md: The checklist item now requires confirmation of compliance with the AI contribution policy as well as understanding of the code; previously it asked only for understanding.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the main change: adding a human-voice AI policy based on ai-policy.dev.
Description check	✅ Passed	The description includes the required Changes, Checklist, and Release Impact sections. The checklist is complete and correctly identifies the change as documentation-only with no release impact.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

nx-cloud · 2026-09-25T14:08:38Z

View your CI Pipeline Execution ↗ for commit 6ef3cda

Command	Status	Duration	Result
`nx affected --targets=test:sherif,test:knip,tes...`	✅ Succeeded	3m 22s	View ↗
`nx run-many --target=build --exclude=examples/*...`	✅ Succeeded	<1s	View ↗

☁️ Nx Cloud last updated this comment at 2026-09-25 14:16:09 UTC

pkg-pr-new · 2026-09-25T14:12:46Z

More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@11641

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@11641

@tanstack/lit-query

npm i https://pkg.pr.new/@tanstack/lit-query@11641

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@11641

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@11641

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@11641

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@11641

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@11641

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@11641

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@11641

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@11641

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@11641

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@11641

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@11641

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@11641

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@11641

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@11641

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@11641

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@11641

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@11641

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@11641

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@11641

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@11641

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@11641

commit: be7edb1

chore: add human voice ai policy from ai-policy.dev

8fd35c5

https://ai-policy.dev/policies/human-voice

DogPawHat marked this pull request as ready for review September 25, 2026 13:21

fix typo pr template

080f9e8

DogPawHat requested a review from a team as a code owner September 25, 2026 13:23

DogPawHat added 2 commits September 25, 2026 14:27

simplfy the contibutions details

dc64676

Fix typo in CONTRIBUTING.md

6ef3cda

TkDodo approved these changes Sep 25, 2026

View reviewed changes

ci: apply automated fixes

be7edb1

TkDodo merged commit 4565791 into TanStack:main Sep 25, 2026
9 checks passed

Navigation Menu

Uh oh!

chore: add human voice ai policy from ai-policy.dev - #11641

chore: add human voice ai policy from ai-policy.dev#11641
TkDodo merged 5 commits into
TanStack:mainfrom
DogPawHat:add-ai-policy-human-voice

DogPawHat commented Sep 25, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Sep 25, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

nx-cloud Bot commented Sep 25, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Sep 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

DogPawHat commented Sep 25, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Sep 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Architecture Summary

Uh oh!

nx-cloud Bot commented Sep 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new Bot commented Sep 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

DogPawHat commented Sep 25, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Sep 25, 2026 •

edited

Loading

nx-cloud Bot commented Sep 25, 2026 •

edited

Loading