Concepts

How Silex thinks about your codebase

Every number, name and edge on this page comes from a real Silex scan of eShop (Microsoft's reference app, MIT), executed with Silex v0.11.35. Nothing here is a mock-up. This page is also written to be read by AI agents (llms.txt).

435
Classes
1,586
Relationships
69
Communities
6
Languages
53
Vendor files excluded
14%
Unknown territory
01

The scan — reading before believing

Silex starts by reading your repository locally: parsing every source file, extracting classes, methods and the relationships between them — calls, inheritance, HTTP routes crossing language boundaries, raw SQL joins. No code leaves your machine.

The result is a local graph: nodes are code symbols, edges are relationships found in the source, each one traceable to a file and line.

classes: 435
relationships: 1,586
communities: 69
languages: csharp javascript typescript json proto markdown
53 vendor/generated files excluded by default
02

The community map — the real shape of the system

Silex clusters the relationship graph (Leiden algorithm) into communities: groups of classes that actually work together — regardless of folder layout. This is the architecture as it is, not as the src/ tree claims it is. Click a node to see its real member classes.

3 4 3 3 2 33Basket vertical 8Basket HTTP contract 6Basket→Order handoff 34Catalog vertical 48Order application 49Ordering domain core 9Cancel-order slice idIdentity seam 7Saga: stock confirmation 6Saga: payment step 5Status webhooks
vertical / core saga step wire contract seam / egress edge width = cross-community references

Ordering domain core

49 classes · cohesion 0.067

The Order aggregate's contract surface: repository, domain events (cancelled/shipped/paid), and the integration-event handlers that glue the order saga together.

Members (real class names)

Description written by an AI agent reading this community's real code pack — the same client-orchestrated flow you get.

Strongest cross-class pairs
Address ↔ Order4
Basket ↔ CustomerBasketResponse4
Basket ↔ CustomerBasket3
CancelOrder ↔ IIdentity3
Order ↔ OrderItem3
CatalogItem ↔ CatalogMock3
Why this matters

The sagas show up as their own communities — the graph found the choreography steps (stock confirmation, payment) without being told what a saga is. Folder layout says "Ordering.API"; the graph says "five independent slices and two saga legs".

03

Evidence anchoring — no anchor, no fact

Every claim Silex makes carries an anchor: the file and line range that proves it, with the quoted snippet verified against the source. A claim that cannot be anchored is not stored as a fact — it is flagged as a gap.

Order status cycle is guarded: Submitted → AwaitingValidation → StockConfirmed → Paid → Shipped

96%verifiedOrder.cs:99-131

SetPaidStatus() only fires from StockConfirmed — payment never skips the stock check

94%verifiedOrder.cs:119-128

GetTotal() ignores the discount field — money risk in a rewrite

88%flagged ⚠OrderItem.cs:48

SetPaymentMethodVerified() writes buyer + payment ids without a state guard

91%verifiedOrder.cs:93-97
0

hallucinated anchors across 328 agent submissions in a real 520-class enterprise engagement. The gate is enforced at the door: an agent-submitted rule without provenance is rejected.

04

Confidence — honesty as a number

Confidence expresses how strongly the evidence supports a claim — and it carries provenance: whether the claim came from static analysis, from an LLM pass, or from your own AI agent. Numbers are never invented: an agent-proposed rule shows n/a until a human reviews it, not a made-up score.

heuristicDeterministic — AST, call graph, schema. Highest trust.96%
llmInferred by the enrichment pass. Always labeled.72%
agentProposed by your agent — pending human review.n/a
05

Unknown territory — what Silex can't prove, it tells you

The inverse of confidence: the parts of the codebase where evidence was too thin. Instead of guessing, Silex marks them. For a migration or an AI-assisted change, knowing where the map ends is as valuable as the map.

86% mapped with evidence
14%

eShop reference scan: 14% flagged as unknown territory by gap_analysis.

06

State machines — recovered from code, not documentation

Where state lives in the code (enums, status fields, guarded transitions), Silex reconstructs the machine — every transition anchored. The real order lifecycle recovered from eShop (Order.cs:99-131): Submitted → AwaitingValidation → StockConfirmed → Paid → Shipped, with Cancelled reachable from the early states.

Submitted AwaitingValidation StockConfirmed Paid Shipped Cancelled warehouse confirms payment succeeds

Cross-check against section 02: the saga steps (stock confirmation, payment) appear as communities, and the transitions they drive appear here — two independent reconstructions agreeing is exactly what evidence-based archaeology looks like.

07

Vendor & generated code — classified, never silently deleted

A real codebase carries vendor bundles, minified assets and generated migrations. Silex classifies them out of the way by default — out of the map, out of the packs, out of the cost estimates — but never hides the fact.

One rule protects you: a vendor-looking file that your team has edited (local commits in git history) is treated as your code and stays on the map, marked. Forked jQuery from 2014 with business rules inside? It stays visible.

# real stats line from this scan
53 vendor/generated files excluded
from the map by default
→ re-include via .silexignore
08

Human review — the 1.5 layer

Between raw extraction and a canonical domain model sits the review layer: every LLM- or agent-proposed fact is a candidate until a human confirms it. Your AI agent does the legwork through MCP tools — reading community code packs, proposing rules with anchors — and you stay the authority. The community descriptions in section 02 were produced exactly this way.

LAYER 1
Raw extraction
Deterministic graph — classes, relationships, communities, state machines.
LAYER 1.5
Human review
Agent-proposed rules with anchors, held as candidates until confirmed.
LAYER 2
Canonical domain model
Confirmed facts — what your agents and your team both trust.

Generated from a real Silex scan of eShop (MIT) with v0.11.35. The graph, the tables and the state machine are data, not illustration.