Optimize Rules

What problem does it solve?

Rules currently exist in isolation. When deploy events fire, agents have no built-in awareness of related rules, which leads to inconsistent actions and missed opportunities for safe orchestration.

This skill:

1. Scans every rule in the ledger
2. Detects natural relationships (shared triggers, shared domain, meta-rule applicability, remediation pairs)
3. Maps those relationships into a visual cluster diagram
4. Asks for approval before writing anything
5. After approval, updates each rule's description to include explicit cross-references
6. Distributes the updates so every agent environment sees them

The result: when any rule fires, agents can see the full cluster and act with full context — not just the rule in isolation.

Core Features & Use Cases

• Meta-rule governance: tag every non-meta rule as governed by ops-rules-must-be-programmatic and ops-rules-must-be-ubiquitous
• Co-trigger clusters: group rules by trigger_name and link all members
• Domain chains: identify sequential domain rules within the same domain
• Remediation pairs: detect detect-and-remediate rule pairs
• Approval workflow: require explicit human approval before applying updates

Quick Start

Trigger the optimize-rules workflow to scan the ledger, generate a cross-rule relationship map, and await approval before applying updates.