domain-language-scan

Extracts a codebase's domain vocabulary into a code-anchored glossary, context map, and drift report.

3|1|Updated Aug 26, 2026
One-click install
npx skills add https://github.com/zeljkoobrenovic/sokrates-skills --skill domain-language-scan-zeljkoobrenovic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-language-scan
Source: https://github.com/zeljkoobrenovic/sokrates-skills/tree/main/skills/scanners/domain-language-scan
Command: npx skills add https://github.com/zeljkoobrenovic/sokrates-skills --skill domain-language-scan-zeljkoobrenovic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Newcomers and AI assistants waste weeks reverse-engineering a codebase's core nouns — what a Thread, Session, or Rollout actually means — and silently misread systems where one concept has two names or one name has two meanings. This scanner writes that domain language down from primary sources so the vocabulary is documented, owned, and checked for drift. ## Core Features & Use Cases - Code-anchored glossary: Defines the 8–15 concepts that carry the system from their defining types, doc comments, identity, lifecycle, and owning component — not from README aspirations. - Bounded context and capability maps: Shows which components own which vocabulary, where concepts are shared or translated, and which nouns each product capability family rides on. - Language drift detection: Finds synonym pairs, homonyms, misleading names, undefined jargon, and renames caught mid-flight, each with the visible canonical direction. - Use Case: After running a Sokrates analysis on a repository, ask for the domain model; the scanner reads the protocol/API types and produces a validated findings file plus an interactive HTML explorer a new hire can read in one sitting. ## Quick Start Ask the AI to run the domain language scan on this repository's _sokrates analysis and produce a glossary of its core concepts with any naming drift.

Frequently Asked Questions about domain-language-scan

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

FAQPage Schema
How do I generate a glossary of a codebase's domain concepts?

Run the domain language scan against a repository with a Sokrates _sokrates analysis. It harvests recurring nouns from protocol and API type names, defines the 8–15 most central concepts from their defining code, and writes a validated findings file plus an HTML explorer.

How to detect naming drift and synonyms in a codebase?

The scanner's language-drift group finds synonym pairs, homonyms, misleading names, undefined jargon, and renames mid-flight. Each drift finding cites both sides' defining lines and names the canonical term the codebase appears to be converging on.

What is the difference between domain-language-scan and functionality-scan?

functionality-scan describes what the software does — features, entry points, and workflows. domain-language-scan maps what the concepts mean — the glossary, bounded contexts, and vocabulary drift — reusing functionality-scan's capability families rather than re-inventorying features.

Does the domain language scan require a Sokrates analysis?

It works best with a Sokrates _sokrates folder, which supplies component names, configuration, and prior scan findings as candidate concepts. Without it, the scanner falls back to the user-facing surface and source tree for vocabulary harvesting.

When should I not use a domain language scan?

Skip it when you need structural architecture mapping (use architecture-scan), technology inventory (use tech-stack-scan), or a feature walkthrough (use functionality-scan). It maps meaning and vocabulary, not components, frameworks, or behavior.