ps2-recomp-Agent-SKILL

<p align="center">
<img width="512" height="512" alt="Ps2-Recomp-Agent-SKILL" src="https://github.com/user-attachments/assets/ef6a9300-ea65-4364-9a67-75602ebf59a5" />
</p>

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](https://visualstudio.microsoft.com/) (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"