From 86076048bb5687e06a42e279fdc4e33dc862b4b1 Mon Sep 17 00:00:00 2001
From: Evelyn Chen <architect@fritzlab.net>
Date: Thu, 27 Aug 2026 18:30:36 +0000
Subject: [PATCH] Document edited-body trigger

Authored-By: Codex (GPT-5) <noreply@openai.com>
---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 080ab96..6636969 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,10 @@ Title:    [bug-x7k2m9] Fix terminal resize loss   (chore PRs: no [bug-id] prefix
 ## Usage
 
 ```yaml
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited]
+
 jobs:
   naming:
     runs-on: fritzlab
@@ -42,6 +46,10 @@ jobs:
           head-sha: ${{ github.event.pull_request.head.sha }}
 ```
 
+The explicit `edited` activity is part of the enforcement contract: changing
+the PR description must issue a new naming status for the same commit.
+Description-only events may skip unrelated validation jobs.
+
 To wire a new repo warn-only first, add `continue-on-error: true` to the
 job — the step still fails, but the job cannot block the PR.