# Documentation hygiene log

**Last Updated:** 2026-04-08

Single entry point for **documentation system maintenance**, superseding overlapping “audit complete / final handoff / improvements summary” files at `docs/` root.

## What to use day to day

| Need | Document |
|------|-----------|
| How to update docs | [DOCUMENTATION_MAINTENANCE_PROCESS.md](DOCUMENTATION_MAINTENANCE_PROCESS.md) |
| Naming / structure | [DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md) |
| Regenerate inventory + redundancy | `make docs-redundancy` (or `make docs-inventory` then `python3 scripts/documentation/check-redundancy.py`) |
| Durable notes not overwritten by inventory | [DOCUMENTATION_INVENTORY_MANUAL_NOTES.md](DOCUMENTATION_INVENTORY_MANUAL_NOTES.md) |
| Full file list (machine) | [documentation-inventory.json](documentation-inventory.json) |
| Slim human index | [DOCUMENTATION_INVENTORY.md](DOCUMENTATION_INVENTORY.md) |
| Redundancy patterns | [DOCUMENTATION_REDUNDANCY_REPORT.md](DOCUMENTATION_REDUNDANCY_REPORT.md) |
| Project-wide doc next steps | [DOCUMENTATION_NEXT_STEPS.md](DOCUMENTATION_NEXT_STEPS.md) |
| Master navigation | [DOCUMENTATION_MASTER_INDEX.md](DOCUMENTATION_MASTER_INDEX.md) |
| Why `docs/` / repo file counts are huge | [DOCUMENTATION_SCALE_AND_SCOPE.md](DOCUMENTATION_SCALE_AND_SCOPE.md) |

## Archived root meta-docs (2026-04-01)

The following files were **moved** to [archive/2026-04-01-docs-cleanup/docs-root-meta-audits/](archive/2026-04-01-docs-cleanup/docs-root-meta-audits/) to reduce duplicate “status complete” narratives. **Duplicates at `docs/<filename>.md` were removed**; the living copies are **only** under that archive folder (plus Git history).

| Former `docs/` root name | Notes |
|-------------|--------|
| `FINAL_DOCUMENTATION_AUDIT_SUMMARY.md` | Final audit summary (Jan 2026 era) |
| `DOCUMENTATION_FINAL_HANDOFF.md` | Framework handoff |
| `DOCUMENTATION_IMPROVEMENTS_SUMMARY_2026.md` | Improvements summary |
| `COMPREHENSIVE_AUDIT_COMPLETE.md` | Comprehensive audit completion |

## Stale root reports bucket (2026-04-01)

Dozens of **one-off audits, validation snapshots, gap matrices, and superseded plans** that previously cluttered `docs/*.md` were moved to [archive/2026-04-01-docs-cleanup/stale-docs-root/](archive/2026-04-01-docs-cleanup/stale-docs-root/) (see README there).  
`docs/DOCUMENTATION_GAPS.md` at root is a **short pointer**; the full 2026 gap write-ups are in that folder.

## Changelog

