Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Decision log

This is the human-readable index of decisions. Architectural decisions have a full ADR in docs/decisions/.

IDDateDecisionRationaleStatus
D12026-10-21Make MCP the product, not an afterthoughtCheat Engine already exposes a large Lua API; an MCP server delivers value without reimplementing the GUIAccepted, ADR-0001
D22026-10-21Scope the current project to the MCP serverA full Rust clone is a multi-year effort and would delay validation of the MCP designAccepted, ADR-0001
D32026-10-21Use a Lua bridge as the first backendImmediate coverage of the documented API and exact Cheat Engine semanticsAccepted, ADR-0006
D42026-10-21Preserve Cheat Engine write semanticsOnce a process is open, Cheat Engine allows writes; adding a different default would break compatibilityAccepted, ADR-0005
D52026-10-21Use core, full, lua and all tool profilesHundreds of tools in every context would hurt discovery and selectionAccepted, ADR-0004
D62026-10-21Default to stdio; offer Streamable HTTP on localhoststdio is the lowest-overhead local transport; HTTP is needed for multi-client and embedded modeAccepted, ADR-0003
D72026-10-21Use stateless MCP with explicit handlesMCP 2026-07-28 has no sessions; state belongs in the backendAccepted, ADR-0002
D82026-10-21Publish a documentation-only public preview nowMakes the design reviewable and the migration reusable without publishing unfinished codeAccepted, ADR-0008
D92026-10-21Write repository documentation in EnglishStandard for open-source reach and contributionsAccepted
D102026-10-21Do not choose a license yetThe code license decision can wait until implementation; the repository is explicitly marked as a public previewAccepted, ADR-0007
D112026-10-21Use REA CLI + Mach-O inventory first; add Ghidra only if neededThe public source covers most of the architecture; REA should target macOS-specific deltasAccepted, pending execution
D122026-10-21Keep .CT and Cheat Engine Lua compatibilityExisting tables and scripts are the main ecosystem; a clean format would lose that valueAccepted
D132026-10-21Defer the egui desktop GUIThe MCP server and bridge must be validated first; the GUI is a separate client of the same engineSuperseded by D2 for the current scope
D142026-10-21Name the public repository ce-mcpShort, neutral and not implying affiliation with Cheat EngineAccepted

Decisions that were considered and deferred

TopicWhy it is deferred
Full Rust engineRequires reimplementing memory access, scanning, debugger, assembler and the Lua API before the MCP contract is validated
In-app desktop UIA GUI is a large surface and not needed to prove the MCP design
Pointer scanNo obvious Lua API; needs either form automation or a native implementation
Windows/Linux bridgeThe first target is macOS 7.7; the contract should stabilize first
.CETRAINER and trainer generationDepends on a working table and script layer
Multi-agent HTTP serverF1/F4 work; stdio is enough for F0

How decisions are changed

Open a Design proposal issue. If the change is architectural, add a new ADR that supersedes the old one and update this table. Do not rewrite history: a superseded ADR stays in the repository.

Open decisions

  • The implementation license.
  • The exact bridge wire format after the F0 spike.
  • Whether the pointer scan gap is filled natively or through the existing Cheat Engine forms.
  • Whether the first public implementation release supports MCP 2025-11-25 clients.