docs: move comparison to web docs, revise README (#845)

* docs: move comparison to web docs, revise README for clarity

- Delete docs/ folder (COMPARISON.md + old plans)
- Move comparison table to web docs at /docs/reference/comparison/
- Add Braintrust to comparison (closed source)
- Rewrite README to be concise and value-prop focused
- Add Reference section to sidebar
- Update all docs links to /docs/* paths

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: flatten docs structure, add /docs/ entry point

Revert nested docs/docs/ back to flat. Add docs.mdx so /docs/
resolves directly. Fix sidebar directories and landing page links.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: christso

README.md

@@ -37,13 +37,14 @@ export default defineConfig({
         { icon: 'github', label: 'GitHub', href: 'https://github.com/EntityProcess/agentv' },
       ],
       sidebar: [
-        { label: 'Getting Started', autogenerate: { directory: 'docs/getting-started' } },
-        { label: 'Evaluation', autogenerate: { directory: 'docs/evaluation' } },
-        { label: 'Evaluators', autogenerate: { directory: 'docs/evaluators' } },
-        { label: 'Targets', autogenerate: { directory: 'docs/targets' } },
-        { label: 'Tools', autogenerate: { directory: 'docs/tools' } },
-        { label: 'Guides', autogenerate: { directory: 'docs/guides' } },
-        { label: 'Integrations', autogenerate: { directory: 'docs/integrations' } },
+        { label: 'Getting Started', autogenerate: { directory: 'getting-started' } },
+        { label: 'Evaluation', autogenerate: { directory: 'evaluation' } },
+        { label: 'Evaluators', autogenerate: { directory: 'evaluators' } },
+        { label: 'Targets', autogenerate: { directory: 'targets' } },
+        { label: 'Tools', autogenerate: { directory: 'tools' } },
+        { label: 'Guides', autogenerate: { directory: 'guides' } },
+        { label: 'Integrations', autogenerate: { directory: 'integrations' } },
+        { label: 'Reference', autogenerate: { directory: 'reference' } },
       ],
       editLink: {
         baseUrl: 'https://github.com/EntityProcess/agentv/edit/main/apps/web/',

apps/web/astro.config.mjs

@@ -13,7 +13,7 @@ import type { Props } from '@astrojs/starlight/props';
       <span class="av-wordmark">agent<span class="av-wordmark-v">v</span></span>
     </a>
     <div class="av-nav-links">
-      <a href="/docs/getting-started/introduction/">Docs</a>
+      <a href="/docs/">Docs</a>
       <a href="https://github.com/EntityProcess/agentv" target="_blank" rel="noopener noreferrer">GitHub</a>
       <button class="av-nav-pill" data-command="npm install -g agentv">
         <code>npm install -g agentv</code>
@@ -39,7 +39,7 @@ import type { Props } from '@astrojs/starlight/props';
           Deterministic code judges + customizable LLM judges, version-controlled in Git.
         </p>
         <div class="av-hero-cta">
-          <a href="/docs/getting-started/introduction/" class="av-btn-primary">Get Started</a>
+          <a href="/docs/" class="av-btn-primary">Get Started</a>
           <a href="https://github.com/EntityProcess/agentv" class="av-btn-ghost" target="_blank" rel="noopener noreferrer">
             <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
             GitHub
@@ -268,7 +268,7 @@ tests:
       <h2 class="av-gradient-text">Start evaluating your agents</h2>
       <p class="av-footer-sub">Open source. Local-first. MIT Licensed.</p>
       <div class="av-footer-actions">
-        <a href="/docs/getting-started/introduction/" class="av-btn-primary">Read the docs</a>
+        <a href="/docs/" class="av-btn-primary">Read the docs</a>
         <button class="av-footer-install" data-command="npm install -g agentv">
           <code>$ npm install -g agentv</code>
           <span class="av-copy-icon">