ps2-recomp-Agent-SKILL

Transform your AI Agent into a PlayStation 2 Reverse Engineering God. An autonomous Claude Code skill packing the MIPS R5900 ISA, topological multimodal vision, and the complete PS2Recomp knowledge.

Welcome to the PS2 Recomp Mastery: a complex, hyper-structured Operating System for LLM Agents (like Antigravity or Cursor) that gives them architectural knowledge, procedural workflow and persistent memory required to autonomously reverse engineer and recompile PlayStation 2 games through PS2Recomp project (even if still in dev process).

This guide explains how you, the human driver, should use this skill to extract maximum performance from the AI.

⚠️ How to Treat the Agent

Before using this, you must change how you interact with the LLM. Do not treat it as a chatbot. Treat it as a Junior Reverse Engineer working on your machine.

1. It is Autonomous: The agent runs cmake builds and the game executable directly. Let it work. Do not compile for it unless it specifically asks.
2. It has Persistent Memory: The agent will create a PS2_PROJECT_STATE.md file in your root directory. This is its "external hippocampus". It allows you to pause a session on Monday, start a new chat on Thursday, point to the state file, and the agent will resume exactly where it left off without forgetting what registers it was analyzing.
3. It has Circuit Breakers: If the agent gets stuck in a loop (failing the same crash 3 times), it is programmed to physically stop, read hardware documentation, or ask for your help. It will not burn your tokens infinitely.

🛠️ Prerequisites (Your PC Setup)

For the agent to work flawlessly, your machine must have the following ready:

1. Visual Studio (C++ Desktop Workload): Required for the MSBuild native tools and vcvars64 environment.
   • ⚠️ CRITICAL: You MUST install Clang and Ninja. Open the Visual Studio Installer, go to "Individual Components", and enable **"C++ Clang Compiler for Windows"