Menu
Use when starting work on the ra codebase, navigating the source, or understanding how components connect.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
System design and architecture decisions. Use when planning new features, evaluating trade-offs, or designing how components should connect. Proposes 2-3 approaches and recommends one.
Smart commit workflow. Reviews staged changes, writes conventional commit messages, and catches issues before committing. Use when ready to commit work.
Quality review of completed work. Use after making changes and before claiming completion. Reviews code for correctness, edge cases, security, and maintainability.
Systematic debugging workflow. Use when diagnosing bugs, test failures, or unexpected behavior. Follows a rigorous reproduce โ isolate โ hypothesize โ fix โ verify cycle.
Systematic multi-agent research. Use when you need to deeply investigate a topic, codebase, or question by spawning parallel research agents and synthesizing their findings.
Deep code explanation. Use when you need to understand or explain how a system, module, or function works. Traces data flow, maps dependencies, and explains design decisions.
| name | ra-architecture |
| description | Use when starting work on the ra codebase, navigating the source, or understanding how components connect. |
Every src/ subdirectory has its own CLAUDE.md with detailed docs. This skill gets you oriented fast.
| I want to... | Go to |
|---|---|
| Understand the agent loop | src/agent/CLAUDE.md โ loop.ts |
| Add or modify a tool | src/tools/CLAUDE.md โ tool file โ index.ts |
| Add or modify a provider | src/providers/CLAUDE.md โ provider file โ registry.ts |
| Change config behavior | src/config/CLAUDE.md โ types.ts, defaults.ts, index.ts |
| Work on CLI/REPL/HTTP | src/interfaces/CLAUDE.md โ interface file |
| Write middleware | src/middleware/CLAUDE.md + src/agent/types.ts for context shapes |
| Work on MCP | src/mcp/CLAUDE.md โ client.ts or server.ts |
| Work on memory | src/memory/CLAUDE.md โ store.ts, tools.ts, middleware.ts |
| Work on skills system | src/skills/CLAUDE.md โ loader.ts, runner.ts |
| Work on context discovery | src/context/CLAUDE.md โ index.ts |
| Work on session storage | src/storage/CLAUDE.md โ sessions.ts |
| Find tests | tests/CLAUDE.md โ tests/<module>/ mirrors src/<module>/ |
Config โ Provider + ToolRegistry + Middleware โ AgentLoop โ Interface (CLI/REPL/HTTP/MCP)
| Type | Location | What |
|---|---|---|
IProvider | src/providers/types.ts | LLM adapter: chat() + stream() |
IMessage | src/providers/types.ts | Unified message format across all providers |
ITool | src/providers/types.ts | Tool: name + description + inputSchema + execute() |
StreamChunk | src/providers/types.ts | Streaming response: `text |
MiddlewareConfig | src/agent/types.ts | 9 hook arrays with typed contexts |
CLAUDE.md in the target directorytests/<module>/ for test patternsbun tsc โ bun test โ git diff (use the verify skill)