ProjGraph: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

# Restore dependencies
dotnet restore ProjGraph.slnx

# Build
dotnet build ProjGraph.slnx

# Run all tests
dotnet test ProjGraph.slnx

# Run a specific test project
dotnet test tests/ProjGraph.Tests.Unit.ClassDiagram

# Run a specific test class
dotnet test tests/ProjGraph.Tests.Unit.ClassDiagram --filter "ClassAnalysisDepthTests"

# Run CLI locally
dotnet run --project src/ProjGraph.Cli -- visualize ./ProjGraph.slnx
dotnet run --project src/ProjGraph.Cli -- stats ./ProjGraph.slnx

# Run MCP server locally
dotnet run --project src/ProjGraph.Mcp

Build enforces TreatWarningsAsErrors=true and EnforceCodeStyleInBuild=true. XML documentation is required on all public APIs.

Architecture

ProjGraph is a .NET 10 tool ecosystem with two entry points — a CLI (Spectre.Console.Cli) and an MCP server (ModelContextProtocol.Server over stdio) — both backed by a shared library layer.

Dependency graph

Cli ──┐
      ├──► Lib ──► Lib.Core ──► Core
Mcp ──┘       ├──► Lib.Dependencies ──► Lib.Core
              ├──► Lib.ClassDiagram ──► Lib.Core
              └──► Lib.EntityFramework ──► Lib.Core

• ProjGraph.Core — Pure domain models (SolutionGraph, ClassModel, EfModel, SolutionStats) and exceptions. No dependencies.
• ProjGraph.Lib.Core — Cross-cutting abstractions (IFileSystem, IOutputConsole, ICompilationFactory, IDiagramRenderer<T>), solution parsers (.sln/.slnx), and infrastructure utilities. Also hosts the TarjanSccAlgorithm (in Domain/Algorithms/) used for cycle detection.
• ProjGraph.Lib.Dependencies — Builds dependency graphs from solution/project files by parsing them directly with the in-house parsers in Lib.Core (SlnParser on Microsoft.VisualStudio.SolutionPersistence, SlnxParser and ProjectParser on System.Xml.Linq; nothing is evaluated); computes stats using TarjanSccAlgorithm for cycle detection.
• ProjGraph.Lib.ClassDiagram — Roslyn-based C# class hierarchy analysis. Accepts a file or directory; optionally discovers related types across the workspace via IWorkspaceTypeDiscovery.
• ProjGraph.Lib.EntityFramework — Roslyn semantic analysis of EF Core DbContext files and ModelSnapshot files; includes a multi-class Fluent API parser.
• ProjGraph.Lib — Composition root only. Exposes AddProjGraphLib() which wires all sub-library services via DI.