William Valentin
7480c67338
10-task plan covering Tailwind migration, responsive mobile nav, and page-by-page rewrites with Inter font and modern dark theme. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Flynn Documentation (Start Here)
This documentation is written to be useful to both humans and AI agents. If you want a fast mental model, read the architecture diagram first.
Reading Order
- Architecture overview (agent-oriented)
docs/architecture/AGENT_DIAGRAM.mddocs/architecture/GATEWAY_SESSIONS_AND_QUEUE.mddocs/architecture/TYPESCRIPT_MAP.mddocs/architecture/SYMBOL_INDEX.mddocs/architecture/CONTRIBUTOR_MAP.md
- Security boundary (safe-by-default personal agent)
docs/security/SAFE_PERSONAL_AGENT.md
- Gateway API (WebSocket JSON-RPC)
docs/api/PROTOCOL.md
- Tool contracts and policy/execution details
docs/api/TOOLS.md
- Production and performance
docs/deployment/PRODUCTION.mddocs/performance/TUNING.md
- Operations runbooks
docs/operations/OPERATOR_PACK.md
Quick Map (One Diagram)
flowchart TD
U[User on chat surface] --> CA[ChannelAdapter]
U --> GW[Gateway WS/HTTP + Web UI]
CA --> RT[Routing + Sessions]
GW --> RT
RT --> OR[AgentOrchestrator]
OR --> NA[NativeAgent tool loop]
NA --> MR[ModelRouter]
MR --> MC[ModelClient -> provider]
NA --> TP[ToolPolicy + ToolRegistry]
TP --> TE[ToolExecutor\nhooks + enforcement + audit]