docs: rewrite READMEs with Agent Gateway positioning

Reposition as AI Agent Gateway with user-facing capability table,
internal module reference, deployment patterns, security summary,
and env var substitution docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gcmsg