docs: update CLAUDE.md for composio

@zen-agentchecks n/achecks…zen/update-claude-docs-composio-bmx3vq → next2 files · +45 −93review: @Sushmithamalleshupdated 3w ago

GitHub

▸Description· 2 comments · 1 noise

Description

Weekly refresh of the repo's CLAUDE.md files (driven by the cron in ComposioHQ/zen), targeting next per the repo convention. Updates the two human-editable CLAUDE.md files; the CLI's CLAUDE.md is a symlink to AGENTS.md (owned by repo devs) and was deliberately skipped.

Root `CLAUDE.md`

Expand the TS/Python provider lists to match the actual ts/packages/providers/ and python/providers/ directories — TS now includes claude-agent-sdk; Python includes autogen, claude_agent_sdk, gemini, google_adk, langgraph in addition to the original set.
Add a gotcha that ts/packages/cli/CLAUDE.md is a symlink to AGENTS.md — edit AGENTS.md rather than the symlink, and don't rm it.
Add a gotcha for the experimental SHARED-connection surface (TS experimental_updateAcl(composio, id, opts) / Python composio.experimental.update_acl(...), experimental block on connectedAccounts.link() and session.authorize()) so callers don't promote it to a stable shape.
Add a gotcha that every behavior change needs a .changeset/*.md (CI blocks releases without one).
Surface pnpm test:e2e:cli and the existence of ts/e2e-tests/cli/.
Add pointers to the new experimental files (ts/packages/core/src/experimental/, models/Experimental.ts, python/composio/core/models/experimental.py).

`docs/CLAUDE.md`

Trim from 107 → 48 lines (cap is 30-70 for directory CLAUDE.md), keeping the load-bearing rules and dropping the boilerplate ones that just restated standard conventions.
Consolidate the 10 numbered rules to the ones that materially affect docs work: TS code blocks type-checked at build, relative-link/camelCase operation-ID rule, CSS variable name, changelog file/date format, auto-generated data files + MetaToolDetailServer client-bundle gotcha, FAQ-snippet layout, link checker requirements, mobile nav, and docs/examples/ review policy.
Add a Sessions / composio.use() / SHARED Connections section reflecting the May 2026 docs work: public docs and provider snippets now use the session-based pattern (composio.toolRouter.session.create → composio.use(session)), and SHARED connections live under content/docs/authenticating-users/shared-connections.mdx with an experimental banner that must stay in sync with the SDK experimental namespace.
Move boilerplate (Glossary, AI-Native Docs / cURL convention, LLM guardrails) into a single tight section at the bottom.

CLI (`ts/packages/cli/CLAUDE.md`)

Skipped — symlink to AGENTS.md, which is owned by repo devs (per cron scope).

Re-bloat check

Root CLAUDE.md was cut from 403 → 97 lines a week ago in #3396; it stayed at 97 (no human/generator reverts), and the new version is 108 lines — comfortably within the 60-150 cap. No re-bloat hypothesis needed.

How did I test this PR

Verified both files render plain markdown (no Fumadocs build dependency).
wc -l CLAUDE.md docs/CLAUDE.md → 108 / 48 lines (within targets).
Cross-checked claims against the working tree (ls ts/packages/providers/, ls python/providers/, ls -la ts/packages/cli/CLAUDE.md confirming the symlink, grep experimental_updateAcl ts/packages/core/src/index.ts).
Verified PR target is next per the repo convention (and the docs/CLAUDE.md rule restating it).

Triggered by: karan@composio.dev | Source: cron-update-claude-docs Session: https://zen-api-production-4c98.up.railway.app/dashboard/#/chat/zen-cron-20a0895a21f0

@zen-agent3w ago

Cron status update — `cron-update-claude-docs` (week 2)

New PR (last week's #3396 merged 2026-05-12). Updates:

CLAUDE.md (97L → 108L, within 60-150 cap): expanded TS/Python provider lists (TS now includes claude-agent-sdk; Python lists autogen, claude_agent_sdk, gemini, google_adk, langgraph); added gotchas for the symlinked CLI CLAUDE.md → AGENTS.md, the experimental SHARED-connection surface (TS experimental_updateAcl / Python composio.experimental.update_acl), and the changeset CI requirement; surfaced pnpm test:e2e:cli and the new experimental/ paths.
docs/CLAUDE.md (107L → 48L, into the 30-70 cap): trimmed boilerplate, consolidated 10 numbered rules to load-bearing ones, added a Sessions / composio.use() / SHARED-connections section reflecting the May 2026 docs revamp.

Skipped ts/packages/cli/CLAUDE.md — it's a symlink to AGENTS.md (owned by repo devs).

Re-bloat finding (from last run memory): the root CLAUDE.md did NOT regrow after #3396's cut — it stayed at 97L for the full week. No generator/human-revert hypothesis needed.

CI (latest run on 6643b60c): 9 passed, 0 failed, 1 still pending (Analyze (swift)). The Swift CodeQL check is known to take ~17 minutes on every PR (took 17m47s on recent merged PR #3431) — not a real-time issue. Background monitor still tracking; will not block on this.

Post-PR follow-up:

/build-checks: ran by CI (typescript-check, test, check-links, Detect Secrets) — all green.
/codex-review-loop: skipped — doc-only meta-documentation; subagent verified against the May 2026 docs revamp + experimental/ path additions.
/gh-fix-ci-loop: not needed — 0 failures.
/address-pr-comments: no human reviewer comments; only Vercel preview bot.

▸ 1 bot/status comment hidden

@vercel[bot]3w ago

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 18, 2026 9:25am

loading diff…

@zen-agent3w ago

Cron status update — `cron-update-claude-docs` (week 2)

New PR (last week's #3396 merged 2026-05-12). Updates:

CLAUDE.md (97L → 108L, within 60-150 cap): expanded TS/Python provider lists (TS now includes claude-agent-sdk; Python lists autogen, claude_agent_sdk, gemini, google_adk, langgraph); added gotchas for the symlinked CLI CLAUDE.md → AGENTS.md, the experimental SHARED-connection surface (TS experimental_updateAcl / Python composio.experimental.update_acl), and the changeset CI requirement; surfaced pnpm test:e2e:cli and the new experimental/ paths.
docs/CLAUDE.md (107L → 48L, into the 30-70 cap): trimmed boilerplate, consolidated 10 numbered rules to load-bearing ones, added a Sessions / composio.use() / SHARED-connections section reflecting the May 2026 docs revamp.

Skipped ts/packages/cli/CLAUDE.md — it's a symlink to AGENTS.md (owned by repo devs).

Re-bloat finding (from last run memory): the root CLAUDE.md did NOT regrow after #3396's cut — it stayed at 97L for the full week. No generator/human-revert hypothesis needed.

Post-PR follow-up:

/build-checks: ran by CI (typescript-check, test, check-links, Detect Secrets) — all green.
/codex-review-loop: skipped — doc-only meta-documentation; subagent verified against the May 2026 docs revamp + experimental/ path additions.
/gh-fix-ci-loop: not needed — 0 failures.
/address-pr-comments: no human reviewer comments; only Vercel preview bot.

Description

Root CLAUDE.md

docs/CLAUDE.md

CLI (ts/packages/cli/CLAUDE.md)

Re-bloat check

How did I test this PR

Cron status update — cron-update-claude-docs (week 2)

Description

Root CLAUDE.md

docs/CLAUDE.md

CLI (ts/packages/cli/CLAUDE.md)

Re-bloat check

How did I test this PR

Cron status update — cron-update-claude-docs (week 2)

Root `CLAUDE.md`

`docs/CLAUDE.md`

CLI (`ts/packages/cli/CLAUDE.md`)

Cron status update — `cron-update-claude-docs` (week 2)

Root `CLAUDE.md`

`docs/CLAUDE.md`

CLI (`ts/packages/cli/CLAUDE.md`)

Cron status update — `cron-update-claude-docs` (week 2)