# Complete Documentation Consolidation - 2026-04-01

## Summary

This pass consolidated the remaining markdown documentation outside `public/docs/` into the docs tree, added category hubs, and replaced the hard-coded `/dev/docs` slug map with a filesystem-backed route.

## Route Changes

- Replaced `src/app/dev/docs/[slug]/page.tsx` with `src/app/dev/docs/[...slug]/page.tsx`.
- Added curated aliases and sidebar categories in `src/lib/docs-catalog.ts`.
- Added markdown link resolution for relative doc links.

## New Canonical Docs

- `public/docs/PROJECT_OVERVIEW.md`.
- `public/docs/developer/AI_OPERATING_PROTOCOL.md`.
- `public/docs/developer/modules/*`.
- `public/docs/operations/BILLING_PRODUCTION_CHECKLIST.md`.
- `public/docs/operations/SECURITY_AUDIT_REPORT.md`.
- `public/docs/operations/FLY_RCLONE_UTILITIES.md`.
- `public/docs/prompts/*`.
- `public/docs/user-guide/*`.

## Verification Checklist

- [x] Audit script added at `scripts/audit-all-docs.sh`.
- [x] Audit report generated at `docs-audit-report.txt`.
- [x] Inventory generated at `docs-inventory.md`.
- [x] `/dev/docs` redirects to a canonical index.
- [x] Nested docs render from `public/docs`.
- [x] New category hubs exist for user, developer, operations, and prompts.

## Follow-Up

- Review legacy oversized markdown files in `public/docs/` and split the ones that still exceed the repository size target.
- Remove or replace duplicate source-folder README files after the consolidated copies are fully adopted.