diff --git a/COLLAB.md b/COLLAB.md
new file mode 100644
index 0000000..6fe9f8a
--- /dev/null
+++ b/COLLAB.md
@@ -0,0 +1,41 @@
+# FreightDesk — Collaboration Guide
+
+## Project Overview
+Freight forwarding commission agent management platform.
+Stack: Node.js + Express + EJS + Supabase PostgreSQL.
+
+## Branch Strategy
+- `master` — stable, production-ready
+- `agent-<name>` — individual agent work branches
+- Feature branches for specific features
+
+## Conventions
+- Commit prefix: `[OWL]` or `[AGENT-NAME]` to identify who made changes
+- EJS views: use `partials/header.ejs` and `partials/footer.ejs` includes
+- CSS: government-app aesthetic (tricolor: saffron, white, green, navy)
+- Routes: RESTful, all protected by `requireAuth` middleware
+- DB: Supabase, use `services/supabase.js` client
+
+## Key Files
+- `src/server.js` — Express app entry
+- `src/routes/` — Route handlers
+- `src/views/` — EJS templates
+- `src/public/css/style.css` — Main stylesheet
+- `src/services/parser.js` — WhatsApp message parser
+- `supabase/migrations/` — DB schema
+
+## Current Features
+- Auth (username/password)
+- Dashboard with stats
+- Load CRUD + filters
+- WhatsApp parser
+- Payment tracking
+- Shipper/vehicle management
+- Reports
+
+## Pending / TODO
+- Client portal (shipper/driver login)
+- Invoice PDF generation
+- React charts on dashboard
+- WhatsApp parser improvements
+- Mobile-responsive polish