Merge branch 'main' into fluency-tracking

Author: rajbos

src/README.md

@@ -77,3 +77,38 @@ Note: These are the current GitHub Copilot supported Gemini models. Pricing from
 - After making changes, run `npm run compile` to rebuild
 - Pricing is for reference only - GitHub Copilot may use different pricing structures
 - Cost estimates assume a 50/50 split between input and output tokens
+
+## customizationPatterns.json
+
+Defines repository file patterns that the extension will scan for to discover Copilot customization files (for example: `copilot-instructions.md`, `skills/` folders, `agents.md`). The extension uses these patterns to produce the "Customization Files" section in the Usage Analysis webview.
+
+Structure:
+
+```json
+{
+  "patterns": [
+    {
+      "id": "copilot-instructions",
+      "label": "copilot-instructions.md",
+      "path": "copilot-instructions.md",
+      "scanMode": "exact",
+      "icon": "📋"
+    }
+  ],
+  "stalenessThresholdDays": 90,
+  "excludeDirs": [".git", "node_modules"]
+}
+```
+
+Notes:
+
+- `scanMode` can be `exact`, `oneLevel`, or `recursive`.
+- `stalenessThresholdDays` controls when a file is marked as stale in the UI.
+- `excludeDirs` lists directories to skip during recursive scans.
+
+To update patterns:
+
+1. Edit `src/customizationPatterns.json` and add or adjust entries.
+2. Run `npm run compile` to rebuild the extension.
+
+The usage webview will surface discovered files per workspace and mark files as stale when their last modification time exceeds `stalenessThresholdDays`.

src/customizationPatterns.json

@@ -0,0 +1,68 @@
+{
+  "description": "Defines Copilot customization file patterns to scan in workspaces",
+  "lastUpdated": "2026-02-11",
+  "stalenessThresholdDays": 90,
+  "excludeDirs": ["node_modules", ".git", "dist", "build", "out", "__pycache__", ".venv", ".next", "coverage"],
+  "patterns": [
+    {
+      "id": "copilot-instructions",
+      "type": "instructions",
+      "icon": "📋",
+      "label": "Instructions",
+      "path": ".github/copilot-instructions.md",
+      "scanMode": "exact"
+    },
+    {
+      "id": "copilot-setup",
+      "type": "coding-agent",
+      "icon": "⚙️",
+      "label": "Coding Agent Setup",
+      "path": ".github/copilot-setup.md",
+      "scanMode": "exact"
+    },
+    {
+      "id": "mcp-config",
+      "type": "mcp-config",
+      "icon": "🔌",
+      "label": "MCP Server Config",
+      "path": ".vscode/mcp.json",
+      "scanMode": "exact"
+    },
+    {
+      "id": "skills",
+      "type": "skill",
+      "icon": "🧠",
+      "label": "Skill Files",
+      "path": ".github/skills/*/SKILL.md",
+      "scanMode": "oneLevel"
+    },
+    {
+      "id": "agents-dir",
+      "type": "agent",
+      "icon": "🤖",
+      "label": "Custom agents",
+      "path": ".github/agents/*.md",
+      "scanMode": "recursive",
+      "maxDepth": 3
+    },
+    {
+      "id": "scoped-instructions",
+      "type": "instructions",
+      "icon": "📋",
+      "label": "Scoped Instructions",
+      "path": "**/*.instructions.md",
+      "scanMode": "recursive",
+      "maxDepth": 5
+    },
+    {
+      "id": "agents-md",
+      "type": "agent",
+      "icon": "🤖",
+      "label": "AGENTS.md",
+      "path": "**/AGENTS.md",
+      "scanMode": "recursive",
+      "maxDepth": 5,
+      "caseInsensitive": true
+    }
+  ]
+}