Handbook

Migration guides

Use this template whenever you introduce v2 of a task_id or materially tighten schemas.

Updated

Template — task version bump

# Migrating `<task_id>` v1 → v2

## Who is affected
Callers embedding payloads matching `src/forge_lcdl/contracts/<task_id>/v1/contract.json`.

## What changed
- Inputs: …
- Outputs: …
- Error taxonomy: …

## Before
Minimal payload example (v1):

## After
Minimal payload example (v2):

## Validation commands
python3 scripts/audit_contract_docs.py --strict --strict-md --require-contract-identity
pytest -q tests/test_<task>_task.py

## Rollback
Pin consumer to prior git SHA / package version; keep gateway profiles unchanged unless coordinated.

Published migrations

Add links here as migrations ship.