azionelab-v2/.codex/project.md

Project configuration for Codex

Edit this file for each repository.

Project identity

Project name: Azione!Lab Project description: Headless Wagtail CMS and Astro single-page website for a theatre workshop. Primary language/runtime: Python 3.12 and Node.js 22

Project mode

Choose one:

project_mode: personal

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:

enabled_profiles:
  - docker
  - 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:

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

Commit style

Codex MUST use Conventional Commits.

Examples:

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:

docker compose run --rm backend python manage.py test
docker compose run --rm frontend npm run check
docker compose run --rm frontend npm run build
docker compose run --rm proxy nginx -t
docker compose config --quiet

Examples:

docker compose run --rm app pytest

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

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.