Skip to content

docs(readme): guardrails section counts 324 matrix cells, not 192 - #206

Merged
jothimani-rajendran merged 1 commit into
mainfrom
readme-counts
Oct 16, 2026
Merged

jothimani-rajendran merged 1 commit into
mainfrom
readme-counts

Conversation

@jothimani-rajendran

Copy link
Copy Markdown
Collaborator

What this changes

"Guardrails, not guarantees" said 0 of 192 matrix cells, but "How it works" said 324. I recounted from matrix.enforcement_level() over every MATRIX agent × contract.EVENTS and got 27 × 12 = 324 cells: 203 none, 74 detect, 45 best-effort, 2 enforceable, 0 enforced. So 324 is right and 192 was stale. I changed the one wrong number.

I added tests/test_readme_counts.py. It recounts three things from the matrix and fails when the README disagrees:

  • the italic tally line (cells, agents, events, and the count at each level)
  • every "N of M matrix cells are graded enforced" claim
  • the pre_tool count in each row of the level table (1 enforceable, 16 best-effort, 0 detect, 10 none, 0 enforced)

I checked that the test fails against the old README (the 192 claim) and passes now.

Claim check

No adapter or matrix change, so nothing here applies.

Checks

  • pytest -q passes (2616 passed, 6 skipped)
  • ruff check . and ruff format --check . pass
  • Runtime path is still stdlib-only (only a test was added)
  • Commits are signed off (git commit -s)

Notes for the reviewer

The other counts in the README already match the matrix: the 17 agents with a pre_tool adapter and the 27 agents in the matrix.

🤖 Generated with Claude Code


Generated by Claude Code

Recounted from matrix.enforcement_level() over 27 agents x 12 events:
324 cells (203 none, 74 detect, 45 best-effort, 2 enforceable, 0 enforced).
tests/test_readme_counts.py recomputes the tally line, every
"N of M matrix cells are graded enforced" claim and the pre_tool level
table from the matrix, so the README cannot drift again.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
@jothimani-rajendran
jothimani-rajendran marked this pull request as ready for review October 16, 2026 11:06
@jothimani-rajendran
jothimani-rajendran merged commit 64e7270 into main Oct 16, 2026
16 checks passed
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.

1 participant