docs: comprehensive overhaul — 8 pages rewritten, 3300+ lines added (… #98

Job	Run time
Cockpit — build / test	1m 1s
Website — lint / build	1m 10s
Cockpit — secret-gated integration	51s
Chat Agent — smoke	56s
Website — e2e	1m 50s
Cockpit — deploy smoke dry-run	54s
Cockpit — representative capability smoke	57s
Cockpit — e2e	1m 22s
Library — lint / test / build	1m 2s
MCP — build / smoke	56s
Deploy → Vercel	3m 18s
	14m 17s

Provide feedback