Ontoly Software Graph
Use Ontoly when a coding agent needs graph-backed software understanding before searching source files directly.
Ontoly builds a deterministic Software Graph from a TypeScript repository and exposes it through CLI queries, MCP capabilities, and agent skills. The skill teaches workflow only; Ontoly remains the source of truth.
Workflow
- Check whether an Ontoly graph already exists in the repository, such as
.ontoly/, SoftwareGraph.json, or documented Ontoly scripts.
- If the graph is missing and local graph output is appropriate, run
ontoly build ..
- Check graph diagnostics, trust, semantic coverage, framework detection, and validation before making architecture claims.
- Prefer Ontoly CLI or MCP capabilities for architecture summaries, request tracing, dependency analysis, configuration lookup, framework reports, and impact analysis.
- Inspect source files only when the graph is missing, incomplete, untrusted for the question, or the user explicitly asks for source-level verification.
Use Cases
- Explain repository architecture, module ownership, services, routes, packages, or dependencies.
- Trace a request, route, controller, service, provider, dependency, or call chain.
- Estimate impact for removing, renaming, or refactoring a symbol, module, package, route, or service.
- Review circular imports, dead code, configuration usage, environment variables, or graph diagnostics.
Evidence Rules
- Separate graph facts from inference.
- Cite exact graph nodes, edges, packages, routes, diagnostics, or query outputs when available.
- Treat unresolved imports, low trust, missing framework detection, and validation failures as answer limitations.
- Do not claim a relationship exists unless Ontoly reports it or the answer labels it as inferred.
Example Prompts
Use Ontoly to explain this repository's architecture.
Use Ontoly to trace the login flow from route to controller, service, and repository.
Use Ontoly to find what depends on UserRepository and what breaks if it changes.
1---2name: ontoly-software-graph3description: Use Ontoly's deterministic Software Graph and MCP server for codebase architecture, request tracing, dependency analysis, and impact analysis.4license: MIT5---6
7# Ontoly Software Graph
8
9Use Ontoly when a coding agent needs graph-backed software understanding before searching source files directly.
10
11Ontoly builds a deterministic Software Graph from a TypeScript repository and exposes it through CLI queries, MCP capabilities, and agent skills. The skill teaches workflow only; Ontoly remains the source of truth.
12
13## Workflow
14
151. Check whether an Ontoly graph already exists in the repository, such as `.ontoly/`, `SoftwareGraph.json`, or documented Ontoly scripts.
162. If the graph is missing and local graph output is appropriate, run `ontoly build .`.
173. Check graph diagnostics, trust, semantic coverage, framework detection, and validation before making architecture claims.
184. Prefer Ontoly CLI or MCP capabilities for architecture summaries, request tracing, dependency analysis, configuration lookup, framework reports, and impact analysis.
195. Inspect source files only when the graph is missing, incomplete, untrusted for the question, or the user explicitly asks for source-level verification.
20
21## Use Cases
22
23- Explain repository architecture, module ownership, services, routes, packages, or dependencies.
24- Trace a request, route, controller, service, provider, dependency, or call chain.
25- Estimate impact for removing, renaming, or refactoring a symbol, module, package, route, or service.
26- Review circular imports, dead code, configuration usage, environment variables, or graph diagnostics.
27
28## Evidence Rules
29
30- Separate graph facts from inference.
31- Cite exact graph nodes, edges, packages, routes, diagnostics, or query outputs when available.
32- Treat unresolved imports, low trust, missing framework detection, and validation failures as answer limitations.
33- Do not claim a relationship exists unless Ontoly reports it or the answer labels it as inferred.
34
35## Example Prompts
36
37```text
38Use Ontoly to explain this repository's architecture.
39```
40
41```text
42Use Ontoly to trace the login flow from route to controller, service, and repository.
43```
44
45```text
46Use Ontoly to find what depends on UserRepository and what breaks if it changes.
47```
gabrielmoreira