When Code Looks Fine but Isn’t: Building Nice Code for Evidence-Based Review

Описание и применение

Nice Code добавляет слой проверки, выявляющий контекстные проблемы, которые пропускают компиляторы и линтеры, улучшая качество ревью кода.

Задача

Pull requests can pass compilers, linters, and tests yet still contain serious engineering issues such as improper async handling, hidden credentials, or ignored errors.

Результат

Nice Code surfaced contextual engineering questions early, reducing hidden bugs and improving review quality without replacing existing compilers or linters.

Рабочий процесс

• Install Nice Code via npm or npx
• Run "nice-code --changed --project ." during local development
• Optionally run "nice-code --all --project ." for full repo scans
• Use "nice-code --json" or "--format sarif" for machine-readable reports
• Integrate into CI with GitHub Actions to upload SARIF
• Create a baseline with "nice-code --write-baseline" to focus on new findings

Доказательства

Nice Code adds a conservative, evidence-oriented review on top of the tools a project already uses.

Источник

The baseline makes it possible to focus on new findings while the project works through older review items deliberately.

Источник