## Mapping Existing Pages to New Structure

### Get Started

| New Item | Existing Page(s) |
|---|---|
| Introduction / Overview | `index`, `getting-started/concepts` |
| Installation | `getting-started/installing` |
| Quickstart | `getting-started/your-first-task` |
| Setup & Authentication | `getting-started/setting-up`, `getting-started/connecting-api-provider` |
| AI Providers | `basic-usage/connecting-providers`, `providers/*` (all of them) |
| Settings | `basic-usage/settings-management` |
| Adding Credits | `basic-usage/adding-credits` |
| FAQ | Keep if it exists |
| Migrating from Cursor/Windsurf | `advanced-usage/migrating-from-cursor-windsurf` |

---

### Code with AI

| New Item | Existing Page(s) |
|---|---|
| **Platforms** (subheader) |  |
| VS Code Extension | Needs new page (or pull from install) |
| JetBrains Extension | Needs new page |
| CLI | `cli` |
| Cloud Agent | `advanced-usage/cloud-agent` (partial) |
| Mobile Apps | Needs new page |
| Slack | `slack` |
| **Working with Agents** (subheader) |  |
| The Chat Interface | `basic-usage/the-chat-interface` |
| Context & Mentions | `basic-usage/context-mentions` |
| Using Modes | `basic-usage/using-modes` |
| Orchestrator Mode | `basic-usage/orchestrator-mode` |
| Model Selection | `basic-usage/model-selection-guide` |
| **Features** (subheader) |  |
| Autocomplete | `basic-usage/autocomplete/index`, `basic-usage/autocomplete/mistral-setup` |
| Code Actions | `features/code-actions` |
| Browser Use | `features/browser-use` |
| Git Commit Generation | `basic-usage/git-commit-generation` |
| Checkpoints | `features/checkpoints` |
| Enhance Prompt | `features/enhance-prompt` |
| Fast Edits | `features/fast-edits` |
| Task Todo List | `basic-usage/task-todo-list` |
| **Context & Indexing** (subheader) |  |
| Codebase Indexing | `features/codebase-indexing` |
| Large Projects | `advanced-usage/large-projects` |
| **Customization** (subheader) |  |
| Custom Modes | `agent-behavior/custom-modes` |
| Custom Rules | `agent-behavior/custom-rules` |
| Custom Instructions | `agent-behavior/custom-instructions` |
| agents.md | `agent-behavior/agents-md` |
| Workflows | `agent-behavior/workflows` |
| Skills | `agent-behavior/skills` |
| Prompt Engineering | `agent-behavior/prompt-engineering` |
| **App Builder** (subheader) |  |
| App Builder | `advanced-usage/appbuilder` |

---

### Collaborate

| New Item | Existing Page(s) |
|---|---|
| Sessions & Sharing | `advanced-usage/sessions` |
| **Kilo for Teams** (subheader) |  |
| About Plans | `plans/about` |
| Getting Started with Teams | `plans/getting-started` |
| Dashboard | `plans/dashboard` |
| Team Management | `plans/team-management` |
| Custom Modes (Org) | `plans/custom-modes` |
| Billing | `plans/billing` |
| Analytics | `plans/analytics` |
| **AI Adoption Dashboard** (subheader) |  |
| Overview | `plans/adoption-dashboard/overview` |
| Understanding Your Score | `plans/adoption-dashboard/understanding-your-score` |
| Improving Your Score | `plans/adoption-dashboard/improving-your-score` |
| For Team Leads | `plans/adoption-dashboard/for-team-leads` |
| **Enterprise** (subheader) |  |
| SSO | `plans/enterprise/SSO` |
| Model Access Controls | `plans/enterprise/model-access` |
| Audit Logs | `plans/enterprise/audit-logs` |
| Migration | `plans/migration` |

---

### Automate

