{
  "name": "Git.Top Agent Recipes",
  "positioning": "The Knowledge Graph of Open Source",
  "summary": "Executable REST and MCP-oriented recipes for common open-source knowledge tasks: choose, compare, replace, inspect graph context, explore ecosystems, map Atlas journeys, check trust, and plan project stacks.",
  "recipes": [
    {
      "id": "choose-cloudflare-agent-framework",
      "title": "Choose A Cloudflare-ready Agent Framework",
      "use_case": "A user wants an agent framework that fits Cloudflare or serverless deployment.",
      "outcome": "Return a shortlist, explain why the top project fits, and cite deployment and confidence evidence.",
      "steps": [
        {
          "label": "Check live data",
          "method": "GET",
          "endpoint": "/api/health",
          "command": "curl https://git.top/api/health",
          "inspect": [
            "db",
            "metadata.source",
            "sync_freshness"
          ]
        },
        {
          "label": "Build selection workflow",
          "method": "GET",
          "endpoint": "/api/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",
            "trust_policy"
          ]
        },
        {
          "label": "Inspect top project",
          "method": "GET",
          "endpoint": "/api/project/cloudflare/agents",
          "command": "curl https://git.top/api/project/cloudflare/agents?require_d1=true",
          "inspect": [
            "classification",
            "quality_signal_confidence",
            "related"
          ]
        },
        {
          "label": "Compare likely candidates",
          "method": "GET",
          "endpoint": "/api/compare",
          "command": "curl \"https://git.top/api/compare?repos=cloudflare/agents,langchain-ai/langchain&deployment=cloudflare&require_d1=true\"",
          "inspect": [
            "decision_matrix",
            "winner",
            "reasoning"
          ]
        }
      ],
      "trust_checks": [
        "metadata.source=d1",
        "classification.cloudflare_ready.evidence",
        "recommendations[].confidence",
        "quality_signal_confidence"
      ]
    },
    {
      "id": "find-project-alternatives",
      "title": "Find Alternatives To A Known Project",
      "use_case": "A user names a project and asks for replacements or adjacent options.",
      "outcome": "Return direct substitutes and adjacent options with replacement risk and next comparison links.",
      "steps": [
        {
          "label": "Resolve project",
          "method": "GET",
          "endpoint": "/api/project/:project",
          "command": "curl https://git.top/api/project/claude-code?require_d1=true",
          "inspect": [
            "repo",
            "resolved_from",
            "metadata.source"
          ]
        },
        {
          "label": "Fetch alternatives",
          "method": "GET",
          "endpoint": "/api/alternatives/:project",
          "command": "curl https://git.top/api/alternatives/claude-code?limit=8&require_d1=true",
          "inspect": [
            "alternative_matches",
            "replacement_risk",
            "comparison_links"
          ]
        },
        {
          "label": "Compare shortlist",
          "method": "GET",
          "endpoint": "/api/compare",
          "command": "curl \"https://git.top/api/compare?repos=anthropics/claude-code,sst/opencode&deployment=local&require_d1=true\"",
          "inspect": [
            "decision_matrix",
            "tradeoffs",
            "winner"
          ]
        }
      ],
      "trust_checks": [
        "alternative_matches[].similarity_score",
        "alternative_matches[].match_signals",
        "replacement_risk",
        "metadata.source"
      ]
    },
    {
      "id": "compare-shortlist",
      "title": "Compare A Shortlist",
      "use_case": "A user already has two or more candidate repositories.",
      "outcome": "Return a decision matrix and next actions instead of a star-only ranking.",
      "steps": [
        {
          "label": "Fetch comparison",
          "method": "GET",
          "endpoint": "/api/compare",
          "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"
          ]
        },
        {
          "label": "Explain score",
          "method": "GET",
          "endpoint": "/api/score/:project",
          "command": "curl https://git.top/api/score/cloudflare/agents?require_d1=true",
          "inspect": [
            "dimensions",
            "score_confidence",
            "risk_flags"
          ]
        },
        {
          "label": "Inspect graph context",
          "method": "GET",
          "endpoint": "/api/graph/:project",
          "command": "curl https://git.top/api/graph/cloudflare/agents?limit=18&require_d1=true",
          "inspect": [
            "relationship_groups",
            "graph_stats",
            "next_actions"
          ]
        }
      ],
      "trust_checks": [
        "context.deployment",
        "decision_matrix[].tradeoffs",
        "score_confidence.level",
        "relationship_groups"
      ]
    },
    {
      "id": "inspect-project-graph",
      "title": "Inspect Project Graph Context",
      "use_case": "A user wants to understand a project's alternatives, dependencies, related projects, and deployment targets.",
      "outcome": "Return the graph summary, grouped relationships, and follow-up links.",
      "steps": [
        {
          "label": "Fetch graph",
          "method": "GET",
          "endpoint": "/api/graph/:project",
          "command": "curl https://git.top/api/graph/browser-use/browser-use?limit=24&require_d1=true",
          "inspect": [
            "summary",
            "graph_stats",
            "relationship_groups",
            "nodes",
            "edges"
          ]
        },
        {
          "label": "Open human page",
          "method": "GET",
          "endpoint": "/graph/:project",
          "command": "curl https://git.top/graph/browser-use/browser-use",
          "inspect": [
            "Project overview",
            "relationship legend",
            "exploration paths"
          ]
        },
        {
          "label": "Fetch alternatives",
          "method": "GET",
          "endpoint": "/api/alternatives/:project",
          "command": "curl https://git.top/api/alternatives/browser-use/browser-use?limit=6&require_d1=true",
          "inspect": [
            "fit_summary",
            "adoption_notes",
            "replacement_risk"
          ]
        }
      ],
      "trust_checks": [
        "graph_stats.relationship_counts",
        "relationship_groups.dependencies",
        "metadata.source"
      ]
    },
    {
      "id": "explore-ecosystem",
      "title": "Explore An Ecosystem",
      "use_case": "A user asks for a map of Cloudflare, MCP, RAG, AI agents, or Browser AI.",
      "outcome": "Return representative projects, concept nodes, exploration paths, comparison paths, and next journeys.",
      "steps": [
        {
          "label": "Fetch Atlas",
          "method": "GET",
          "endpoint": "/api/atlas/:ecosystem",
          "command": "curl https://git.top/api/atlas/cloudflare?limit=8&require_d1=true",
          "inspect": [
            "ecosystem.stats",
            "map.nodes",
            "map.edges",
            "exploration_paths",
            "comparison_paths"
          ]
        },
        {
          "label": "Browse human map",
          "method": "GET",
          "endpoint": "/atlas/:ecosystem",
          "command": "curl https://git.top/atlas/cloudflare",
          "inspect": [
            "representative projects",
            "journeys",
            "comparison paths",
            "map"
          ]
        },
        {
          "label": "Recommend within ecosystem",
          "method": "GET",
          "endpoint": "/api/recommend",
          "command": "curl \"https://git.top/api/recommend?use_case=build%20Cloudflare-ready%20AI%20agents&deployment=cloudflare&category=agent_framework&cloudflare_ready=true&require_d1=true\"",
          "inspect": [
            "recommendations",
            "fit_profile",
            "risk_flags"
          ]
        }
      ],
      "trust_checks": [
        "stats.project_count",
        "exploration_paths",
        "comparison_paths[].context",
        "recommendations[].confidence",
        "metadata.source"
      ]
    },
    {
      "id": "map-ecosystem-to-comparison",
      "title": "Map An Ecosystem To Comparison Paths",
      "use_case": "A user wants to move from an ecosystem map to concrete candidate comparisons.",
      "outcome": "Return ecosystem-specific comparison paths, run the selected Compare JSON, and cite why the shortlist was chosen.",
      "steps": [
        {
          "label": "Fetch journey index",
          "method": "GET",
          "endpoint": "/api/journeys",
          "command": "curl https://git.top/api/journeys?limit=8&require_d1=true",
          "inspect": [
            "journeys",
            "comparison_paths",
            "stats.comparison_path_count",
            "metadata.source"
          ]
        },
        {
          "label": "Fetch ecosystem map",
          "method": "GET",
          "endpoint": "/api/atlas/:ecosystem",
          "command": "curl https://git.top/api/atlas/cloudflare?limit=8&require_d1=true",
          "inspect": [
            "ecosystem.comparison_paths",
            "ecosystem.map.nodes",
            "ecosystem.stats"
          ]
        },
        {
          "label": "Run comparison path",
          "method": "GET",
          "endpoint": "/api/compare",
          "command": "curl \"https://git.top/api/compare?repos=cloudflare/agents,langchain-ai/langchain&deployment=cloudflare&require_d1=true\"",
          "inspect": [
            "summary",
            "decision_matrix",
            "winner",
            "next_actions"
          ]
        }
      ],
      "trust_checks": [
        "comparison_paths[].repos",
        "comparison_paths[].decision_focus",
        "decision_matrix[].tradeoffs",
        "metadata.source=d1"
      ]
    },
    {
      "id": "check-recommendation-trust",
      "title": "Check Recommendation Trust",
      "use_case": "A user or agent needs to know whether recommendations are safe to cite.",
      "outcome": "Return release score, data trust score, risk level, and disclosure guidance.",
      "steps": [
        {
          "label": "Fetch health",
          "method": "GET",
          "endpoint": "/api/health",
          "command": "curl https://git.top/api/health",
          "inspect": [
            "db",
            "metadata.source",
            "sync_health",
            "sync_freshness"
          ]
        },
        {
          "label": "Fetch quality report",
          "method": "GET",
          "endpoint": "/api/quality",
          "command": "curl https://git.top/api/quality?require_d1=true",
          "inspect": [
            "release_score",
            "data_trust_score",
            "risk_level",
            "improvement_plan",
            "coverage",
            "issues"
          ]
        },
        {
          "label": "Fetch review queue",
          "method": "GET",
          "endpoint": "/api/quality/review",
          "command": "curl https://git.top/api/quality/review?require_d1=true",
          "inspect": [
            "review_count",
            "items",
            "impact_score"
          ]
        },
        {
          "label": "Fetch coverage page",
          "method": "GET",
          "endpoint": "/coverage",
          "command": "curl https://git.top/coverage",
          "inspect": [
            "category distribution",
            "collection semantics",
            "use boundaries"
          ]
        }
      ],
      "trust_checks": [
        "release_score",
        "data_trust_score",
        "risk_summary.reasons",
        "improvement_plan",
        "coverage.low_confidence_classification_rate"
      ]
    },
    {
      "id": "plan-with-grp",
      "title": "Plan With Graph Reasoning",
      "use_case": "A user asks for a plan, stack, or project set rather than a single repository.",
      "outcome": "Return graph-grounded paths or stacks, then validate candidate projects through normal APIs.",
      "steps": [
        {
          "label": "Run GRP",
          "method": "POST",
          "endpoint": "/api/grp/query",
          "command": "curl -X POST \"https://git.top/api/grp/query?require_d1=true\" -H \"content-type: application/json\" -d '{\"goal\":\"compose an autonomous coding stack with MCP tools\",\"mode\":\"compose\",\"constraints\":{\"agent_ready\":true}}'",
          "inspect": [
            "solution_paths",
            "recommended_stack",
            "nodes",
            "metadata.data_source"
          ]
        },
        {
          "label": "Inspect candidate",
          "method": "GET",
          "endpoint": "/api/project/:project",
          "command": "curl https://git.top/api/project/cloudflare/agents?require_d1=true",
          "inspect": [
            "classification",
            "related",
            "quality_signal_confidence"
          ]
        },
        {
          "label": "Compare final stack candidates",
          "method": "GET",
          "endpoint": "/api/compare",
          "command": "curl \"https://git.top/api/compare?repos=cloudflare/agents,github/github-mcp-server&require_d1=true\"",
          "inspect": [
            "decision_matrix",
            "next_actions"
          ]
        }
      ],
      "trust_checks": [
        "metadata.data_source",
        "nodes[].repo",
        "classification evidence",
        "comparison tradeoffs"
      ]
    }
  ]
}