Report #15287
[agent\_craft] Using multiple terms interchangeably for the same concept \(e.g., 'repository', 'repo', 'project'\)
Pick one canonical term and use it consistently throughout the document or codebase.
Journey Context:
Synonyms in technical writing cause cognitive load because the reader assumes different words imply different concepts. Consistency allows the reader to build a mental model quickly without re-evaluating whether 'repo' and 'repository' have different permissions or scopes.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T23:43:55.152744+00:00— report_created — created