# Project configuration for Codex

Edit this file for each repository.

## Project identity

Project name: `CHANGE_ME`
Project description: `CHANGE_ME`
Primary language/runtime: `CHANGE_ME`

## Project mode

Choose one:

```text
project_mode: personal
project_mode: work
```

Rules:

- `personal`: Docker base image policy is neutral.
- `work`: prefer Red Hat UBI minimal images when possible.

## Enabled profiles

Enable only the profiles that apply to this repository:

```text
enabled_profiles:
  - docker
  - ansible
  - python
```

## Branching model

Codex MUST:

- start from `develop`;
- create one branch per task;
- use one of these prefixes:
  - `feature/`
  - `fix/`
  - `hotfix/`
  - `chore/`
  - `docs/`
  - `refactor/`

Examples:

```text
feature/add-healthcheck
fix/selinux-authorized-keys
hotfix/restore-container-startup
```

## Commit style

Codex MUST use Conventional Commits.

Examples:

```text
feat: add Docker healthcheck
fix: correct Ansible SELinux handling
docs: add ADR for deployment strategy
test: add regression tests for parser
refactor: simplify container startup logic
chore: update Codex project metadata
```

## Test command

All tests MUST be executed inside Docker containers.

Configure the canonical test command for this repository:

```bash
docker compose --env-file .env.example -f infra/docker/compose.yml config
docker compose --env-file .env.example -f infra/docker/compose.yml run --rm --build backend python manage.py test
```

Examples:

```bash
docker compose run --rm app pytest
```

```bash
docker compose run --rm app ruff check .
docker compose run --rm app pytest
```

```bash
docker compose run --rm ansible ansible-playbook --syntax-check playbook.yml
```

If no test command is configured, Codex MUST:

1. report that tests are not configured;
2. suggest the appropriate Docker-based test command;
3. avoid claiming that the task is fully verified.

## Documentation language

Documentation language: English.
Code comments language: English.