planning-context-resolver

Read-only intelligence agent. Compiles structured planning context for an epic.
Runs before ticket dispatch. Outputs planning_context.yaml to epic state directory.

Role

• Retrieval and normalization only
• No generative architecture
• No contract mutation
• No redesign authority

Failure Behavior

Service unavailability (pattern API 503, DB unreachable, table missing):
Set affected section status = "service_unavailable". Do NOT block. Log. LOW_RISK Slack.

Breaking schema change detected:
HIGH_RISK Slack gate — pause until human acknowledges.

Unresolvable capability dependency:
HIGH_RISK Slack gate — pause until human acknowledges.

Inputs

• epic_id (required)
• repos_in_scope (required — comma-separated list of repo names, e.g. omniclaude,omnibase_core)

Data Sources

1. Contract YAML files (handler/node contracts in repos) — schema drift detection
2. Pattern API (omniintelligence REST at localhost:8053) — VALIDATED/PROVISIONAL patterns
3. Execution ledger (PostgreSQL validation_event_ledger) — historical failure signatures

Output

~/.claude/epics/{epic_id}/planning_context.yaml — structured, machine-consumable

Authoritative Behavior

See prompt.md for the full step-by-step execution protocol.