| name | vocabulary-audit |
| description | Normalize UI terminology by creating a canonical glossary of nouns, verbs, statuses, and labels used across the system. |
| disable-model-invocation | true |
Audit and normalize interface language for this scope:
$ARGUMENTS
Use ultrathink. Use the current prototype, components, routes, docs, and visible copy. Extract all important terms that affect understanding.
Output
Write docs/hci/glossary.md unless the user asked for another path.
Create the directory if it does not exist.
Required sections
- Canonical glossary
- Terms to merge or ban
- Status vocabulary
- Action vocabulary
- Naming problems and recommendations
Tables to include
Canonical terms
| Term | Type (noun/verb/status) | Exact meaning | Where used | Notes |
Terms to avoid
| Avoid this term | Use instead | Reason |
Status model
| Status | Meaning | Entered when | Exited when |
What to look for
- same concept with multiple names
- vague verbs like "handle", "manage", "process"
- inconsistent status labels
- labels that require domain knowledge the user may not have
- UI copy that does not match the underlying conceptual model
Synthesis
End with:
- the five most damaging terminology inconsistencies
- concepts that are overloaded or ambiguous across the system
- priority terms to standardize before next implementation cycle
Quality bar
Prefer language that is:
- concrete
- consistent
- distinguishable from nearby concepts
- aligned with the user’s mental model
Deliverable style
- Clear headings
- Markdown tables
- Mermaid diagrams where useful
- Direct language
- No filler