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

## Summary
- Adds `docs/tech-debt-2026-05-26.md` with this repo's findings from the
estate-wide tech-debt scan.

## Companion estate-wide audits
- hyperpolymath/standards#195 — proof-debt
- hyperpolymath/standards#196 — licence-debt
- hyperpolymath/standards#197 — documentation-debt

Records findings only. Closing the debt is follow-up work.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

Author: hyperpolymath

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 — universal-language-server-plugin — 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
+
+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 | 424 |
+| `docs/` files | 2 |
+| `docs/` LoC | 531 |
+| CHANGELOG.md | Y |
+| CONTRIBUTING.md | Y |
+| CODE_OF_CONDUCT.md | Y |
+| SECURITY.md | Y |
+| Severity | `MEDIUM` |
+
+**Recommended next move:** introduce a `docs/` directory. The README at 424 lines has likely grown to do the work of `docs/` — split it into a thin README + `docs/architecture.md`, `docs/usage.md`, etc. Heavy-wiki exemplars to copy from: `affinescript`, `boj-server`, `echidna`, `hypatia`.
+
+## 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.