feat: add roadmap for Q4 2025 (#2193)

Author: theodesp

ROADMAP.md

@@ -0,0 +1,27 @@
+# 📅 Q4 2025 Faust Refactor Roadmap
+
+| Sprint | Dates           | Focus Areas                  | Key Deliverables |
+|--------|----------------|-----------------------------|-----------------|
+| 1      | Oct 7 – Oct 20  | 🛤 Roadmap + Toolbar (first cut) | - Publish roadmap (internal + OSS)<br>- Scaffold `@faustjs/toolbar` package<br>- Toolbar alpha (Preview + Edit buttons, responsive & accessible)<br>- Demo app with Toolbar |
+| 2      | Oct 21 – Nov 3  | 📐 Core Packages (iteration 1) | - Scaffold `@faustjs/template-hierarchy` and `@faustjs/client`<br>- GraphQL client wrapper MVP<br>- Template Hierarchy MVP (basic post/page rendering) |
+| 3      | Nov 4 – Nov 17  | 📦 Core Packages (iteration 2) | - Publish Template Hierarchy alpha<br>- Publish GraphQL Client alpha<br>- Toolbar beta (theming tokens, accessibility improvements)<br>- Scaffold `@faustjs/auth`<br>- Draft: *Getting Started with Faust v2* doc |
+| 4      | Nov 18 – Dec 1  | 🔗 Framework Adapter + Utils | - Next.js App Router adapter beta (or Pages router)<br>- Publish `@faustjs/utils` package<br>- Toolbar adds draft/publish toggle<br>- Migration Guide v1 |
+| 5      | Dec 2 – Dec 15  | 🚀 DX + Starter Tooling      | - Finalize Toolbar stable (white-label theming)<br>- Starter CLI: `npx create-faust-app` (Next.js baseline) (or just a template)<br>- Docs: Migration guide expanded with examples |
+| 6      | Dec 16 – Dec 23 | 🎉 Release Prep & OSS Launch | - Internal & OSS testing of migration flow<br>- Publish Next.js adapter stable<br>- Release Faust Core v4.0 (Next.js baseline)<br>- Community demo + OSS announcement<br>- Plan Q1 2026 (Astro + SvelteKit adapters) |
+
+---
+
+## 🎯 End of Quarter Outcomes
+- Core packages available: Template Hierarchy, GraphQL Client, Toolbar  
+- Framework adapter: Next.js App/Pages Router stable  
+- CLI tooling + Docs  
+- DX improvements: starter project generator (`npx create-faust-app`)  
+- Docs: Getting Started, migration guide, roadmap published  
+
+---
+
+## 👉 By Dec 23, 2025, developers can:
+- Scaffold a Faust app in minutes  
+- Use the modular Template Hierarchy + GraphQL Client without boilerplate  
+- Provide editors a functional Toolbar  
+- Migrate legacy Faust projects safely