{
  "name": "Git.Top 2.0 Product Roadmap",
  "positioning": "The Knowledge Graph of Open Source",
  "summary": "Git.Top 2.0 is mostly through the first product cycle: the Worker-only surface now exposes human pages and agent-readable APIs for discovery, alternatives, comparison, graph reasoning, scoring, Atlas, workflow, and trust.",
  "completion": 88,
  "current_focus": [
    "Expand high-intent topic pages and product guides.",
    "Improve Atlas exploration depth without reintroducing a separate frontend surface.",
    "Reduce data trust risk through sync freshness, classification review, and stronger alternatives evidence.",
    "Keep REST, MCP, OpenAPI, llms.txt, Agent Map, and human pages aligned."
  ],
  "phases": [
    {
      "id": "homepage-entry-points",
      "phase": 1,
      "title": "Homepage And Entry Points",
      "status": "implemented",
      "progress": 92,
      "goal": "Make the first visit explain Git.Top's value as the knowledge layer for open source.",
      "shipped": [
        "Homepage hero states The Knowledge Graph of Open Source.",
        "Discover, Compare, Alternatives, Workflow, Agent API, Score, Trust, Graph, Atlas, Recommend, and Ecosystems entry cards are live.",
        "High-value topic pages cover agents, MCP, RAG, browser automation, AI IDE, comparison, graph, score, workflow, alternatives, and trust."
      ],
      "next": [
        "Continue adding topic pages for high-intent discovery and SEO clusters."
      ],
      "human_pages": [
        "/",
        "/discover",
        "/compare",
        "/alternatives",
        "/topics/project-comparison-guide"
      ],
      "api_endpoints": [
        "/api/search",
        "/api/trends",
        "/api/compare",
        "/api/alternatives"
      ],
      "mcp_tools": [
        "search_projects",
        "get_trends",
        "compare_projects",
        "get_alternatives"
      ]
    },
    {
      "id": "project-knowledge-graph",
      "phase": 2,
      "title": "Project Knowledge Graph",
      "status": "implemented",
      "progress": 88,
      "goal": "Make relationship pages the core moat: related projects, alternatives, dependencies, deployments, and graph JSON.",
      "shipped": [
        "Project graph pages expose overview, relationship groups, deployment targets, dependencies, related projects, alternatives, filters, and exploration paths.",
        "Graph APIs expose summary, graph stats, relationship groups, nodes, edges, and next actions.",
        "Graph guide pages explain how humans and agents should read project relationships."
      ],
      "next": [
        "Introduce a client-side graph library only when relationship density needs richer interaction."
      ],
      "human_pages": [
        "/graph",
        "/graph/cloudflare/agents",
        "/topics/graph-guide",
        "/topics/project-graph-guide"
      ],
      "api_endpoints": [
        "/api/graph/cloudflare/agents",
        "/api/graph?repo=cloudflare/agents"
      ],
      "mcp_tools": [
        "get_project_graph"
      ]
    },
    {
      "id": "alternatives-engine",
      "phase": 3,
      "title": "Alternatives Engine",
      "status": "implemented",
      "progress": 86,
      "goal": "Turn alternatives into an SEO and decision-support entry point.",
      "shipped": [
        "Alternatives index and project alternatives pages are live.",
        "Alternative matches include fit summary, adoption notes, replacement risk, comparison links, and next actions.",
        "Matching uses explicit alternatives, category, deployment, use cases, topics, dependencies, language, maintenance, and Cloudflare readiness."
      ],
      "next": [
        "Improve semantic similarity when vector infrastructure is introduced."
      ],
      "human_pages": [
        "/alternatives",
        "/alternatives/langchain-ai/langchain",
        "/topics/alternatives-engine-guide"
      ],
      "api_endpoints": [
        "/api/alternatives/langchain-ai/langchain",
        "/api/alternatives"
      ],
      "mcp_tools": [
        "get_alternatives",
        "find_alternatives"
      ]
    },
    {
      "id": "project-score",
      "phase": 4,
      "title": "Git.Top Score",
      "status": "implemented",
      "progress": 90,
      "goal": "Stop relying on GitHub stars as the primary quality proxy.",
      "shipped": [
        "Project pages and score pages show Git.Top Score, Agent Score, Quality Score, weighted dimensions, confidence, evidence, and risk flags.",
        "Score APIs expose dimensions, strongest and weakest dimensions, adoption guidance, related scores, next actions, and score confidence.",
        "Quality and trust pages separate release score from corpus data trust."
      ],
      "next": [
        "Keep improving confidence evidence and reviewed overrides for flagship projects."
      ],
      "human_pages": [
        "/score/cloudflare/agents",
        "/topics/git-top-score-guide",
        "/quality",
        "/coverage"
      ],
      "api_endpoints": [
        "/api/score/cloudflare/agents",
        "/api/quality",
        "/api/quality/review"
      ],
      "mcp_tools": [
        "get_quality_score",
        "get_quality_report"
      ]
    },
    {
      "id": "atlas",
      "phase": 5,
      "title": "Atlas",
      "status": "active",
      "progress": 82,
      "goal": "Create an exploratory map for open-source ecosystems.",
      "shipped": [
        "Atlas maps are live for Cloudflare, AI Agents, MCP, RAG, and Browser AI.",
        "Atlas now includes AI IDE, LLM Gateway, AI Observability, and Workflow Automation ecosystems for denser exploration.",
        "Atlas exposes stats, exploration paths, graph nodes, graph edges, representative projects, and journeys.",
        "Atlas Journeys is live as a human page and JSON API for turning ecosystem maps into ordered exploration routes.",
        "Atlas now exposes ecosystem-specific comparison paths so users and agents can move from a map to a decision matrix.",
        "MCP get_atlas exposes the same curated maps to agents."
      ],
      "next": [
        "Add richer interactive graph controls when the Worker UI needs dense exploration."
      ],
      "human_pages": [
        "/atlas",
        "/journeys",
        "/atlas/cloudflare",
        "/atlas/agents",
        "/topics/atlas-guide"
      ],
      "api_endpoints": [
        "/api/atlas",
        "/api/atlas/cloudflare",
        "/api/journeys"
      ],
      "mcp_tools": [
        "get_atlas",
        "git_top_grp_query"
      ]
    },
    {
      "id": "agent-api",
      "phase": 6,
      "title": "Agent API",
      "status": "active",
      "progress": 89,
      "goal": "Make Git.Top a default structured knowledge source for agents.",
      "shipped": [
        "REST endpoints cover project lookup, recommendation, workflow, alternatives, graph, compare, score, trends, atlas, journeys, quality, quickstart, recipes, and agent map.",
        "MCP tools map to the same product concepts and support D1-required strict mode.",
        "llms.txt, llms-full.txt, OpenAPI, schema, Agent Map, Quickstart, Recipes, Examples, and workflow pages make the product machine-discoverable.",
        "Quickstart and Recipes now include Atlas journeys and comparison paths as first-class agent workflows.",
        "Knowledge Graph API and MCP integration guide pages now explain the human page, REST, MCP, OpenAPI, LLM discovery, output field, and trust-field pairs.",
        "API Examples now exposes copyable REST, MCP, and GRP calls through both /examples and /api/examples.",
        "Trust Gate is live at /trust and /api/trust to combine D1 source, sync freshness, release score, data trust score, and risk level into one production-readiness decision."
      ],
      "next": [
        "Continue tightening OpenAPI schemas and MCP integration recipes for common production workflows."
      ],
      "human_pages": [
        "/docs",
        "/quickstart",
        "/recipes",
        "/examples",
        "/integrations",
        "/workflow",
        "/trust",
        "/mcp",
        "/topics/open-source-knowledge-graph-api",
        "/topics/mcp-integration-guide",
        "/llms.txt"
      ],
      "api_endpoints": [
        "/api/project/cloudflare/agents",
        "/api/recommend",
        "/api/workflow",
        "/api/trust",
        "/api/quickstart",
        "/api/recipes",
        "/api/examples",
        "/api/agent-map",
        "/openapi.json",
        "/mcp"
      ],
      "mcp_tools": [
        "get_project",
        "recommend_project",
        "get_agent_workflow",
        "compare_projects",
        "get_quality_report"
      ]
    }
  ],
  "agent_use": [
    "Use /api/roadmap to understand which Git.Top surfaces are production-ready for a task.",
    "Use /api/agent-map to map a product concept to the matching REST endpoint, MCP tool, output fields, and trust fields.",
    "Use /api/workflow when the agent needs a guided path from trend context to shortlist, graph, alternatives, score, compare, and trust checks.",
    "Check /api/trust before making high-confidence production recommendations."
  ],
  "next_milestones": [
    "Add more decision-oriented topic pages for SEO and onboarding.",
    "Add richer Atlas journeys and ecosystem-specific comparison paths.",
    "Improve production data trust by shrinking stale sync and weak alternatives review queues.",
    "Extend MCP integration recipes for common agent selection workflows."
  ]
}