diff --git a/ROADMAP.md b/ROADMAP.md new file mode 100644 index 0000000..9c093b5 --- /dev/null +++ b/ROADMAP.md @@ -0,0 +1,93 @@ +# LearnKit AI — Roadmap + +LearnKit AI is an open-source TypeScript engine for embedding role-aware AI learning paths in any product. Apache-2.0, no hosted SaaS, no paid tier. + +--- + +## v0 — Foundation ✅ + +Core engine, React component, and public website shipped. + +### Packages +- [x] `@learnkit-ai/schemas` — Zod schemas and inferred TypeScript types +- [x] `@learnkit-ai/core` — `generateLearningPath()`, pure deterministic, no LLM +- [x] `@learnkit-ai/react` — ``, ``, ``, `useLearnKit()` + +### Content +- [x] Role-specific 4-week curricula: Product Manager, Software Engineer, Designer, Data Analyst, Marketer, Founder, Operations, Researcher +- [x] 8 supported tools: Claude, ChatGPT, Cursor, Copilot, Midjourney, Notion AI, Perplexity, Gemini +- [x] `level` field (`beginner` / `intermediate` / `advanced`) adjusts lesson pacing + +### Web +- [x] Landing page (`/`) +- [x] Interactive demo (`/demo`) with role, tools, goal, level, and optional company context +- [x] Docs (`/docs`) with full API reference +- [x] `/roles/[slug]` and `/tools/[slug]` SEO pages +- [x] `/teams` page (OSS integration guide) +- [x] Blog (`/blog`) — pedagogy and engineering posts +- [x] Custom 404, OG image, sitemap, robots.txt + +### Infrastructure +- [x] pnpm workspaces + Turborepo +- [x] tsup: ESM + CJS + `.d.ts` for all packages +- [x] Vitest: unit tests for core + React components +- [x] GitHub Actions CI +- [x] `examples/nextjs-basic` + +--- + +## v1 — Depth (planned) + +### Engine +- [ ] `companyContext` field used in lesson personalisation (currently accepted but not applied) +- [ ] More supported tools (target: 20+), including Windsurf, Replit, Linear, Figma AI, v0 +- [ ] More roles: Sales, Customer Success, Legal, Finance, Executive +- [ ] `progress` field in `LearningPath` to track completed lessons +- [ ] Lesson prerequisite graph — reorder-aware sequencing +- [ ] `generateLessonContent(lesson)` — returns full lesson body, exercises, and rubric + +### React package +- [ ] `` component — persist lesson state to localStorage +- [ ] `` — renders full lesson body returned by `generateLessonContent()` +- [ ] `light` theme variant (in addition to `warm`, `midnight`, `technical`) +- [ ] Headless mode: all components accept `renderItem` render-prop overrides + +### Web +- [ ] `/changelog` page — versioned release notes +- [ ] `/compare` pages — e.g. "Claude vs ChatGPT for engineers" +- [ ] `/guides/[slug]` — long-form integration guides +- [ ] Per-role `opengraph-image` for `/roles/[slug]` pages + +### Developer experience +- [ ] `@learnkit-ai/cli` — `npx @learnkit-ai/cli generate` outputs a JSON learning path +- [ ] VS Code extension — sidebar learning path panel +- [ ] Storybook for `@learnkit-ai/react` components + +--- + +## v2 — Scale (exploratory) + +These are directions worth exploring, not commitments. + +- Multi-language support: lessons in Spanish, French, German, Portuguese +- Team progress aggregation: local-first, no server required (IndexedDB + export) +- Embeddable widget (`