source_structure_overview

Generates a reusable whole-system source-structure overview for .NET repositories and services.

4|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/synthaicode/XRefKit --skill source-structure-overview-synthaicode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: source_structure_overview
Source: https://github.com/synthaicode/XRefKit/tree/main/skills/source_structure_overview
Command: npx skills add https://github.com/synthaicode/XRefKit --skill source-structure-overview-synthaicode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams analyzing brownfield .NET systems often lack a current, trustworthy map of how the codebase is structured, so every change-impact question starts from guesswork. This Skill produces a baseline, reusable source-structure overview that later change-analysis work can reference by XID instead of re-reading the entire repository. ## Core Features & Use Cases - Whole-System Structure Mapping: Documents runtime units, major subsystems, startup/composition flow, request/event/job flows, state and persistence boundaries, and extension or plugin mechanisms for a confirmed source scope. - External Dependency Possibility Map: Records configuration keys, environment variables, build rules, queues, topics, schemas, and other external levers that can change runtime structure, with verification status for each. - Brownfield API Naming Extractor: Extracts local naming vocabularies (action verbs, business objects, lifecycle states, role suffixes, casing rules) and naming clusters that must stay aligned, so later design work can construct consistent names. - Use Case: Before asking how a specific modification affects a legacy .NET service, run this Skill on the service's solution to produce a registered source-structure finding that dotnet_change_analysis can select as target context. ## Quick Start Run the source_structure_overview skill against your target .NET repository or solution path with an explicit source scope boundary to produce a Markdown structure overview.

Frequently Asked Questions about source_structure_overview

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

FAQPage Schema
How do I generate a source structure overview for a .NET repository?▼

Run the Skill through xrefkit skill run with the target repository, solution, or project path and an explicit source scope boundary. It produces a Markdown overview covering runtime units, subsystems, startup flow, runtime flows, state boundaries, and external dependencies.

What is the difference between source_structure_overview and dotnet_change_analysis?▼

source_structure_overview answers how a target works structurally and produces reusable domain knowledge. dotnet_change_analysis answers what must change for a specific modification proposition, consuming the overview output as context selected by XID.

Can the overview handle large repositories that exceed one run?▼

Yes, but it never silently narrows scope. If the confirmed scope is too large, the run decomposes investigation into continuation work items or closes with an incomplete-analysis cause review classifying the cause, such as context size or scope too large.

What is the Brownfield API Naming Extractor used for?▼

It extracts local naming evidence from routes, DTOs, commands, handlers, events, jobs, tables, and configuration keys. The output separates action verbs, business objects, lifecycle terms, and role suffixes so later design work can construct consistent candidate names.

When is a source structure overview not allowed to close as complete?▼

Closure is blocked when any in-scope structure area remains an unresolved unknown, when scope was narrowed after startup, or when completion control is continue_required, blocked, or failed. Such runs may only close as an incomplete-analysis cause review.