Copilot instructions

1---
2description: Rule for Agent Skills Standard - Always consult AGENTS.md for consolidated project context and technical triggers.
3applyTo: '**/*'
4---
5 
6# 🛠 Agent Skills Routing Protocol (CRITICAL)
7 
8You are operating in a Zero-Trust environment. You are strictly forbidden from relying on your baseline pre-training for architecture, styling, testing, or code patterns in this repository.
9 
10> [!CRITICAL] GATEKEEPER CONSTRAINT
11> **Your first action in ANY session MUST be a tool call to read `AGENTS.md`.**
12> You must NOT write code, suggest solutions, or output text explanations until you have completed the State Machine below.
13 
14## 🔄 The Mandatory State Machine
15 
16You must execute these states sequentially. Do not proceed to the next state until the current one is satisfied.
17 
18### State 1: Discovery (Tool Call Required)
19 
20- **Action:** Execute a file-reading tool (e.g., `view_file`, `read_file`, `cat`) targeting the exact path: `AGENTS.md` (located in the project root).
21- **Condition to pass:** You have successfully read the `<!-- SKILLS_INDEX_START -->` block.
22 
23### State 2: Trigger Matching (Internal Thought)
24 
25- **Action:** Analyze the user's prompt (keywords) and the files involved in the task (globs).
26- **Condition to pass:** Cross-reference them against the `(triggers: ...)` list inside `AGENTS.md`. Identify all matching Skills and note their exact file paths.
27 
28### State 3: Context Loading (Tool Call Required)
29 
30- **Action:** Execute file-reading tools to read the `SKILL.md` files at the exact paths identified in State 2.
31- **Condition to pass:** You have ingested the specific guidelines for the task. If no skills matched in State 2, you may skip this state.
32 
33### State 4: Execution & Audit Log (Output Generation)
34 
35- **Action:** You may now begin answering the user or writing code.
36- **Constraint:** Your very first text output MUST be a "Pre-Write Audit Log" confirming which skills were loaded, or explicitly stating "No project-specific skills applicable."
37 
38## Self-Learning Protocol
39 
40At the end of any multi-step task with user corrections, load and run **[common/common-session-retrospective](../skills/common/common-session-retrospective/SKILL.md)** to capture skill gaps and prevent repeat rework.
41