Add AGENTS.md + tighten contribution flow

- AGENTS.md: public contributor/agent guide (two-file rule, model-centric
  ids, one-entry-per-harness, bilingual notes, screenshot proof)
- PR template: require a generation proof screenshot; drop the manual
  update-registry step; add id-naming and no-README-edit checks
- CI: PRs only run validate-data; pushes to main auto-regenerate and commit
  the README registry (contents:write on that job, [skip ci], no loop)
- README/update-registry: reflect auto-synced registry; fix stale 'two cases'
  -> three (mythos-craft, pelican-cycling, skeleton-watch); link AGENTS.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jesse ZhangandClaude Opus 4.8 committed 2026-06-21 11:29:23 +01:00
1 parent 2fb8499fa8
commit 30983f0e7d
6 files changed
+167 -26

No files matched your search

+26 -2
View File
@@ -14,11 +14,35 @@ jobs:
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- name: Check README registry
run: bun scripts/update-registry.ts --check
- name: Validate contribution data
run: bun scripts/validate-data.ts
sync-registry:
# The README Registry tables are generated from models/*.json. Contributors
# do not edit them by hand; on every push to main we regenerate and commit
# any drift back. Commits pushed with GITHUB_TOKEN do not retrigger
# workflows, and the message carries [skip ci] too, so there is no loop.
if: github.event_name == 'push'
needs: validate
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
- name: Regenerate README registry
run: bun scripts/update-registry.ts
- name: Commit if registry drifted
run: |
if git diff --quiet -- README.md README.en.md; then
echo "Registry already in sync."
exit 0
fi
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git commit -am "chore: sync README registry [skip ci]"
git push origin HEAD:main
trigger-site-rebuild:
# The site lives in the private nagi-bench-site repo (Cloudflare Pages).
# With SITE_DISPATCH_TOKEN set the rebuild is instant; without it the