diff --git a/.gitignore b/.gitignore
index b4d552e4..1f2c6f1e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,12 +13,6 @@ __pycache__/
 website/output/
 website/data/
 
-# docs (except decision records)
-docs/*
-!docs/adr/
-
 # agents
-tmp/
-.superpowers/
 .playwright-cli/
-skills-lock.json
+tmp/
diff --git a/docs/audit-logs.md b/docs/audit-logs.md
new file mode 100644
index 00000000..93fad35e
--- /dev/null
+++ b/docs/audit-logs.md
@@ -0,0 +1,33 @@
+# Audit Log
+
+awesome-python is audited section by section. Every entry gets re-verified against live data, and every removal lands in a commit whose body carries the reason. Git history is the archive. This file is the at-a-glance register of maintainer decisions that a single commit can't show.
+
+## Overrides
+
+[CONTRIBUTING.md](../CONTRIBUTING.md) allows the maintainer to exceed any limit for a specific entry or use case. Each override is recorded here.
+
+### Naming Exceptions
+
+Display names follow the canonical PyPI package name. These entries keep a different name by maintainer decision:
+
+- autobahn-python -- `autobahn`.
+- django-rest-framework -- `djangorestframework`.
+- django-rules -- `rules`.
+- fasthtml -- `python-fasthtml`.
+- jinja -- `Jinja2`.
+- mem0 -- `mem0ai`.
+- pangu.py -- `pangu`.
+- playwright-python -- `playwright`.
+- pytorch -- `torch`.
+- strawberry -- `strawberry-graphql`.
+- strawberry-django -- `strawberry-graphql-django`.
+
+### Mature-stable Keeps
+
+These entries sit past the 12-month activity requirement without an override. Each one is kept by editorial judgment: mature, stable, and no successor exists.
+
+- sortedcontainers
+- jinja
+- itsdangerous
+- jieba
+- ftfy