docs: add staged Learning Roadmap to vault index

[jerelvelarde]

What

Adds 00-Index/Learning Roadmap.md — a staged path from zero to fluent in the CopilotKit codebase, built entirely on the existing vault notes. Linked from 🗺️ Home so it's the first stop for newcomers.

The roadmap

Eight progressive phases, each with a goal, an ordered reading list (all links resolve to existing notes), a checkpoint (what you should be able to explain), and a small exercise:

• Phase 0 — Orientation: Home, Glossary, Concepts MOC + vault mechanics (graph, tags, canvases)
• Phase 1 — The Spine: Three-Layer Architecture, AG-UI Protocol, Request Lifecycle
• Phase 2 — Frontend ↔ Runtime wiring: ProxiedAgent, transports, Tools, Context, Threads, Suggestions, core
• Phase 3 — Runtime internals: runtime overview (V1/V2), AgentRunner, handler, Middleware, A2UI, Multi-Agent
• Phase 4 — Agent layer: BuiltInAgent, sdk-js, demo-agents, Python SDK
• Phase 5 — Framework bindings: react-core/ui, angular, vue, a2ui-renderer
• Phase 6 — Ops, build & wider repo: Debug, Telemetry, Build/CI, Apps, Examples, Docs
• Phase 7 — Mastery: end-to-end traces + a design exercise

Closes with a "three things people get wrong" quick reference (no packages/agent; dual V1/V2 runtime; @copilotkitnext scope).

Conventions / verification

• Follows the vault frontmatter + linking contract (type: moc, layer: meta, nested tags).
• node .build/verify.js passes — all roadmap links resolve; the one pre-existing broken link ([[...slug]] in a Fumadocs note) is unrelated and untouched.

https://claude.ai/code/session_01Y38q55qnvZP17Y3Uziyw1u

---

Generated by Claude Code

[gemini-code-assist]

Code Review

This pull request introduces a structured 'Learning Roadmap' markdown document that outlines a phased learning path for the CopilotKit codebase, complete with goals, reading lists, checkpoints, and exercises. It also updates the main index ('🗺️ Home.md') to link to this new roadmap. Feedback was provided to use an em-dash instead of a colon in the Phase 7 header of the roadmap to maintain consistency with the other phase headers and the Mermaid diagram.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.