Developer documentation: architecture, build/release, platforms, gotchas

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -10,6 +10,13 @@ remote server over SSH/SFTP, so you can move files **local↔remote**,
 > **Name & icon are placeholders.** See [Rebranding](#rebranding) — it's a
 > one-file change.
 
+## Developer docs
+
+Dense reference material lives in [docs/](docs/): [architecture](docs/architecture.md)
+(processes, windows, RPC, every module/service), [build & release](docs/build-and-release.md)
+(Build-n versioning, per-target release pipeline, CI), [platform notes](docs/platform-notes.md)
+(macOS/Windows matrix + smoke tests), and [gotchas](docs/gotchas.md) (known landmines).
+
 ## Features
 
 - Dual-panel commander UI; either panel can be Local or any saved connection.