Skip to content

docs(agents): describe the live catalog pipeline, not registry drafts - #1295

Merged
gildesmarais merged 2 commits into
mainfrom
brain/t2-docs-catalog
Nov 13, 2026
Merged

gildesmarais merged 2 commits into
mainfrom
brain/t2-docs-catalog

Conversation

@gildesmarais

Copy link
Copy Markdown
Member

What changed

  • AGENTS.md ownership list: html2rss-configs owns YAML under lib/html2rss/configs/ and Html2rss::Configs::Catalog; html2rss-web owns GET /api/v1/configs.
  • AGENTS.md contracts: served catalog rows are html2rss-web's Catalog::Entry#to_h — id, path, source, directory, channel, parameters, plus required last_result; source is embedded for packaged configs.
  • AGENTS.md: catalog metadata (directory.*) is authored in html2rss-configs; html2rss-web serves it through the html2rss-configs gem.

Why

The file described the signed-registry pipeline (tool/registry-build, Registry::Sync, registry.id, source: registry | local). None of it exists on the default branches of html2rss-configs or html2rss-web; it lives only in draft PRs. Agents followed instructions for code that isn't there. When the registry work lands, its PRs (here: #1245) carry the matching AGENTS.md change.

Risk

Review map: whole PR is small — start at AGENTS.md.

Validation

  • make lint — exit 0
  • git grep -ni registry -- AGENTS.md — no matches
  • Each named class, path, and field checked against the current default branches of html2rss-configs and html2rss-web

🤖 Generated with Claude Code

gildesmarais and others added 2 commits November 13, 2026 11:15
AGENTS.md described the registry work (signed bundles, tool/registry-build,
Registry::Sync, registry.id, source: registry|local). That work is still a
draft on PR #1245 and is not on main, so it misled agents about the current
contract.

Describe what ships today: YAML under html2rss-configs/lib/html2rss/configs/,
Html2rss::Configs::Catalog entries, html2rss-web serving GET /api/v1/configs
through the html2rss-configs gem, and source: embedded. The registry draft
PR carries its own AGENTS.md change.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
The served row bullet omitted the required last_result that the v2 contract bullet already requires; point it at Catalog::Entry#to_h as owner.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
@gildesmarais
gildesmarais merged commit 19448e6 into main Nov 13, 2026
5 checks passed
@gildesmarais
gildesmarais deleted the brain/t2-docs-catalog branch November 13, 2026 10:35
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