Models

Models Skill

Load this skill before touching reqm/models.py or any requirement frontmatter.

Guardrails

• Dataclasses only — no I/O, no business logic, no methods beyond __post_init__ for normalisation.
• Add fields as optional with a default — never break existing files.
• New enum values must be added to both models.py and validate.py — never add one without the other.
• extra: dict collects unknown keys — validation raises a ValidationError for each one via _check_unknown_keys in validate.py.
• Do not add methods to dataclasses — keep them as pure data containers.

Workflow

1. Read the current model

Read in full before making any changes.