chore(repo): stop blanket-ignoring docs/, ignore only docs/generated/

.gitignore

@@ -135,10 +135,12 @@ security-audit-swarm/
 # ~/.claude/CLAUDE.md §2a (Tool Selection) for the full rationale.
 .claude/
 
-# Generated docs (security runbooks etc.) and scratch/review files.
-# docs/cli/ is explicitly tracked; all other docs/ subdirectories are ignored.
-docs/*
-!docs/cli
+# Generated docs (security runbooks etc.). Only the generated output
+# directory is ignored; hand-written documentation under docs/ is
+# tracked normally (e.g. docs/DEPLOYMENT.md, docs/DEVELOPMENT.md, and the
+# docs/cli/ CLI reference). Do not re-add a blanket docs/* ignore: it
+# silently hid hand-written docs, which is the regression this narrows away.
+docs/generated/
 
 # Graphify knowledge graph output — regenerated locally, not committed
 graphify-out/

README.md

@@ -595,6 +595,10 @@ the dashboard.
 
 ## Development
 
+See [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) for the full development
+guide, including the local Docker environment, database migrations, hot
+reload, and debugging workflows.
+
 ### Prerequisites
 
 - Go 1.23 or later