ecommerceapp-kg-query

Query a Neo4j knowledge graph to answer structural questions about the ECommerceApp codebase.

Updated Nov 19, 2020
One-click install
npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill ecommerceapp-kg-query-kwojtasinski-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ecommerceapp-kg-query
Source: https://github.com/kwojtasinski-repo/ECommerceApp/tree/main/.claude/skills/ecommerceapp-kg-query
Command: npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill ecommerceapp-kg-query-kwojtasinski-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering structural questions about a large codebase—blast radius of a change, module ownership, endpoint exposure, orphaned message contracts, RBAC coverage—normally requires slow, error-prone grepping across many projects. This Skill answers those questions by querying a code-derived Neo4j knowledge graph through ten fixed, read-only MCP tools instead of reading source files. ## Core Features & Use Cases - Impact and dependency analysis: Use GetBlastRadius and GetNodeDependencies to see what a change affects or what a node needs to run, with configurable depth. - Architecture and contract auditing: Use GetModuleDependencies, GetModuleOwnership, and GetOrphanContracts to map bounded-context integration and find dead message/query contracts with confidence levels. - Exposure, jobs, and RBAC: Use GetActionExposure, GetJobSchedulers, GetGovernedActions, and FindStructurallySimilarActions to trace endpoint/page wiring, job scheduling, authorization coverage, and reusable patterns. - Use Case: Before renaming an OrderService method, ask what breaks—the Skill calls GetBlastRadius on the fully-qualified node id and returns a markdown table of every affected endpoint, page, handler, and job. ## Quick Start Ask the assistant to use the ecommerceapp-kg-query skill to show the blast radius of changing ECommerceApp.Application.Orders.OrderService.PlaceOrder.

Frequently Asked Questions about ecommerceapp-kg-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the blast radius of a code change in a .NET codebase?

Call the GetBlastRadius MCP tool with the fully-qualified, case-sensitive node id of the type or member you plan to change, plus an optional maxDepth of 1-5. It returns one row per affected node at its shortest distance, covering endpoints, pages, handlers, and jobs.

How do I detect orphaned message or query contracts?

Use the GetOrphanContracts tool, which takes no parameters and lists messages or queries with no handler. Read the confidence column: high and contradiction rows warrant investigation, while ambiguous rows are known false positives that must be verified manually before deleting anything.

What prerequisites does the knowledge graph query workflow need?

You must start Neo4j with docker compose --profile kg up -d neo4j, then run pwsh tools/kg/load-graph.ps1 to load the generated seed. Without both steps every tool returns an error envelope naming KG_NEO4J_URL and these two commands.

Can I run raw Cypher queries against the knowledge graph MCP server?

No. The server exposes exactly ten fixed, typed, read-only tools such as GetNodeNeighbors and GetModuleDependencies, with no free-form Cypher escape hatch. Pick the single tool matching your question and pass exact, case-sensitive node ids.

Why does the knowledge graph not show recently added code?

The graph is a point-in-time snapshot from the last kg-codegen and load-graph.ps1 run, so it lags the working tree. New or modified code will not appear until the graph is regenerated; in that case verify by grepping the source directly.

When should I not use the knowledge graph for codebase questions?

Avoid it for effort estimates, architectural pattern classification, test coverage, git authorship, and runtime behavior such as call frequency or message volume, since these are explicitly out of scope. The graph only models static structure derived from source code.