# Language policy

- `README.md` is the primary English/international README.
- `README.pt-BR.md` is a practical Portuguese introduction for Brazilian adoption.
- Commands, paths, statuses, skill names, and technical tokens stay in English.
- Human-facing CLI prose follows the selected `.sdd-agentic-flow/config.yml` profile. This
  includes guided prompts, plans, diagnostics, menus, and learning output; commands, paths,
  statuses, IDs, JSON keys, and URLs remain canonical English.
- The [English skills usage guide](saf-skills-usage-guide.md) is the primary
  reference; the [Portuguese guide](saf-skills-usage-guide.pt-BR.md) provides
  the same workflow with Brazilian Portuguese explanations.
- The [English language profile guide](language-profiles.md) documents the
  profile contract; the [Portuguese language profile guide](language-profiles.pt-BR.md)
  provides the same guidance for Brazilian adoption.

## Parity expectations

Portuguese docs explain the same workflow surfaces as English. When the English README adds CLI commands, flags, or workflow sections (for example autonomy levels or execution modes), update `README.pt-BR.md` to match. Technical tokens, command names, and file paths stay in English in both languages.

Link labels use human titles in both languages (`[installation scope](installation-scope.md)`, not the filename alone).

CLI JSON is intentionally locale-neutral. Use ordinary output for localized human reports and
`doctor --json` only for the stable machine contract.