From 1795402d0ea55ac74d8f8d372d178edf2d0695f5 Mon Sep 17 00:00:00 2001
From: Holger Schmermbeck <holger@secpal.app>
Date: Sun, 2 Nov 2025 17:57:33 +0100
Subject: [PATCH] docs: add explicit reminder to read org-wide instructions

SPDX-FileCopyrightText: 2025 SecPal
SPDX-License-Identifier: AGPL-3.0-or-later

Adds prominent comment block reminding AI to check parent
organization instructions before PR/commit/merge operations.

Lists critical topics: Copilot Review Protocol, Quality Gates,
Branch Protection, TDD Policy, CHANGELOG maintenance.
---
 .github/copilot-instructions.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 19da826..b26e085 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -1,6 +1,24 @@
 <!-- @EXTENDS: ../../.github/.github/copilot-instructions.md -->
 <!-- INHERITANCE: Core Principles + Org Rules from parent, Laravel-specific rules below -->
 
+<!--
+🚨 AI MUST READ ORGANIZATION-WIDE INSTRUCTIONS FIRST:
+   File: SecPal/.github/.github/copilot-instructions.md
+
+   Contains CRITICAL rules about:
+   - Copilot Review Protocol (GraphQL only, NO comment tools!)
+   - Pre-Commit/Pre-Push/CI Quality Gates
+   - Branch Protection & PR Rules
+   - TDD Mandatory Policy
+   - CHANGELOG Maintenance
+
+   ALWAYS check org instructions before taking actions on:
+   - Pull Request comments/reviews
+   - Commits and pushes
+   - Merges
+   - Quality gate decisions
+-->
+
 <laravel-boost-guidelines>
 === foundation rules ===