docs: record tech-debt audit findings (2026-05-26) (#66)

Adds docs/tech-debt-2026-05-26.md with this repo's findings from the
estate-wide tech-debt scan: proof debt, licence debt, documentation
debt.

This file records the findings only — it does not close the debt.

Cross-references:
- hyperpolymath/standards#195 (estate proof-debt audit)
- hyperpolymath/standards#196 (estate licence-debt audit)
- hyperpolymath/standards#197 (estate documentation-debt audit)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

docs/tech-debt-2026-05-26.md

@@ -0,0 +1,73 @@
+<!--
+SPDX-License-Identifier: MPL-2.0
+SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath)
+-->
+
+# Tech-Debt Audit — stapeln — 2026-05-26
+
+**Source:** estate-wide automated scan 2026-05-26.
+**Companion:** [`hyperpolymath/standards` 2026-05-26-estate-*-debt audits](https://github.com/hyperpolymath/standards/tree/main/docs/audits).
+**Combined severity:** `MEDIUM`.
+
+This file records the *raw findings* — it does not by itself fix the debt. Each section ends with a 'Recommended next move' line; closing the debt is follow-up work.
+
+## 1. Proof debt
+
+Scanner counted the following markers in proof-bearing files of this repo:
+
+```
+files=  102 | Coq-Axm/Adm=   0 | Lean-srry/ax=   0 | Agda-pst=   0 | Idr-blv=  10 | Idr-prtl=  34 | Fstr-asm=  0 | TODO=  0 | Unsafe=  0
+```
+
+**Total markers:** 44. **Severity:** `>044`.
+
+**Marker types** (any non-zero counts above):
+- Coq `Axiom`/`Admitted` — unconditional proof escapes.
+- Lean `sorry`/`axiom` — Lean's equivalent.
+- Agda `postulate` — accepted axiomatically.
+- Idris2 `believe_me`/`assert_total` — runtime-safe coercion / totality assumption.
+- Idris2 top-level `partial` — totality-check waived.
+- F\* `assume val`/`admit_p` — F\* admit.
+- `TODO PROOF` / `OWED:` — self-documented debt markers.
+- `unsafePerformIO`/`unsafeCoerce` — soundness-relevant escape hatches in Haskell/Rust source.
+
+**Recommended next move:** triage each finding into one of: (a) discharge by proof, (b) cover with property-tests + a documented refutation budget, or (c) annotate as a known/necessary axiom (e.g. `funExt`) in `docs/proof-debt.md`.
+
+## 2. Licence debt
+
+| Field | Value |
+|---|---|
+| LICENSE file | `LICENSE` |
+| SPDX header | `PMPL-1.0-or-later` |
+| Manifest licence | `PMPL-1.0-or-later` |
+| Body classifier | `PMPL-1.0-or-later` |
+| Severity | `ok` |
+
+**Recommended next move:** none for licence.
+
+## 3. Documentation debt
+
+| Field | Value |
+|---|---|
+| README lines | 564 |
+| `docs/` files | 14 |
+| `docs/` LoC | 2036 |
+| CHANGELOG.md | N |
+| CONTRIBUTING.md | Y |
+| CODE_OF_CONDUCT.md | Y |
+| SECURITY.md | Y |
+| Severity | `LOW` |
+
+**Recommended next move:** `docs/` has only 14 file(s). Aim for ≥10 organised docs (architecture, usage, contributing-guide, troubleshooting, design-decisions). The user's bar for a "heavily-developed and well-organised wiki" is ≥10 files with topical organisation.
+
+Additionally: **CHANGELOG.md is missing.** 65% of estate repos lack one — adopting a CHANGELOG (or auto-generating via `git-cliff`) is a recommended estate-wide follow-up.
+
+## Cross-references
+
+- Estate proof-debt audit: `hyperpolymath/standards/docs/audits/2026-05-26-estate-proof-debt.md`
+- Estate licence-debt audit: `hyperpolymath/standards/docs/audits/2026-05-26-estate-licence-debt.md`
+- Estate documentation-debt audit: `hyperpolymath/standards/docs/audits/2026-05-26-estate-documentation-debt.md`
+
+---
+
+🤖 Generated by Claude Code estate-wide tech-debt scan (2026-05-26). This file is informational — closing the debt is follow-up work owned by the maintainer.