{ "name": "Git.Top Agent Selection Workflow", "positioning": "The Knowledge Graph of Open Source", "purpose": "Turn an agent's open-source selection goal into a structured path across trends, recommendations, graph, alternatives, score, compare, and trust checks.", "input": { "intent": "choose a RAG framework", "project_id": null, "constraints": { "deployment": "local", "category": "rag_framework", "license": null, "language": null, "difficulty": null, "cloudflare_ready": null }, "limit": 5 }, "summary": "Use this workflow to move from trend context to shortlist, graph inspection, alternatives, score explanation, and final comparison for \"choose a RAG framework\". 5 candidate(s) were shortlisted. Focus project: huggingface/transformers.", "recommended_sequence": [ { "step": 1, "name": "Check data trust", "purpose": "Verify that production recommendations can rely on D1-backed knowledge.", "method": "GET", "url": "/api/health?require_d1=true", "mcp_tool": null }, { "step": 2, "name": "Read trend context", "purpose": "Understand corpus-level category, deployment, language, and rising-project signals before picking candidates.", "method": "GET", "url": "/api/trends?limit=5", "mcp_tool": "get_trends" }, { "step": 3, "name": "Generate shortlist", "purpose": "Get ranked candidates with fit profile, adoption plan, risk flags, confidence, and next actions.", "method": "GET", "url": "/api/recommend?use_case=choose+a+RAG+framework&deployment=local&category=rag_framework&limit=5", "mcp_tool": "recommend_project" }, { "step": 4, "name": "Inspect project graph", "purpose": "Read alternatives, related projects, dependencies, deployment targets, and graph edges for the leading candidate.", "method": "GET", "url": "/api/graph/huggingface/transformers?limit=24", "mcp_tool": "get_project_graph" }, { "step": 5, "name": "Find alternatives", "purpose": "Separate direct substitutes from adjacent options with similarity score, match signals, adoption notes, and replacement risk.", "method": "GET", "url": "/api/alternatives/huggingface/transformers?limit=5", "mcp_tool": "get_alternatives" }, { "step": 6, "name": "Explain score", "purpose": "Inspect Git.Top Score dimensions, score confidence, evidence, risk flags, and adoption guidance.", "method": "GET", "url": "/api/score/huggingface/transformers", "mcp_tool": "get_quality_score" }, { "step": 7, "name": "Compare final candidates", "purpose": "Turn the shortlist into a decision matrix with winner reasoning and tradeoffs.", "method": "GET", "url": "/api/compare?repos=huggingface%2Ftransformers%2Cggml-org%2Fllama.cpp%2Cinfiniflow%2Fragflow%2Cmem0ai%2Fmem0%2CQuantumNous%2Fnew-api", "mcp_tool": "compare_projects" } ], "shortlist": [ { "project_id": "huggingface/transformers", "score": 66, "confidence": "high", "decision_summary": "huggingface/transformers is a strong candidate for \"choose a RAG framework\": recommendation score 66/100 with matched deployment, category constraints.", "next_actions": [ { "label": "Open project knowledge", "href": "/projects/huggingface/transformers", "kind": "project" }, { "label": "Inspect graph", "href": "/graph/huggingface/transformers", "kind": "graph" }, { "label": "Find alternatives", "href": "/alternatives/huggingface/transformers", "kind": "alternatives" }, { "label": "Explain score", "href": "/score/huggingface/transformers", "kind": "score" }, { "label": "Compare shortlist", "href": "/compare/huggingface/transformers", "kind": "compare" } ] }, { "project_id": "ggml-org/llama.cpp", "score": 66, "confidence": "high", "decision_summary": "ggml-org/llama.cpp is a strong candidate for \"choose a RAG framework\": recommendation score 66/100 with matched deployment, category constraints.", "next_actions": [ { "label": "Open project knowledge", "href": "/projects/ggml-org/llama.cpp", "kind": "project" }, { "label": "Inspect graph", "href": "/graph/ggml-org/llama.cpp", "kind": "graph" }, { "label": "Find alternatives", "href": "/alternatives/ggml-org/llama.cpp", "kind": "alternatives" }, { "label": "Explain score", "href": "/score/ggml-org/llama.cpp", "kind": "score" }, { "label": "Compare shortlist", "href": "/compare/ggml-org/llama.cpp", "kind": "compare" } ] }, { "project_id": "infiniflow/ragflow", "score": 66, "confidence": "high", "decision_summary": "infiniflow/ragflow is a strong candidate for \"choose a RAG framework\": recommendation score 66/100 with matched deployment, category constraints.", "next_actions": [ { "label": "Open project knowledge", "href": "/projects/infiniflow/ragflow", "kind": "project" }, { "label": "Inspect graph", "href": "/graph/infiniflow/ragflow", "kind": "graph" }, { "label": "Find alternatives", "href": "/alternatives/infiniflow/ragflow", "kind": "alternatives" }, { "label": "Explain score", "href": "/score/infiniflow/ragflow", "kind": "score" }, { "label": "Compare shortlist", "href": "/compare/infiniflow/ragflow", "kind": "compare" } ] }, { "project_id": "mem0ai/mem0", "score": 66, "confidence": "high", "decision_summary": "mem0ai/mem0 is a strong candidate for \"choose a RAG framework\": recommendation score 66/100 with matched deployment, category constraints.", "next_actions": [ { "label": "Open project knowledge", "href": "/projects/mem0ai/mem0", "kind": "project" }, { "label": "Inspect graph", "href": "/graph/mem0ai/mem0", "kind": "graph" }, { "label": "Find alternatives", "href": "/alternatives/mem0ai/mem0", "kind": "alternatives" }, { "label": "Explain score", "href": "/score/mem0ai/mem0", "kind": "score" }, { "label": "Compare shortlist", "href": "/compare/mem0ai/mem0", "kind": "compare" } ] }, { "project_id": "QuantumNous/new-api", "score": 66, "confidence": "high", "decision_summary": "QuantumNous/new-api is a strong candidate for \"choose a RAG framework\": recommendation score 66/100 with matched deployment, category constraints.", "next_actions": [ { "label": "Open project knowledge", "href": "/projects/QuantumNous/new-api", "kind": "project" }, { "label": "Inspect graph", "href": "/graph/QuantumNous/new-api", "kind": "graph" }, { "label": "Find alternatives", "href": "/alternatives/QuantumNous/new-api", "kind": "alternatives" }, { "label": "Explain score", "href": "/score/QuantumNous/new-api", "kind": "score" }, { "label": "Compare shortlist", "href": "/compare/QuantumNous/new-api", "kind": "compare" } ] } ], "trend_context": { "summary": "MCP Server is the largest indexed category with 326 projects; Local leads deployment coverage across the corpus.", "stats": { "project_count": 1159, "category_count": 13, "deployment_count": 8, "cloudflare_ready_count": 9, "collection_count": 58 }, "top_categories": [ { "id": "mcp_server", "label": "MCP Server", "count": 326, "average_score": 26, "average_maintenance": 40, "cloudflare_ready_count": 2, "top_projects": [ { "repo": "koala73/worldmonitor", "name": "worldmonitor", "description": "Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface", "language": "TypeScript", "category": [ "mcp_server" ], "deployments": [ "docker", "vercel", "serverless", "library_only", "local" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 92, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "estimated", "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "headroomlabs-ai/headroom", "name": "headroom", "description": "Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.", "language": "Python", "category": [ "mcp_server" ], "deployments": [ "docker", "vercel", "serverless", "library_only", "local" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 91, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 18, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "BerriAI/litellm", "name": "litellm", "description": "The fastest, litest AI Gateway. Rust core with Python SDK. Call 100+ LLM APIs in OpenAI (or native) format with cost tracking, guardrails, load balancing, and logging [Bedrock, Azure, OpenAI, Anthropic, OpenAI, VertexAI, vLLM, Nvidia NIM]", "language": "Python", "category": [ "mcp_server" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 89, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "aaif-goose/goose", "name": "goose", "description": "an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM", "language": "Rust", "category": [ "mcp_server" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 87, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } } ], "insight": "326 projects, 2 Cloudflare-ready, average maintenance 40.", "href": "/categories/mcp_server" }, { "id": "rag_framework", "label": "RAG Framework", "count": 165, "average_score": 24, "average_maintenance": 34, "cloudflare_ready_count": 1, "top_projects": [ { "repo": "huggingface/transformers", "name": "transformers", "description": "🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training. ", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "ggml-org/llama.cpp", "name": "llama.cpp", "description": "LLM inference in C/C++", "language": "C++", "category": [ "rag_framework" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 90, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 32, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "infiniflow/ragflow", "name": "ragflow", "description": "RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fuses cutting-edge RAG with Agent capabilities to create a superior context layer for LLMs", "language": "Go", "category": [ "rag_framework" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 90, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "mem0ai/mem0", "name": "mem0", "description": "Universal memory layer for AI Agents", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "docker", "vercel", "serverless", "library_only", "local" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 91, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } } ], "insight": "165 projects, 1 Cloudflare-ready, average maintenance 34.", "href": "/categories/rag_framework" }, { "id": "agent_framework", "label": "Agent Framework", "count": 125, "average_score": 33, "average_maintenance": 43, "cloudflare_ready_count": 2, "top_projects": [ { "repo": "langchain-ai/langchain", "name": "langchain", "description": "The agent engineering platform.", "language": "Python", "category": [ "agent_framework" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 90, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "unslothai/unsloth", "name": "unsloth", "description": "Local UI to run and train LLMs and diffusion models, including Qwen3.8, Kimi K3, MiniMax-H3, Gemma 4, DeepSeek-V4, FLUX and more.", "language": "Python", "category": [ "agent_framework" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 90, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "iOfficeAI/AionUi", "name": "AionUi", "description": "Open-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20+ more CLI Agent | Customize your assistants | Team them up｜Star if you like it!", "language": "TypeScript", "category": [ "agent_framework" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 86, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "alibaba/open-code-review", "name": "open-code-review", "description": "Fast, efficient, battle-tested at Alibaba's scale. Hybrid architecture code review tool: deterministic pipelines + LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI & Anthropic compatible.", "language": "Go", "category": [ "agent_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 86, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 33, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } } ], "insight": "125 projects, 2 Cloudflare-ready, average maintenance 43.", "href": "/categories/agent_framework" } ], "top_deployments": [ { "id": "local", "label": "Local", "count": 1159, "average_score": 25, "average_maintenance": 37, "cloudflare_ready_count": 9, "top_projects": [ { "repo": "n8n-io/n8n", "name": "n8n", "description": "Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.", "language": "TypeScript", "category": [ "workflow_automation" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 32, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "anomalyco/opencode", "name": "opencode", "description": "The open source coding agent.", "language": "TypeScript", "category": [ "coding_agent" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "huggingface/transformers", "name": "transformers", "description": "🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training. ", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "open-webui/open-webui", "name": "open-webui", "description": "User-friendly AI Interface (Supports Ollama, OpenAI API, ...)", "language": "Python", "category": [ "ai_app_template" ], "deployments": [ "docker", "kubernetes", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 92, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } } ], "insight": "1159 projects, 9 Cloudflare-ready, average maintenance 37.", "href": "/deployments/local" }, { "id": "cloud", "label": "Cloud", "count": 1030, "average_score": 25, "average_maintenance": 36, "cloudflare_ready_count": 0, "top_projects": [ { "repo": "n8n-io/n8n", "name": "n8n", "description": "Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.", "language": "TypeScript", "category": [ "workflow_automation" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 32, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "anomalyco/opencode", "name": "opencode", "description": "The open source coding agent.", "language": "TypeScript", "category": [ "coding_agent" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "huggingface/transformers", "name": "transformers", "description": "🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training. ", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "open-webui/open-webui", "name": "open-webui", "description": "User-friendly AI Interface (Supports Ollama, OpenAI API, ...)", "language": "Python", "category": [ "ai_app_template" ], "deployments": [ "docker", "kubernetes", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 92, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } } ], "insight": "1030 projects, 0 Cloudflare-ready, average maintenance 36.", "href": "/deployments/cloud" }, { "id": "library_only", "label": "Library Only", "count": 733, "average_score": 26, "average_maintenance": 37, "cloudflare_ready_count": 7, "top_projects": [ { "repo": "huggingface/transformers", "name": "transformers", "description": "🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training. ", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "open-webui/open-webui", "name": "open-webui", "description": "User-friendly AI Interface (Supports Ollama, OpenAI API, ...)", "language": "Python", "category": [ "ai_app_template" ], "deployments": [ "docker", "kubernetes", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 92, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } }, { "repo": "langchain-ai/langchain", "name": "langchain", "description": "The agent engineering platform.", "language": "Python", "category": [ "agent_framework" ], "deployments": [ "docker", "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 90, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "github/spec-kit", "name": "spec-kit", "description": "💫 Toolkit to help you get started with Spec-Driven Development", "language": "Python", "category": [ "coding_agent" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } } ], "insight": "733 projects, 7 Cloudflare-ready, average maintenance 37.", "href": "/deployments/library_only" } ], "rising_projects": [ { "repo": "n8n-io/n8n", "name": "n8n", "description": "Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.", "language": "TypeScript", "category": [ "workflow_automation" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 32, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "anomalyco/opencode", "name": "opencode", "description": "The open source coding agent.", "language": "TypeScript", "category": [ "coding_agent" ], "deployments": [ "docker", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 93, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 30, "commits_30d": "partial", "releases_180d": "partial", "contributors_90d": "partial" } }, { "repo": "huggingface/transformers", "name": "transformers", "description": "🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training. ", "language": "Python", "category": [ "rag_framework" ], "deployments": [ "library_only", "local", "cloud" ], "cloudflare_ready": false, "quality_score": 84, "agent_score": 88, "git_top_score": 94, "quality_signal_confidence": { "stars_30d_delta": "snapshot", "stars30d_window_days": 31, "commits_30d": "partial", "releases_180d": "complete", "contributors_90d": "partial" } } ] }, "agent_map": { "url": "/api/agent-map", "short_path": [ { "step": 1, "concept": "Trust preflight", "rest": [ "GET /api/health", "GET /api/trust" ], "mcp_tools": [ "get_trust_gate" ], "inspect": [ "db=available", "metadata.source=d1", "decision", "production_ready" ], "trust_fields": [ "metadata.source", "metadata.reason", "sync.freshness", "quality.risk_level" ], "use_when": "Start here before any high-confidence production answer." }, { "step": 2, "concept": "Discovery", "rest": [ "GET /api/agent-map", "GET /api/quickstart", "GET /api/workflow" ], "mcp_tools": [ "get_agent_workflow", "get_atlas" ], "inspect": [ "core_surfaces", "recommended_agent_flow", "recommended_sequence", "shortlist" ], "trust_fields": [ "trust_policy.strict_mode", "trust_policy.disclose_when" ], "use_when": "Use this to choose the shortest route into search, lookup, alternatives, compare, graph, or Atlas." }, { "step": 3, "concept": "Project action", "rest": [ "GET /api/search", "GET /api/project/:owner/:repo", "GET /api/recommend", "GET /api/compare" ], "mcp_tools": [ "search_projects", "get_project", "recommend_project", "compare_projects" ], "inspect": [ "projects[].repo", "knowledge", "recommendations", "decision_matrix" ], "trust_fields": [ "metadata.source", "metadata.truncated", "metadata.candidate_retrieval", "quality_signal_confidence", "classification.*.confidence" ], "use_when": "Use this once trust and discovery are settled and you need the actual answer." } ], "reference_path": [ { "step": 1, "concept": "Trust and freshness", "rest": [ "GET /api/health", "GET /api/trust", "GET /api/quality", "GET /api/sync/status" ], "mcp_tools": [ "get_trust_gate", "get_quality_report" ], "inspect": [ "db=available", "sync_freshness", "hot_project_freshness_rate", "whole_corpus_freshness_rate", "release_score", "data_trust_score", "risk_level" ], "trust_fields": [ "metadata.source", "metadata.reason", "sync.freshness", "freshness_slo.hot_projects", "freshness_slo.whole_corpus", "quality.risk_level" ], "use_when": "Use when the answer must explain source quality or freshness in detail." }, { "step": 2, "concept": "Discovery and planning", "rest": [ "GET /api/agent-map", "GET /api/quickstart", "GET /api/workflow", "GET /api/journeys", "GET /api/atlas" ], "mcp_tools": [ "get_agent_workflow", "get_atlas", "get_trends" ], "inspect": [ "surfaces", "core_surfaces", "recommended_agent_flow", "recommended_sequence", "comparison_paths" ], "trust_fields": [ "trust_policy.strict_mode", "trust_policy.disclose_when", "trend_context.stats.project_count" ], "use_when": "Use when you need the broader discovery layer, not just the first action." }, { "step": 3, "concept": "Project analysis", "rest": [ "GET /api/search", "GET /api/project/:owner/:repo", "GET /api/alternatives/:project", "GET /api/graph?repo=:project", "GET /api/score/:project", "GET /api/compare" ], "mcp_tools": [ "search_projects", "get_project", "get_alternatives", "get_project_graph", "get_quality_score", "compare_projects" ], "inspect": [ "projects[].repo", "knowledge", "related", "alternative_matches", "graph_stats", "score_confidence", "decision_matrix" ], "trust_fields": [ "metadata.source", "metadata.truncated", "metadata.candidate_retrieval", "quality_signal_confidence", "classification.*.confidence" ], "use_when": "Use this when you are explaining or comparing concrete projects." } ], "surfaces": [ { "concept": "Agent connection", "rest": [ "GET /connect", "GET /mcp/core", "GET /mcp" ], "mcp_tools": [ "search_projects", "get_project", "recommend_project", "compare_projects", "get_agent_workflow" ], "recommended_use": "Start here when a client needs the shortest tested connection path; use the core MCP profile for first-use project decisions and the full profile for advanced workflows." }, { "concept": "Client compatibility", "rest": [ "GET /compatibility", "GET /api/compatibility" ], "mcp_tools": [], "recommended_use": "Check this before calling a named client supported; configuration verification and generic protocol tests are reported separately from real-client production evidence." }, { "concept": "Project knowledge", "rest": [ "GET /api/project/:owner/:repo", "GET /api/project/:project", "POST /api/project", "GET /api/projects", "POST /api/projects" ], "mcp_tools": [ "get_project", "get_project_card", "get_projects_batch" ], "recommended_use": "Fetch one repository before making a recommendation or citing project facts." }, { "concept": "Project change feed", "rest": [ "GET /api/changes" ], "mcp_tools": [ "get_project_changes" ], "recommended_use": "Incrementally update an agent cache and remove deleted projects using explicit tombstones instead of re-fetching the whole corpus." }, { "concept": "Agent feedback proposals", "rest": [ "POST /api/feedback/proposals" ], "mcp_tools": [ "propose_project_feedback" ], "recommended_use": "Submit evidence-backed corrections for review without allowing external agents to mutate trusted knowledge directly." }, { "concept": "Recommendations", "rest": [ "GET /api/recommend", "POST /api/recommend" ], "mcp_tools": [ "recommend_project" ], "recommended_use": "Choose candidates from use case, deployment, category, license, language, and Cloudflare-readiness constraints." }, { "concept": "Agent workflow", "rest": [ "GET /api/workflow", "POST /api/workflow" ], "mcp_tools": [ "get_agent_workflow" ], "recommended_use": "Start here when an agent needs a guided path from trend context to shortlist, graph, alternatives, score, compare, and trust checks." }, { "concept": "Agent quickstart", "rest": [ "GET /api/quickstart" ], "mcp_tools": [], "recommended_use": "Use this as the shortest integration path from health checks to workflow, Atlas journeys, project lookup, recommendations, comparison, MCP, GRP, and trust checks." }, { "concept": "Agent recipes", "rest": [ "GET /api/recipes" ], "mcp_tools": [], "recommended_use": "Use recipes when an agent needs a repeatable workflow for choosing projects, finding alternatives, comparing shortlists, exploring ecosystems, mapping Atlas journeys to comparison paths, checking trust, or planning with GRP." }, { "concept": "API examples", "rest": [ "GET /api/examples" ], "mcp_tools": [], "recommended_use": "Use examples when an agent developer needs copyable REST, MCP, and GRP calls or verified decision-first examples with fields to inspect before citing results." }, { "concept": "API and MCP discovery", "rest": [ "GET /connect", "GET /distribution.json", "GET /.well-known/skills.json", "GET /api/agent-map", "GET /openapi.json", "GET /mcp/core", "GET /mcp", "GET /llms.txt", "GET /llms-full.txt" ], "mcp_tools": [], "recommended_use": "Use this discovery path before guessing routes or tool names; it links the versioned distribution package, installable Skill, REST, MCP, OpenAPI, LLM discovery, output fields, and trust policy." }, { "concept": "Alternatives", "rest": [ "GET /api/alternatives/:project", "POST /api/alternatives" ], "mcp_tools": [ "get_alternatives", "find_alternatives" ], "recommended_use": "Find replacement candidates and move into compare, graph, score, or recommendation flows." }, { "concept": "Project graph", "rest": [ "GET /api/graph/:project", "GET /api/graph?repo=:project", "POST /api/graph" ], "mcp_tools": [ "get_project_graph" ], "recommended_use": "Inspect related projects, alternatives, dependencies, deployment targets, and use cases as first-class graph edges." }, { "concept": "Comparison", "rest": [ "GET /api/compare", "POST /api/compare" ], "mcp_tools": [ "compare_projects" ], "recommended_use": "Turn a shortlist into a decision matrix instead of ranking only by GitHub stars." }, { "concept": "Score explanation", "rest": [ "GET /api/score/:project", "POST /api/score" ], "mcp_tools": [ "get_quality_score" ], "recommended_use": "Explain why a project scores well or poorly across community, maintenance, documentation, stability, adoption, and agent readability." }, { "concept": "Atlas ecosystem map", "rest": [ "GET /api/atlas", "GET /api/atlas/:ecosystem" ], "mcp_tools": [ "get_atlas", "git_top_grp_query" ], "recommended_use": "Start from an ecosystem map before choosing a specific repository." }, { "concept": "Atlas journeys", "rest": [ "GET /api/journeys" ], "mcp_tools": [ "get_atlas", "git_top_grp_query" ], "recommended_use": "Use this when an agent needs ordered ecosystem routes into recommendations, graph, alternatives, compare, score, and Agent Map surfaces." }, { "concept": "Open source trends", "rest": [ "GET /api/trends", "GET /api/trending" ], "mcp_tools": [ "get_trends" ], "recommended_use": "Understand current corpus-level trends before choosing categories, deployment targets, or rising projects." }, { "concept": "Graph reasoning", "rest": [ "POST /api/grp/query" ], "mcp_tools": [ "git_top_grp_query" ], "recommended_use": "Plan, compose, compare, or find project sets from a higher-level goal. MCP defaults to a bounded compact response; request profile=full only when the complete graph is required." }, { "concept": "Quality and coverage", "rest": [ "GET /api/trust", "GET /api/benchmark", "GET /api/quality", "GET /api/quality/review", "GET /api/health", "GET /api/sync/status" ], "mcp_tools": [ "get_trust_gate", "get_quality_report" ], "recommended_use": "Use the Trust Gate and public benchmark before high-confidence recommendations; they combine source, sync freshness, eval health, explanation coverage, release health, data trust, and risk." }, { "concept": "Product roadmap", "rest": [ "GET /api/roadmap" ], "mcp_tools": [], "recommended_use": "Understand which Git.Top 2.0 surfaces are implemented, active, or still being deepened before choosing an integration path." } ] }, "trust_policy": { "production_check": "/api/health?require_d1=true", "disclose_when": [ "metadata.source=seed", "sync.health is degraded", "recommendation confidence is low", "score_confidence.level is low" ], "cite_fields": [ "metadata.source", "metadata.reason", "classification.*.confidence", "quality_signal_confidence", "recommendations[].confidence", "score_confidence.level" ] }, "metadata": { "source": "d1", "reason": "d1_query", "project_count": 1159, "generated_at": "2026-08-19T15:08:12.219Z", "snapshot_id": "d1:1159:2026-08-19T14:30:59.260Z", "latest_synced_at": "2026-08-19T14:30:59.260Z", "schema_version": "git-top.knowledge.v1", "loaded_project_limit": 2000, "truncated": false } }