Skip to content

content-inconsistent-terminology

Detect inconsistent terminology across instruction files (e.g., mixing 'directory' and 'folder')
Severity info (auto)
Autofix -
Since v0.7.0
Category Content Intelligence

Why

When instruction files use "directory" in one place and "folder" in another, the model may treat them as different concepts or waste tokens reconciling them. Consistent terminology reduces ambiguity and helps the model pattern-match instructions to the right context.

Examples

Bad (across files):

<!-- CLAUDE.md -->
Create a new directory under `src/`.

<!-- .claude/rules/testing.md -->
Put test fixtures in the `tests/` folder.

Good:

<!-- Both files -->
Create a new directory under `src/`.
Put test fixtures in the `tests/` directory.

How to fix

Pick the most common term across your instruction files and use it everywhere. Prefer technical terms over informal ones (e.g., "directory" over "folder", "repository" over "codebase"). A coding agent can standardize terminology automatically.

Configuration

rules:
  content-inconsistent-terminology:
    enabled: auto  # true | false | auto
    severity: info

Research Basis

Detects inconsistent terminology across instruction files (e.g., one file says "directory" while another says "folder").

If one file says "run npm test" and another says "execute yarn test", the model must resolve the ambiguity at inference time. The "Curse of Instructions" paper shows that instruction conflicts compound multiplicatively — inconsistent terminology creates implicit contradictions that degrade compliance.

Consistent terminology is a well-established principle in technical writing. For LLMs, it's even more important: the model lacks the human ability to infer that two different terms refer to the same concept from broader context.

References:

Run skillsaw explain content-inconsistent-terminology to see this documentation and the rule's effective configuration in your terminal.