diff --git a/docs/porting-notes.md b/docs/porting-notes.md
index 1d39ff9a..66650a61 100644
--- a/docs/porting-notes.md
+++ b/docs/porting-notes.md
@@ -1112,6 +1112,7 @@ made mutually acceptable (dual validation / one-time migration).
   writing anything new; same Rare engine family.
 - Don't re-investigate a closed §F finding or re-derive a format spec
   that already has a converter.
+- **`docs/dev/findings-index.csv` is generator-derived** (`tools_pc/gen_findings_index.py`): the status cell is normalised from the `## Dxx` entry's §F summary-table row in `findings.md`, so hand-editing the CSV is silently reverted on the next regen (hit live in the D219/D252 M-158 session). Update the table row, then run the generator.
 - **Every game launch rewrites `data/ge007.eep`** (the eeprom shim stores on
   every write; validation resets, cheat patches and normal saves all write).
   When restoring a specific save artifact for a controlled test (e.g. an issue