Source library

This is the shelf I wanted when the project stopped being a codebase and became an archive. Every Markdown document outside the website tree gets a public page: active docs, generated scene specs, archaeology notes, old plans, status reports, and things that are half fossil, half runbook.

The pages are generated. The source files remain canonical. The value here is navigation: each page names the source path, extracts the outline, gives a short read of why that file matters, and links back to GitHub.

Use this with the resource catalog for binary assets, the regtest case shelf for host references, and the Curious Hacker’s Guide for a guided learning path through the machinery.

On this page

• Active PS1 reference
• Archaeology source
• Archived PS1 research
• General project reference
• Generated PS1 research
• Historical archive
• PS1 research worklog
• Project front door
• Repository documentation
• Repository note

Active PS1 reference

• PS1 Port - API Mapping Reference

  docs/ps1/api-mapping.md

• PS1 Audio Implementation Spec

  docs/ps1/audio-optimization-spec.md

• Ocean Ambience — PS1 Implementation Plan

  docs/ps1/background-music-feasibility.md

• PS1 Build System

  docs/ps1/build-system.md

• PS1 Port — Current Status

  docs/ps1/current-status.md

• PS1 Development Workflow

  docs/ps1/development-workflow.md

• Castaway Freeplay And Debug Mode

  docs/ps1/freeplay-mode-design.md

• Hand-Rolled MIPS Assembly — Feasibility Research

  docs/ps1/hand-rolled-asm-feasibility.md

• PlayStation 1 - Hardware Specifications

  docs/ps1/hardware-specs.md

• Holiday Expansion Design

  docs/ps1/holidays-expansion-design.md

• Holiday Art Implementation Plan

  docs/ps1/holidays-implementation-plan.md

• Holiday emblem sheet pipeline

  docs/ps1/holidays-pipeline.md

• Holiday Emblem Style Guide

  docs/ps1/holidays-style-guide.md

• Milestones — 2026-04-25

  docs/ps1/milestones-2026-04-25.md

• Pause Menu Design

  docs/ps1/pause-menu-design.md

• PS1 Performance Experiment Log

  docs/ps1/performance-experiment-log.md

• PS1 Performance Next 100

  docs/ps1/performance-next-100.md

• PS1 -O2 Audit

  docs/ps1/performance-o2-audit.md

• PS1 Scene Playback Performance Optimization Plan

  docs/ps1/performance-optimization-plan.md

• PS1 Foreground Preprocess Opportunity Matrix

  docs/ps1/performance-preprocess-opportunities.md

• PS1 Foreground Read Candidate Matrix

  docs/ps1/performance-read-candidate-matrix.md

• PS1 Port - Project History

  docs/ps1/project-history.md

• Johnny Reborn — PlayStation 1 Port

  docs/ps1/README.md

• PS1 Regression Test Harness

  docs/ps1/regtest-harness.md

• PS1 Headless Regression Testing Harness

  docs/ps1/regtest-quickstart.md

• v0.4.20-ps1 Release Notes

  docs/ps1/release-notes-0.4.20.md

• v0.5.0-ps1 Release Notes

  docs/ps1/release-notes-0.5.0.md

• v0.7.0-ps1 Release Notes

  docs/ps1/release-notes-0.7.0.md

• v0.7.1-ps1 Release Notes

  docs/ps1/release-notes-0.7.1.md

• v0.7.2-ps1 Release Notes

  docs/ps1/release-notes-0.7.2.md

• v0.8.0-ps1 Release Notes

  docs/ps1/release-notes-0.8.0.md

• v0.8.1-ps1 Release Notes

  docs/ps1/release-notes-0.8.1.md

• v0.8.10-ps1 Release Notes

  docs/ps1/release-notes-0.8.10.md

• v0.8.11-ps1 Release Notes

  docs/ps1/release-notes-0.8.11.md

• v0.8.12-ps1 Release Notes

  docs/ps1/release-notes-0.8.12.md

