Imported from khoadd879/odoo_testing (AGENTS.md). Install upstream with npx skills add khoadd879/odoo_testing. Copyright stays with the author.

AGENTS.md — Fashion eCommerce

Binding instructions for coding agents working in this repository. The repo is the source of truth; read the active feature docs before changing code and update them whenever scope changes.

1. Project identity

Never touch the legacy project at /home/khoa/Company/odoo. Never use its compose project, network, volumes, filestore, or ports.

2. Architecture boundary

Native Odoo modules own products, variants, carts, checkout, orders, payments, delivery, stock, portal, and website editing. Custom code may extend those modules but must not replace their core flows.

The fashion_ecommerce module owns only:

• storefront branding and homepage QWeb;
• project SCSS and owned static assets;
• public product categories;
• size/color attributes and reproducible starter products.

AI chatbot and CRM lead automation are out of scope until the native eCommerce purchase flow is complete.

3. Workflow rules

1. Read docs/PROGRESS.md and the active feature in docs/FEATURE_LIST.json before changing code.
2. Work on one independently verifiable feature at a time.
3. Prefer native Odoo 19 and compatible OCA modules over custom logic.
4. Never patch Odoo core.
5. Preserve unrelated user changes.
6. Verify real behavior before claiming completion.
7. Update docs/PROGRESS.md and docs/FEATURE_LIST.json with fresh evidence.
8. Before deleting project-owned Docker volumes, create and verify an offline backup. Only odoo_fashion_db and odoo_fashion_data are in scope.

4. Definition of done

A feature is done only when:

• code/config is committed in this repo;
• docker compose -p odoo_fashion up -d succeeds;
• the relevant module install/update succeeds;
• / and /shop return HTTP 200 when storefront work is involved;
• no new traceback or critical log entry exists;
• every acceptance criterion has fresh evidence;
• ./scripts/agent_check.sh exits 0;
• progress and feature-list docs are current.

5. Approved commands

docker compose -p odoo_fashion up -d
docker compose -p odoo_fashion stop
docker compose -p odoo_fashion ps
docker compose -p odoo_fashion logs --tail=200 odoo
./scripts/update-module.sh fashion_ecommerce
./scripts/update-module.sh fashion_ecommerce --install
./scripts/agent_check.sh

Do not run docker compose down against the legacy project. Do not delete broad directories or volumes. Use exact project-owned targets.

6. When blocked

Capture the failing command and full relevant error. Record the blocker in docs/PROGRESS.md, fix the smallest root cause first, and do not mark the feature done while the blocker remains.