generated from bisco/codex-bootstrap
bisco
113 lines
2.6 KiB
Markdown
113 lines
2.6 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```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 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:
|
|
|
|
```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.
|