ddd test

README.md

@@ -6,6 +6,12 @@ Desktop chat app with three parts:
 - `electron/` desktop shell, IPC, and local database
 - `server/` directory server, join request API, and websocket events
 
+## Architecture
+
+- Renderer architecture and refactor conventions live in `docs/architecture.md`
+- Electron renderer integrations should go through `src/app/core/platform/electron/`
+- Pure shared logic belongs in `src/app/core/helpers/` and reusable contracts belong in `src/app/core/models/`
+
 ## Install
 
 1. Run `npm install`