{
  "name": "Git.Top Agent Quickstart",
  "positioning": "The Knowledge Graph of Open Source",
  "summary": "A short, production-oriented path for agents and developers to move from health checks to workflow, Atlas journeys, project knowledge, recommendations, comparison, MCP, GRP, and trust evidence.",
  "production_endpoints": {
    "rest": "https://git.top/api/*",
    "mcp": "https://git.top/mcp",
    "mcp_core": "https://git.top/mcp/core",
    "grp": "https://git.top/api/grp/query"
  },
  "steps": [
    {
      "id": "check-trust-gate",
      "title": "Check Trust Gate",
      "purpose": "Get a single production-readiness decision before making a high-confidence recommendation.",
      "rest": "GET /api/trust",
      "mcp_tool": "get_trust_gate",
      "command": "curl https://git.top/api/trust",
      "inspect": [
        "decision",
        "production_ready",
        "checks[].status",
        "quality.release_score",
        "quality.data_trust_score",
        "metadata.source"
      ],
      "next": "Use the gate decision to decide whether to answer directly, disclose caveats, or fail closed."
    },
    {
      "id": "check-data-source",
      "title": "Check Data Source",
      "purpose": "Verify production data is D1-backed before making a high-confidence recommendation.",
      "rest": "GET /api/health",
      "command": "curl https://git.top/api/health",
      "inspect": [
        "db=available",
        "metadata.source=d1",
        "metadata.reason=d1_query",
        "sync_freshness"
      ],
      "next": "Use require_d1=true on critical REST calls when an agent should fail closed instead of accepting seed fallback."
    },
    {
      "id": "choose-workflow",
      "title": "Choose A Workflow",
      "purpose": "Use a guided path when the task spans trends, recommendations, graph, alternatives, score, compare, and trust checks.",
      "rest": "GET /api/workflow",
      "mcp_tool": "get_agent_workflow",
      "command": "curl \"https://git.top/api/workflow?intent=choose%20a%20Cloudflare-ready%20agent%20framework&deployment=cloudflare&category=agent_framework&cloudflare_ready=true&limit=5&require_d1=true\"",
      "inspect": [
        "recommended_sequence",
        "shortlist",
        "trend_context",
        "agent_map",
        "trust_policy"
      ],
      "next": "Start here for broad or ambiguous project-selection tasks after confirming the trust gate."
    },
    {
      "id": "inspect-surface-map",
      "title": "Inspect The Surface Map",
      "purpose": "Map each Git.Top product concept to the human page, REST endpoint, MCP tool, output fields, and trust fields.",
      "rest": "GET /api/agent-map",
      "command": "curl https://git.top/api/agent-map",
      "inspect": [
        "surfaces[].concept",
        "surfaces[].rest",
        "surfaces[].mcp_tools",
        "surfaces[].trust_fields"
      ],
      "next": "Use this before guessing whether to call recommendations, alternatives, graph, compare, score, Atlas, GRP, or quality endpoints. Treat short_path as the default route and reference_path as the expansion route."
    },
    {
      "id": "search-projects",
      "title": "Search Projects",
      "purpose": "Retrieve candidate projects by query, category, deployment, language, project kind, and Cloudflare readiness.",
      "rest": "GET /api/search",
      "mcp_tool": "search_projects",
      "command": "curl \"https://git.top/api/search?category=agent_framework&deployment=cloudflare&ranking=browse&limit=10&require_d1=true\"",
      "inspect": [
        "projects[].repo",
        "projects[].project_kind",
        "projects[].collection_metadata",
        "metadata.source"
      ],
      "next": "Use browse ranking for category discovery and query search for direct retrieval."
    },
    {
      "id": "explore-atlas-journeys",
      "title": "Explore Atlas Journeys",
      "purpose": "Start from an ecosystem map and move into ordered journeys plus comparison paths before choosing projects.",
      "rest": "GET /api/journeys",
      "mcp_tool": "get_atlas",
      "command": "curl https://git.top/api/journeys?limit=8&require_d1=true",
      "inspect": [
        "journeys[].steps",
        "comparison_paths",
        "comparison_paths[].api_href",
        "stats.comparison_path_count"
      ],
      "next": "Use comparison_paths when the user asks for ecosystem-specific shortlists or map-to-compare decisions."
    },
    {
      "id": "inspect-project",
      "title": "Inspect One Project",
      "purpose": "Fetch structured project knowledge and the compact agent summary before recommending, comparing, or citing a repository.",
      "rest": "GET /api/project/:project",
      "mcp_tool": "get_project",
      "command": "curl https://git.top/api/project/cloudflare/agents?require_d1=true",
      "inspect": [
        "summary.purpose",
        "summary.good_for",
        "summary.not_good_for",
        "quality_signal_confidence",
        "metadata.source"
      ],
      "next": "Use summary for first-pass agent reasoning, then check classification evidence before saying a project is Cloudflare-ready or production-fit."
    },
    {
      "id": "recommend",
      "title": "Ask For A Recommendation",
      "purpose": "Turn a concrete use case and constraints into an explainable shortlist.",
      "rest": "GET /api/recommend",
      "mcp_tool": "recommend_project",
      "command": "curl \"https://git.top/api/recommend?use_case=build%20a%20browser%20automation%20agent&deployment=docker&limit=5&require_d1=true\"",
      "inspect": [
        "recommendations[].decision_summary",
        "fit_profile",
        "adoption_plan",
        "risk_flags",
        "confidence"
      ],
      "next": "Present the top project, one alternative, caveats, and metadata source."
    },
    {
      "id": "compare",
      "title": "Compare Candidates",
      "purpose": "Use decision matrices instead of raw star counts when the user already has candidates.",
      "rest": "GET /api/compare",
      "mcp_tool": "compare_projects",
      "command": "curl \"https://git.top/api/compare?repos=cloudflare/agents,langchain-ai/langchain,run-llama/llama_index&deployment=cloudflare&require_d1=true\"",
      "inspect": [
        "summary",
        "decision_matrix",
        "winner",
        "reasoning",
        "next_actions"
      ],
      "next": "Move from comparison into graph, alternatives, score, or project pages before finalizing."
    },
    {
      "id": "quality",
      "title": "Check Trust And Coverage",
      "purpose": "Inspect release score, corpus data trust, coverage, stale data, and review risk before high-confidence answers.",
      "rest": "GET /api/quality",
      "mcp_tool": "get_quality_report",
      "command": "curl https://git.top/api/quality?require_d1=true",
      "inspect": [
        "release_score",
        "data_trust_score",
        "risk_level",
        "improvement_plan",
        "coverage",
        "issues",
        "metadata.source"
      ],
      "next": "Use the trust gate first, then disclose degraded sync, seed fallback, low classification confidence, or partial quality signals."
    },
    {
      "id": "grp",
      "title": "Use GRP For Goal-Level Planning",
      "purpose": "Use graph reasoning when the user asks for a plan, stack, comparison, or project set.",
      "rest": "POST /api/grp/query",
      "mcp_tool": "git_top_grp_query",
      "command": "curl -X POST \"https://git.top/api/grp/query?require_d1=true\" -H \"content-type: application/json\" -d '{\"goal\":\"build a Cloudflare-ready coding agent stack\",\"mode\":\"plan\",\"constraints\":{\"deploy\":[\"cloudflare\"],\"agent_ready\":true}}'",
      "inspect": [
        "solution_paths",
        "recommended_stack",
        "nodes",
        "edges",
        "metadata.data_source"
      ],
      "next": "Use GRP output as a plan, then fetch project, graph, score, and compare details for the final answer."
    }
  ],
  "output_pattern": [
    "Recommended repository.",
    "Why it matches the task.",
    "Deployment or runtime caveats.",
    "One credible alternative.",
    "Data source and confidence evidence."
  ],
  "trust_policy": [
    "Check /api/trust before high-confidence answers.",
    "Prefer metadata.source=d1 for production answers.",
    "Disclose metadata.source=seed as fallback mode.",
    "Check classification evidence before claiming deployment fit.",
    "Check quality_signal_confidence before citing score-driven claims.",
    "Use /api/quality, /api/health, and /api/sync/status when corpus freshness or confidence matters.",
    "Read improvement_plan when risk_level is medium or high."
  ]
}