• v0.8.2-ps1 Release Notes

  docs/ps1/release-notes-0.8.2.md

• v0.8.3-ps1 Release Notes

  docs/ps1/release-notes-0.8.3.md

• v0.8.4-ps1 Release Notes

  docs/ps1/release-notes-0.8.4.md

• v0.8.5-ps1 Release Notes

  docs/ps1/release-notes-0.8.5.md

• v0.8.6-ps1 Release Notes

  docs/ps1/release-notes-0.8.6.md

• v0.8.7-ps1 Release Notes

  docs/ps1/release-notes-0.8.7.md

• v0.8.8-ps1 Release Notes

  docs/ps1/release-notes-0.8.8.md

• v0.8.9-ps1 Release Notes

  docs/ps1/release-notes-0.8.9.md

• v0.7.1-ps1 Feature Notes

  docs/ps1/release-plan-0.7.1.md

• Scene Explorer — design doc

  docs/ps1/scene-explorer-design.md

• Scene Picker Algorithms — Research + Design (v2)

  docs/ps1/scene-picker-design.md

• PS1 Scene Pipeline Status

  docs/ps1/scene-status.md

• PS1 Scene Validation Agent Handoff

  docs/ps1/scene-validation-agent-handoff.md

• PS1 Scripted Input Harness

  docs/ps1/scripted-input-harness.md

• PS1 Port Testing Guide

  docs/ps1/TESTING.md

• PS1 Port TODO

  docs/ps1/TODO.md

• PS1 Toolchain Setup

  docs/ps1/toolchain-setup.md

• Visual Detection Spec: Screenshot-Based Scene and Sprite Identification

  docs/ps1/visual-detection-spec.md

• Walk-Connected Story Loop — Implementation Plan

  docs/ps1/walk-implementation-plan.md

• Walk Subsystem — Spot Coordinates and Pre-Flight Audit

  docs/ps1/walk-spot-coordinates.md

• Website Master Plan — Johnny Castaway PS1

  docs/ps1/website-plan.md

Archaeology source

• PS1 Archaeology: Blog Source Map

  docs/ps1/archaeology/blog-source-map.md

• PS1 Archaeology: Memory Constraints

  docs/ps1/archaeology/memory-constraints.md

• PS1 Archaeology: Reporter Notes

  docs/ps1/archaeology/reporter-notes.md

• Retired Scripts — Binary Library Archaeology

  docs/ps1/archaeology/retired-scripts/README.md

Archived PS1 research

• Restore Candidate Report

  docs/ps1/research/archive/2026-03-18-pilot-artifacts/restore_candidate_report_2026-03-18.md

• Restore Pilot Spec

  docs/ps1/research/archive/2026-03-18-pilot-artifacts/restore_pilot_spec_2026-03-18.md

• Restore Pilot Spec

  docs/ps1/research/archive/2026-03-18-pilot-artifacts/restore_pilot_spec_johnny_2026-03-18.md

• Restore Pilot Spec

  docs/ps1/research/archive/2026-03-18-pilot-artifacts/restore_pilot_spec_walkstuf_2026-03-18.md

• Restore Rollout Manifest

  docs/ps1/research/archive/2026-03-19-rollout-snapshot/restore_rollout_manifest_2026-03-19.md

• Research Archive

  docs/ps1/research/archive/README.md

General project reference

• Johnny Reborn - System Architecture

  docs/general/architecture.md

• Johnny Reborn - Branch Structure and Platform Ports

  docs/general/branch-structure.md

• Johnny Reborn - Build Instructions

  docs/general/build-instructions.md

• PS1 Emulator Setup Guide

  docs/general/emulator-setup.md

• Johnny Reborn - Memory Management

  docs/general/memory-management.md

• Quick Start - PS1 Development on Linux

  docs/general/quickstart-linux.md

• Johnny Reborn - Testing Guide

  docs/general/testing-guide.md

