Skip to content

Draw which agents Chock wires and how strongly each holds (RD-9) - #405

Merged
jothimani-rajendran merged 3 commits into
mainfrom
rd9-agents-picture
Nov 20, 2026
Merged

jothimani-rajendran merged 3 commits into
mainfrom
rd9-agents-picture

Conversation

@jothimani-rajendran

@jothimani-rajendran jothimani-rajendran commented Nov 20, 2026 •

Copy link
Copy Markdown
Collaborator

What

A picture, "Where each coding agent can be stopped", in the harness diagram's style (README palette only): one card per agent in SURFACE_AGENTS, in three dashed boxes (one plugin tested live, one plugin untested, git hook and CI). Each card has diamond chips: CI and commit filled (refuses), pre-tool hollow and labelled with its grade (no chip when none), AGENTS.md hollow.

  • docs/assets/readme/agents_data.py derives agents.json from SURFACE_AGENTS, in_agent_grade, agentseam's matrix and the plugin warnings data. derive.py readme runs it.
  • agents.mjs lays it out; render.mjs writes v2/agents.png.
  • Linked from docs/adapters/README.md. The README, where-chock-sits*, matrix.png and .chock/ are untouched.

Tests

tests/test_readme_agents.py: agents.json equals what the code derives now; rows equal SURFACE_AGENTS; cells and counts agree with surfaces, grades and the README summary; display names are the README table's; title and footer wording; no text typed into the layout; no overflow (crowded); the PNG exists at 2x width.

🤖 Generated with Claude Code

agents.json is derived from SURFACE_AGENTS, in_agent_grade, agentseam's matrix and
the plugin warnings data by the same command that refreshes the README blocks.
agents.mjs lays it out; render.mjs writes v2/agents.png (README palette) and
v2/agents-site.png (site palette). Tests fail when the code moves an agent
without the picture, when text overflows a card, or when the two renders differ.

Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
Per the updated plan: README palette only, one card per agent in three dashed
boxes (one plugin tested live, one plugin untested, git hook and CI), diamond
chips for CI, commit, pre-tool (labelled with its grade) and AGENTS.md, the
title "Where each coding agent can be stopped", Chock named only in the footer.
The site render, its PNG and the grid layout are removed.

Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com>
Chips are laid out by the browser in one row per card, so none has an empty
tail and none wraps. The footer names the chock version and the agentseam
version instead of a branch commit that will not exist on main.

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 November 20, 2026 01:23
@jothimani-rajendran
jothimani-rajendran merged commit 27fcc37 into main Nov 20, 2026
26 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