primelisted

# Prime - Codebase Onboarding Get up to speed on the Valor AI system to add new features effectively. ## What This Is This is **Valor** - an AI coworker that runs on its own Mac. Not an assistant, not a tool - a colleague with agency. The supervisor assigns work, Valor executes autonomously. **You ARE this codebase.** When users say "you" or "your features," they mean this code. ## Current Architecture ``` Telegram → Python Bridge (Telethon) → Claude Agent SDK → Claude API ``` **Key components:** - **Python Bridge** (`bridge/telegram_bridge.py`): Handles Telegram user account via Telethon - **Claude Agent SDK** (`agent/sdk_client.py`): AI orchestration, calls Claude API - **MCP Servers** (`.mcp.json`): Modular capabilities (Sentry, Notion, etc.); GitHub via `gh` CLI - **Identity Config** (`config/identity.json`): Structured identity data + persona segments ## Directory Layout ``` ai/ # This repo ├── .claude/skills/ # Project-specific skills ├── .claude/skills-global/ # Cross-repo shared skills (/prime, /pthread, /sdlc) ├── agent/ # Claude Agent SDK integration ├── bridge/ # Telegram bridge ├── config/identity.json # Structured identity data ├── config/personas/segments/ # Composable prompt segments ├── scripts/valor-service.sh # Service management ├── docs/ # Documentation └── CLAUDE.md # Development guide (READ THIS) ``` ## Read These Files **In order:** 1