Donate to Postulo/postulo

• https://buymeacoffee.com/tiagoagueda

---

See the documentation for more details on donation links.

docs: AGENTS.md for every assistant, a code of conduct, an accessibility statement #1009

Merged

tiagoagueda merged 2 commits from 939-agents-md into main 2026-10-19 09:30:10 +00:00

Conversation 0 Commits 2 Files changed 15 +398 -113

tiagoagueda commented 2026-10-18 21:39:33 +00:00

Owner

• Copy link
• Copy Markdown

Closes #939
Closes #1007
Closes #1008
Closes #1011

• #939 — CLAUDE.md is renamed to AGENTS.md and worded for any assistant. The new CLAUDE.md is the single line @AGENTS.md, as the Claude Code docs recommend: not a symlink, and not the per-person /config option. tests/test_contribution_rules.py holds CLAUDE.md to that one import. README, CONTRIBUTING, the tests that read the file and the core/cells.py docstring now point at AGENTS.md, and .github/README.md is regenerated.
• #1007 — CODE_OF_CONDUCT.md is the Contributor Covenant 2.1 as published. The contact is filled in with the maintainer's address, and a preface names the spaces it covers (Forgejo, Weblate, the GitHub mirror). The preface also says plainly that, with one maintainer, a report about the maintainer has nobody else to go to yet. It is registered in THIRD-PARTY.md (CC BY 4.0).
• #1008 — ACCESSIBILITY.md, the statement #41 asked for:
  • WCAG 2.2 AA as the aim, with the status "partially conformant", because no complete manual audit has been published;
  • what is done, and the options under Settings → Accessibility;
  • how it is checked (axe-core in both themes, the page-coverage test, the template lints);
  • the known limits;
  • how to report a barrier without an account;
  • what an instance's operator still answers for.
• #1011 — found on this branch when its rebase was force-pushed: CI's translation guard crashed with git merge-base <before> HEAD exiting 128, because the commit the branch pointed at before the push was no longer in the checkout. A base the guard cannot find now makes it read the branch since origin/main, as a new branch already did, and say so. Every commit the push brought is still read. A test covers it.

The README and CONTRIBUTING link both new files, and a test keeps those links in place.

Library check: the code of conduct is the standard Contributor Covenant rather than one written here. The guard fix is two calls to git.

Model use: written with Claude Code, and reviewed by the person who opens the PR.

Full unit suite: 18,991 passed locally before the rebase. After it, the doc, changelog and guard tests pass.

🤖 Generated with Claude Code

Closes #939 Closes #1007 Closes #1008 Closes #1011 - **#939** — `CLAUDE.md` is renamed to `AGENTS.md` and worded for any assistant. The new `CLAUDE.md` is the single line `@AGENTS.md`, as the Claude Code docs recommend: not a symlink, and not the per-person `/config` option. `tests/test_contribution_rules.py` holds `CLAUDE.md` to that one import. README, CONTRIBUTING, the tests that read the file and the `core/cells.py` docstring now point at `AGENTS.md`, and `.github/README.md` is regenerated. - **#1007** — `CODE_OF_CONDUCT.md` is the Contributor Covenant 2.1 as published. The contact is filled in with the maintainer's address, and a preface names the spaces it covers (Forgejo, Weblate, the GitHub mirror). The preface also says plainly that, with one maintainer, a report about the maintainer has nobody else to go to yet. It is registered in `THIRD-PARTY.md` (CC BY 4.0). - **#1008** — `ACCESSIBILITY.md`, the statement #41 asked for: - WCAG 2.2 AA as the aim, with the status "partially conformant", because no complete manual audit has been published; - what is done, and the options under Settings → Accessibility; - how it is checked (axe-core in both themes, the page-coverage test, the template lints); - the known limits; - how to report a barrier without an account; - what an instance's operator still answers for. - **#1011** — found on this branch when its rebase was force-pushed: CI's translation guard crashed with `git merge-base <before> HEAD` exiting 128, because the commit the branch pointed at before the push was no longer in the checkout. A base the guard cannot find now makes it read the branch since `origin/main`, as a new branch already did, and say so. Every commit the push brought is still read. A test covers it. The README and CONTRIBUTING link both new files, and a test keeps those links in place. **Library check:** the code of conduct is the standard Contributor Covenant rather than one written here. The guard fix is two calls to git. **Model use:** written with Claude Code, and reviewed by the person who opens the PR. Full unit suite: 18,991 passed locally before the rebase. After it, the doc, changelog and guard tests pass. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