Generated PS1 research

• Generated Research Artifacts

  docs/ps1/research/generated/README.md

• Restore Candidate Report

  docs/ps1/research/generated/restore_candidate_report_full_2026-03-19.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-01be6456479e.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-78a8dda15a0d.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-8463f3831c05.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-ba7617a9b24e.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-cc600f374d46.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/activity-ads-cce08eb4bcd4.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/building-ads-1533fe96913e.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/building-ads-50347529e8e2.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/building-ads-9e585b524707.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/building-ads-d55d620d2ee3.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/building-ads-f0332f0909a8.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/fishing-ads-0d4ad9117637.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/fishing-ads-88fb417bdfb4.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/fishing-ads-c6e0ad821661.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/fishing-ads-f32b6fac7f0e.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/johnny-ads-6e547fdb477d.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/johnny-ads-91036ad6c850.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/johnny-ads-cfe5ac96fb8f.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/mary-ads-15d5f3f71aee.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/mary-ads-23e389bae672.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/mary-ads-7fd6377bbf4a.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/mary-ads-86de7bfb6098.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/mary-ads-d3c315d3dc84.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/miscgag-ads-40f9391cb4b7.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/miscgag-ads-993764e013c4.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/stand-ads-97bad97ad5d8.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/stand-ads-b39c6b8ebf4a.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/suzy-ads-08387fe8e04f.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/suzy-ads-56d4ea771a80.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/visitor-ads-1ce431cd95eb.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/visitor-ads-3a234e6f01ae.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/visitor-ads-8c5dbc40f81e.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/visitor-ads-9c6d6b5fa573.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/visitor-ads-d59893d35209.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/walkstuf-ads-069f7e1c435f.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/walkstuf-ads-8fab4126c2db.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-19/walkstuf-ads-daafca374403.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-0ac02941ac27.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-306254dfc4d0.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-37dfc150c7d3.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-ccf58440d356.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-d79dda25b922.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/activity-ads-da9796821a68.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/building-ads-880d26b1085c.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/building-ads-ad99c333603c.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/building-ads-fa82f9b7222d.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/fishing-ads-6dab2548cba7.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/fishing-ads-7434693204b9.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/fishing-ads-9f543a76e974.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/johnny-ads-289fabd14af6.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/johnny-ads-4a43421d8fd7.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/johnny-ads-ed5379fe15a2.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/mary-ads-5a07efbfeaf6.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/mary-ads-5fac37705196.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/mary-ads-b6b3ccb55fef.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/mary-ads-c11a92332075.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/mary-ads-da436c719e02.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/miscgag-ads-a042893bb927.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/miscgag-ads-e227990fd435.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/stand-ads-4639e71e35cb.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/stand-ads-c9d4c9b8c017.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/suzy-ads-45d534135345.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/suzy-ads-83958a78a6bc.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/visitor-ads-0c2807cdc62f.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/visitor-ads-4ba4d3b98d79.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/visitor-ads-d466c70a8992.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/visitor-ads-d7af143bb83b.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/walkstuf-ads-70d5dfb55c92.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/walkstuf-ads-771a194e54f6.md

• Restore Cluster Spec

  docs/ps1/research/generated/restore_cluster_specs_2026-03-21/walkstuf-ads-8266d1f9f7fa.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/activity-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/fishing-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/johnny-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/stand-ads.md

• Restore Pilot Spec Batch

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/summary.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_2026-03-19/walkstuf-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/activity-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/building-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/fishing-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/johnny-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/mary-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/miscgag-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/stand-ads.md

• Restore Pilot Spec Batch

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/summary.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/suzy-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/visitor-ads.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_pilot_specs_full_2026-03-19/walkstuf-ads.md

• Restore Rollout Manifest

  docs/ps1/research/generated/restore_rollout_manifest_2026-03-21.md

