azionelab-v2/.codex/project.md

Project configuration for Codex

Edit this file for each repository.

Project identity

Project name: Azione!Lab WordPress Project description: Single-page WordPress website for a contemporary theatre workshop. Primary language/runtime: PHP 8.3 and WordPress 7

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

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 --no-deps wordpress php -l /opt/azionelab/theme/functions.php
docker compose run --rm --no-deps wordpress php -l /opt/azionelab/theme/front-page.php
docker compose run --rm --no-deps wordpress php -l /opt/azionelab/azionelab-content.php
docker compose run --rm --no-deps proxy nginx -t
docker compose -f docker-compose.yml -f docker-compose.test.yml up --build -d db wordpress proxy
docker compose -f docker-compose.yml -f docker-compose.test.yml --profile tools run --rm wp-cli /scripts/bootstrap.sh
docker compose -f docker-compose.yml -f docker-compose.test.yml --profile test run --build --rm functional-tests
docker compose -f docker-compose.yml -f docker-compose.test.yml --profile test run --rm security-tests
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.