docs: complete the README layout tree for all ten packs - #75
Conversation
The tree documented four of the ten packs and carried a note asking readers to browse the directory listing until it caught up. This adds claude_skill, langchain, crewai, autogen, pydantic_ai, and vercel_ai and drops the note. Checking the existing entries against the packs turned up six that had gone stale as rules shipped: CSDK-121..124 and CSDK-130/131, CSDK-204, CSDK-112, CSDK-017/018, OAI-112, and the eight go/csharp/php/rust MCP rules MCP-015..022 — none of which appeared in the tree. Those are corrected here too. Also notes where the ID convention does not hold: autogen numbers its agent rules AG2-001..006 in the tool range, and claude_skill groups CSKILL-NNN by topic rather than scope. Verified mechanically rather than by eye — a script parses the tree, expands the range notation, and diffs the claimed IDs against `- id:` in every file, asserting both directions and that no rule file is left undocumented.
|
Thanks @bradAGI, this is careful work. I walked the whole tree against Two things before I take it. The ID convention sentence is not quite right. It is not two packs: No engine-side pair is needed for this one, Happy to take this once |
The layout tree documented four of the ten packs and carried a note asking readers to browse the directory listing "until this section catches up." This catches it up:
claude_skill/,langchain/,crewai/,autogen/,pydantic_ai/, andvercel_ai/are added and the note is dropped.Checking the existing entries against the packs turned up six that had gone stale as rules shipped. None of these appeared in the tree:
claude_sdk/agent_safety.yaml120/130/131shorthand also hid the real set)claude_sdk/repo.yamlclaude_sdk/subagent_safety.yamlclaude_sdk/tool_definition.yamlopenai_sdk/agent_safety.yamlmcp/tool_definition.yamlThose are corrected here too. The MCP one seemed worth calling out: multi-language MCP coverage is a genuinely notable capability and the README gave no sign it existed.
Also added a line where the ID convention is stated, noting the two packs that don't follow it —
autogen/numbers its agent rules AG2-001..006 in the tool range, andclaude_skill/groups CSKILL-NNN by topic rather than scope. Both currently read as violations of the documented scheme.Verification. Not checked by eye — I wrote a script that parses the tree out of the README, expands the
A-001..005range notation, and diffs the claimed IDs against every- id:in every file, asserting both directions plus "no rule file left undocumented":Happy to contribute that script as a CI check if you'd want the tree kept honest automatically — it's ~40 lines of stdlib Python and would have caught all six drifts at the commit that introduced them. Say the word and I'll open a separate PR.
Deliberately documents only what's on
maintoday, so it doesn't conflict with the rule PRs I have open.