# Language profiles

Language profiles control human-facing explanations without translating the
technical contract of the toolkit.

## Available profiles

| Profile | Human output         | Technical tokens  | Bilingual mode        |
| ------- | -------------------- | ----------------- | --------------------- |
| `en-US` | English              | Canonical English | `technical-canonical` |
| `pt-BR` | Brazilian Portuguese | Canonical English | `technical-canonical` |

The shared profile files are installed with the official bundle. They define how an
agent should write explanations, prompts, and reports. Commands, paths, skill
names, configuration keys, modes, statuses, and identifiers remain unchanged.

## Select a profile

The fallback profile is `en-US`. Direct `init` does not create or overwrite project
configuration. Interactive workspace setup persists the selected profile only when you apply the
reviewed Git-workspace plan; it writes matching `language.profile` and `language.human_outputs`
values. User-only setup keeps the selection in the session and does not create project config or a
global language preference.

An explicit configuration override has this shape:

```yaml
language:
  profile: pt-BR
  human_outputs: pt-BR
  technical_tokens: canonical
  bilingual_mode: technical-canonical
```

## Validate a profile

```bash
npx sdd-agentic-flow doctor
npx sdd-agentic-flow doctor --json
```

`doctor` reports a `Language` section. `doctor --json` includes a top-level
`language` object with the selected profile and validation status. A legacy project may omit
`language.profile`; the doctor reports this as a compatibility `WARN` and does not rewrite the file.

## Language policy

Human-facing CLI output follows the selected profile, including interactive prompts, plans,
doctor reports, menus, and learning output. Technical tokens stay
canonical so prompts, paths, statuses, and skill references remain usable
across agent clients. See [the language policy](../shared/references/language-policy.md)
and the [Portuguese profile guide](language-profiles.pt-BR.md).