dark-code-suite-init

To set up dark code prevention on a new codebase, run a one-step initialization that creates required comprehension directories, updates CLAUDE.md with onboarding guidance, and baselines your initial comprehension debt.

Comprehension debt is the measure of how difficult a codebase is to understand. An initial dark-code-audit baselines this debt by generating audit reports in the docs/dark-code-audit/ directory during project setup.

You do not need an existing CLAUDE.md file. The initialization process will create CLAUDE.md if it is missing, or append a Dark Code Prevention section to it if the file already exists in your project.

You can integrate dark code prevention into ongoing projects by running the initialization suite. It prepares the documentation scaffold and runs an initial audit without disrupting your existing project structure.

Onboarding a codebase to dark code practices requires the .claude/comprehension/ directory for artifacts and the docs/dark-code-audit/ directory for audit reports, both created automatically during initialization.

The initialization is designed as a one-time setup per project to establish comprehension artifacts and baseline audits. It does not perform ongoing audits or prevent dark code automatically without subsequent suite tools.