• Restore Scene Clusters

  docs/ps1/research/generated/restore_scene_clusters_2026-03-19.md

• Restore Scene Clusters

  docs/ps1/research/generated/restore_scene_clusters_2026-03-21.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-09.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-10.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-11.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/activity-ads-tag-12.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/building-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/fishing-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/johnny-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/mary-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/mary-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/mary-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/mary-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/mary-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/miscgag-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/miscgag-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-09.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-10.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-11.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-12.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-15.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/stand-ads-tag-16.md

• Restore Pilot Spec Batch

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/summary.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/suzy-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/suzy-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/visitor-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/walkstuf-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/walkstuf-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-19/walkstuf-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-09.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-10.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-11.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/activity-ads-tag-12.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/building-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/fishing-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/johnny-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/mary-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/mary-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/mary-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/mary-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/mary-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/miscgag-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/miscgag-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-08.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-09.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-10.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-11.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-12.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-15.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/stand-ads-tag-16.md

• Restore Pilot Spec Batch

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/summary.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/suzy-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/suzy-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-03.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-04.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-05.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-06.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/visitor-ads-tag-07.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/walkstuf-ads-tag-01.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/walkstuf-ads-tag-02.md

• Restore Pilot Spec

  docs/ps1/research/generated/restore_scene_specs_full_2026-03-21/walkstuf-ads-tag-03.md

• Scene Transition and Prefetch Report

  docs/ps1/research/generated/scene_transition_prefetch_report_2026-03-17.md

• Scene Transition and Prefetch Report

  docs/ps1/research/generated/scene_transition_prefetch_report_2026-03-21.md

• Transition / Prefetch Schema Notes

  docs/ps1/research/generated/TRANSITION_PREFETCH_SCHEMA_NOTE_2026-03-21.md

Historical archive

• CLAUDE.md

  docs/archive/CLAUDE.md

• jcreborn — Memory-lite refactor

  docs/archive/MEMORY_OPTIMIZATION_NOTES.md

• PlayStation 1 Automation Testing Skill

  docs/archive/PS1_AUTOMATION_SKILL.md

• PS1 Debug Snippets

  docs/archive/PS1_DEBUG_SNIPPETS.md

• PS1 Debugging Guide - Standardized Workflows

  docs/archive/PS1_DEBUGGING_GUIDE.md

• PS1 Development Guide - Johnny Reborn

  docs/archive/PS1_DEVELOPMENT_GUIDE.md

• Johnny Reborn - PlayStation 1 Port Plan

  docs/archive/PS1_PORT_PLAN.md

• Johnny Reborn - PS1 Port Status

  docs/archive/PS1_PORT_STATUS.md

• Johnny Reborn - PlayStation 1 Port: Complete Project Summary

  docs/archive/PS1_PROJECT_SUMMARY.md

• Johnny Reborn - PlayStation 1 Port

  docs/archive/PS1_README.md

• PS1 Development Environment Setup Notes

  docs/archive/PS1_SETUP_NOTES.md

• PS1 Testing Guide

  docs/archive/PS1_TESTING_GUIDE.md

• PS1 Testing Session 4 - DuckStation Emulator Testing

  docs/archive/PS1_TESTING_SESSION_4.md

• PS1 Testing Session 5 - Graphics Boot Investigation

  docs/archive/PS1_TESTING_SESSION_5.md

• PS1 Sprite Tiling Debug Log

  docs/archive/PS1_TILE_RENDERING_DEBUG.md

• PS1 Toolchain Installation Status

  docs/archive/PS1_TOOLCHAIN_STATUS.md

• PS1 Triangle Rendering - Key Findings

  docs/archive/PS1_TRIANGLE_FINDINGS.md

• PS1 Port - Quick Start Guide

  docs/archive/QUICK_START.md

PS1 research worklog

• PS1 Scene Validation And Debug Prompt

  docs/ps1/research/AGENT_PROMPT_2026-03-29.md

