diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md
new file mode 100644
index 0000000..96a746e
--- /dev/null
+++ b/.planning/REQUIREMENTS.md
@@ -0,0 +1,82 @@
+# Requirements: Xtablo — Go + HTMX Product
+
+**Defined:** 2026-05-17
+**Core Value:** A user can sign in and run the Tablos workflow — organize work, attach files, discuss, and plan scheduled events — without a JS framework or managed chat provider.
+
+## v4.0 Requirements — Figma Design Parity
+
+Requirements for v4.0. Each maps to roadmap phases.
+
+### Navigation & Shell
+
+- [ ] **NAV-01**: User sees a redesigned sidebar/nav bar matching Figma (brand section, icon nav items, tablo list section, user footer)
+- [ ] **NAV-02**: User sees a per-page top header bar with page title and contextual action buttons matching Figma
+
+### Tablo List
+
+- [ ] **LIST-01**: Tablo project cards are revamped to match Figma with updated layout, typography, and progress bar wired to real task completion percentage
+- [ ] **LIST-02**: User can toggle between card grid view and list view on the tablos page
+- [ ] **LIST-03**: Tablos have an active/archived status field stored in DB, visible as a UI indicator on cards and list rows
+
+### Tasks
+
+- [ ] **TASK-01**: Kanban board columns, task cards, and drag-and-drop are restyled to match Figma
+- [ ] **TASK-02**: User can switch to a grid/table view of tasks within a tablo (new view — data model + UI)
+- [ ] **TASK-03**: User can switch to a roadmap/timeline view of tasks within a tablo (new view — requires due date fields added to tasks schema)
+
+### Calendar (Planning)
+
+- [ ] **CAL-01**: User can view their planning in a month/week/day calendar grid, replacing the current flat agenda list
+- [ ] **CAL-02**: Events render as colored blocks inside calendar cells (not just text list items)
+- [ ] **CAL-03**: User can filter calendar events by tablo
+
+### Tablo Detail
+
+- [ ] **DETAIL-01**: Tablo detail page (header, tasks section, etapes section, files table) is restyled to match Figma
+
+## v5.0 Candidates (Deferred)
+
+### Polish & Accessibility
+
+- **RESP-01**: Responsive layout — sidebar collapses on small screens, kanban scrolls horizontally on mobile
+- **DARK-01**: Dark mode — CSS token `prefers-color-scheme` counterparts or class-toggle variant
+
+## Out of Scope
+
+| Feature | Reason |
+|---------|--------|
+| Apple sign-in | Disabled in v2.0; remains out of scope |
+| Stripe / billing | Deferred until product loop validated |
+| Public booking widget | Deferred to a later milestone |
+| Client portal | Deferred |
+| Admin app | Deferred |
+| Mobile / Expo app | Out of scope for this rewrite |
+| Notes / rich documents | Not part of this milestone |
+
+## Traceability
+
+Which phases cover which requirements. Updated during roadmap creation.
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| NAV-01 | TBD | Pending |
+| NAV-02 | TBD | Pending |
+| LIST-01 | TBD | Pending |
+| LIST-02 | TBD | Pending |
+| LIST-03 | TBD | Pending |
+| TASK-01 | TBD | Pending |
+| TASK-02 | TBD | Pending |
+| TASK-03 | TBD | Pending |
+| CAL-01 | TBD | Pending |
+| CAL-02 | TBD | Pending |
+| CAL-03 | TBD | Pending |
+| DETAIL-01 | TBD | Pending |
+
+**Coverage:**
+- v4.0 requirements: 12 total
+- Mapped to phases: 0 (roadmap pending)
+- Unmapped: 12 ⚠️
+
+---
+*Requirements defined: 2026-05-17*
+*Last updated: 2026-05-17 after initial definition*