Merge pull request #40 from hotdata-dev/docs/comment-style-harness

docs(review): add the comment style harness

Author: zfarrell

.github/workflows/tests.yml

@@ -55,6 +55,12 @@ jobs:
       - name: Context step end to end
         run: tests/context-step-test.sh
 
+      # Guards the comment style harness's corpus rather than the review workflow: the
+      # recorded totals in docs/comment-style-harness.md are only comparable while the
+      # committed corpus keeps the shape they were measured against.
+      - name: Comment style corpus
+        run: tests/comment-style-corpus-test.sh
+
   # Runs claude-pr-review.yml itself, from this commit, with the review step skipped. The checks
   # above all read the workflow as text; this one hands it to Actions and asks whether it starts.
   #

README.md

@@ -13,6 +13,10 @@ Automated code review on every pull request using [claude-code-action](https://g
 - **No issues** — silent approve
 
 The review prompt lives in [`docs/claude-pr-review-prompt.md`](docs/claude-pr-review-prompt.md).
+Changes to its comment-style rules go through
+[`docs/comment-style-harness.md`](docs/comment-style-harness.md) first — the prompt deploys
+org-wide from `main` with no staging, and that procedure is the staging. It does not cover
+the severity or summary-comment rules; that document says why.
 
 ### Frontloaded review context