docs: add an AI policy and agent instructions - #5377

Open

marcoscaceres wants to merge 26 commits into

mainfrom

Commits on Aug 4, 2026

docs: add an AI policy
marcoscaceres
committed
5215a63
docs(ai-policy): split audiences, add responsibility clause, scope the label
marcoscaceres
committed
c9ce3d2
docs(ai-policy): the two-model process is ours, not a contributor requirement
marcoscaceres
committed
b47d17e
docs(ai-policy): state the house style for PR bodies, commits, and comments
marcoscaceres
committed
9692abf
docs(ai-policy): resolve the brevity vs issue-accounting conflict
marcoscaceres
committed
3a9b72b
docs(ai-policy): fix the labeling mechanism, add a privacy rule, scope the test rules
marcoscaceres
committed
f37ab08
docs: point contributors, human and otherwise, at the AI policy
marcoscaceres
committed
992b930
docs: show the mascot on CONTRIBUTING, keep both at a sane size
marcoscaceres
committed
fc46573
docs(ai-policy): name the work we keep away from an agent
marcoscaceres
committed
f170b03
chore: add Copilot repository instructions and agent setup steps
marcoscaceres
committed
4b75bc5
chore(copilot): keep the browser download, put the build in the canonical sequence
marcoscaceres
committed
bd1c0eb
chore(copilot): require BROWSERS, keep the browser in the workspace, correct two claims
marcoscaceres
committed
a4214f6
fix(copilot): install the browser explicitly, not via puppeteer's postinstall
marcoscaceres
committed
1241754
fix(copilot): set the puppeteer cache per step, since job env is not honored
marcoscaceres
committed
a2ac8ec
chore(eslint): ignore the in-workspace puppeteer cache
marcoscaceres
committed
4976f34
docs(copilot): note the workspace browser cache is not for humans
marcoscaceres
committed
d261f36
chore(copilot): dynamic import in the browser probe, shorter image alt text
marcoscaceres
committed
59a59e8

Commits on Aug 5, 2026

docs(ai-policy): welcome Co-Authored-By for the model that wrote it

marcoscaceres
and
claude
committed
9023d2f
docs: commit a CLAUDE.md, keeping personal notes in CLAUDE.local.md

marcoscaceres
and
claude
committed
2b9664c
docs: drop a dead pointer and un-stale the headings API note

marcoscaceres
and
claude
committed
4cca610
docs: drop two CI notes that no longer hold

marcoscaceres
and
claude
committed
ca58627
docs: soft wrap, and fix four things Sid caught

marcoscaceres
and
claude
committed
d49d965
docs: require proof that a bug reproduced before the fix

committed
2913f47

Commits on Aug 19, 2026

Merge branch 'main' into docs/ai-policy
marcoscaceres
authored
57ab72a
Apply suggestions from code review
marcoscaceres
authored
332d14f
Apply suggestion from @marcoscaceres
marcoscaceres
authored
f954f27