# 🤖 GitHub Copilot Custom Agents for Black Trigram (흑괘)

This directory contains specialized GitHub Copilot custom agent profiles for Black Trigram development. Each agent is an expert in a specific domain, providing focused assistance for particular development tasks.

## 🆕 Agent Skills System

**New in 2026:** Black Trigram now includes **[GitHub Copilot Agent Skills](../skills/README.md)** - strategic, high-level principles that are automatically enforced across all development work.

### Skills vs Agents

| **Skills** ([📚 View All](../skills/README.md)) | **Agents** (This Directory) |
|-----------|-----------|
| Strategic principles and rules | Task-specific implementers |
| Automatically activated by context | Explicitly invoked |
| Enforce standards and patterns | Execute specific workflows |
| High-level, declarative | Detailed, procedural |

**Example:**
- **Skill**: "All security changes must update SECURITY_ARCHITECTURE.md" ✅ Automatic
- **Agent**: "I will implement JWT authentication in `src/auth/jwt.ts`" 🤖 On-demand

### Available Skills (7 Total)

1. **[security-architecture-validation](../skills/security-architecture-validation/SKILL.md)** - ISMS security-by-design enforcement
2. **[c4-architecture-documentation](../skills/c4-architecture-documentation/SKILL.md)** - C4 Model architecture standards
3. **[korean-theming-standards](../skills/korean-theming-standards/SKILL.md)** - Korean cyberpunk aesthetic rules
4. **[testing-strategy-enforcement](../skills/testing-strategy-enforcement/SKILL.md)** - >90% test coverage requirements
5. **[performance-optimization](../skills/performance-optimization/SKILL.md)** - 60fps and bundle size enforcement
6. **[isms-compliance-checking](../skills/isms-compliance-checking/SKILL.md)** - ISO 27001, NIST CSF, CIS Controls
7. **[threejs-best-practices](../skills/threejs-best-practices/SKILL.md)** - Three.js/React best practices

All agents leverage these skills for automatic quality enforcement. **[Learn more →](../skills/README.md)**

## 🔑 Essential Context Files

All agents reference these key files to understand the project environment and configuration:

### 1. 🔧 Setup & Environment
**File**: `.github/workflows/copilot-setup-steps.yml`
- Node.js 24, npm, TypeScript toolchain
- Build and test environment setup
- Cache configuration for dependencies
- Workflow permissions (read/write access levels)

### 2. 🔌 MCP Server Configuration
**File**: `.github/copilot-mcp.json`
- **GitHub MCP**: Repository operations, issues, PRs, releases
- **Filesystem MCP**: Secure file access for the workspace
- **Git MCP**: Git operations and repository history
- **Memory MCP**: Conversation context between sessions
- **Playwright MCP**: Browser automation for UI testing
- **AWS MCP**: Cloud infrastructure operations (disabled by default)
- **Brave Search MCP**: Web search for documentation (disabled by default)

### 3. 📚 Project Context
**File**: `README.md` (root)
- Project overview and mission
- Korean martial arts philosophy (八卦 - Eight Trigrams)
- Technology stack (React 19, Three.js, TypeScript)
- Combat mechanics and player archetypes
- Development guidelines and documentation

## 📖 Quick Start

GitHub Copilot custom agents are AI assistants with specialized knowledge. When working with Black Trigram, select the agent that matches your current task for context-aware assistance following project patterns.

