# Migrating to application configuration v3

Audita v3 is a hard cutover. Move application settings to `version: 3` and use
[the configuration reference](../config.md) and [maintained examples](../../examples/)
to construct the new files. The previous configuration and standalone glossary
formats are not loaded by the new processing path.

- Replace `pipeline.modules` with ordered `pipeline.stages` records containing
  `module` and any per-entry overrides. An explicit empty list runs normalization.
- Define named `glossary_collections` in configuration or its companion imports;
  select them using `glossaries` and `protected_terms`. Remove `--glossary` and
  `--modules` from invocations.
- Move profiles and backends out of the application configuration and retired
  `profiles_dir` layout into PromptKit resources. Use its current list records,
  IDs, credential sources, and backend admission settings. Select proposal and
  validation profiles in application `llm` settings.
- Use the shared `--debug` flag for capture; `diagnostics.work_dir` remains the
  parent directory. Review report and output destinations before running.

Inspect configuration and resources before processing, then try a controlled
small transcript. Processing preflight checks every glossary correction and
selected role before preparing outputs or invoking a model. See [operations](../operations.md)
for lifecycle and recovery.