+----------+    +------+    +---------+    +----------+    +--------+
|  Agent   | -> | Flow | -> | Session | -> | Worktree | -> | Commit |
+----------+    +------+    +---------+    +----------+    +--------+
     |                          |
     v                          v
 +--------+              +----------+
 | SQLite |              | Kanban   |
 | Features|             | Board    |
 +--------+              +----------+

~/.claude/tasks/
  session-abc/
    1.json  ->  { id: "1", subject: "Fix login", status: "in_progress", owner: "claude" }
    2.json  ->  { id: "2", subject: "Add tests", status: "pending", blockedBy: ["1"] }

                         +-------------+
                         |  flow-cli   |  Binary ("flow")
                         +------+------+  All commands live here
                                |
          +---------------------+---------------------+
          |           |         |         |            |
          v           v         v         v            v
    +-----------+ +--------+ +--------+ +------+ +-----------+
    | flow-git  | | flow-  | | flow-  | | flow-| | flow-     |
    | Worktrees | | tmux   | | sync   | | tui  | | server    |
    +-----------+ +--------+ +--------+ +------+ +-----------+
          |           |         |         |  |         |
          +-----+-----+---------+---------+  |    +----+----+
                |                             |    |         |
                v                             |    v         v
          +-----------+                       |  +------+ +-----+
          | flow-core |  Types, Config,       |  | flow-| |flow-|
          | Errors, Themes, Events            |  | mcp  | |orch.|
          +-----------+                       |  +------+ +-----+
                ^                             |    |
                |                             v    v
          +-----+------+              +------------+
          | flow-       |             | flow-db    |
          | resolver    |             | SQLite     |
          | Topo sort,  |<----------->| Features   |
          | Scheduling  |             | Events     |
          +-------------+             +------------+

1. Agent writes task JSON     ->  ~/.claude/tasks/{session}/{id}.json
2. File watcher detects it    ->  notify crate with debouncing
3. SSE/WS broadcast           ->  All connected clients get the update
4. Web UI / TUI updates       ->  Kanban board shows new task

1. User creates feature       ->  flow features add "Login page"
2. SQLite stores it           ->  WAL mode for concurrent access
3. Resolver sorts deps        ->  Kahn's algorithm topological sort
4. Scorer ranks by priority   ->  unblock_count * 1000 + depth_score * 100 + priority * 10
5. Agent claims next ready    ->  Atomic UPDATE with WHERE guard

flow/
├── Cargo.toml                 # Workspace: 11 crates, shared lints
├── README.md                  # You are here
├── .github/workflows/ci.yml   # CI: test, clippy, format
│
├── crates/
│   ├── flow-cli/              # Binary ("flow") - all commands
│   │   └── src/commands/      # branch, switch, serve, features, monitor, theme...
│   │
│   ├── flow-core/             # Shared types and configuration
│   │   └── src/
│   │       ├── config.rs      # Workflow config (~/.config/flow/config.toml)
│   │       ├── agent.rs       # AgentConfig (port, themes, concurrency)
│   │       ├── feature.rs     # Feature, FeatureStats, FeatureGraphNode
│   │       ├── task.rs        # Task, SessionListItem, SessionMeta
│   │       ├── theme.rs       # 7 themes with ANSI + CSS colors
│   │       ├── event.rs       # FlowEvent (TaskUpdate, FeatureUpdate, etc.)
│   │       └── error.rs       # FlowError (12 variants)
│   │
│   ├── flow-db/               # SQLite feature management
│   │   └── src/
│   │       ├── feature.rs     # CRUD + atomic claim/pass/fail
│   │       ├── schema.rs      # Tables + WAL + performance pragmas
│   │       ├── migration.rs   # Schema versioning
│   │       ├── event_log.rs   # Change audit trail
│   │       └── task_sync.rs   # JSON <-> SQLite bidirectional sync
│   │
│   ├── flow-resolver/         # Dependency resolution
│   │   └── src/
│   │       ├── topo.rs        # Kahn's algorithm with priority heap
│   │       ├── cycle.rs       # DFS cycle detection (depth limit: 50)
│   │       └── scorer.rs      # Scheduling score computation
│   │
│   ├── flow-server/           # Web server (axum)
│   │   └── src/
│   │       ├── routes/        # REST API: sessions, tasks, features, theme
│   │       ├── sse.rs         # Server-Sent Events
│   │       ├── ws.rs          # WebSocket handler
│   │       ├── watcher.rs     # File system watcher (notify crate)
│   │       └── state.rs       # Shared application state
│   │
│   ├── flow-tui/              # Terminal UI (ratatui)
│   │   └── src/
│   │       ├── app.rs         # App state, key handling, rendering
│   │       ├── views/         # kanban, agents, graph, logs, help
│   │       └── theme.rs       # ANSI color mapping from flow-core themes
│   │
│   ├── flow-git/              # Git worktree operations
│   ├── flow-tmux/             # tmux session management
│   ├── flow-sync/             # Multi-machine sync
│   ├── flow-mcp/              # MCP server (planned)
│   └── flow-orchestrator/     # Agent orchestrator (planned)
│
└── extensions/                # TypeScript security scanners