How do I create a new entity?

Every entity must conform to entity lifecycle before writing any code. That document specifies what each layer must contain and what the defaults are. Partial entities or disabled defaults without written rationale are not acceptable.

Scaffold the org model:

./compass.sh add entity_org --component {component} --slug {entity} \
    --description "<one line>"

This writes projects/ores.<component>/modeling/ores.<component>.<entity>.org with #+type: ores.codegen.entity. Fill in the columns, the profile flags, and the knobs the meta-model requires.

If any of has_history, has_pagination, or detail_fields is absent or disabled, add a deviation_rationale_{dimension} key with a one-sentence justification before proceeding.

# SQL (table DDL, trigger, RLS, artefact table)
./compass.sh codegen entity generate <entity> --address ores.sql.schema

# C++ API and core (domain type, repository, service, handler)
./compass.sh codegen entity generate <entity> --address ores.cpp

Follow the compass-codegen-add-entity skill for CMakeLists integration, layer wiring, and PR checkpoints at each layer boundary.

# SQL schema integrity
./projects/ores.sql/utility/validate_schemas.sh

# Component documentation
./projects/ores.codegen/validate_docs.sh

Ask the user to build the affected targets before raising each PR.