docs: add Phase 8 — Mobile Layout + PWA

.planning/REQUIREMENTS.md

@@ -81,6 +81,15 @@ Requirements for beta-ready release. Each maps to roadmap phases.
 - [x] **I18N-05**: Error messages, validation text, and system notifications are localized
 - [x] **I18N-06**: Adding a new language requires only translation files, not code changes (extensible i18n architecture)
 
+### Mobile + PWA
+
+- [ ] **MOB-01**: All portal pages render correctly and are usable on mobile (320px–480px) and tablet (768px–1024px) screens
+- [ ] **MOB-02**: Sidebar collapses to a hamburger menu on mobile with smooth open/close animation
+- [ ] **MOB-03**: Chat interface is fully functional on mobile — send messages, see streaming responses, scroll history
+- [ ] **MOB-04**: Portal installable as a PWA with app icon, splash screen, and service worker for offline shell caching
+- [ ] **MOB-05**: Push notifications for new messages when PWA is installed (or service worker caches app shell for instant load)
+- [ ] **MOB-06**: All touch interactions feel native — no hover-dependent UI that breaks on touch devices
+
 ## v2 Requirements
 
 Deferred to future release. Tracked but not in current roadmap.
@@ -177,12 +186,20 @@ Which phases cover which requirements. Updated during roadmap creation.
 | I18N-05 | Phase 7 | Complete |
 | I18N-06 | Phase 7 | Complete |
 
+| MOB-01 | Phase 8 | Pending |
+| MOB-02 | Phase 8 | Pending |
+| MOB-03 | Phase 8 | Pending |
+| MOB-04 | Phase 8 | Pending |
+| MOB-05 | Phase 8 | Pending |
+| MOB-06 | Phase 8 | Pending |
+
 **Coverage:**
 - v1 requirements: 25 total (all complete)
 - RBAC requirements: 6 total (Phase 4, all complete)
 - Employee Design requirements: 5 total (Phase 5, all complete)
 - Web Chat requirements: 5 total (Phase 6, all complete)
-- Multilanguage requirements: 6 total (Phase 7)
+- Multilanguage requirements: 6 total (Phase 7, all complete)
+- Mobile + PWA requirements: 6 total (Phase 8)
 
 ---
 *Requirements defined: 2026-03-23*

.planning/ROADMAP.md

@@ -131,7 +131,7 @@ Plans:
 ## Progress
 
 **Execution Order:**
-Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7
+Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7 -> 8
 
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
@@ -142,6 +142,7 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7
 | 5. Employee Design | 4/4 | Complete    | 2026-03-25 |
 | 6. Web Chat | 3/3 | Complete    | 2026-03-25 |
 | 7. Multilanguage | 4/4 | Complete    | 2026-03-25 |
+| 8. Mobile + PWA | 0/0 | Not started | - |
 
 ---
 
@@ -168,6 +169,22 @@ Plans:
 - [ ] 07-03-PLAN.md — Frontend string extraction: replace all hardcoded English strings with useTranslations() calls across all pages and components
 - [ ] 07-04-PLAN.md — Human verification: multilanguage testing across all pages, language switcher, AI Employee language response
 
+### Phase 8: Mobile + PWA
+**Goal**: The portal is fully responsive on mobile/tablet devices and installable as a Progressive Web App — operators and customers can manage their AI workforce and chat with employees from any device
+**Depends on**: Phase 7
+**Requirements**: MOB-01, MOB-02, MOB-03, MOB-04, MOB-05, MOB-06
+**Success Criteria** (what must be TRUE):
+  1. All portal pages render correctly and are usable on mobile screens (320px–480px) and tablets (768px–1024px)
+  2. The sidebar collapses to a hamburger menu on mobile with smooth open/close animation
+  3. The chat interface is fully functional on mobile — send messages, see streaming responses, scroll history
+  4. The portal can be installed as a PWA from Chrome/Safari with app icon, splash screen, and offline shell
+  5. Push notifications work for new messages when the PWA is installed (or at minimum, the service worker caches the app shell for instant load)
+  6. All touch interactions (swipe, tap, long-press) feel native — no hover-dependent UI that breaks on touch
+**Plans**: 0 plans
+
+Plans:
+- [ ] TBD (run /gsd:plan-phase 8 to break down)
+
 ---
 *Roadmap created: 2026-03-23*
 *Coverage: 25/25 v1 requirements + 6 RBAC requirements + 5 Employee Design requirements + 5 Web Chat requirements + 6 Multilanguage requirements mapped*