diff --git a/.github/agents/README.md b/.github/agents/README.md index 701d1a5c3..4842c144a 100644 --- a/.github/agents/README.md +++ b/.github/agents/README.md @@ -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
File Operations] + GH[๐Ÿ™ github
GitHub API] + GT[๐Ÿ“Š git
Git Operations] + MEM[๐Ÿง  memory
Context Memory] + ST[๐Ÿค” sequential-thinking
Problem Solving] + end + + subgraph "Testing & Automation" + PW[๐ŸŽญ playwright
Browser Automation] + end + + subgraph "Optional Servers" + BS[๐Ÿ” brave-search
Web Search] + AWS[โ˜๏ธ aws
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 diff --git a/.github/agents/code-review-agent.md b/.github/agents/code-review-agent.md index 51211799b..4efe4755b 100644 --- a/.github/agents/code-review-agent.md +++ b/.github/agents/code-review-agent.md @@ -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 diff --git a/.github/agents/coding-agent.md b/.github/agents/coding-agent.md index 57c568370..eafc9c919 100644 --- a/.github/agents/coding-agent.md +++ b/.github/agents/coding-agent.md @@ -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 diff --git a/.github/agents/documentation-writer.md b/.github/agents/documentation-writer.md index a3e4d064d..6f55c0462 100644 --- a/.github/agents/documentation-writer.md +++ b/.github/agents/documentation-writer.md @@ -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 diff --git a/.github/agents/frontend-specialist.md b/.github/agents/frontend-specialist.md index 4ccdfe765..6bb2a1023 100644 --- a/.github/agents/frontend-specialist.md +++ b/.github/agents/frontend-specialist.md @@ -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 diff --git a/.github/agents/game-developer.md b/.github/agents/game-developer.md index 51cae82fa..d816ea1fd 100644 --- a/.github/agents/game-developer.md +++ b/.github/agents/game-developer.md @@ -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 diff --git a/.github/agents/security-specialist.md b/.github/agents/security-specialist.md index b94445427..5f3d98aae 100644 --- a/.github/agents/security-specialist.md +++ b/.github/agents/security-specialist.md @@ -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 diff --git a/.github/agents/task-agent.md b/.github/agents/task-agent.md index 7680ea5b6..2f28e7923 100644 --- a/.github/agents/task-agent.md +++ b/.github/agents/task-agent.md @@ -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: diff --git a/.github/agents/test-engineer.md b/.github/agents/test-engineer.md index 98be022fe..5ae62ead9 100644 --- a/.github/agents/test-engineer.md +++ b/.github/agents/test-engineer.md @@ -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 diff --git a/.github/agents/testing-agent.md b/.github/agents/testing-agent.md index 52f0a3a8c..d1e82a420 100644 --- a/.github/agents/testing-agent.md +++ b/.github/agents/testing-agent.md @@ -10,6 +10,27 @@ You are a specialized testing agent for the Black Trigram (ํ‘๊ด˜) project. Your You help write comprehensive tests, debug test failures, and ensure high-quality test coverage following the project's testing patterns. +## 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 - **Vitest** for unit and integration tests diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml index 995fd357b..1e2b0a639 100644 --- a/.github/workflows/copilot-setup-steps.yml +++ b/.github/workflows/copilot-setup-steps.yml @@ -25,7 +25,6 @@ jobs: permissions: contents: read actions: read - artifact-metadata: read attestations: read checks: read deployments: read