Guide¶
Recipes and workflows for humans and AI agents. For normative guarantees (schemas, enums, payload semantics), use the Contracts book.
Who is this for?
- Developers — install, CI, first analysis run
- Agent authors — MCP workflows, change control, memory recipes
- IDE and agent users — VS Code, Cursor, Claude Code, Codex, Claude Desktop setup
Start here¶
| I want to… | Page |
|---|---|
| Install and run locally | Getting started |
| Understand the pipeline | How CodeClone works |
| Connect an AI agent via MCP | MCP overview |
| Govern agent edits | Change control overview |
| Scope context before edits | Engineering Memory overview |
| Inspect trajectory history and patterns | Trajectories and Experiences |
| Diagnose CodeClone's own runtime (maintainer) | Platform Observability |
| Cluster historical agent intents (maintainer) | Corpus Analytics |
MCP workflows¶
| Task | Recipe |
|---|---|
| First analysis pass | Analyze & triage |
| Hotspots and checks | Drill down & checks |
| Declare → edit → finish | Change control |
| Memory before/after edits | Memory recipes |
| Cobertura join & session markers | Coverage join & session markers |
Integrations¶
| Client | Setup guide | Contract |
|---|---|---|
| VS Code | Setup | Contract |
| Cursor | Install & skills | Contract |
| Claude Code | Install | Contract |
| Codex | Install | Contract |
| Claude Desktop | Setup | Contract |
| SARIF export | Export | Contract |