From 636965ad546aeea4ffbb49cc3bd6a90da6555ad8 Mon Sep 17 00:00:00 2001
From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com>
Date: Tue, 26 May 2026 12:47:34 +0100
Subject: [PATCH] docs: record tech-debt audit findings (2026-05-26)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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>
---
 docs/tech-debt-2026-05-26.md | 55 ++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 docs/tech-debt-2026-05-26.md

diff --git a/docs/tech-debt-2026-05-26.md b/docs/tech-debt-2026-05-26.md
new file mode 100644
index 0000000..a9a004b
--- /dev/null
+++ b/docs/tech-debt-2026-05-26.md
@@ -0,0 +1,55 @@
+<!--
+SPDX-License-Identifier: MPL-2.0
+SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath)
+-->
+
+# Tech-Debt Audit — aspasia — 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:** `LOW`.
+
+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
+
+No proof-bearing files (`*.v`, `*.lean`, `*.agda`, `*.idr`, `*.idr2`, `*.fst`, `*.dfy`, `*.tla`, `*.ads`, `*.adb`) found in this repo.
+
+**Recommended next move:** none.
+
+## 2. Licence debt
+
+| Field | Value |
+|---|---|
+| LICENSE file | `LICENSE` |
+| SPDX header | `MPL-2.0` |
+| Manifest licence | `NONE` |
+| Body classifier | `Palimp-MPL-2.0` |
+| Severity | `ok` |
+
+**Recommended next move:** none for licence.
+
+## 3. Documentation debt
+
+| Field | Value |
+|---|---|
+| README lines | 204 |
+| `docs/` files | 10 |
+| `docs/` LoC | 1040 |
+| CHANGELOG.md | Y |
+| CONTRIBUTING.md | Y |
+| CODE_OF_CONDUCT.md | Y |
+| SECURITY.md | Y |
+| Severity | `LOW` |
+
+**Recommended next move:** `docs/` has only 10 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.
+
+## 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.