**📊 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?}
    B -->|Product Analysis| K[🎯 Task Agent]
    B -->|Create Issues| K
    B -->|Quality Check| K
    B -->|Feature/Bug| C[🛠️ Coding Agent]
    B -->|UI/React| D[⚛️ Frontend Specialist]
    B -->|Game Logic| E[🎮 Game Developer]
    B -->|Combat/Martial Arts| L[🥋 Korean Martial Arts Expert]
    B -->|Testing| F[🧪 Testing Agent]
    B -->|Documentation| G[📝 Documentation Writer]
    B -->|Security| H[🛡️ Security Specialist]
    B -->|Review| I[🔍 Code Review Agent]
    B -->|Test Strategy| J[🔬 Test Engineer]
    
    K -.Delegates.-> C
    K -.Delegates.-> D
    K -.Delegates.-> E
    K -.Delegates.-> L
    K -.Delegates.-> F
    K -.Delegates.-> G
    K -.Delegates.-> H
    K -.Delegates.-> J
    
    style K fill:#8BC34A,stroke:#558B2F,stroke-width:3px,color:#fff
    style C fill:#4CAF50,stroke:#2E7D32,stroke-width:2px,color:#fff
    style D fill:#2196F3,stroke:#1565C0,stroke-width:2px,color:#fff
    style E fill:#FF9800,stroke:#E65100,stroke-width:2px,color:#fff
    style L fill:#673AB7,stroke:#4527A0,stroke-width:2px,color:#fff
    style F fill:#9C27B0,stroke:#6A1B9A,stroke-width:2px,color:#fff
    style G fill:#00BCD4,stroke:#00838F,stroke-width:2px,color:#fff
    style H fill:#F44336,stroke:#C62828,stroke-width:2px,color:#fff
    style I fill:#FFC107,stroke:#F57F17,stroke-width:2px,color:#000
    style J fill:#E91E63,stroke:#AD1457,stroke-width:2px,color:#fff
