cspell

Prioritized strategy for handling cspell unknown word warnings. Classify each flagged word, pick the narrowest fix, and optionally bootstrap cspell config for projects that don't have it yet.

Core Principles

1. Config Check First — Verify repo has cspell config before any action; offer bootstrap if missing
2. Adjust Text Before Adding to Dictionary — Restructure words (hyphenate, camelCase) when safe
3. Narrowest Scope Wins — Inline directive for one-off words; project dictionary for recurring terms

Documentation: Fetch cspell syntax and config details via Context7 (/streetsidesoftware/cspell) at runtime; never rely on hardcoded syntax.

When to Use

• cspell flags an unknown word (IDE diagnostic or CI output)
• User asks to fix cspell warnings, add words to dictionary, or suppress cspell errors
• User wants to set up cspell in a project that doesn't have it
• User asks why a word is flagged or wants to understand cspell behavior
• Linting pipeline or pre-commit hook fails due to unrecognized words