agent-claw/.kiro/steering/general.md

agent-claw Project Context

This is a Telegram bot running on AWS AgentCore (Bedrock) with Google Workspace integration.

Architecture

• AgentCore runtime: Python 3.14, Strands SDK, Claude Sonnet 4.6
• workspace_mcp Lambda: Mangum/FastMCP + workspace-mcp package, AWS_IAM Function URL auth + SigV4
• tg-ingest Lambda: Telegram webhook ingest → SQS
• agent-runner Lambda: SQS consumer → invokes AgentCore

Key Directories

• agentclaw/app/agent_claw_main/ — AgentCore runtime code (Python)
• cdk/lib/agent-claw-stack.ts — AWS infrastructure (CDK TypeScript)
• src/lambdas/agent-runner/ — SQS → AgentCore bridge
• src/lambdas/tg-ingest/ — Telegram webhook ingest
• src/lambdas/workspace-mcp/ — Google Workspace MCP server
• src/lambdas/oauth-handler/ — Google OAuth callback

Deploy

• CDK: cd cdk && AWS_PROFILE=ai1 npx cdk deploy --require-approval never [context params]
• AgentCore: cd agentclaw && AWS_PROFILE=ai1 agentcore deploy --yes
• Both required for any change

Rules

• Do NOT restart com.openclaw.vikunja-proxy
• Do NOT use mcporter
• Always run both deploy steps after code changes