Diagnose the Retrace installation: Node version, workspace roots, write policy, external analyzer availability (Capstone, binutils, radare2, Ghidra, PS2 toolchain, emulators) and the number of registered tools. Run this first in any session.

List the bundled engineering skills (hardware, reverse engineering, graphics, audio, build/validation) with their purpose and path.

Read the full instructions of one bundled skill before performing the matching engineering task.

Show the active safety limits and the level classification of an operation before doing anything destructive.

Inspect an N64 ROM file: detects byte-order format (.z64, .v64, .n64), parses header, entry point, CRC and ROM name.

Identify byte-order format of an N64 ROM without reading entire file.

Scan an N64 ROM for executable MIPS code regions using prologue patterns.

Compare two N64 ROM versions byte-by-byte and report segment differences.

Inspect a PlayStation 2 or MIPS ELF executable: header, machine type, entry point, section count, segment count.

List all sections in a PlayStation 2 ELF binary with memory addresses, sizes, and permissions.

List symbols from .symtab and .dynsym of a PS2 ELF binary.

Locate a function by virtual address within a PS2 ELF binary.

Disassemble raw MIPS machine code instructions (R4300i for N64 big-endian or R5900 for PS2 little-endian) using Capstone engine.

Analyze a MIPS function: detects stack frame size, saved registers (ra, s0-s7, fp), calls, jumps, basic blocks and pseudocode.

Reconstruct a function's structure from MIPS instructions: CFG edges, stack frame, saved registers, parameters, loops and heuristic pseudo-C. Never claims to be original source.

Summarize the repository architecture from its real files: languages, build systems, binaries, symbol/config files, directory ownership and Git state.

Inspect the workspace repository: file tree, detected languages, build tools, binary assets and architecture summary.

Find literal references to a symbol or identifier across repository source files without executing project code.

Search repository code files for symbol names, function signatures, or string patterns.

Analyze dependencies declared in build files (Make, CMake, Cargo, npm) in the repository.

Get git commit history for a file in the repository.

Inspect a virtual memory address: checks which region it belongs to (RDRAM, KSEG, Main RAM, GS registers, VRAM) on N64 or PS2.

Check a pointer for 4-byte or 8-byte alignment, nullness, and architectural valid range.

Detect memory layout collisions between buffers, heaps, display lists, and texture staging areas.

Analyze a crash log or register dump from PCSX2 or an N64 emulator: parses PC, RA, SP, BadVAddr, correlates symbols, and formulates hypotheses.

Calculate N64 texture metadata (format, size, required buffer bytes, completeness) based on format code, size code, width and height.

Analyze an N64 TLUT palette buffer: count transparent vs opaque colors, unique colors, and hex values.

Decode raw N64 texture data into RGBA pixels and PNG image.

Decode a PS2 GS texture (PSMCT32/16/16S, PSMT8/4) from swizzled or linear data, optionally with a CSM2 CLUT, into RGBA and PNG.

Inspect an audio asset file (PS2 VAG, N64 bank, or raw ADPCM) to detect sample rate, channels, and compression.

Decode a 16-byte Sony PS2 VAG ADPCM block into 28 linear 16-bit PCM samples.

Decode a PS2 VAG/VAGi or N64 AIFC VADPCM file to 16-bit PCM WAV. N64 decoding requires the file's own VADPCMCODES codebook and refuses to invent one.

Inspect a decompilation configuration file (YAML, JSON, splat) for functions, segments, and symbols.

Validate the syntax and structure of a decompilation configuration file.

Prepare a safe proposed modification to a decompilation config and inspect the unified diff before applying.

Apply an approved modification proposal to a decompilation configuration file. Requires RETRACE_ALLOW_WRITE=1.

Add or update a node in the project Knowledge Graph (file, function, symbol, structure, texture, audio, crash).

Add or update a relationship edge between two nodes in the Knowledge Graph.

Query related nodes in the Knowledge Graph up to a given depth (e.g. what textures does this function render? What crashes are linked to this address?).

