docs: add Phase 7 — Multilanguage (English, Spanish, Portuguese)

.planning/REQUIREMENTS.md

@@ -72,6 +72,15 @@ Requirements for beta-ready release. Each maps to roadmap phases.
 - [x] **CHAT-04**: Chat respects RBAC — users can only chat with agents belonging to tenants they have access to
 - [x] **CHAT-05**: Chat interface feels responsive — typing indicators, message streaming or fast response display
 
+### Multilanguage
+
+- [ ] **I18N-01**: Portal UI fully localized in English, Spanish, and Portuguese (all pages, labels, buttons, error messages)
+- [ ] **I18N-02**: Language switcher accessible from anywhere in the portal — selection persists across sessions
+- [ ] **I18N-03**: AI Employees detect user language and respond accordingly, or use a language configured per agent
+- [ ] **I18N-04**: Agent templates, wizard steps, and onboarding flow are fully translated in all three languages
+- [ ] **I18N-05**: Error messages, validation text, and system notifications are localized
+- [ ] **I18N-06**: Adding a new language requires only translation files, not code changes (extensible i18n architecture)
+
 ## v2 Requirements
 
 Deferred to future release. Tracked but not in current roadmap.
@@ -161,12 +170,19 @@ Which phases cover which requirements. Updated during roadmap creation.
 | CHAT-03 | Phase 6 | Complete |
 | CHAT-04 | Phase 6 | Complete |
 | CHAT-05 | Phase 6 | Complete |
+| I18N-01 | Phase 7 | Pending |
+| I18N-02 | Phase 7 | Pending |
+| I18N-03 | Phase 7 | Pending |
+| I18N-04 | Phase 7 | Pending |
+| I18N-05 | Phase 7 | Pending |
+| I18N-06 | Phase 7 | 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)
+- Web Chat requirements: 5 total (Phase 6, all complete)
+- Multilanguage requirements: 6 total (Phase 7)
 
 ---
 *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
+Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7
 
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
@@ -141,6 +141,7 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6
 | 4. RBAC | 3/3 | Complete    | 2026-03-24 |
 | 5. Employee Design | 4/4 | Complete    | 2026-03-25 |
 | 6. Web Chat | 3/3 | Complete    | 2026-03-25 |
+| 7. Multilanguage | 0/0 | Not started | - |
 
 ---
 
@@ -148,6 +149,22 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6
 
 **LLM-03 conflict resolved:** BYO API keys confirmed in v1 scope per user decision during Phase 3 context gathering. Implemented via Fernet encryption in Phase 3.
 
+### Phase 7: Multilanguage
+**Goal**: The entire platform supports English, Spanish, and Portuguese — the portal UI is fully localized with a language switcher, and AI Employees respond in the user's language
+**Depends on**: Phase 6
+**Requirements**: I18N-01, I18N-02, I18N-03, I18N-04, I18N-05, I18N-06
+**Success Criteria** (what must be TRUE):
+  1. The portal UI (all pages, labels, buttons, messages) renders correctly in English, Spanish, and Portuguese
+  2. A user can switch language from anywhere in the portal via a language selector, and the change persists across sessions
+  3. AI Employees detect the user's language and respond in the same language — or use a language configured per agent
+  4. Agent templates, wizard steps, and onboarding flow are all fully translated
+  5. Error messages, validation text, and system notifications are localized
+  6. Adding a new language in the future requires only adding translation files, not code changes
+**Plans**: 0 plans
+
+Plans:
+- [ ] TBD (run /gsd:plan-phase 7 to break down)
+
 ---
 *Roadmap created: 2026-03-23*
 *Coverage: 25/25 v1 requirements + 6 RBAC requirements + 5 Employee Design requirements + 5 Web Chat requirements mapped*