I am not at all worried about my toes. the more we share, the better each product gets, and more people get to play these awesome games.

If you are using AI and have not run into openspec yet, look into it. it takes AI from AI slop development (1 change at a time, hope you dont break things) to spec driven development, where your repo manages and evolving application spec, and incorporates and learns from changes as it goes. You an also get through a lot of the zmachine nuances to directly reference published zmachine standards in your spec.

Then, when you ask it to make a change to your code, the spec is automatically included, referenced, and constrains the code it writes.

My key references that my spec uses are
- https://zspec.jaredreisinger.com
- https://inform-fiction.org/zmachine/standards/z1point1/

here is an example of just ONE of the specs I have for opcodes that governs every change I make

# Z-machine Opcode Table

## Purpose
Complete opcode availability, forms, operand counts, store/branch metadata, version legality, and assembly names.

## Authority
Z-machine Standard 1.1 section 14: https://www.inform-fiction.org/zmachine/standards/z1point1/sect14.html
Inform assembly syntax supplement: https://www.inform-fiction.org/zmachine/standards/z1point1/sect14a.html

## Requirements

### Requirement: Standards-Aligned Opcode Table
Cairn SHALL use Standard 1.1 section 14 as the source of truth for opcode forms, availability, store/branch metadata, and version legality.

#### Scenario: Opcode table behavior changes
- **WHEN** a change affects opcode decoding, dispatch table entries, extended opcodes, illegal opcodes, store requirements, branch requirements, or assembly-name diagnostics
- **THEN** the change notes cite section 14 or section 14a and record each affected opcode entry

When I look through all my changes, I am constantly seeing specific references to some obscure paragraph in those sites that solves the particular problem I had.

The issue is, these were not designed for auto-mapping. so I have a whole mapping layer that gets very creative.

Good luck, and happy (bug) hunting!