From 55c042211a24ff891049f1a45604e6b00e27038d Mon Sep 17 00:00:00 2001
From: hopeatina <hopeatina@gmail.com>
Date: Fri, 17 Apr 2026 05:44:19 -0500
Subject: [PATCH] feat(daily-brief): orgx-deviation-reporting skill

Instructs Codex to record skill deviations with OrgX when OrgX skills
fire locally. Feeds the Daily Brief's proof strip + confidence sparkline.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 skills/orgx-deviation-reporting/SKILL.md | 74 ++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 skills/orgx-deviation-reporting/SKILL.md

diff --git a/skills/orgx-deviation-reporting/SKILL.md b/skills/orgx-deviation-reporting/SKILL.md
new file mode 100644
index 0000000..67ece1d
--- /dev/null
+++ b/skills/orgx-deviation-reporting/SKILL.md
@@ -0,0 +1,74 @@
+---
+name: orgx-deviation-reporting
+description: Record a skill deviation with OrgX so it feeds tomorrow's Daily Brief. Use whenever an OrgX skill fires locally on a file edit, commit, PR, chat turn, or task output.
+tools:
+  - mcp__orgx__*
+---
+
+# OrgX — skill deviation reporting
+
+Every time an OrgX skill catches a deviation during your work, record it
+with OrgX so the evidence shows up in tomorrow's Daily Brief and drives
+the confidence trajectory for that skill.
+
+## When to record
+
+You should record a deviation when:
+
+- A rule from an OrgX skill triggered on code or content you touched.
+- You accepted or rejected a skill's suggestion (pass `outcome: confirmed`
+  or `outcome: rejected`).
+- A skill surfaced a pattern in output you produced.
+
+Do **not** record the same deviation more than once per 10-minute window —
+the server dedupes on `dedupe_key` automatically; duplicate POSTs waste
+tokens.
+
+## How to record
+
+Direct HTTP POST through the OpenClaw bridge or via `orgx.post_skill_deviation`
+MCP tool:
+
+```
+POST /api/v1/skills/{skill_id}/deviations
+Authorization: Bearer <OrgX API key>
+Content-Type: application/json
+
+{
+  "evidence_kind":      "file_edit" | "commit" | "pr" | "chat_turn" | "task_output",
+  "evidence_ref":       "<repo>#<pr>" | "<path>:<line>" | "<commit_sha>",
+  "summary":            "<one-line description>",
+  "application_source": "plugin_codex",
+  "confidence":         0.0..1.0,
+  "outcome":            "pending" | "confirmed" | "rejected" | "ignored",
+  "trigger_context":    { "file_path": "...", "rule_matched": "..." },
+  "dedupe_key":         "<sha1(skill_id | evidence_kind | evidence_ref | floor(epoch/600))>",
+  "captured_at":        "2026-04-17T10:00:00Z"
+}
+```
+
+### Computing `dedupe_key`
+
+```ts
+import { createHash } from "node:crypto";
+
+const bucket = Math.floor(Date.now() / 1000 / 600);
+const material = [skillId, evidenceKind, evidenceRef, String(bucket)].join("|");
+const dedupe_key = createHash("sha1").update(material).digest("hex");
+```
+
+10-minute bucketing handles save-happy editors without losing legitimate
+re-fires beyond that window.
+
+## What happens next
+
+Your deviation lands in `skill_deviations`. The nightly rollup feeds it
+into the Daily Brief proof strip's "Deviations caught" tile + updates
+the skill's confidence sparkline. Agents whose loadout doesn't include
+the skill may get a cross-pollination proposal surfaced.
+
+## Links
+
+- Full contract: https://github.com/hopeatina/orgx/blob/main/orgx/docs/api-contracts/daily-brief-schema.md#04
+- SDK reference implementation (Node): https://github.com/useorgx/openclaw-plugin/blob/main/src/deviations-sdk.ts
+- Daily Brief surface: https://useorgx.com/today