Ingest an ELF, an N64 ROM, or a symbol table into the Knowledge Graph. Extracts only what is actually parsed; no code is decompiled during ingestion.

Generate a structured forensic investigation report as Markdown, JSON, or both. The default is read-only; writing files requires RETRACE_ALLOW_WRITE=1 and write=true.

Inspect real build manifests and report build systems, scripts, targets, toolchain hints and safety warnings without executing commands.

Run one allowlisted build command with shell:false, a workspace-bound cwd, a timeout and no shell metacharacters. Requires RETRACE_ALLOW_WRITE=1 and confirm=true.

Compare two functions across N64 (R4300i) and PS2 (R5900) by canonical instruction shape. Returns exact|structural|probable|unknown and never claims confirmed equivalence.

Rank candidate functions against a reference by canonical instruction-shape similarity.

Record a CONFIRMED N64<->PS2 function equivalence with mandatory evidence. Only this tool can mark equivalence as confirmed.

List recorded confirmed N64<->PS2 equivalences for a workspace.

Build an evidence-driven N64/PS2 porting plan with ISA, ABI, runtime, asset and validation gates.

Translate encoding-preserving MIPS words between N64 and PS2 endian representations. Refuses console-specific instructions unless explicitly allowed.

Validate that a supported N64/PS2 encoding translation round-trips exactly; this is not a semantic equivalence proof.

Create a read-only, reproducible intake record for an authorized N64 to PS2 port project.

Validate a local N64 ROM header, byte order, checksum metadata and hash without copying or modifying it.

Probe optional N64 reversing and PS2 development tools and report which automated stages are actually available.

Analyze an authorized local N64 ROM and produce format, region, entrypoint, checksum, code-region and string metadata.

Run the installed splat CLI against a versioned config and return the generated tree. Dry-run is the default.

Import and analyze an authorized ROM/ELF using Ghidra Headless. Requires explicit write confirmation because Ghidra creates a project.

Run the same reproducible Ghidra Headless import/analyze step under an explicit tool name for pipeline orchestration.

Run the installed N64Recomp CLI with an authorized config. Returns generated output and diagnostics; it never claims a PS2 port.

Run m2c over an authorized assembly file and return candidate C plus raw diagnostics. Candidate code is never treated as recovered source.

Compare two MIPS function byte strings using the internal canonical diff engine and return an explicit unverified match level.

Generate a minimal PS2 port scaffold with CMake, a C entrypoint and an explicit pending-layer checklist.

Alias with an explicit pipeline name for generating the guarded PS2SDK project scaffold.

Launch an authorized PS2 ELF with the installed PCSX2 adapter after explicit confirmation; captures are not claimed unless the configured CLI emits them.

Build a PS2 port workspace through the existing allowlisted build runner. Requires explicit confirmation and RETRACE_ALLOW_WRITE=1.

Persist an attributed reverse-engineering finding in the workspace knowledge graph.

Plan or execute the evidence-driven N64-to-PS2 pipeline. It runs only installed adapters and records blocked stages instead of simulating results.

Read or persist the reproducible project manifest used by the N64-to-PS2 autopilot.

Infer stack locals, globals, arguments, returns and register roles from MIPS dataflow observations. Results are candidates with evidence, not automatic source edits.

Group repeated base-register offsets into candidate structs and fields for N64-to-PS2 variable translation.

Return evidence-ranked names for inferred variables without modifying source files.

Validate inferred variable names, offsets, widths and conflicting observations before an ABI translation is reviewed.

Create a resumable, evidence-driven N64-to-PS2 port job. It preserves the ROM and never claims a port before validation.

Read the last persisted port job, including blocked stages, tool versions, artifacts and source provenance.

Verify that a port project contains inspectable generated source, translated variables and provenance before packaging an ISO.

Build a PS2 ISO from an authorized ELF and project tree using mkisofs/genisoimage. The source tree and SYSTEM.CNF remain in the project.

Verify a PS2 ISO with an installed ISO reader and confirm that SYSTEM.CNF and BOOT.ELF are present. This is a filesystem gate, not a gameplay claim.