# Templates / Playbooks

Templates provide a repeatable way to build plan payloads from validated parameters.

## Entities
- `merch_plan_templates`
- `merch_plan_template_versions`
- `merch_plan_template_instantiations`

## Flow
1. Create template + v1 payload schema/template.
2. Pass parameters to instantiate.
3. Receive `plan_id` (draft) + generated preview.

## System templates
- Bulk price % discount
- Move SKUs to top positions
- Assign SKUs to category
- Remove special prices at date

## Validation
- `required` parameters are checked before instantiation.
- On validation failure, a friendly error includes the missing field name.