Skip to content

Latest commit

ย 

History

History
736 lines (572 loc) ยท 28.9 KB

File metadata and controls

736 lines (572 loc) ยท 28.9 KB

๐Ÿค– 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 - strategic, high-level principles that are automatically enforced across all development work.

Skills vs Agents

Skills (๐Ÿ“š View All) 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 (29 Total)

Black Trigram now ships 29 strategic skills organized across Security & Compliance, Architecture & Documentation, Visual & Cultural, Testing & Quality, Performance, Three.js, Game Development, AI Governance, and Agentic Workflows. See the Skills catalog for the full list and activation triggers.

Highlights (security & compliance core):

  1. security-architecture-validation โ€” ISMS security-by-design enforcement
  2. secure-development-lifecycle โ€” all 7 SDLC phases + DevSecOps
  3. isms-compliance-checking โ€” ISO 27001, NIST CSF 2.0, CIS v8.1
  4. compliance-framework-alignment โ€” multi-framework traceability
  5. classification-framework-enforcement โ€” C/I/A/P classification + BIA
  6. open-source-governance โ€” Hack23 Open Source Policy enforcement
  7. threat-modeling-enforcement โ€” STRIDE + MITRE ATT&CK + attack trees
  8. vulnerability-management โ€” CVE remediation SLAs, OSSF โ‰ฅ 8, SBOM
  9. incident-response โ€” severity SLAs, rotation, lessons learned
  10. secrets-management โ€” credential hygiene, GitHub Secrets
  11. data-protection โ€” classification, TLS, CSP, SRI
  12. input-validation โ€” Zod / type guards at boundaries
  13. risk-assessment-frameworks โ€” ISO 31000 / ID.RA
  14. gdpr-compliance โ€” GDPR / NIS2 / EU CRA
  15. ai-governance โ€” EU AI Act, NIST AI RMF, AI transparency
  16. github-agentic-workflows โ€” defense-in-depth workflow security

Architecture & Docs: c4-architecture-documentation ยท documentation-standards

Quality & Testing: testing-strategy-enforcement ยท code-quality-excellence ยท typescript-strict-patterns ยท accessibility-wcag-patterns

Performance & Three.js: performance-optimization ยท threejs-best-practices

Game & Cultural: game-development-patterns ยท korean-martial-arts-authenticity ยท 3d-combat-systems ยท audio-game-integration ยท korean-theming-standards

All agents leverage these skills for automatic quality enforcement. Learn more โ†’

๐Ÿ” Hack23 ISMS Policy Integration (all agents reference these)

Every repo agent encodes links to the applicable Hack23 ISMS policies so that code changes, reviews, tests, and documentation trace back to a governed source of truth:

Domain Policy
Governance baseline Information Security Policy
SDLC / secure coding Secure Development Policy
OSS supply chain Open Source Policy
CVE response Vulnerability Management
Crypto Cryptography Policy
Access / identity Access Control Policy
Incidents Incident Response Plan
Data handling Data Classification Policy
AI AI Governance Policy
Threat analysis Threat Modeling Policy
Change control Change Management
Continuity / DR Business Continuity Plan
Compliance Compliance Checklist (ISO 27001 ยท NIST CSF 2.0 ยท CIS v8.1)

๐Ÿ”‘ 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 26, 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 - 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 Main Project Context Project overview, tech stack, ISMS compliance framework, combat mechanics, Korean martial arts philosophy
.github/workflows/copilot-setup-steps.yml Environment Setup Node.js 26 configuration, npm dependencies, build/test commands, GitHub Actions permissions
.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

See .github/copilot-mcp.json for the authoritative list. Repository-level agents do not embed MCP config in their frontmatter โ€” session-level MCP applies uniformly. Core servers: github (Insiders with Copilot coding-agent tools), filesystem, memory, sequential-thinking, playwright.

Development Environment

The setup workflow (.github/workflows/copilot-setup-steps.yml) defines:

  • Node.js Version: 26 (current)
  • 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:

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

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
Loading

๐ŸŽฏ Available Agents

๐ŸŽฏ Task Agent

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: ["*"] (all tools allowed โ€” no MCP server config at repo level; session-level MCP from .github/copilot-mcp.json applies)

MCP (session-level only): GitHub, filesystem, memory, sequential-thinking, playwright โ€” configured in .github/copilot-mcp.json, not in individual agent frontmatter

