Imported from ProjectConsolation/Client (.agents-reverse-engineer/AGENTS.md). Install upstream with npx skills add ProjectConsolation/Client --skill .agents-reverse-engineer. Copyright stays with the author.

.agents-reverse-engineer

config.yaml controls agents-reverse-engineer discovery, summarization, AI execution, and telemetry, while GENERATION-PLAN.md records the post-order documentation queue for ConsolationClient.

Session Startup and Context Recovery

The following steps are executed sequentially only when a new task truly begins:

1. Read this document in its entirety.

2. Check git status --short --branch and recent commits to identify user changes, completed work, and the current branch.

3. Prioritize the current state of files, code, tests, and runtime processes; do not treat historical current statements in chat summaries or research documents as real-time facts.

Project Goals

A partial reverse engineering of Quantum of Solace, including additional features. The end goal is a full game client reverse engineered to the point of being able to attach a debugger, rebuilding Xlive as a emulation layer for full offline support, to stable in-game gameplay.

Fixed success responses that temporarily advance the UI, hard-coded gamestate, or manual snapshots etc should only serve as probes indicating the level of implementation and should not be used to masquerade as completed implementations.

Decision Priorities

When conflicts arise, weigh the following in order:

1. The user's current clear goal and informed decisions.

2. QoS' xref, decompilation, wire bytes, runtime tracing, and repeatable testing.

3. Existing module boundaries in the repository, long-term maintainability, and data security.

4. Reference implementations such as COD4, WaW, BO1/KisakBlack, and PDB.

Do not override QoS evidence simply because reference projects have similar function names, nor mechanically implement solutions that clearly deviate from the final goal because the user's initial description was incomplete.

Engineering Principles

• Prioritize source code and native implementations; retain closed-source components only as clear compatibility boundaries that have not yet been replaced.

• Prioritize reusing QoS' own functions, states, and serialization; the relevant COD code is a blueprint, not a directly bindable implementation.

• The structure should be as close as possible to the traceable naming of WAW/COD4, but the final standard should be QoS evidence and the clarity of the current code.

• When reverse engineering, ** WaW PDB, CoD4 PDB, and BO1 Windows x86 server/KisakBlack must be checked simultaneously before implementation or modification**; do not rely solely on BO1 or a single community source code. Compare algorithms, control flow, responsibility boundaries, state ownership, and native code organization; BO1/KisakBlack should only be added when there are divergences between COD4/WAW, QoS is located between the two. QoS-confirmed differences must be retained; if any mandatory check item is unavailable, it can only be marked as incomplete verification, not claimed to have been restored in the native way.

• Clearly distinguish the responsibilities of the control plane, player persistence, and authoritative gameplay; whether to deploy in the same process is an implementation phase choice, without blurring logical boundaries.

• Do not use string searches to support reverse engineering conclusions alone. Addresses, offsets, ABIs, structures, and call relationships must have xref, decompilation, dynamic tracing, or wire evidence.

• Temporary hooks, binary patches, and synthetic probes must specify their purpose, applicable build, verification conditions, and exit path.

• Fix scale should match risk to test coverage. Shared protocols, persistence, and cross-module contracts require automated regression; do not treat "success received" as a side effect restoration.

• Allow the cleanup of worthless builds, duplicate documentation, and obsolete implementations in the repository; the scope and value must be verified before deleting user data, external reference libraries, or non-reproducible files.

Contents

• config.yaml defines exclude, options, output, generation, and ai settings for traversal, compression, backend execution, retries, concurrency, and telemetry.
• GENERATION-PLAN.md defines the 2892-task documentation manifest, including 2549 file tasks, 343 directory tasks, and post-order traversal metadata.

Configuration

exclude.patterns, exclude.vendorDirs, and exclude.binaryExtensions define traversal exclusions; options.followSymlinks defaults to false, and options.maxFileSize defaults to 1048576.

output.colors defaults to true, while generation.compressionRatio is 0.25 with a documented 0.1–1.0 range and annex bypass behavior.

ai.backend currently selects codex, ai.model currently selects gpt-5.6-luna, ai.timeoutMs is 300000, ai.maxRetries is 3, and ai.telemetry.keepRuns retains 50 logs.

Workflow

GENERATION-PLAN.md executes Phase 1: File Analysis (Post-Order Traversal) before Phase 2: Directory AGENTS.md (Post-Order Traversal, 343 directories).

Depth 9 through Depth 0 group directory tasks by path depth, [ ] marks pending tasks, and ./AGENTS.md is the final root-level task.

File Relationships

config.yaml supplies runtime configuration for the generation process, while GENERATION-PLAN.md acts as both the queued input and execution manifest.

AGENTS.md is the generated directory-level artifact expected at every directory listed by GENERATION-PLAN.md.

Behavioral Contracts

• Generated: 2026-08-31 records the plan creation date.
• Project: C:\Users\vamp\source\repos\ConsolationClient identifies the repository root.
• Total Tasks: 2892, File Tasks: 2549, and Directory Tasks: 343 define required task counts.
• Traversal: Post-order (children before parents) defines execution order.
• [ ] is the pending-task sentinel.
• AGENTS.md is the exact generated filename.
• ./AGENTS.md is the final root-level directory task.
• ai.backend accepts claude, codex, gemini, opencode, or auto.
• ai.concurrency documents a 1–20 range, with machine default 20.
• exclude.patterns includes exact rules for AGENTS.md, AGENTS.override.md, CLAUDE.md, OPENCODE.md, GEMINI.md, *.lock, .env, *.log, **/*.sum, **/SKILL.md, test/spec globs, automation/config globs, infrastructure globs, deps/**, _tmp_iw4x_gamepad/**, .github/**, and .vscode/**.
• exclude.vendorDirs includes node_modules, vendor, deps, .git, dist, build, __pycache__, .next, venv, .venv, target, .cargo, .gradle, .agents-reverse-engineer, .agents, .planning, .claude, .codex, .opencode, and .gemini.
• exclude.binaryExtensions includes .png, .jpg, .jpeg, .gif, .bmp, .ico, .webp, .zip, .tar, .gz, .rar, .7z, .exe, .dll, .so, .dylib, .mp3, .mp4, .wav, .pdf, .woff, .woff2, .ttf, .eot, .class, and .pyc.