```

## 🎯 Available Agents

### 🎯 [Task Agent](./task-agent.md)
**Primary Role:** Product Quality Orchestrator & Issue Manager

**When to Use:**
- ✅ Analyzing product quality holistically
- ✅ Creating GitHub issues with clear acceptance criteria
- ✅ Assigning work to appropriate specialized agents
- ✅ Ensuring ISMS compliance and security alignment
- ✅ Evaluating UI/UX against Korean theming standards
- ✅ Monitoring test coverage and quality metrics
- ✅ Performance analysis and optimization tracking

**Tools Available:** `view`, `edit`, `create`, `search_code`, `bash`, `custom-agent`

**MCP Servers:** GitHub, Playwright, AWS

**Expertise:**
- Product management and issue orchestration
- Quality assurance across all dimensions
- UI/UX evaluation and accessibility
- ISMS alignment (ISO 27001, NIST CSF, CIS Controls)
- Performance monitoring (60fps, bundle size)
- Agent coordination and delegation
- GitHub issue creation and management

---

### 🛠️ [Coding Agent](./coding-agent.md)
**Primary Role:** Full-Stack TypeScript/React/Three.js Development

**When to Use:**
- ✅ Implementing new game features
- ✅ Creating UI components with Korean theming
- ✅ Fixing bugs in React/Three.js code
- ✅ Refactoring existing code
- ✅ Integrating @react-three/fiber components
- ✅ Implementing combat mechanics

**Tools Available:** `view`, `edit`, `create`, `search_code`, `bash`, `playwright-browser_*`

**Expertise:**
- React + Three.js integration patterns
- Korean theming and bilingual text
- @react-three/fiber and @react-three/drei
- Combat system implementation
- Type-safe development with strict TypeScript

---

### ⚛️ [Frontend Specialist](./frontend-specialist.md)
**Primary Role:** React 19 & Strict TypeScript Expert

**When to Use:**
- ✅ Building type-safe React components
- ✅ Implementing React 19 features
- ✅ Component architecture design
- ✅ State management patterns
- ✅ React Testing Library tests
- ✅ Performance optimization

**Tools Available:** `view`, `edit`, `create`, `search_code`, `bash`, `playwright-browser_*`

**Expertise:**
- React 19 best practices
- Strict TypeScript configuration
- Component composition
- Testing with RTL
- Performance profiling

---

### 🎮 [Game Developer](./game-developer.md)
**Primary Role:** Three.js/@react-three/fiber Game Systems Engineer

**When to Use:**
- ✅ Implementing game loops
- ✅ Optimizing rendering (60fps target)
- ✅ Audio system integration
- ✅ Collision detection
- ✅ 3D scene and resource management
- ✅ Object pooling

**Tools Available:** `view`, `edit`, `create`, `search_code`, `bash`, `playwright-browser_*`

**Expertise:**
- Three.js / @react-three/fiber integration
- Game loop architecture
- Howler.js audio management
- Performance optimization
- WebGL rendering

---

### 🧪 [Testing Agent](./testing-agent.md)
**Primary Role:** Vitest & Cypress Testing Specialist

**When to Use:**
- ✅ Writing unit tests
- ✅ Creating integration tests
- ✅ Developing E2E tests with Cypress
- ✅ Debugging test failures
- ✅ Testing Three.js components
- ✅ Testing Korean UI elements

**Tools Available:** `view`, `edit`, `create`, `bash`, `playwright-browser_*`

**Expertise:**
- Vitest unit testing
- Cypress E2E testing
- Component testing
- Mock strategies
- Test coverage

---

### 🔬 [Test Engineer](./test-engineer.md)
**Primary Role:** Test Strategy & CI Integration Specialist

**When to Use:**
- ✅ Designing comprehensive test strategies
- ✅ Enforcing coverage standards (>90%)
- ✅ Integrating tests into CI/CD
- ✅ Setting up test parallelization
- ✅ Performance and accessibility testing
- ✅ Test metrics and reporting

**Tools Available:** `view`, `edit`, `create`, `bash`, `search_code`, `playwright-browser_*`

**Expertise:**
- Test suite architecture
- Coverage enforcement
- GitHub Actions integration
- Visual regression testing
- Mutation testing

---

### 📝 [Documentation Writer](./documentation-writer.md)
**Primary Role:** Technical Documentation Specialist

**When to Use:**
- ✅ Writing JSDoc/TSDoc comments
- ✅ Creating API documentation
- ✅ Writing user guides and tutorials
- ✅ Documenting Korean martial arts concepts
- ✅ Security policy documentation (SECURITY.md)
- ✅ Bilingual content (Korean/English)

**Tools Available:** `view`, `edit`, `create`, `search_code`, `playwright-browser_*`

**Expertise:**
- Code documentation
- Technical writing
- Korean cultural context
- API references
- Security policies

---

### 🔍 [Code Review Agent](./code-review-agent.md)
**Primary Role:** Code Quality & Standards Reviewer

**When to Use:**
- ✅ Reviewing pull requests
- ✅ Checking code quality and standards
- ✅ Verifying Korean theming compliance
- ✅ Validating test coverage
- ✅ Security assessment
- ✅ Performance review

**Tools Available:** `view`, `search_code`, `playwright-browser_*` (read-only)

**Expertise:**
- Code quality assessment
- Korean theming validation
- Testing coverage verification
- Security best practices
- Accessibility standards

---

### 🛡️ [Security Specialist](./security-specialist.md)
**Primary Role:** Supply Chain & Compliance Security Expert

**When to Use:**
- ✅ OSSF Scorecard compliance
- ✅ SBOM generation (CycloneDX)
- ✅ Vulnerability scanning
- ✅ License compliance checking
- ✅ Dependency security audits
- ✅ Security automation

**Tools Available:** `view`, `edit`, `create`, `bash`, `search_code`, `playwright-browser_*`

**Expertise:**
- Supply chain security
- OSSF best practices
- Software Bill of Materials
- License compliance
- Automated security workflows

---

## 🎨 Agent Selection Guide

```mermaid
flowchart TD
    Start([Need Help?]) --> Type{What are you doing?}
    
    Type -->|Product Management| Management{Management Type?}
    Management -->|Create Issues| TaskAgent[🎯 Task Agent]
    Management -->|Quality Analysis| TaskAgent
    Management -->|ISMS Compliance| TaskAgent
    Management -->|Agent Coordination| TaskAgent
    
    Type -->|Writing Code| Code{Code Type?}
    Code -->|UI Components| Frontend[⚛️ Frontend Specialist]
    Code -->|Game Logic| Game[🎮 Game Developer]
    Code -->|Combat/Martial Arts| MartialArts[🥋 Korean Martial Arts Expert]
    Code -->|General Feature| Coding[🛠️ Coding Agent]
    
    Type -->|Writing Tests| TestType{Test Type?}
    TestType -->|Unit/E2E Tests| Testing[🧪 Testing Agent]
    TestType -->|Test Strategy| TestEng[🔬 Test Engineer]
    
    Type -->|Documentation| Docs[📝 Documentation Writer]
    Type -->|Code Review| Review[🔍 Code Review Agent]
    Type -->|Security| Security[🛡️ Security Specialist]
    
    TaskAgent --> Action[Get Agent Help]
    Frontend --> Action
    Game --> Action
    MartialArts --> Action
    Coding --> Action
    Testing --> Action
    TestEng --> Action
    Docs --> Action
    Review --> Action
    Security --> Action
    
    style Start fill:#E0E0E0,stroke:#757575,stroke-width:2px,color:#000
    style Type fill:#FFEB3B,stroke:#F57F17,stroke-width:2px,color:#000
    style Management fill:#FFEB3B,stroke:#F57F17,stroke-width:2px,color:#000
    style Code fill:#FFEB3B,stroke:#F57F17,stroke-width:2px,color:#000
    style TestType fill:#FFEB3B,stroke:#F57F17,stroke-width:2px,color:#000
    style TaskAgent fill:#8BC34A,stroke:#558B2F,stroke-width:3px,color:#fff
    style Frontend fill:#2196F3,stroke:#1565C0,stroke-width:2px,color:#fff
    style Game fill:#FF9800,stroke:#E65100,stroke-width:2px,color:#fff
    style MartialArts fill:#673AB7,stroke:#4527A0,stroke-width:2px,color:#fff
    style Coding fill:#4CAF50,stroke:#2E7D32,stroke-width:2px,color:#fff
    style Testing fill:#9C27B0,stroke:#6A1B9A,stroke-width:2px,color:#fff
    style TestEng fill:#E91E63,stroke:#AD1457,stroke-width:2px,color:#fff
    style Docs fill:#00BCD4,stroke:#00838F,stroke-width:2px,color:#fff
    style Review fill:#FFC107,stroke:#F57F17,stroke-width:2px,color:#000
    style Security fill:#F44336,stroke:#C62828,stroke-width:2px,color:#fff
    style Action fill:#8BC34A,stroke:#558B2F,stroke-width:3px,color:#fff
