docs: add repository technical audit and roadmap

[TMHSDigital]

Summary

Adds docs/technical-audit.md — a Principal-Engineer audit of the repository capturing:

• Architecture map — reframes the repo as a content/knowledge-pack (skills, rules, snippets, templates, examples + CI tooling), not a runnable add-on.
• Gap analysis — six gaps (G1–G6), including the concrete .cursor-plugin/plugin.json drift bug and the absence of an MCP surface.
• 3-stage roadmap — quick wins, core enhancements, next-gen capabilities.
• Five filed issues — the actionable items, opened as Fix and CI-gate the stale .cursor-plugin/plugin.json manifest #28–Prototype an MCP server exposing the pack as resources + a Blender-Python lint tool #32.

Linked issues

• Fix and CI-gate the stale .cursor-plugin/plugin.json manifest #28 — Fix and CI-gate the stale .cursor-plugin/plugin.json manifest
• Add orphan-content and dead-link validation to CI #29 — Add orphan-content and dead-link validation to CI
• Generalize the smoke harness to per-snippet coverage + emit a coverage table #30 — Generalize the smoke harness to per-snippet coverage
• New skill: performance-and-dense-data (numpy buffer interop + profiling) #31 — New skill: performance-and-dense-data
• Prototype an MCP server exposing the pack as resources + a Blender-Python lint tool #32 — Prototype an MCP server + Blender-Python lint tool

Notes

Docs-only change (docs: prefix), so it does not trigger a release per the conventional-commit gate.

🤖 Generated with Claude Code