From 9636e86b75c5cd090f05e3cf79df54307b41624f Mon Sep 17 00:00:00 2001
From: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
Date: Tue, 17 Mar 2026 11:14:51 -0600
Subject: [PATCH] feat(coderabbit): add docs-staleness check for all src/
 changes

Adds a path_instructions entry so CodeRabbit flags when documentation
under docs/ may need updating whenever source files are modified.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .coderabbit.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.coderabbit.yaml b/.coderabbit.yaml
index e8ddc9aac..160201054 100644
--- a/.coderabbit.yaml
+++ b/.coderabbit.yaml
@@ -60,6 +60,13 @@ reviews:
     - "!**/validation-report-*.md"
     - "!CHANGELOG.md"
   path_instructions:
+    - path: "src/**"
+      instructions: |
+        Source file changed. Check whether documentation under docs/ needs
+        a corresponding update — new features, changed behavior, renamed
+        concepts, altered CLI flags, or modified configuration options should
+        all be reflected in the relevant doc pages. Flag missing or outdated
+        docs as a review comment.
     - path: "src/**/skills/**"
       instructions: |
         Skill file. Apply the full rule catalog defined in tools/skill-validator.md.