---
name: find-ubiquitous-language
description: |
  Analyze the codebase to discover and extract the ubiquitous language.
  Identify domain terms, their definitions, and how consistently they are used.
---

## Find Ubiquitous Language Skill

Analyze the codebase to extract the ubiquitous language — the shared vocabulary between developers and domain experts that should be consistently reflected in the code.

### Analysis Flow

1. **Scan the domain layer**: Read domain models, entities, value objects, aggregates, services, and events to identify key domain terms.

2. **Scan supporting layers**: Check application services, API endpoints, database schemas, and documentation for additional terms and potential inconsistencies.

3. **Build the glossary**: For each discovered term, record:
   - **Term**: The canonical name
   - **Definition**: What it means in the business domain
   - **Code locations**: Where it appears (classes, methods, variables, tables)
   - **Aliases/Inconsistencies**: Alternative names used for the same concept (e.g., `User` vs `Account` vs `Customer` for the same entity)

4. **Identify problems**:
   - **Synonyms**: Multiple names for the same concept
   - **Homonyms**: Same name used for different concepts in different contexts
   - **Missing terms**: Business concepts that exist implicitly but have no explicit representation in code
   - **Technical leakage**: Domain terms polluted with technical jargon

5. **Output format**:

   ```
   ## Ubiquitous Language: <project name>

   ### Glossary

   | Term        | Definition                     | Code Locations          | Issues        |
   |-------------|--------------------------------|-------------------------|---------------|
   | Order       | A customer's purchase request  | `src/domain/Order.ts`   | —             |
   | Customer    | A registered buyer             | `src/domain/User.ts`    | Called "User" in code |
   | ...         | ...                            | ...                     | ...           |

   ### Inconsistencies

   #### 1. <Issue title>
   - **Concept**: The business concept involved
   - **Variants found**: List of different names used
   - **Recommendation**: Which term to standardize on and why

   ### Missing Terms
   - <Business concepts that should be explicit in code but aren't>
   ```

### Guidelines

- Focus on domain-meaningful terms, not generic programming terms.
- When in doubt about the business meaning, note the ambiguity rather than guessing.
- Do NOT make changes. This skill only produces the analysis.