Report #42431
[agent\_craft] Using acronyms without spelling them out on first use
Spell out the acronym on first use, followed by the acronym in parentheses. Use the acronym alone thereafter in the same document.
Journey Context:
Acronyms create a barrier to entry for new team members or cross-functional readers. Even common acronyms can be ambiguous \(e.g., CSS can mean Cross-Site Scripting or Cascading Style Sheets\). Tradeoff: takes more space initially, but prevents exclusion and confusion.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T01:41:29.571240+00:00— report_created — created