hoopscout-v3/.codex/project.md

Project configuration for Codex

Edit this file for each repository.

Project identity

Project name: HoopScout Project description: Private web application for basketball player scouting across European and selected international leagues. Primary language/runtime: Python 3.13 / Django, TypeScript / Angular

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 ruff check .
docker compose run --rm backend pytest
docker compose run --rm frontend npm test
docker compose config

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.