• PS1 Offline-Surface Research Backlog

  docs/ps1/research/BACKLOG.md

• Current PS1 Restore Rollout Status

  docs/ps1/research/CURRENT_STATUS_2026-03-21.md

• Current PS1 Prerender Pilot Status

  docs/ps1/research/CURRENT_STATUS_2026-04-16.md

• Dirty-Region Template Schema

  docs/ps1/research/DIRTY_REGION_TEMPLATE_SCHEMA.md

• Fishing 1 Pixel-Perfect Plan — 2026-04-21

  docs/ps1/research/FISHING1_PIXEL_PERFECT_PLAN_2026-04-21.md

• Foreground Timing Plan 2026-04-13

  docs/ps1/research/FOREGROUND_TIMING_PLAN_2026-04-13.md

• PS1 Foreground Top-Layer Validation Log — 2026-04-13

  docs/ps1/research/FOREGROUND_TOP_LAYER_LOG_2026-04-13.md

• Regtest Harness Worklog — 2026-03-28

  docs/ps1/research/HARNESS_WORKLOG_2026-03-28.md

• PS1 Offline-Surface Implementation Plan

  docs/ps1/research/IMPLEMENTATION_PLAN.md

• Local Vision Classifier Plan

  docs/ps1/research/LOCAL_VISION_CLASSIFIER_PLAN_2026-03-29.md

• Ocean Restore Plan 2026-04-16

  docs/ps1/research/OCEAN_RESTORE_PLAN_2026-04-16.md

• Offline Scene Playback Pivot

  docs/ps1/research/OFFLINE_SCENE_PLAYBACK_PIVOT_2026-04-12.md

• PS1 Pack Manifest Schema

  docs/ps1/research/PACK_MANIFEST_SCHEMA.md

• Pack Payload Layout

  docs/ps1/research/PACK_PAYLOAD_LAYOUT.md

• PS1 Research — Historical Design Logs

  docs/ps1/research/README.md

• PS1 Restore Rollout History

  docs/ps1/research/ROLLOUT_HISTORY.md

• SDL-Compat Lite Specification

  docs/ps1/research/SDL_COMPAT_LITE_SPEC.md

• Transition / Prefetch Schema Notes

  docs/ps1/research/TRANSITION_PREFETCH_SCHEMA.md

• PS1 Scene Validation Log — 2026-03-29

  docs/ps1/research/VALIDATION_LOG_2026-03-29.md

• Vision Classifier Usage

  docs/ps1/research/VISION_CLASSIFIER_USAGE_2026-03-29.md

• Vision Classifier Worklog

  docs/ps1/research/VISION_CLASSIFIER_WORKLOG_2026-03-29.md

• VLM Classifier Plan

  docs/ps1/research/VLM_CLASSIFIER_PLAN_2026-03-29.md

• PS1 Fishing 1 Water Animation Handoff

  docs/ps1/research/WATER_ANIMATION_HANDOFF_2026-04-21.md

• PS1 Fishing 1 Water Animation — Session Worklog 2026-04-21

  docs/ps1/research/WATER_ANIMATION_WORKLOG_2026-04-21.md

Project front door

• Johnny Castaway — PlayStation 1

  README.md

Repository documentation

• Documentation Cleanup Summary

  docs/CLEANUP_SUMMARY.md

• PS1 Port Debugging Guide

  docs/PS1_DEBUGGING.md

• PS1 Left Debug Panel

  docs/PS1_LEFT_DEBUG_PANEL.md

• PS1 Root Cause Execution Plan

  docs/PS1_ROOT_CAUSE_EXEC_PLAN.md

• Johnny Reborn Documentation

  docs/README.md

• Johnny Reborn PS1 Port - Development Handoff Document

  docs/resuming-1-10-2026.md

Repository note

• Johnny Reborn Test Suite

  tests/README.md

• Visual Regression Testing

  tests/VISUAL_TESTING.md