tiagoagueda added 1 commit 2026-10-18 21:39:33 +00:00

docs: AGENTS.md for every assistant, a code of conduct, an accessibility statement ... a7cc52b933

The instructions for AI assistants lived in CLAUDE.md, which only Claude Code reads. They
are now AGENTS.md, the file Codex, Copilot, Cursor and others read, worded for any
assistant, and CLAUDE.md is the single line `@AGENTS.md`: an import works on every Claude
Code version and setting, where reading AGENTS.md beside CLAUDE.md is a per-person option
and a symlink breaks on Windows clones. A test holds CLAUDE.md to that one line, so a rule
cannot land where only one assistant would see it. README, CONTRIBUTING, the tests that
read the file and a docstring point at AGENTS.md.

CODE_OF_CONDUCT.md adopts the Contributor Covenant 2.1 as published, with the contact
filled in and a preface naming the spaces it covers (Forgejo, Weblate, the mirror) and
saying plainly that, with one maintainer, a report about the maintainer has nobody else to
go to yet. THIRD-PARTY.md registers it (CC BY 4.0).

ACCESSIBILITY.md is the statement #41 asked for: WCAG 2.2 AA as the aim, "partially
conformant" because no complete manual audit has been published, what is done, the
options under Settings -> Accessibility, how axe-core and the lints check it, the known
limits, how to report a barrier without an account, and what an operator still answers for.

Closes #939
Closes #1007
Closes #1008

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tiagoagueda force-pushed 939-agents-md from a7cc52b933 to 84dc738913 2026-10-19 06:21:52 +00:00 Compare

tiagoagueda referenced this pull request 2026-10-19 07:27:00 +00:00

CI: the translation guard crashes on a force-pushed branch #1011

tiagoagueda added 1 commit 2026-10-19 07:30:50 +00:00

Read the branch from origin/main when the guard's base is gone ... 83a360197c

On a push, CI hands the translation guard github.event.before, the commit the branch
pointed at before the push. A force-push leaves that commit out of the checkout, so
`git merge-base <before> HEAD` exited 128 and the step died with a traceback, as it did on
this branch after its rebase. A base git does not know now takes the path a new branch
already took: every commit since the branch left origin/main, which includes every commit
the push brought, so nothing goes unread. The guard says which path it took.

Closes #1011

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tiagoagueda merged commit 4eafdc0480 into main 2026-10-19 09:30:10 +00:00

tiagoagueda referenced this pull request from a commit 2026-10-19 09:30:11 +00:00

Merge pull request 'docs: AGENTS.md for every assistant, a code of conduct, an accessibility statement' (#1009) from 939-agents-md into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

accessibility

Usable by everyone, including people with disabilities: one of the project's stated missions

  

authentication

Signing in, and proving who you are

  

breaking change

Changes behaviour or data in a way operators must act on

  

bug

Something does not do what it says it does

  

documentation

The wiki, the docs, or the words in the interface

  

enhancement

An improvement or a new capability

  

interface

The shape of the pages: what is where, and how it reads

  

internationalisation

Languages, regions, and the formats and symbols that go with them

  

observability

What an operator can see about a running instance: metrics, logs, health

  

performance

Uses fewer resources, or is more reliable, with no loss of features or accessibility

  

security

Keeping the code and the data secure: one of the project's stated missions

  

tier

1

Easy: small, self-contained, no prerequisites

  

tier

2

High-severity security: account access, personal data, the boundaries

  

tier

3

Foundations: prerequisite work that unblocks other issues

  

tier/4

Later: large features and long-horizon work

No labels

accessibility

authentication

breaking change

bug

documentation

enhancement

interface

internationalisation

observability

performance

security

tier

1

tier

2

tier

3

tier/4

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

Postulo/postulo!1009

No description provided.