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

The .gitignore blanket-ignored the entire docs/ directory while it
contains tracked, hand-written documentation (DEPLOYMENT.md,
DEVELOPMENT.md, smoke-test-multi-account.sh) and CLAUDE.md tells
contributors to put documentation there. Any new file under docs/ was
silently excluded from git add / git status, and substantive review
docs had already accumulated untracked and invisible to git.

Narrow the ignore to docs/generated/, the generated-runbook output the
blanket rule was meant to cover, so hand-written docs are tracked
normally. Also link docs/DEVELOPMENT.md from the README Development
section so the guide is discoverable (DEPLOYMENT.md was already
linked).

Verified with git check-ignore: before, docs/new-doc.md matched
.gitignore:137 (docs/); after, it is not ignored while
docs/generated/runbook.md still is, and the three tracked docs/ files
are unaffected.

Closes #1169

Author: cristim

.gitignore

@@ -135,8 +135,10 @@ security-audit-swarm/
 # ~/.claude/CLAUDE.md §2a (Tool Selection) for the full rationale.
 .claude/
 
-# Generated docs (security runbooks etc.)
-docs/
+# 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).
+docs/generated/
 
 # Graphify knowledge graph output — regenerated locally, not committed
 graphify-out/

README.md

@@ -585,6 +585,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