| New Item | Existing Page(s) |
|---|---|
| Integrations Overview | `advanced-usage/integrations` |
| Code Reviews | `advanced-usage/code-reviews` |
| Agent Manager | `advanced-usage/agent-manager` |
| **Extending Kilo** (subheader) |  |
| Local Models | `advanced-usage/local-models` |
| Shell Integration | `features/shell-integration` |
| Auto-launch Configuration | `features/auto-launch-configuration` |
| **MCP** (subheader) |  |
| MCP Overview | `features/mcp/overview` |
| Using MCP in Kilo Code | `features/mcp/using-mcp-in-kilo-code` |
| Using MCP in CLI | `features/mcp/using-mcp-in-cli` |
| What is MCP | `features/mcp/what-is-mcp` |
| Server Transports | `features/mcp/server-transports` |
| MCP vs API | `features/mcp/mcp-vs-api` |
| **Tools (subheader)** |  |
| How Tools Work | `basic-usage/how-tools-work` |
| Tool Details | ALL of Tool reference |

---

### Deploy & Secure

| New Item | Existing Page(s) |
|---|---|
| Deploy | `advanced-usage/deploy` |
| Security Reviews | `contributing/architecture/security-reviews` (move out of contributing) |

---

### Contributing

| New Item | Existing Page(s) |
|---|---|
| Contributing Overview | `contributing/index` |
| Development Environment | `contributing/development-environment` |
| **Architecture** (subheader) |  |
| Architecture Overview | `contributing/architecture/index` |
| Annual Billing | `contributing/architecture/annual-billing` |
| Enterprise MCP Controls | `contributing/architecture/enterprise-mcp-controls` |
| Onboarding Improvements | `contributing/architecture/onboarding-engagement-improvements` |
| Organization Modes Library | `contributing/architecture/organization-modes-library` |
| Track Repo URL | `contributing/architecture/track-repo-url` |
| Vercel AI Gateway | `contributing/architecture/vercel-ai-gateway` |
| Voice Transcription | `contributing/architecture/voice-transcription` |

---

## Pages to Add (Don't Exist Yet)

| Section | New Page Needed |
|---|---|
| Get Started | "Choosing Your Surface" (decision tree) |
| Code with AI | VS Code dedicated page |
| Code with AI | JetBrains dedicated page |
| Code with AI | Web App dedicated page |
| Code with AI | Mobile Apps (iOS/Android) |
| Collaborate | Team Workspaces overview |
| Collaborate | Permissions & Roles |
| Automate | Triage Agent |
| Automate | Auto-fix Agent |
| Automate | GitHub Actions guide |
| Automate | Webhooks & Triggers |
| Deploy & Secure | Security Scanning Agent |
| Deploy & Secure | Environment Configuration |
| Deploy & Secure | Secrets Management |
| Contributing | Roadmap |
| Contributing | Community / Discord |

---

## Pages to Remove from Nav / Condense

| Page | Recommendation |
|---|---|
| ☑️ `features/system-notifications` | Fold into Settings or remove |
| ❎ `features/more-features` | Remove |
| ☑️ `features/suggested-responses` | Fold into Chat Interface |
| ☑️ `features/auto-approving-actions` | Fold into Settings |
| ☑️ `advanced-usage/auto-cleanup` | Fold into Settings |
| ❎ `features/model-temperature` | Remove |
| ☑️ `advanced-usage/rate-limits-costs` | Fold into Adding Credits or AI Providers |
| ❎ `features/footgun-prompting` | Remove |
| ☑️ `tips-and-tricks` | Could become a blog post or fold relevant bits elsewhere |

---

## Summary

**Reusable as-is:** ~70% of your content maps cleanly

**Needs new pages:** ~12-15 new pages, mostly for newer cloud/platform features

**Condense/remove:** ~10-12 pages that are either too granular or should be folded into parent pages

**Tools Reference:** Decide if this stays in nav or becomes a "Reference" footer link - it's useful but clutters the IA

Want me to mock up the actual sidebar structure with the subheaders?
