ontoly-software-graph

name	ontoly-software-graph
description	Use Ontoly's deterministic Software Graph and MCP capabilities for repository architecture, request tracing, dependency analysis, configuration lookup, and impact analysis before falling back to source search.

Ontoly Software Graph

Use this skill when a coding agent needs graph-backed understanding of a TypeScript repository. Ontoly is the source of truth; the skill only teaches the workflow.

When to Use

• Explain repository architecture or package/module topology
• Trace a route, controller, service, function, or dependency path
• Find services, controllers, providers, modules, routes, configuration, or environment variables
• Estimate impact before refactoring or deleting code
• Audit unresolved imports, circular dependencies, dead code, semantic coverage, or graph quality
• Produce onboarding, documentation, or architecture-review notes with deterministic evidence

Workflow

1. Check whether an Ontoly graph already exists: .ontoly/, SoftwareGraph.json, diagnostics.json, validation reports, graph hash, or MCP setup.

2. If the graph is missing and local analysis is allowed, run:

   ontoly build .
   

3. Inspect graph health before answering: diagnostics, graph hash, semantic coverage, trust or quality score, framework detection, and build timestamp.

4. Prefer Ontoly CLI or MCP capabilities over repository search for graph-answerable questions.

5. Search source files only when Ontoly cannot answer, the graph is stale or incomplete, or the user explicitly asks for file-level verification.

6. Always cite graph evidence: node IDs, edge types, file paths, source locations, diagnostics, framework analyzer output, and confidence.

Capability Map