refactored reason string and remediation instructions framework