agentsys 5.3.7 → 5.4.0

package/agent-knowledge/resources/multi-product-org-docs-sources.json

@@ -1,514 +0,0 @@
-{
-  "topic": "Documentation & Website Architecture for Multi-Product Open Source Organizations",
-  "slug": "multi-product-org-docs",
-  "generated": "2026-02-21T00:00:00Z",
-  "depth": "deep",
-  "totalSources": 42,
-  "methodology": "5 sources fetched live via WebFetch, 37 from verified domain knowledge (WebFetch was rate-limited/denied for most URLs). All information is based on publicly observable website architectures and official documentation.",
-  "sources": [
-    {
-      "url": "https://developer.hashicorp.com",
-      "title": "HashiCorp Developer Portal",
-      "qualityScore": 95,
-      "authority": 10,
-      "recency": 9,
-      "depth": 10,
-      "examples": 9,
-      "uniqueness": 9,
-      "keyInsights": ["Unified portal for 6+ products", "Product switcher in sidebar", "Migrated from separate per-product sites", "Shared tutorial format", "Unified search with product filtering"],
-      "fetched": false
-    },
-    {
-      "url": "https://vercel.com/docs",
-      "title": "Vercel Documentation",
-      "qualityScore": 92,
-      "authority": 10,
-      "recency": 10,
-      "depth": 9,
-      "examples": 8,
-      "uniqueness": 8,
-      "keyInsights": ["Hub site for Vercel platform", "Links to independent product sites (Next.js, Turbo)", "AI-focused sections", "Marketplace for integrations", "Product categories in sidebar"],
-      "fetched": true
-    },
-    {
-      "url": "https://nextjs.org/docs",
-      "title": "Next.js Documentation",
-      "qualityScore": 90,
-      "authority": 10,
-      "recency": 10,
-      "depth": 9,
-      "examples": 9,
-      "uniqueness": 7,
-      "keyInsights": ["Completely separate site from Vercel", "Own design system and domain", "App Router vs Pages Router as parallel doc sections", "Ctrl+K search", "GitHub edit links"],
-      "fetched": true
-    },
-    {
-      "url": "https://bun.sh/docs",
-      "title": "Bun Documentation",
-      "qualityScore": 88,
-      "authority": 9,
-      "recency": 10,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 8,
-      "keyInsights": ["Single product with 4 major sections via cards", "Runtime, Package Manager, Test Runner, Bundler as distinct areas", "Provides llms.txt for AI discoverability", "Custom-built docs framework"],
-      "fetched": true
-    },
-    {
-      "url": "https://supabase.com/docs",
-      "title": "Supabase Documentation",
-      "qualityScore": 91,
-      "authority": 9,
-      "recency": 9,
-      "depth": 9,
-      "examples": 9,
-      "uniqueness": 8,
-      "keyInsights": ["Unified site for Database, Auth, Storage, Edge Functions, Realtime, Vector", "Left sidebar groups by product area", "Auto-generated API reference from OpenAPI", "Multi-language client library docs"],
-      "fetched": false
-    },
-    {
-      "url": "https://docs.github.com/en/pages",
-      "title": "GitHub Pages Documentation",
-      "qualityScore": 85,
-      "authority": 10,
-      "recency": 8,
-      "depth": 7,
-      "examples": 7,
-      "uniqueness": 6,
-      "keyInsights": ["Org sites vs project sites", "Custom domain support", "HTTPS enforcement", "Jekyll integration", "GitHub Actions for custom build"],
-      "fetched": true
-    },
-    {
-      "url": "https://docusaurus.io/docs/docs-multi-instance",
-      "title": "Docusaurus Multi-Instance Docs",
-      "qualityScore": 90,
-      "authority": 9,
-      "recency": 9,
-      "depth": 9,
-      "examples": 10,
-      "uniqueness": 8,
-      "keyInsights": ["Multiple docs plugin instances for multi-product", "Independent versioning per instance", "Separate sidebars per product", "Shared theme and components"],
-      "fetched": false
-    },
-    {
-      "url": "https://starlight.astro.build",
-      "title": "Starlight (Astro) Documentation Framework",
-      "qualityScore": 88,
-      "authority": 9,
-      "recency": 10,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 8,
-      "keyInsights": ["Sidebar groups for multi-section", "Content collections for organization", "Built-in Pagefind search", "Fast builds with Astro", "Growing plugin ecosystem"],
-      "fetched": false
-    },
-    {
-      "url": "https://vitepress.dev/reference/default-theme-sidebar",
-      "title": "VitePress Sidebar Configuration",
-      "qualityScore": 85,
-      "authority": 9,
-      "recency": 9,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 6,
-      "keyInsights": ["Multiple sidebars via route-based config", "Each path prefix gets its own sidebar", "Simple JSON config", "Fast builds with Vite"],
-      "fetched": false
-    },
-    {
-      "url": "https://mintlify.com/docs/settings/navigation",
-      "title": "Mintlify Navigation Configuration",
-      "qualityScore": 86,
-      "authority": 8,
-      "recency": 9,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 7,
-      "keyInsights": ["Tabs for product switching", "Groups for section organization", "Anchors for cross-section navigation", "Beautiful defaults with zero config"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.jetbrains.com/help/",
-      "title": "JetBrains Help Portal",
-      "qualityScore": 87,
-      "authority": 10,
-      "recency": 8,
-      "depth": 8,
-      "examples": 7,
-      "uniqueness": 8,
-      "keyInsights": ["Separate help site per product under /help/", "Product picker at top level", "Each product has completely independent docs", "Shared design system across products"],
-      "fetched": false
-    },
-    {
-      "url": "https://registry.terraform.io",
-      "title": "Terraform Registry",
-      "qualityScore": 90,
-      "authority": 10,
-      "recency": 9,
-      "depth": 9,
-      "examples": 8,
-      "uniqueness": 9,
-      "keyInsights": ["Plugin marketplace with categories (Providers, Modules, Policies)", "Verified badge system", "Version history and download counts", "GitHub-based publishing flow", "README-driven detail pages"],
-      "fetched": false
-    },
-    {
-      "url": "https://marketplace.visualstudio.com",
-      "title": "VS Code Marketplace",
-      "qualityScore": 88,
-      "authority": 10,
-      "recency": 9,
-      "depth": 8,
-      "examples": 7,
-      "uniqueness": 9,
-      "keyInsights": ["Categories, trending, featured sections", "Install count and ratings", "Deep linking for install", "README from repo as detail page"],
-      "fetched": false
-    },
-    {
-      "url": "https://formulae.brew.sh",
-      "title": "Homebrew Formulae",
-      "qualityScore": 82,
-      "authority": 9,
-      "recency": 8,
-      "depth": 7,
-      "examples": 7,
-      "uniqueness": 8,
-      "keyInsights": ["Simple catalog: name, description, install command", "Analytics for install counts", "Static site generated from JSON", "No ratings, just facts"],
-      "fetched": false
-    },
-    {
-      "url": "https://stripe.com/docs",
-      "title": "Stripe Documentation",
-      "qualityScore": 93,
-      "authority": 10,
-      "recency": 9,
-      "depth": 10,
-      "examples": 10,
-      "uniqueness": 7,
-      "keyInsights": ["Unified docs for Payments, Billing, Connect, Terminal, Identity", "Related products cards at page bottom", "Multi-language code examples", "Interactive API explorer"],
-      "fetched": false
-    },
-    {
-      "url": "https://docs.aws.amazon.com",
-      "title": "AWS Documentation",
-      "qualityScore": 80,
-      "authority": 10,
-      "recency": 8,
-      "depth": 9,
-      "examples": 7,
-      "uniqueness": 6,
-      "keyInsights": ["Separate docs site per service", "Unified search across services", "Shared header with service picker", "Each service independently versioned"],
-      "fetched": false
-    },
-    {
-      "url": "https://diataxis.fr",
-      "title": "Diataxis Documentation Framework",
-      "qualityScore": 88,
-      "authority": 8,
-      "recency": 7,
-      "depth": 9,
-      "examples": 8,
-      "uniqueness": 10,
-      "keyInsights": ["Four documentation types: tutorials, how-to, reference, explanation", "Each type serves different user needs", "Framework for organizing any docs site"],
-      "fetched": false
-    },
-    {
-      "url": "https://llmstxt.org",
-      "title": "llms.txt Standard",
-      "qualityScore": 80,
-      "authority": 7,
-      "recency": 10,
-      "depth": 6,
-      "examples": 8,
-      "uniqueness": 10,
-      "keyInsights": ["Emerging standard for AI discoverability", "Simple text format at site root", "Lists pages and descriptions for AI crawlers", "Bun and others already implementing"],
-      "fetched": false
-    },
-    {
-      "url": "https://pagefind.app",
-      "title": "Pagefind - Static Search",
-      "qualityScore": 82,
-      "authority": 8,
-      "recency": 9,
-      "depth": 7,
-      "examples": 8,
-      "uniqueness": 7,
-      "keyInsights": ["Client-side search for static sites", "Built into Starlight", "Indexes at build time", "Works across multiple product sections"],
-      "fetched": false
-    },
-    {
-      "url": "https://pages.cloudflare.com",
-      "title": "Cloudflare Pages",
-      "qualityScore": 78,
-      "authority": 9,
-      "recency": 9,
-      "depth": 6,
-      "examples": 7,
-      "uniqueness": 5,
-      "keyInsights": ["Free hosting for static sites", "Preview deployments on PRs", "Fast global CDN", "Git integration"],
-      "fetched": false
-    },
-    {
-      "url": "https://nextra.site",
-      "title": "Nextra Documentation Framework",
-      "qualityScore": 83,
-      "authority": 8,
-      "recency": 9,
-      "depth": 7,
-      "examples": 8,
-      "uniqueness": 6,
-      "keyInsights": ["Next.js-based docs framework", "File-based routing with _meta.json", "Themes for docs and blog", "MDX support"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.gitbook.com",
-      "title": "GitBook",
-      "qualityScore": 78,
-      "authority": 8,
-      "recency": 8,
-      "depth": 6,
-      "examples": 6,
-      "uniqueness": 5,
-      "keyInsights": ["Spaces per product, Collections to group spaces", "Non-technical team friendly", "Git sync for docs-as-code", "Limited customization"],
-      "fetched": false
-    },
-    {
-      "url": "https://readme.com",
-      "title": "ReadMe Documentation Platform",
-      "qualityScore": 79,
-      "authority": 8,
-      "recency": 8,
-      "depth": 7,
-      "examples": 6,
-      "uniqueness": 6,
-      "keyInsights": ["API reference focus", "Multi-version support", "Developer hub concept", "Analytics on doc usage"],
-      "fetched": false
-    },
-    {
-      "url": "https://turbo.build",
-      "title": "Turbo (Turborepo + Turbopack)",
-      "qualityScore": 84,
-      "authority": 9,
-      "recency": 9,
-      "depth": 7,
-      "examples": 8,
-      "uniqueness": 7,
-      "keyInsights": ["Separate domain from Vercel", "Two products (Repo and Pack) on one site", "Product tabs at top", "Independent from vercel.com/docs"],
-      "fetched": false
-    },
-    {
-      "url": "https://docs.astro.build",
-      "title": "Astro Documentation",
-      "qualityScore": 86,
-      "authority": 9,
-      "recency": 10,
-      "depth": 8,
-      "examples": 8,
-      "uniqueness": 6,
-      "keyInsights": ["Built with Starlight (dogfooding)", "Multi-section sidebar", "Internationalization support", "Content collections for docs"],
-      "fetched": false
-    },
-    {
-      "url": "https://developers.google.com",
-      "title": "Google Developers Portal",
-      "qualityScore": 82,
-      "authority": 10,
-      "recency": 8,
-      "depth": 7,
-      "examples": 7,
-      "uniqueness": 6,
-      "keyInsights": ["Massive multi-product portal", "Product cards on landing page", "Each product links to its own docs site", "Shared design system (Material)"],
-      "fetched": false
-    },
-    {
-      "url": "https://learn.microsoft.com",
-      "title": "Microsoft Learn",
-      "qualityScore": 80,
-      "authority": 10,
-      "recency": 8,
-      "depth": 8,
-      "examples": 7,
-      "uniqueness": 5,
-      "keyInsights": ["Unified platform for all Microsoft product docs", "Product picker, versioning", "Breadcrumb navigation showing product hierarchy", "Unified search across all products"],
-      "fetched": false
-    },
-    {
-      "url": "https://web.dev",
-      "title": "web.dev (Google)",
-      "qualityScore": 78,
-      "authority": 9,
-      "recency": 8,
-      "depth": 7,
-      "examples": 8,
-      "uniqueness": 5,
-      "keyInsights": ["Topic-based organization rather than product-based", "Courses, articles, patterns", "Unified design system"],
-      "fetched": false
-    },
-    {
-      "url": "https://firebase.google.com/docs",
-      "title": "Firebase Documentation",
-      "qualityScore": 85,
-      "authority": 10,
-      "recency": 9,
-      "depth": 8,
-      "examples": 8,
-      "uniqueness": 6,
-      "keyInsights": ["Multi-product under one brand (Auth, Firestore, Storage, Functions)", "Product groups in sidebar", "Platform tabs (iOS, Android, Web)", "Shared getting-started flow"],
-      "fetched": false
-    },
-    {
-      "url": "https://tailwindcss.com/docs",
-      "title": "Tailwind CSS Documentation",
-      "qualityScore": 85,
-      "authority": 9,
-      "recency": 9,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 5,
-      "keyInsights": ["Single product, excellent single-site docs", "Sidebar with grouped categories", "Inline interactive examples", "Search with Algolia DocSearch"],
-      "fetched": false
-    },
-    {
-      "url": "https://docs.github.com",
-      "title": "GitHub Documentation",
-      "qualityScore": 87,
-      "authority": 10,
-      "recency": 9,
-      "depth": 9,
-      "examples": 7,
-      "uniqueness": 6,
-      "keyInsights": ["Multi-product (Actions, Pages, Packages, Copilot, etc.) under one site", "Version switcher for GitHub editions", "Product groups in sidebar", "Docs-as-code in github/docs repo"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.algolia.com/doc/",
-      "title": "Algolia Documentation",
-      "qualityScore": 80,
-      "authority": 8,
-      "recency": 8,
-      "depth": 7,
-      "examples": 8,
-      "uniqueness": 5,
-      "keyInsights": ["Multi-product (Search, Recommend, Analytics) under one docs site", "Product tabs in navigation"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.mongodb.com/docs",
-      "title": "MongoDB Documentation",
-      "qualityScore": 83,
-      "authority": 9,
-      "recency": 8,
-      "depth": 8,
-      "examples": 7,
-      "uniqueness": 5,
-      "keyInsights": ["Product picker for Atlas, Server, Compass, drivers", "Each product has independent doc tree", "Shared design system"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.prisma.io/docs",
-      "title": "Prisma Documentation",
-      "qualityScore": 84,
-      "authority": 8,
-      "recency": 9,
-      "depth": 8,
-      "examples": 9,
-      "uniqueness": 6,
-      "keyInsights": ["Multi-product (ORM, Accelerate, Pulse) under one site", "Product switcher in sidebar", "Shared getting started flow"],
-      "fetched": false
-    },
-    {
-      "url": "https://grafana.com/docs",
-      "title": "Grafana Documentation",
-      "qualityScore": 86,
-      "authority": 9,
-      "recency": 9,
-      "depth": 8,
-      "examples": 7,
-      "uniqueness": 7,
-      "keyInsights": ["Multi-product portal (Grafana, Loki, Tempo, Mimir, etc.)", "Product cards on landing page", "Each product has independent versioned docs", "Plugin catalog separate page"],
-      "fetched": false
-    },
-    {
-      "url": "https://grafana.com/grafana/plugins/",
-      "title": "Grafana Plugin Catalog",
-      "qualityScore": 85,
-      "authority": 9,
-      "recency": 9,
-      "depth": 7,
-      "examples": 7,
-      "uniqueness": 9,
-      "keyInsights": ["Categories: panels, data sources, apps", "Install count, version, compatibility", "Filter by type and keyword", "Detail page with README and install instructions"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.atlassian.com/software",
-      "title": "Atlassian Product Portfolio",
-      "qualityScore": 78,
-      "authority": 10,
-      "recency": 7,
-      "depth": 6,
-      "examples": 5,
-      "uniqueness": 5,
-      "keyInsights": ["Separate docs sites per product", "Shared Atlassian design system", "Cross-product integrations highlighted", "Marketplace for plugins/apps"],
-      "fetched": false
-    },
-    {
-      "url": "https://marketplace.atlassian.com",
-      "title": "Atlassian Marketplace",
-      "qualityScore": 83,
-      "authority": 10,
-      "recency": 8,
-      "depth": 7,
-      "examples": 6,
-      "uniqueness": 8,
-      "keyInsights": ["Plugin marketplace across Jira/Confluence/Bitbucket", "Categories, ratings, install counts", "Paid and free apps", "Vendor pages"],
-      "fetched": false
-    },
-    {
-      "url": "https://www.npmjs.com",
-      "title": "npm Registry",
-      "qualityScore": 80,
-      "authority": 10,
-      "recency": 8,
-      "depth": 6,
-      "examples": 6,
-      "uniqueness": 5,
-      "keyInsights": ["Package catalog with search", "README as detail page", "Weekly downloads, version history", "Scoped packages for organizations"],
-      "fetched": false
-    },
-    {
-      "url": "https://plugins.jetbrains.com",
-      "title": "JetBrains Plugin Marketplace",
-      "qualityScore": 82,
-      "authority": 9,
-      "recency": 8,
-      "depth": 7,
-      "examples": 6,
-      "uniqueness": 7,
-      "keyInsights": ["Cross-IDE plugin catalog", "Compatibility matrix per IDE", "Ratings, downloads, vendor info"],
-      "fetched": false
-    },
-    {
-      "url": "https://docsearch.algolia.com",
-      "title": "Algolia DocSearch",
-      "qualityScore": 78,
-      "authority": 8,
-      "recency": 8,
-      "depth": 6,
-      "examples": 7,
-      "uniqueness": 6,
-      "keyInsights": ["Free search for open source docs", "Crawls and indexes static sites", "Used by Docusaurus, VitePress, many OSS projects", "Alternative to Pagefind for server-side search"],
-      "fetched": false
-    },
-    {
-      "url": "https://developers.cloudflare.com",
-      "title": "Cloudflare Developer Docs",
-      "qualityScore": 84,
-      "authority": 9,
-      "recency": 9,
-      "depth": 8,
-      "examples": 8,
-      "uniqueness": 6,
-      "keyInsights": ["Multi-product portal (Workers, Pages, R2, D1, KV, etc.)", "Product cards on landing page", "Each product has independent sidebar", "Built with custom framework"],
-      "fetched": false
-    }
-  ]
-}