referencelisted
Install: claude install-skill ajitta/know-your-unknowns
# Reference — A Reference Is Another Map
Best way to give a model a map: **give it another map**.
Origin: Point at a Reference — see skills/loop/references/talk-source.md.
## Iron Rule
**Reference is not an answer to copy verbatim — it is material for understanding intent and behavior.**
Before implementing, **prove comprehension** with a semantics map.
## Procedure
1. Read reference to the end; summarize **intent, core behavior, invariants**.
2. Present 4-category analysis:
- **Behaviors to preserve** — the reference's reason to exist
- **Parts to transform for current environment** — language/framework/scale differences
- **Unnecessary or dangerous parts** — must not be brought into this project
- **Parts improvable beyond the reference** — where we can do better
3. For port/transform work, also present **proof of comprehension (semantics map)**:
key reference excerpts ↔ new-environment counterparts side by side, gotcha points
where behavior subtly differs, and an edge-case table with a **Match** column —
identical / equivalent / changed ("equivalent" = same decision, different surface).
Number every note and row so a correction can name one.
4. Contrast with current project conventions (code style, dependencies, test
approach); present an **application plan**.
5. **Sign-off gate — nothing is implemented until the user signs off.** They reply
`semantics confirmed`, or correct any row by its number ("note 5", "budget
exhaustion row") and