- **2026-04-10:** Dienstplan pillar FAQ refresh: `docs/content/pages/pillar-pages/dienstplan/` research artifacts (`data/gsc-queries.json`, SISTRIX JSON), `KEYWORD_DECISION.md`, `SERP_ANALYSIS.md`, `COMPETITIVE_ANALYSIS.md`; playbook [`DATA_COLLECTION_PILLAR.md`](content/pages/pillar-pages/DATA_COLLECTION_PILLAR.md); scripts `v2/scripts/pillar-pages/collect-pillar-keywords-sistrix.php`, `collect-pillar-keyword-serp.php`.
- **2026-04-08:** ROI-Rechner Schichtplanung FAQ/SEO research sprint: `DATA_DRIVEN_SYNTHESIS.md`, `FAQ_INTENT_MATRIX.md`, `WEB_COMPETITIVE_SNAPSHOT_2026-04-08.md`, `keywords-candidate.json`; Checklist-Zeile in [TOOL_FAQ_REFRESH_CHECKLIST.md](content/tools/_templates/TOOL_FAQ_REFRESH_CHECKLIST.md) zu SERP-/Primary-Keyword-Mismatch; Backlog-Zeile [TOOLS_SEO_IMPROVEMENT_BACKLOG.md](content/tools/TOOLS_SEO_IMPROVEMENT_BACKLOG.md).
- **2026-04-03:** Completed Cursor quality-hardening pass: added [CURSOR_RULE_SKILL_CENSUS.md](ai/CURSOR_RULE_SKILL_CENSUS.md), [CURSOR_SKILL_CONFLICT_MATRIX.md](ai/CURSOR_SKILL_CONFLICT_MATRIX.md), [CURSOR_RULE_SKILL_SSOT_MAP.md](ai/CURSOR_RULE_SKILL_SSOT_MAP.md), warning-first quality scripts (`scripts/ai/check-rule-size-and-noglob.py`, `scripts/ai/check-skill-trigger-quality.py`), Makefile/CI wiring, and pointerized long no-glob rule bodies into [docs/ai/rules-archive/](ai/rules-archive/).
- **2026-04-03:** Added continuous Cursor optimization governance stack in `docs/ai/`: `CURSOR_CONTINUOUS_OPTIMIZATION_PROGRAM.md`, `CURSOR_OPTIMIZATION_RUNBOOK.md`, `CURSOR_OPTIMIZATION_RUN_LOG.md`, `CURSOR_OPTIMIZATION_BACKLOG.md`, `CURSOR_OPTIMIZATION_RISK_REGISTER.md`, `CURSOR_OPTIMIZATION_DECISIONS.md`, thresholds/config JSON, and metrics snapshot README; wired new automation scripts under `scripts/ai/` and updated CI/make targets for staged warn-then-gate checks.
- **2026-04-03:** Cursor/AI efficiency pass: refreshed [`docs/ai/rule-hierarchy.md`](ai/rule-hierarchy.md), [`docs/ai/agent-workflows.md`](ai/agent-workflows.md) (Quick route), [`docs/ai/CURSOR_TOKEN_EFFICIENCY.md`](ai/CURSOR_TOKEN_EFFICIENCY.md), [`docs/ai/RULE_GLOB_OVERLAP_AUDIT.md`](ai/RULE_GLOB_OVERLAP_AUDIT.md), [`scripts/ai/rule-footprint.py`](../scripts/ai/rule-footprint.py); slimmed [`.cursor/rules/README`](../.cursor/rules/README.md). Regenerated inventory/redundancy (`DOCUMENTATION_INVENTORY.md`, `DOCUMENTATION_REDUNDANCY_REPORT.md`).
- **2026-04-02:** `/kunden` FAQ + keyword sprint docs: [DATA_COLLECTION_STATIC_SITE.md](content/pages/static-pages/DATA_COLLECTION_STATIC_SITE.md) (checklist), [kunden/data/](content/pages/static-pages/kunden/data/) research JSON + `KEYWORD_DECISION.md`, [kunden-documentation.md](content/pages/static-pages/kunden-documentation.md) maintenance note; registry `kunden` competitor URL Personio → `/referenzen/`.
- **2026-04-01:** Archived `docs/link-validation/` snapshot → [link-validation-2026-01](archive/2026-04-01-docs-cleanup/link-validation-2026-01/); replaced with [docs/link-validation/README.md](link-validation/README.md). Moved UTM cleanup analyses from `docs/analysis/` → [utm-cleanup-analysis](archive/2026-04-01-docs-cleanup/utm-cleanup-analysis/). Added [DOCUMENTATION_SCALE_AND_SCOPE.md](DOCUMENTATION_SCALE_AND_SCOPE.md) and [archive/2026-04-01-docs-cleanup/README.md](archive/2026-04-01-docs-cleanup/README.md).
- **2026-04-01:** Moved stale `docs/` root reports into [stale-docs-root](archive/2026-04-01-docs-cleanup/stale-docs-root/); slimmed [README.md](README.md) and [DOCUMENTATION_NEXT_STEPS.md](DOCUMENTATION_NEXT_STEPS.md); updated entry-point links across onboarding and rules mapping.
- **2026-04-01:** Consolidated root meta-docs; canonical inventory pipeline documented in [DOCUMENTATION_MAINTENANCE_PROCESS.md](DOCUMENTATION_MAINTENANCE_PROCESS.md); blog `NEXT_STEPS_*` companions removed from `docs/content/blog/`; tools-pages status consolidated to `FINAL_STATUS_2026.md`.