# Concepts

Architecture, vision, and the laws that govern FlowWink. **Read these before building anything.**

| Doc | Read when |
|---|---|
| [`elevator-pitch.md`](./elevator-pitch.md) | Explaining FlowWink in one page |
| [`prd.md`](./prd.md) | You need the full system reference — modules, processes, scope |
| [`operator-strategy.md`](./operator-strategy.md) | Deciding which operator(s) to run (FlowPilot vs external MCP) |
| [`openclaw-law.md`](./openclaw-law.md) | Building or modifying any agentic feature (the 10 inviolable laws) |
| [`flowpilot.md`](./flowpilot.md) | Understanding the local operator — skills, heartbeat, memory |
| [`flowchat-vs-flowpilot.md`](./flowchat-vs-flowpilot.md) | Choosing utility AI vs operator AI for a feature |
| [`agent-driven-development.md`](./agent-driven-development.md) | How FlowPilot participates in its own development |
| [`a2a-communication-model.md`](./a2a-communication-model.md) | Implementing agent-to-agent federation |
| [`feedback-loops.md`](./feedback-loops.md) | Designing growth/lifecycle loops |
| [`integrations-strategy.md`](./integrations-strategy.md) | Planning third-party integrations |
| [`ai-dependencies.md`](./ai-dependencies.md) | Checking which features need OpenAI / Gemini / local AI |
