fix: remove old plans

Author: brandonkachen

plans/agent-runtime-migration.md

@@ -131,6 +131,7 @@ describe('Documentation Content Integrity', () => {
   describe('Internal Links Validation', () => {
     // Build a set of valid doc paths
     const validDocPaths = new Set<string>()
+    const categoryPaths = new Set<string>()
 
     beforeAll(() => {
       for (const filePath of getMdxFiles(CONTENT_DIR)) {
@@ -139,13 +140,11 @@ describe('Documentation Content Integrity', () => {
         const category = parts[0]
         const slug = path.basename(filePath, '.mdx')
         validDocPaths.add(`/docs/${category}/${slug}`)
-        validDocPaths.add(`/docs/${category}#${slug}`)
       }
       // Add category index paths
       VALID_SECTIONS.forEach((section) => {
-        validDocPaths.add(`/docs/${section}`)
+        categoryPaths.add(`/docs/${section}`)
       })
-      validDocPaths.add('/docs')
     })
 
     it.each(
@@ -164,20 +163,17 @@ describe('Documentation Content Integrity', () => {
         // For doc links, validate they exist
         if (link.startsWith('/docs/')) {
           const pathWithoutAnchor = link.split('#')[0]
-          const isValid =
-            validDocPaths.has(pathWithoutAnchor) ||
-            validDocPaths.has(link)
-
-          if (!isValid) {
-            // Check if it's a category#slug format (e.g., /docs/tips#modes)
-            const categoryMatch = pathWithoutAnchor.match(/^\/docs\/([^/]+)$/)
-            if (categoryMatch) {
-              // Category pages are valid
-              continue
-            }
+          const hasAnchor = link.includes('#')
+          const isDocPath = validDocPaths.has(pathWithoutAnchor)
+          const isCategoryPath = categoryPaths.has(pathWithoutAnchor)
+          const isDocsIndex = pathWithoutAnchor === '/docs'
+
+          if (hasAnchor) {
+            expect(isDocPath).toBe(true)
+            continue
           }
 
-          expect(isValid).toBe(true)
+          expect(isDocPath || isCategoryPath || isDocsIndex).toBe(true)
         }
       }
     })

plans/bash-mode-ephemeral-execution.md

@@ -48,7 +48,7 @@ test.describe('Documentation Pages', { tag: '@docs' }, () => {
 
     test('has working internal links', async ({ page }) => {
       // Find an internal link
-      const internalLinks = page.locator('a[href^="/docs/"]')
+      const internalLinks = page.locator('article a[href^="/docs/"]')
       const count = await internalLinks.count()
 
       if (count > 0) {

plans/logger-refactor-plan.md

@@ -91,6 +91,6 @@ Then inside the CLI:
 /init
 ```
 
-1. **[Customize existing agents](/docs/agents#customizing-agents)** - Modify prompts and tools
-2. **[Create new agents](/docs/agents#creating-new-agents)** - Build specialized functionality
-3. **[Reference guide](/docs/agents#agent-reference)** - Complete field documentation
+1. **[Customize existing agents](/docs/agents/customizing-agents)** - Modify prompts and tools
+2. **[Create new agents](/docs/agents/creating-new-agents)** - Build specialized functionality
+3. **[Reference guide](/docs/agents/agent-reference)** - Complete field documentation

web/src/__tests__/docs/content-integrity.test.ts

@@ -32,7 +32,7 @@ Error: Agent 'my-custom-agent' not found
 Validation error: spawnableAgents contains invalid agent 'researcher-typo'
 ```
 
-**Fix:** Check spelling against [built-in agents list](/docs/agents#h2-built-in-agents), use exact IDs
+**Fix:** Check spelling against [built-in agents list](/docs/agents/overview#h2-built-in-agents), use exact IDs
 
 ### "Path not found" Error
 
@@ -294,7 +294,7 @@ git commit -m "Add custom reviewer agent"
 1. Check logs for error messages on startup
 2. Remove customizations until it works, then add back one at a time
 3. Join [Discord](https://codebuff.com/discord)
-4. See the [Agent Reference](/docs/agents#agent-reference)
+4. See the [Agent Reference](/docs/agents/agent-reference)
 
 ## Quick Reference
 

web/src/__tests__/e2e/docs.spec.ts

@@ -13,7 +13,7 @@ Software development: Writing features, tests, and scripts across common languag
 
 ## What model does Codebuff use?
 
-Multiple. The orchestrator ("Buffy") uses Claude Opus 4.5 in Default and Max modes, or Grok 4.1 Fast in Lite mode. Subagents are matched to their tasks: GPT-5.1 and Claude Opus 4.5 for code editing, Gemini 2.5 Pro for deep reasoning, Grok 4 Fast for terminal commands and research, and Relace AI for fast file rewrites. See [What models do you use?](/docs/advanced#what-models-do-you-use) for the full breakdown.
+Multiple. The orchestrator ("Buffy") uses Claude Opus 4.5 in Default and Max modes, or Grok 4.1 Fast in Lite mode. Subagents are matched to their tasks: GPT-5.1 and Claude Opus 4.5 for code editing, Gemini 2.5 Pro for deep reasoning, Grok 4 Fast for terminal commands and research, and Relace AI for fast file rewrites. See [What models do you use?](/docs/advanced/what-models) for the full breakdown.
 
 ## Is Codebuff open source?
 
@@ -72,10 +72,10 @@ Codebuff runs specialized models in parallel: one finds files, another reasons t
 
 ## How does Codebuff compare to Claude Code?
 
-See [Codebuff vs Claude Code](/docs/advanced#codebuff-vs-claude-code) for a detailed comparison. Short version: Codebuff is faster, cheaper, and handles large codebases better.
+See [Codebuff vs Claude Code](/docs/advanced/claude-code-comparison) for a detailed comparison. Short version: Codebuff is faster, cheaper, and handles large codebases better.
 
 ## I have more questions!
 
 Contact [support@codebuff.com](mailto:support@codebuff.com) or [join our Discord](https://codebuff.com/discord).
 
-[Troubleshooting](/docs/advanced#troubleshooting)
+[Troubleshooting](/docs/advanced/troubleshooting)

web/src/content/agents/overview.mdx

@@ -27,7 +27,7 @@ cd /path/to/your-repo
 codebuff
 ```
 
-Codebuff has multiple [modes](/docs/tips#modes): `lite` for quick tasks, `max` for complex work, and `plan` for planning without file changes. You can invoke them in the slash menu with `/mode:`.
+Codebuff has multiple [modes](/docs/tips/modes): `lite` for quick tasks, `max` for complex work, and `plan` for planning without file changes. You can invoke them in the slash menu with `/mode:`.
 
 ## 4. Initialize Your Project (Optional)
 
@@ -62,4 +62,4 @@ If you run into issues during installation:
    - On Mac/Linux, you can fix permissions with: `sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}`
    - On Windows, run your terminal as administrator
 
-[Troubleshooting](/docs/advanced#troubleshooting) | [Discord](https://codebuff.com/discord)
+[Troubleshooting](/docs/advanced/troubleshooting) | [Discord](https://codebuff.com/discord)

web/src/content/agents/troubleshooting-agent-customization.mdx

@@ -19,7 +19,7 @@ Codebuff skips files in `.gitignore`. For files you keep in git but want Codebuf
 
 Use `/mode:plan` to scope work before implementing. Codebuff gathers context, asks clarifying questions, and outputs a structured plan without touching files. Review and adjust the plan, then switch to default or max mode to execute.
 
-See [Modes](/docs/tips#modes) for details on plan mode and other options.
+See [Modes](/docs/tips/modes) for details on plan mode and other options.
 
 ## Include docs by link