Hack23 · pethers · Nov 26, 2025 · Nov 26, 2025 · Nov 26, 2025 · Nov 26, 2025
@@ -8,6 +8,87 @@ GitHub Copilot custom agents are AI assistants with specialized knowledge. When
 
 **📊 New: [Agent Capabilities Matrix](./AGENT_CAPABILITIES.md)** - Comprehensive guide to all agents, their capabilities, and coordination patterns.
 
+## 🔧 Environment & Configuration
+
+All agents have access to essential project configuration files that define the development environment, available tools, and project context:
+
+### Essential Files
+
+| File | Purpose | What Agents Find Here |
+|------|---------|----------------------|
+| **[`README.md`](/README.md)** | Main Project Context | Project overview, tech stack, ISMS compliance framework, combat mechanics, Korean martial arts philosophy |
+| **[`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)** | Environment Setup | Node.js 24 configuration, npm dependencies, build/test commands, GitHub Actions permissions |
+| **[`.github/copilot-mcp.json`](/.github/copilot-mcp.json)** | MCP Server Configuration | Available MCP servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws), tool capabilities, integration patterns |
+
+### MCP Servers Available
+
+```mermaid
+graph TB
+    subgraph "Core MCP Servers"
+        FS[📁 filesystem<br/>File Operations]
+        GH[🐙 github<br/>GitHub API]
+        GT[📊 git<br/>Git Operations]
+        MEM[🧠 memory<br/>Context Memory]
+        ST[🤔 sequential-thinking<br/>Problem Solving]
+    end
+
+    subgraph "Testing & Automation"
+        PW[🎭 playwright<br/>Browser Automation]
+    end
+
+    subgraph "Optional Servers"
+        BS[🔍 brave-search<br/>Web Search]
+        AWS[☁️ aws<br/>Cloud Infrastructure]
+    end
+
+    Agents[GitHub Copilot Agents] --> FS
+    Agents --> GH
+    Agents --> GT
+    Agents --> MEM
+    Agents --> ST
+    Agents --> PW
+    Agents -.-> BS
+    Agents -.-> AWS
+
+    style FS fill:#4CAF50,stroke:#2E7D32,color:#fff
+    style GH fill:#2196F3,stroke:#1565C0,color:#fff
+    style GT fill:#FF9800,stroke:#E65100,color:#fff
+    style MEM fill:#9C27B0,stroke:#6A1B9A,color:#fff
+    style ST fill:#00BCD4,stroke:#00838F,color:#fff
+    style PW fill:#E91E63,stroke:#AD1457,color:#fff
+    style BS fill:#FFC107,stroke:#F57F17,color:#000
+    style AWS fill:#FF5722,stroke:#BF360C,color:#fff
+    style Agents fill:#607D8B,stroke:#37474F,color:#fff
+```
+
+### Development Environment
+
+The setup workflow (`.github/workflows/copilot-setup-steps.yml`) defines:
+
+- **Node.js Version**: 24 (latest LTS)
+- **Package Manager**: npm with `npm ci` for reproducible builds
+- **Build Tool**: Vite for fast development and optimized production builds
+- **Test Frameworks**: Vitest (unit/integration), Cypress (E2E)
+- **TypeScript**: Strict mode enabled for type safety
+
+**Permissions Available in CI:**
+```yaml
+contents: read          # Read repository contents
+actions: read          # Read workflow runs
+attestations: read     # Read attestations
+checks: read           # Read check runs
+deployments: read      # Read deployment status
+issues: write          # Create and update issues
+models: read           # Read AI models (Copilot)
+discussions: read      # Read discussions
+pages: read            # Read GitHub Pages
+pull-requests: write   # Create and update PRs
+security-events: read  # Read security alerts
+statuses: read         # Read commit statuses
+```
+
+## 📋 Agent Overview
+
 ```mermaid
 graph LR
     A[Development Task] --> B{Task Type?}
@@ -31,15 +112,15 @@ graph LR
     K -.Delegates.-> H
     K -.Delegates.-> J
 
-    style K fill:#8BC34A
-    style C fill:#4CAF50
-    style D fill:#2196F3
-    style E fill:#FF9800
-    style F fill:#9C27B0
-    style G fill:#00BCD4
-    style H fill:#F44336
-    style I fill:#FFC107
-    style J fill:#E91E63
+    style K fill:#8BC34A,stroke:#558B2F,color:#fff
+    style C fill:#4CAF50,stroke:#2E7D32,color:#fff
+    style D fill:#2196F3,stroke:#1565C0,color:#fff
+    style E fill:#FF9800,stroke:#E65100,color:#fff
+    style F fill:#9C27B0,stroke:#6A1B9A,color:#fff
+    style G fill:#00BCD4,stroke:#00838F,color:#fff
+    style H fill:#F44336,stroke:#C62828,color:#fff
+    style I fill:#FFC107,stroke:#F57F17,color:#000
+    style J fill:#E91E63,stroke:#AD1457,color:#fff
 ```
 
 ## 🎯 Available Agents
@@ -282,16 +363,16 @@ flowchart TD
     Review --> Action
     Security --> Action
 
-    style TaskAgent fill:#8BC34A,color:#fff
-    style Frontend fill:#2196F3,color:#fff
-    style Game fill:#FF9800,color:#fff
-    style Coding fill:#4CAF50,color:#fff
-    style Testing fill:#9C27B0,color:#fff
-    style TestEng fill:#E91E63,color:#fff
-    style Docs fill:#00BCD4,color:#fff
-    style Review fill:#FFC107,color:#000
-    style Security fill:#F44336,color:#fff
-    style Action fill:#8BC34A,color:#fff
+    style TaskAgent fill:#8BC34A,stroke:#558B2F,color:#fff
+    style Frontend fill:#2196F3,stroke:#1565C0,color:#fff
+    style Game fill:#FF9800,stroke:#E65100,color:#fff
+    style Coding fill:#4CAF50,stroke:#2E7D32,color:#fff
+    style Testing fill:#9C27B0,stroke:#6A1B9A,color:#fff
+    style TestEng fill:#E91E63,stroke:#AD1457,color:#fff
+    style Docs fill:#00BCD4,stroke:#00838F,color:#fff
+    style Review fill:#FFC107,stroke:#F57F17,color:#000
+    style Security fill:#F44336,stroke:#C62828,color:#fff
+    style Action fill:#8BC34A,stroke:#558B2F,color:#fff
 ```
 
 ## 🛠️ Tools Available to Agents
@@ -369,15 +450,15 @@ graph TD
     TestEng --> FullTools
     Security --> FullTools
 
-    style TaskAgent fill:#8BC34A,color:#fff
-    style Review fill:#FFC107,color:#000
-    style Docs fill:#00BCD4,color:#fff
-    style Coding fill:#4CAF50,color:#fff
-    style Frontend fill:#2196F3,color:#fff
-    style Game fill:#FF9800,color:#fff
-    style Testing fill:#9C27B0,color:#fff
-    style TestEng fill:#E91E63,color:#fff
-    style Security fill:#F44336,color:#fff
+    style TaskAgent fill:#8BC34A,stroke:#558B2F,color:#fff
+    style Review fill:#FFC107,stroke:#F57F17,color:#000
+    style Docs fill:#00BCD4,stroke:#00838F,color:#fff
+    style Coding fill:#4CAF50,stroke:#2E7D32,color:#fff
+    style Frontend fill:#2196F3,stroke:#1565C0,color:#fff
+    style Game fill:#FF9800,stroke:#E65100,color:#fff
+    style Testing fill:#9C27B0,stroke:#6A1B9A,color:#fff
+    style TestEng fill:#E91E63,stroke:#AD1457,color:#fff
+    style Security fill:#F44336,stroke:#C62828,color:#fff
 ```
 
 ## 🎯 Agent Development Guidelines

@@ -10,6 +10,27 @@ You are a specialized code review agent for the Black Trigram (흑괘) project.
 
 You perform thorough code reviews, provide constructive feedback, and ensure all changes maintain the high quality standards expected for this traditional Korean martial arts inspired game.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Expertise
 
 - Code quality assessment and standards enforcement

@@ -10,6 +10,27 @@ You are a specialized coding agent for the Black Trigram (흑괘) project - a re
 
 You help implement new features, fix bugs, and refactor code following the project's established patterns. Always reference the main `.github/copilot-instructions.md` file for comprehensive guidelines.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Technologies
 
 - **React 18+** with TypeScript

@@ -10,6 +10,27 @@ You are a specialized documentation agent for the Black Trigram (흑괘) project
 
 You help create clear, comprehensive, and accessible documentation for this Korean martial arts combat game, covering code documentation, API references, user guides, security policies, and Korean cultural context.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Documentation Types
 
 ### Technical Documentation

@@ -10,6 +10,27 @@ You are a specialized frontend development agent for the Black Trigram (흑괘)
 
 You help build robust, type-safe React components following modern best practices, focusing on component architecture, state management, 3D rendering with @react-three/fiber, and comprehensive testing with React Testing Library.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Expertise
 
 ### React 19 Features

@@ -21,6 +21,27 @@ You:
 - Optimize rendering, physics, and asset usage for a consistent 60fps target on mid-range mobile and desktop hardware.
 - Deliver production-oriented, typed, and maintainable code (TypeScript preferred).
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ---
 
 ## Core Technologies

@@ -10,6 +10,27 @@ You are a specialized security agent for the Black Trigram (흑괘) project. You
 
 You help secure the application from development through deployment, focusing on dependency security, supply chain integrity, license compliance, vulnerability management, and security best practices for this Korean martial arts game.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Security Focus Areas
 
 ### Supply Chain Security

@@ -17,6 +17,27 @@ You are a **product quality guardian** and **issue orchestrator** who:
 - 🧪 Assesses test coverage and quality metrics
 - ⚡ Monitors performance and optimization opportunities
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Core Expertise
 
 You are an expert in:

@@ -10,6 +10,27 @@ You are a specialized test engineering agent for the Black Trigram (흑괘) proj
 
 You help build robust test suites, enforce coverage standards, integrate testing into CI/CD pipelines, and ensure high-quality code through comprehensive testing strategies for this Korean martial arts game.
 
+## Project Configuration & Context
+
+**Essential Files for Understanding the Environment:**
+
+1. **Main Project Context**: [`README.md`](/README.md)
+   - Project overview, tech stack, and documentation links
+   - ISMS compliance framework and security standards
+   - Combat mechanics and Korean martial arts game design philosophy
+
+2. **Environment Setup**: [`.github/workflows/copilot-setup-steps.yml`](/.github/workflows/copilot-setup-steps.yml)
+   - Development environment configuration (Node.js 24, npm dependencies)
+   - Build and test commands that are run in CI
+   - Available GitHub Actions permissions for automation
+
+3. **MCP Server Configuration**: [`.github/copilot-mcp.json`](/.github/copilot-mcp.json)
+   - Model Context Protocol servers (filesystem, github, git, memory, sequential-thinking, playwright, brave-search, aws)
+   - Available tools and capabilities per MCP server
+   - Integration patterns with GitHub, AWS, and browser automation
+
+**Always consult these files** to understand the complete development environment, available tools, and project context before making changes.
+
 ## Testing Stack
 
 ### Core Testing Tools