# Project Frankenstein Engineering Specification (PFES)

**Revision:** 0.15.6  
**Authority:** canonical Git `main`, accepted annotated `pfes-v*` tags, and matching hash-verified cumulative release ZIPs

PFES is the engineering constitution, operating manual, technical reference,
evidence-status system, and institutional memory for Project Frankenstein. It
governs optical-drive firmware analysis, media engineering, emulator work,
hardware validation, project incubation, repository admission, provenance, and
artifact retention.

## Canonical repositories

| Repository | Purpose | Canonical location |
|---|---|---|
| PFES | Specification, evidence status, decisions, and history | `/srv/project-frankenstein/repos/pfes.git` |
| xbox-dvd-tools | HLDS analyzer chain and Windows host/hardware tools | `/srv/project-frankenstein/repos/xbox-dvd-tools.git` |
| mn103s-emulator | MN103S execution core and GDR-8050L bridge | `/srv/project-frankenstein/repos/mn103s-emulator.git` |
| friidump | Maintained FriiDump application and drive profiles | `/srv/project-frankenstein/repos/friidump.git` |

Large firmware, media, generated traces, analyzer outputs, and evolving
incubation packages live in managed artifact storage rather than ordinary Git.

## Incubating projects

| Project | State | Repository |
|---|---|---|
| MN103S Optical-Drive IDE Recovery Programmer | Rev B0; PCB-layout handoff | Deferred until repository-readiness gate |

Start at
[`Migration/Project_Incubation/MN103S_IDE_RECOVERY_PROGRAMMER/AGENT_HANDOFF.md`](Migration/Project_Incubation/MN103S_IDE_RECOVERY_PROGRAMMER/AGENT_HANDOFF.md)
when transferring this project to another engineer or agent.

## Start here

- [`HANDOFF.md`](HANDOFF.md) — workstream routing and five-minute continuation brief.
- [`NEXT_WORK_PLAN.md`](NEXT_WORK_PLAN.md) — ranked near-term work.
- [`PFES_CURRENT_STATE.json`](PFES_CURRENT_STATE.json) — machine-readable state.
- [`DOCUMENT_MAP.md`](DOCUMENT_MAP.md) — document roles and reading paths.
- [`Volume_I_Constitution/`](Volume_I_Constitution/) — durable authority and principles.
- [`Volume_II_Engineering_Manual/`](Volume_II_Engineering_Manual/) — reusable workflow.
- [`Volume_III_Technical_Reference/`](Volume_III_Technical_Reference/) — schemas, contracts, and formats.

## Current workstreams

- analyzer-chain refinement: indirect/table-driven command discovery, especially
  READ DVD STRUCTURE `0xAD`, without unnecessary Stage5B reruns;
- MN103S emulator v259 in its separate workstream;
- MN103S recovery programmer incubation through ERC, mechanical verification,
  layout/DRC, and read-only first-article planning.

## Current scope

The present architecture focus is Panasonic MN103S-based HLDS firmware.
GDR-8081N board evidence identifies `HD62602AFD1`; it remains outside this
MN103S-focused effort unless a separate architecture project is admitted.

## Preservation limitation

The repositories, release ZIPs, and recovery bundles currently reside on one
physical HDD. They are recovery aids, not independent backups. Keep at least
15% of the project filesystem free and add an independent physical backup when
hardware becomes available.
