name: korean-martial-arts-authenticity description: | Enforces authentic Korean martial arts systems (Hapkido, Taekwondo, Taekyon, Kuk Sool Won, Tang Soo Do, Hwa Rang Do, Gumdo, Ssireum, Subak, Yudo, Gongkwon Yusul) with Eight Trigram stances, 70 vital points, Dark Ops combat applications, special forces integration, cultural respect, anatomical precision, and realistic combat mechanics for Black Trigram. license: MIT
Korean Martial Arts Authenticity Skill
Purpose
This skill ensures that all Korean martial arts content in Black Trigram is authentic, culturally respectful, anatomically accurate, and properly implements traditional systems like the Eight Trigrams (팔괘), 70 vital points (급소), and Korean martial arts techniques from Hapkido, Taekwondo, and Taekyon.
When to Apply
Automatically trigger this skill when:
- Implementing Eight Trigram stance system (팔괘)
- Adding vital point targeting (급소)
- Creating combat techniques or special moves
- Writing Korean martial arts terminology (any of 11 arts)
- Implementing damage calculations based on anatomy
- Creating character archetypes with martial arts backgrounds
- Adding martial arts animations or movements
- Designing combat mechanics or strike systems
- Translating martial arts concepts
- Reviewing combat balance and realism
- Implementing Dark Ops special forces techniques
- Adding tactical combat applications
- Integrating equipment-enhanced martial arts
- Creating special operations units or missions
- Implementing silent kill or suppression mechanics
Core Principles
1. Eight Trigram System (팔괘 체계) Accuracy
ALWAYS use the correct trigram associations:
✅ Authentic Eight Trigram Implementation
export const EIGHT_TRIGRAMS = {
GEON: {
symbol: '☰',
korean: '건',
english: 'Heaven',
element: 'Metal',
direction: 'Northwest',
attributes: ['Direct Force', 'Strength', 'Creativity'],
combatStyle: 'Overwhelming power and direct strikes',
// ... (see full reference in Hack23 ISMS)
❌ Anti-Pattern: Incorrect Trigram Associations
// BAD: Wrong symbols or meanings
const TRIGRAMS = {
GEON: { symbol: '☱', korean: '간' }, // ❌ Wrong symbol and name
// Mixing up trigram attributes undermines authenticity
};
2. 70 Vital Points (급소 七十穴) Precision
ALWAYS use anatomically accurate vital point locations:
✅ Authentic Vital Point System
export interface VitalPoint {
readonly id: string;
readonly koreanName: string;
readonly englishName: string;
readonly anatomicalLocation: string;
readonly category: 'head' | 'neck' | 'torso' | 'arms' | 'legs';
readonly severity: 'instant' | 'severe' | 'moderate' | 'minor';
readonly strikeTypes: readonly StrikeType[];
readonly effectiveStances: readonly TrigramStance[];
// ... (see full reference in Hack23 ISMS)
❌ Anti-Pattern: Vague or Inaccurate Vital Points
// BAD: No anatomical precision
const vitalPoints = {
head: 100, // ❌ Where on head?
body: 75, // ❌ Body has many vital points
arm: 25, // ❌ Not anatomically specific
};
3. Korean Martial Arts Terminology Accuracy
ALWAYS use proper Korean terminology with correct Romanization:
✅ Proper Terminology and Translations
export const KOREAN_TERMINOLOGY = {
// Basic Concepts
MARTIAL_ART: { korean: '무술', romanization: 'Musul', english: 'Martial Art' },
TECHNIQUE: { korean: '기술', romanization: 'Gisul', english: 'Technique' },
STANCE: { korean: '자세', romanization: 'Jase', english: 'Stance' },
VITAL_POINT: { korean: '급소', romanization: 'Geupso', english: 'Vital Point' },
// Hapkido (합기도) Terms
WRIST_LOCK: { korean: '손목꺾기', romanization: 'Sonmok-kkeokgi', english: 'Wrist Lock' },
// ... (see full reference in Hack23 ISMS)
❌ Anti-Pattern: Incorrect or Mixed Terminology
// BAD: Wrong romanization or mixing styles
const terminology = {
hapkido: 'Hapgido', // ❌ Wrong romanization (should be Hapkido)
geupso: 'Guepso', // ❌ Wrong romanization (should be Geupso)
taekwondo: 'Tae Kwon Do', // ❌ Inconsistent spacing
};
4. Cultural Respect and Context
ALWAYS provide proper cultural context:
✅ Respectful Implementation with Context
export const CULTURAL_CONTEXT = {
EIGHT_TRIGRAMS: {
origin: 'I Ching (易經) / Yijing - Ancient Chinese divination text',
koreanAdoption: 'Integrated into Korean philosophy and martial arts',
meaning: 'Represents fundamental forces of nature and combat principles',
respect: 'Used with understanding of philosophical depth, not just symbols',
},
VITAL_POINTS: {
// ... (see full reference in Hack23 ISMS)
❌ Anti-Pattern: Superficial or Disrespectful Use
// BAD: No cultural context or respect
const trigrams = ['random', 'symbol', 'for', 'decoration']; // ❌
const vitalPoints = ['mystery', 'chakra', 'points']; // ❌ Mixing concepts
5. Comprehensive Korean Martial Arts Coverage
ALWAYS implement all major Korean martial arts with authentic techniques:
✅ Complete Korean Martial Arts System
export const KOREAN_MARTIAL_ARTS = {
// Traditional Arts
HAPKIDO: {
korean: '합기도',
english: 'The Way of Coordinating Energy',
founded: '1948',
founder: 'Choi Yong-Sool (최용술)',
focus: ['Joint locks', 'Throws', 'Pressure points', 'Circular motion'],
techniques: {
// ... (see full reference in Hack23 ISMS)
6. Dark Ops Combat Applications
ALWAYS integrate special operations tactical combat with traditional martial arts:
✅ Dark Ops Vital Point Targeting System
export interface DarkOpsVitalPoint extends VitalPoint {
readonly tacticalApplication: 'silent_kill' | 'suppression' | 'interrogation' | 'mobility_denial';
readonly soundLevel: 'silent' | 'quiet' | 'audible';
readonly incapacitationTime: number; // seconds
readonly requiresFollowUp: boolean;
readonly specialForces: readonly string[]; // Which units specialize in this
}
export const DARK_OPS_VITAL_POINTS: readonly DarkOpsVitalPoint[] = [
// ... (see full reference in Hack23 ISMS)
7. Special Forces Integration Patterns
ALWAYS integrate Korean special forces units with martial arts philosophies:
✅ Special Forces Combat Doctrine
export const SPECIAL_FORCES_UNITS = {
AMHEUK_JAKJEON: {
korean: '암흑작전부대',
english: 'Dark Operations Unit',
motto: '어둠 속의 칼날 (Blade in the Darkness)',
specialization: ['Silent infiltration', 'Assassination', 'Black-site operations'],
martialArtsBase: ['Hapkido (pressure points)', 'Taekyon (stealth movement)'],
combatMultiplier: {
night: 1.4, // +40% at night
// ... (see full reference in Hack23 ISMS)
Enforcement Rules
Rule 5: Comprehensive Martial Arts Coverage
IF (implementing Korean martial art NOT in KOREAN_MARTIAL_ARTS constant)
THEN (add art with proper Korean name, founder, techniques, philosophy)
ELSE (verify terminology and historical accuracy)
Rule 6: Dark Ops Tactical Integration
IF (implementing special forces technique WITHOUT martial arts base)
THEN (integrate with appropriate Korean martial art from SPECIAL_FORCES_UNITS)
ELSE (verify tactical application matches unit specialization)
Rule 7: Equipment-Enhanced Combat
IF (Dark Ops technique uses equipment OR technology)
THEN (apply appropriate equipment multiplier AND verify sound level)
ELSE (ensure bare-hands baseline remains balanced)
❌ Anti-Pattern: Superficial or Disrespectful Use
## Enforcement Rules
### Rule 1: Eight Trigram Accuracy
IF (trigram symbol OR attributes OR philosophy incorrect) THEN (reject with: "Verify Eight Trigram authenticity - use EIGHT_TRIGRAMS constant") ELSE (verify combat style matches trigram philosophy)
### Rule 2: Vital Point Anatomical Precision
IF (vital point lacks anatomical location OR severity OR effective stances) THEN (add anatomical details from TCM/Korean medicine sources) ELSE (verify strike type compatibility)
### Rule 3: Korean Terminology Consistency
IF (Korean terms use wrong romanization OR inconsistent spelling) THEN (apply Revised Romanization of Korean standard) ELSE (verify bilingual format: "Korean | English")
### Rule 4: Cultural Context Required
IF (implementing traditional system WITHOUT context OR education) THEN (add CULTURAL_CONTEXT documentation and player tooltips) ELSE (verify respectful and accurate portrayal)
## Anti-Patterns to REJECT
❌ **Invented Trigrams** - Only use the authentic Eight Trigrams
❌ **Fantasy Vital Points** - Must be anatomically accurate
❌ **Mixed Martial Arts Styles** - Don't conflate Japanese/Chinese/Korean arts
❌ **Appropriation Without Context** - Always provide educational context
❌ **Disrespectful Portrayal** - Treat cultural systems with respect
❌ **Incomplete Martial Arts** - All 11 Korean arts should be available, not just 2-3
// ... (see full reference in Hack23 ISMS)
```typescript
export function getTrigramAdvantage(
attackerStance: TrigramStance,
defenderStance: TrigramStance
): number {
const matchup = TRIGRAM_MATCHUPS[attackerStance];
if (matchup.strong.includes(defenderStance)) {
return 1.5; // 50% damage bonus
}
if (matchup.weak.includes(defenderStance)) {
return 0.7; // 30% damage penalty
}
return 1.0; // Neutral matchup
}
✅ Educational Tooltips for Players
export const VitalPointTooltip: React.FC<{ point: VitalPoint }> = ({ point }) => {
return (
<div className="tooltip">
<h3>{point.koreanName} | {point.englishName}</h3>
<p><strong>Location:</strong> {point.anatomicalLocation}</p>
<p><strong>Severity:</strong> {point.severity}</p>
<p><strong>Best Stances:</strong> {point.effectiveStances.join(', ')}</p>
<p><strong>Description:</strong> {point.description}</p>
<p className="warning">
⚠️ This is based on traditional martial arts anatomy.
In real life, strikes to vital points can cause serious injury or death.
</p>
</div>
);
};