```

## 🛠️ Tools Available to Agents

All agents have access to appropriate GitHub Copilot tools:

| Tool Category | Tools | Purpose |
|--------------|-------|---------|
| **File Operations** | `view`, `edit`, `create` | Read, modify, and create files |
| **Code Search** | `search_code` | Search codebase for patterns and references |
| **Shell Access** | `bash` | Execute build, test, and automation commands |
| **Agent Delegation** | `custom-agent` | Invoke other specialized agents |
| **Browser Automation** | `playwright-browser_snapshot` | Capture DOM state for testing |
| | `playwright-browser_take_screenshot` | Visual regression testing |
| | `playwright-browser_navigate` | Navigate to URLs for E2E testing |
| | `playwright-browser_click` | Interact with UI elements |
| | `playwright-browser_type` | Input text for testing |
| | `playwright-browser_evaluate` | Execute JavaScript in browser context |

### 🔌 MCP (Model Context Protocol) Servers

The Task Agent has access to specialized MCP servers for enhanced capabilities:

| MCP Server | Purpose | Operations |
|------------|---------|------------|
| **GitHub MCP** | Repository and issue management | Create/update issues, search code, manage PRs, releases |
| **Playwright MCP** | Browser automation and UI testing | Navigate, screenshot, DOM analysis, interaction testing |
| **AWS MCP** | Cloud infrastructure operations | Infrastructure monitoring, deployment validation, cost analysis |

**Benefits of MCP Integration:**
- 🎯 Direct GitHub API access for issue creation and management
- 🌐 Live browser automation for UI/UX testing
- ☁️ Cloud infrastructure insights and deployment validation
- 🔄 Seamless integration with existing workflows
- 📊 Real-time quality metrics and analysis

### 🏗️ Agent Architecture Overview

All agents read Essential Context Files (`copilot-setup-steps.yml`, `copilot-mcp.json`, `README.md`) at session start and have access to File Operations and GitHub API. Task Agent additionally uses Browser Automation and AWS Operations.

### Tool Access by Agent

| Agent | Access Level |
|-------|-------------|
| 🎯 Task Agent | All tools + GitHub MCP + Playwright MCP + AWS MCP |
| 🔍 Code Review Agent | View + search + Playwright (read-only) |
| 📝 Documentation Writer | View + edit + create + search + Playwright |
| 🛠️ Coding / ⚛️ Frontend / 🎮 Game Dev | All tools |
| 🧪 Testing / 🔬 Test Engineer | All tools |
| 🛡️ Security Specialist | All tools |
| 🥋 Korean Martial Arts Expert | All tools |

## 🎯 Agent Development Guidelines
- Performance testing
- Accessibility testing

**Key Responsibilities:**
- Test suite organization
- Coverage threshold enforcement
- GitHub Actions integration
- Visual regression testing
- Test metrics and reporting
- Mutation testing

---

### 📚 [Documentation Writer](./documentation-writer.md)
**Specialization**: Technical Docs + Security Policies

**Use for:**
- TSDoc/JSDoc code documentation
- User guides and tutorials
- Security policy documentation
- API reference documentation
- Korean cultural context
- Bilingual content creation

**Key Responsibilities:**
- Comprehensive code documentation
- User guide creation
- Security policy writing (SECURITY.md)
- API reference generation
- Korean martial arts explanations
- Bilingual technical writing

---

### 🔍 [Code Review Agent](./code-review-agent.md)
**Specialization**: Code Quality & Standards

**Use for:**
- Reviewing pull requests
- Checking code quality
- Verifying Korean theming compliance
- Validating test coverage
- Ensuring accessibility
- Performance review

**Key Responsibilities:**
- Code quality assessment
- Korean theming compliance
- Testing coverage verification
- Performance review
- Security assessment
- Accessibility validation

---

### 🛡️ [Security Specialist](./security-specialist.md)
**Specialization**: Supply Chain + Compliance

**Use for:**
- Supply chain security
- OSSF Scorecard compliance
- SBOM generation
- License compliance
- Vulnerability management
- Security automation

**Key Responsibilities:**
- Dependency security scanning
- OSSF Scorecard optimization
- Software Bill of Materials (SBOM)
- License compatibility checking
- Automated security workflows
- Security policy enforcement

---

### 🥋 [Korean Martial Arts Expert](./korean-martial-arts-expert.md)
**Specialization**: Korean Martial Arts Combat Systems & Vital Point Targeting

**Use for:**
- Extending the 70 vital point system
- Implementing Hapkido, Taekwondo, Taekyon techniques
- Anatomical targeting accuracy
- Combat realism and applications
- Eight Trigram stance integration
- Player archetype combat specializations
- Korean martial arts authenticity
- Bilingual technique documentation

**Key Responsibilities:**
- Vital point system extension and maintenance
- Korean martial arts technique design
- Anatomical accuracy in targeting
- Combat effectiveness calculations
- Trigram stance technique mapping
- Archetype combat specialization
- Cultural authenticity and respect
- Bilingual Korean-English documentation

**Martial Arts Expertise:**
- 합기도 (Hapkido) - Joint locks, pressure points, throws
- 태권도 (Taekwondo) - High kicks, speed techniques, power strikes
- 택견 (Taekyon) - Fluid movements, sweeping kicks, rhythmic footwork
- 기타 한국 무술 - Ssireum, Kumdo, traditional Korean military arts

**Combat System Integration:**
- 70 anatomical target points across head, torso, and limbs
- Eight Trigram stance system (팔괘)
- Five player archetypes (무사, 암살자, 해커, 정보요원, 조직폭력배)
- Real combat applications with anatomical precision
- Realistic injury and incapacitation mechanics

## How to Use These Agents

### With GitHub Copilot Chat

When using GitHub Copilot in your IDE, you can reference these agents:

```
@workspace /explain this component following the patterns in .github/agents/coding-agent.md
```

```
@workspace Help me write tests for this component using patterns from .github/agents/testing-agent.md
```

### With GitHub Copilot Pull Requests

These agents help Copilot provide better code review feedback when reviewing PRs.

### With GitHub Copilot CLI

```bash
gh copilot suggest "Create a new combat component following .github/agents/coding-agent.md"
```

## Agent Development Guidelines

All agents should:

✅ Reference the main `.github/copilot-instructions.md` file
✅ Provide specific, actionable guidance
✅ Include code examples
✅ Follow the project's Korean theming requirements
✅ Emphasize testing and quality standards
✅ Be focused on their specific domain
✅ Include anti-patterns to avoid
✅ Provide checklists where applicable

## Relationship to Main Instructions

These agent files are **complementary** to the main `.github/copilot-instructions.md` file:

- **Main Instructions**: Comprehensive coding guidelines for all developers and Copilot
- **Agent Files**: Specialized, task-focused instructions for specific activities

**Always consult both:**
1. The agent file for specialized, task-specific guidance
2. The main instructions for comprehensive patterns and standards

## Korean Philosophy Integration

All agents respect Black Trigram's core philosophy:

**흑괘의 길을 걸어라** - _Walk the Path of the Black Trigram_

- Traditional Korean martial arts wisdom
- Modern interactive technology
- Cyberpunk Korean aesthetic
- Bilingual support (Korean | English)
- Cultural authenticity and respect

## Updating Agents

When updating agent instructions:

1. Ensure consistency with main `.github/copilot-instructions.md`
2. Add relevant code examples
3. Update checklists and anti-patterns
4. Test with actual Copilot interactions
5. Keep focus on the agent's specialization
6. Maintain Korean cultural context

## Contributing

When adding new agents:

1. Identify a clear, focused specialization
2. Create comprehensive instructions
3. Include practical examples
4. Add to this README
5. Link to related documentation
6. Ensure Korean theming integration

## Success Metrics

Effective agents should:

✅ Reduce development time
✅ Improve code quality
✅ Ensure consistent patterns
✅ Maintain Korean theming
✅ Increase test coverage
✅ Enhance documentation quality
✅ Improve security posture
✅ Optimize performance

## 🎯 Using the Task Agent for Product Management

The Task Agent is your entry point for comprehensive product quality management. Use it for quality analysis, issue creation, ISMS compliance checks, UI/UX audits, performance reviews, and agent coordination. See [task-agent.md](./task-agent.md) for full details.

## Support

- Review `.github/copilot-instructions.md` for comprehensive guidelines
- Check existing codebase for established patterns
- Consult game design docs: `game-design.md`, `COMBAT_ARCHITECTURE.md`
- See architectural docs: `ARCHITECTURE.md`

---

**Project**: Black Trigram (흑괘)
**Description**: A realistic combat simulator inspired by Korean martial arts
**Tech Stack**: React, TypeScript, Three.js, Vite, Vitest, Cypress

**흑괘의 길을 걸어라** - _Walk the Path of the Black Trigram_