Expertise:

  • Product management and issue orchestration
  • Quality assurance across all dimensions
  • UI/UX evaluation and accessibility
  • ISMS alignment (ISO 27001, NIST CSF, CIS Controls, Information Security Policy)
  • Performance monitoring (60fps, bundle size)
  • Agent coordination and delegation
  • GitHub issue creation and management
  • Copilot coding agent orchestration with base_ref, custom_instructions, stacked PRs

๐Ÿ› ๏ธ Coding Agent

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: ["*"] (all tools allowed)

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

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: ["*"] (all tools allowed)

Expertise:

  • React 19 best practices
  • Strict TypeScript configuration
  • Component composition
  • Testing with RTL
  • Performance profiling

๐ŸŽฎ Game Developer

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: ["*"] (all tools allowed)

Expertise:

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

๐Ÿงช Testing Agent

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: ["*"] (all tools allowed)

Expertise:

  • Vitest unit testing
  • Cypress E2E testing
  • Component testing
  • Mock strategies
  • Test coverage

๐Ÿ”ฌ Test Engineer

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: ["*"] (all tools allowed)

Expertise:

  • Test suite architecture
  • Coverage enforcement
  • GitHub Actions integration
  • Visual regression testing
  • Mutation testing

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: ["*"] (all tools allowed)

Expertise:

  • Code documentation
  • Technical writing
  • Korean cultural context
  • API references
  • Security policies

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: ["*"] (all tools allowed; by convention this agent treats edits as suggestions)

Expertise:

  • Code quality assessment
  • Korean theming validation
  • Testing coverage verification
  • Security best practices
  • Accessibility standards

๐Ÿ›ก๏ธ Security Specialist

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: ["*"] (all tools allowed)

Expertise:

  • Supply chain security
  • OSSF best practices
  • Software Bill of Materials
  • License compliance
  • Automated security workflows

๐ŸŽจ Agent Selection Guide

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
Loading

๐Ÿ› ๏ธ 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

Important: Repository-level agents (the ones in this directory) do not embed MCP server configuration in their frontmatter. MCP servers are configured once at the repository level in .github/copilot-mcp.json and are available to every agent session. This keeps agent definitions focused on capability and prompt engineering.

Servers configured for Black Trigram sessions:

MCP Server Purpose Operations
GitHub MCP (Insiders) Repository and issue management Issues, PRs, Actions, Copilot coding agent tools (assign_copilot_to_issue, create_pull_request_with_copilot with base_ref / custom_instructions / custom_agent), get_copilot_job_status
Filesystem MCP File-system operations Read, list, search within allowed directories
Memory MCP Cross-session memory Entity/observation graph for persistent facts
Sequential-thinking MCP Structured reasoning Step-by-step problem decomposition
Playwright MCP Browser automation Navigate, screenshot, DOM interaction, network capture

Benefits of session-level MCP:

  • ๐ŸŽฏ Uniform capability across all agents (no drift)
  • ๐Ÿ” Central secret management (PAT injected from environment)
  • ๐ŸŒ Live browser automation for UI / E2E
  • ๐Ÿ”„ Seamless Copilot coding-agent orchestration with Insiders experimental features
  • ๐Ÿ“Š Real-time GitHub metrics and history

๐Ÿ—๏ธ 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

All repository-level agents declare tools: ["*"] in frontmatter โ€” no per-agent tool restrictions. MCP capability is session-level (see .github/copilot-mcp.json).

Agent Access Level Notes
๐ŸŽฏ Task Agent ["*"] Orchestrator โ€” leans on GitHub MCP Copilot coding-agent tools
๐Ÿ› ๏ธ Coding Agent ["*"] General implementation
โš›๏ธ Frontend Specialist ["*"] React 19 + strict TS
๐ŸŽฎ Game Developer ["*"] Three.js / R3F / physics / audio
๐Ÿงช Testing Agent ["*"] Vitest + Cypress + security tests
๐Ÿ”ฌ Test Engineer ["*"] Strategy + CI gates + SAST/DAST/SCA
๐Ÿ“ Documentation Writer ["*"] TSDoc + C4 + ISMS docs
๐Ÿ” Code Review Agent ["*"] By convention treats edits as suggestions
๐Ÿ›ก๏ธ Security Specialist ["*"] Supply chain + ISMS + vulnerability
๐Ÿฅ‹ Korean Martial Arts Expert ["*"] Authenticity + cultural accuracy

๐ŸŽฏ 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

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

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

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

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

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 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