Skip to content

Add CLAUDE.md project guide and Composio GitHub integration wrapper - #378

Open
kspade21-pixel wants to merge 2 commits into
Conway-Research:mainfrom
kspade21-pixel:claude/claude-md-and-composio-integration
Open

Add CLAUDE.md project guide and Composio GitHub integration wrapper#378
kspade21-pixel wants to merge 2 commits into
Conway-Research:mainfrom
kspade21-pixel:claude/claude-md-and-composio-integration

Conversation

@kspade21-pixel

Copy link
Copy Markdown

Summary

  • Adds CLAUDE.md: guidance for Claude Code covering build/test commands, the subsystem map (agent loop, policy engine, heartbeat, memory, financial system), and the security-sensitive areas that should come with test coverage. Points to the existing ARCHITECTURE.md/DOCUMENTATION.md for full detail rather than duplicating them.
  • Adds src/integrations/composio.ts: a thin wrapper around @composio/core so the automaton can authorize and call third-party toolkits (GitHub first) on behalf of a user via OAuth. Exposes getComposio/isConnected/beginAuthorization/connectToolkit/listToolSlugs/executeTool/getGithubUser as building blocks. Requires COMPOSIO_API_KEY at runtime. Not yet wired into the agent's tool system.
  • Adds the @composio/core dependency and updates pnpm-lock.yaml accordingly.

Anything a reviewer should know

  • pnpm install and pnpm typecheck pass cleanly with these changes.
  • The Composio integration is a standalone module with no existing test coverage or call sites yet — follow-up work would be wiring it into src/agent/tools.ts and adding tests, per the security-sensitive-areas note in the new CLAUDE.md.

Adds guidance for Claude Code covering build/test commands, the
subsystem map (agent loop, policy engine, heartbeat, memory,
financial system), and the security-sensitive areas that should
come with test coverage. Points to ARCHITECTURE.md/DOCUMENTATION.md
for full detail rather than duplicating them.
Thin wrapper around @composio/core (src/integrations/composio.ts) so the automaton can authorize and call third-party toolkits, GitHub first, on behalf of a user via OAuth. Not yet wired into the agent tool system; provides getComposio/isConnected/beginAuthorization/connectToolkit/listToolSlugs/executeTool/getGithubUser as building blocks for that follow-up. Requires COMPOSIO_API_KEY at runtime. Adds the composio/core dependency and updates the lockfile.
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