architecture

# Architecture Skill Determine correct file placement and structure for an Electron multi-process project. ## Detailed References - **Renderer layer** (components, hooks, utils, pages, CSS): [references/renderer.md](references/renderer.md) - **Main process & shared layer** (bridges, services, worker, preload): [references/process.md](references/process.md) - **Project root & src/ layout** (directory structure, migration status): [references/project-layout.md](references/project-layout.md) --- ## Decision Tree - Where Does New Code Go? ``` Is it UI (React components, hooks, pages)? └── YES → src/renderer/ → see references/renderer.md Is it an IPC handler responding to renderer calls? └── YES → src/process/bridge/ → see references/process.md Is it business logic running in the main process? └── YES → src/process/services/ → see references/process.md Is it an AI platform connection (API client, message protocol)? └── YES → src/process/agent/<platform>/ Is it a background task that runs in a worker thread? └── YES → src/process/worker/ Is it used by BOTH main and renderer processes? └── YES → src/common/ Is it an HTTP/WebSocket endpoint? └── YES → src/process/webserver/ Is it a plugin/extension resolver or loader? └── YES → src/process/extensions/ Is it a messaging channel (Lark, DingTalk, Telegram)? └── YES → src/process/channels/ ``` --- ## Process Boundary Rules **Hard rules - violating them causes runtime crashes.** ...