Policy troubleshooting playbook

Symptom: control not added

Check:

• scope key and value spelling
• target/entity alignment
• rule location in correct environment file
• condition path uses correct entity (component, connection, upstream, etc)

Symptom: wrong entities affected

Check:

• overly broad condition (*, missing type filter)
• use of global selectors without configKey restrictions
• unintended cross-entity action logic

Symptom: score looks wrong

Check:

• map keys match stored value format
• default/missing behavior is explicit
• score action stage order is correct

Symptom: policies appear inconsistent across environments

Check:

• equivalent rules exist in each environment pack
• naming and scope semantics are consistent
• environment-specific configuration keys are aligned