@bhoon716/skill-forge 1.0.0

package/bin/cli.js

@@ -0,0 +1,386 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+const sourceSkillsDir = path.join(__dirname, '..', 'skills');
+
+// Helper to print usage info
+const def_usage = () => {
+  console.log(`
+Usage: npx @bhoon716/skill-forge [command] [options]
+
+If run without arguments, launches Interactive Setup Mode.
+
+Commands:
+  list                 List all available skills and their descriptions.
+  add <skill-name>     Install a specific skill from the forge workspace.
+  install-all          Install all available skills from the forge workspace.
+
+Options:
+  -l, --lang <lang>    Specify localization language (e.g., en, ko, zh). (Default: en)
+  -a, --agent <agent>  Target AI Agent environment. (Default: codex)
+                       Supported: codex, gemini, claude, cursor, copilot, global
+  --dry-run            Simulate copying without actually modifying files.
+  -h, --help           Display help message.
+
+Examples:
+  npx @bhoon716/skill-forge list --lang ko
+  npx @bhoon716/skill-forge add ultra-grill-me --lang ko
+  npx @bhoon716/skill-forge add ultra-grill-me --lang zh --agent claude
+`);
+};
+
+// Autodetect agent paths in current working directory
+const detectAgents = () => {
+  const detected = [];
+  const pwd = process.cwd();
+  if (fs.existsSync(path.join(pwd, '.agents'))) detected.push({ name: 'codex/gemini', value: 'codex' });
+  if (fs.existsSync(path.join(pwd, '.claude'))) detected.push({ name: 'claude', value: 'claude' });
+  if (fs.existsSync(path.join(pwd, '.cursor'))) detected.push({ name: 'cursor', value: 'cursor' });
+  if (fs.existsSync(path.join(pwd, '.copilot'))) detected.push({ name: 'copilot', value: 'copilot' });
+  return detected;
+};
+
+// List available skills logic
+const listSkillsLogic = (selectedLang = 'en') => {
+  if (!fs.existsSync(sourceSkillsDir)) {
+    console.error(`Error: Skills source directory not found at ${sourceSkillsDir}`);
+    process.exit(1);
+  }
+
+  const skills = fs.readdirSync(sourceSkillsDir).filter(file => {
+    return fs.statSync(path.join(sourceSkillsDir, file)).isDirectory();
+  });
+
+  console.log('\n===================================================');
+  console.log(`📚 Available Skills in Forge Workspace (Lang: ${selectedLang})`);
+  console.log('===================================================\n');
+
+  if (skills.length === 0) {
+    console.log('No skills found in workspace.');
+    return;
+  }
+
+  skills.forEach(skill => {
+    // Try to find localized SKILL file
+    let skillFile = path.join(sourceSkillsDir, skill, `SKILL.${selectedLang}.md`);
+    if (!fs.existsSync(skillFile)) {
+      skillFile = path.join(sourceSkillsDir, skill, 'SKILL.md'); // Fallback to default
+    }
+
+    let description = 'No description provided.';
+    if (fs.existsSync(skillFile)) {
+      const content = fs.readFileSync(skillFile, 'utf8');
+      
+      // Parse description from frontmatter
+      const descMatch = content.match(/description:\s*(.*)/);
+      if (descMatch && descMatch[1]) {
+        description = descMatch[1].trim();
+      }
+    }
+
+    console.log(`* ${skill.padEnd(20)} - ${description}`);
+  });
+  console.log('\nUse "skill-forge add <skill-name>" to install a specific skill.\n');
+};
+
+// Interactive Mode Prompt
+const runInteractiveMode = async () => {
+  console.log('===================================================');
+  console.log('🛠️  Welcome to skill-forge Interactive Setup Mode');
+  console.log('===================================================\n');
+
+  if (!fs.existsSync(sourceSkillsDir)) {
+    console.error(`Error: Skills source directory not found at ${sourceSkillsDir}`);
+    process.exit(1);
+  }
+
+  const skills = fs.readdirSync(sourceSkillsDir).filter(file => {
+    return fs.statSync(path.join(sourceSkillsDir, file)).isDirectory();
+  });
+
+  if (skills.length === 0) {
+    console.log('No skills found in workspace to install.');
+    process.exit(0);
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const question = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+  try {
+    // 1. Select Skill
+    console.log('Available Skills in Forge:');
+    skills.forEach((s, idx) => console.log(`  [${idx + 1}] ${s}`));
+    console.log(`  [${skills.length + 1}] (Install All Available Skills)`);
+    
+    let skillChoiceIdx = -1;
+    while (true) {
+      const ans = await question(`\nSelect a skill to install [1-${skills.length + 1}]: `);
+      const val = parseInt(ans.trim());
+      if (val >= 1 && val <= skills.length + 1) {
+        skillChoiceIdx = val - 1;
+        break;
+      }
+      console.log('Invalid choice. Please select a valid option number.');
+    }
+
+    const installAll = skillChoiceIdx === skills.length;
+    const selectedSkill = installAll ? null : skills[skillChoiceIdx];
+
+    // 2. Select Language
+    console.log('\nSelect localization language:');
+    console.log('  [1] English (en) - Default');
+    console.log('  [2] 한국어 (ko)');
+    console.log('  [3] 简体中文 (zh)');
+    
+    let selectedLang = 'en';
+    while (true) {
+      const ans = await question('\nSelect language option [1-3, Default 1]: ');
+      const val = ans.trim();
+      if (val === '' || val === '1') {
+        selectedLang = 'en';
+        break;
+      } else if (val === '2') {
+        selectedLang = 'ko';
+        break;
+      } else if (val === '3') {
+        selectedLang = 'zh';
+        break;
+      }
+      console.log('Invalid choice. Please select 1, 2, or 3.');
+    }
+
+    // 3. Select Agent Target
+    const detected = detectAgents();
+    console.log('\nSelect target AI Agent environment:');
+    
+    const agentsList = [
+      { name: 'Codex / Gemini (./.agents/)', value: 'codex' },
+      { name: 'Claude Code (./.claude/)', value: 'claude' },
+      { name: 'Cursor (./.cursor/)', value: 'cursor' },
+      { name: 'Github Copilot (./.copilot/)', value: 'copilot' },
+      { name: 'Global User Setting (~/.gemini/config/)', value: 'global' }
+    ];
+
+    agentsList.forEach((ag, idx) => {
+      const isDetected = detected.some(d => d.value === ag.value);
+      const label = isDetected ? '⭐ (Detected in Project)' : '';
+      console.log(`  [${idx + 1}] ${ag.name} ${label}`);
+    });
+
+    let selectedAgent = 'codex';
+    while (true) {
+      const ans = await question('\nSelect agent option [1-5, Default 1]: ');
+      const val = ans.trim();
+      if (val === '') {
+        selectedAgent = 'codex';
+        break;
+      }
+      const idx = parseInt(val);
+      if (idx >= 1 && idx <= 5) {
+        selectedAgent = agentsList[idx - 1].value;
+        break;
+      }
+      console.log('Invalid choice. Please select a option number between 1 and 5.');
+    }
+
+    rl.close();
+
+    // Summary and Execute
+    console.log('\n---------------------------------------------------');
+    console.log('🚀 Ready to install:');
+    console.log(`   - Skill: ${installAll ? 'ALL Skills' : selectedSkill}`);
+    console.log(`   - Language: ${selectedLang}`);
+    console.log(`   - Target Agent: ${selectedAgent}`);
+    console.log('---------------------------------------------------\n');
+
+    // Run installation logic
+    const targetBaseDir = getTargetBaseDir(selectedAgent);
+    if (installAll) {
+      console.log(`Installing all ${skills.length} skills to target path: ${targetBaseDir}...\n`);
+      skills.forEach(s => installSkillLogic(s, selectedLang, selectedAgent, targetBaseDir));
+    } else {
+      installSkillLogic(selectedSkill, selectedLang, selectedAgent, targetBaseDir);
+    }
+
+  } catch (err) {
+    console.error('Error during interactive setup:', err);
+    rl.close();
+    process.exit(1);
+  }
+};
+
+const getTargetBaseDir = (selectedAgent) => {
+  const pwd = process.cwd();
+  switch (selectedAgent.toLowerCase()) {
+    case 'codex':
+    case 'gemini':
+      return path.join(pwd, '.agents', 'skills');
+    case 'claude':
+      return path.join(pwd, '.claude', 'skills');
+    case 'cursor':
+      return path.join(pwd, '.cursor', 'skills');
+    case 'copilot':
+      return path.join(pwd, '.copilot', 'skills');
+    case 'global':
+      return path.join(os.homedir(), '.gemini', 'config', 'skills');
+    default:
+      console.error(`Error: Unsupported agent type "${selectedAgent}".`);
+      process.exit(1);
+  }
+};
+
+// Main Entry Point Parsing
+const args = process.argv.slice(2);
+
+if (args.includes('-h') || args.includes('--help')) {
+  def_usage();
+  process.exit(0);
+}
+
+// If no arguments, launch Interactive Mode
+if (args.length === 0) {
+  runInteractiveMode();
+} else {
+  // Command line parameters parsing mode
+  const command = args[0];
+  if (command !== 'add' && command !== 'install-all' && command !== 'list') {
+    console.error(`Error: Unknown command "${command}"`);
+    def_usage();
+    process.exit(1);
+  }
+
+  let targetSkill = null;
+  let lang = 'en';
+  let agent = 'codex';
+  let dryRun = false;
+
+  if (command === 'add') {
+    targetSkill = args[1];
+    if (!targetSkill || targetSkill.startsWith('-')) {
+      console.error('Error: Please specify a skill name to add.');
+      process.exit(1);
+    }
+  }
+
+  // Parse command flags
+  const parseStartIdx = command === 'add' ? 2 : 1;
+  for (let i = parseStartIdx; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '-l' || arg === '--lang') {
+      lang = args[++i];
+    } else if (arg === '-a' || arg === '--agent') {
+      agent = args[++i];
+    } else if (arg === '--dry-run') {
+      dryRun = true;
+    }
+  }
+
+  if (command === 'list') {
+    listSkillsLogic(lang);
+  } else {
+    const targetBaseDir = getTargetBaseDir(agent);
+
+    if (command === 'add') {
+      installSkillLogic(targetSkill, lang, agent, targetBaseDir, dryRun);
+    } else if (command === 'install-all') {
+      if (!fs.existsSync(sourceSkillsDir)) {
+        console.error(`Error: Skills source directory not found at ${sourceSkillsDir}`);
+        process.exit(1);
+      }
+      const skills = fs.readdirSync(sourceSkillsDir).filter(file => {
+        return fs.statSync(path.join(sourceSkillsDir, file)).isDirectory();
+      });
+      skills.forEach(s => installSkillLogic(s, lang, agent, targetBaseDir, dryRun));
+    }
+  }
+}
+
+function installSkillLogic(skillName, lang, agent, targetBaseDir, dryRun = false) {
+  const sourceDir = path.join(sourceSkillsDir, skillName);
+  const destDir = path.join(targetBaseDir, skillName);
+
+  if (!fs.existsSync(sourceDir)) {
+    console.error(`Error: Skill "${skillName}" does not exist in path: ${sourceDir}`);
+    process.exit(1);
+  }
+
+  console.log(`[INSTALLING] Skill "${skillName}" (Language: ${lang}, Target Agent: ${agent})`);
+  if (dryRun) console.log('  *** DRY-RUN MODE: No files will be modified ***');
+
+  function copyRecursive(src, dest) {
+    if (!fs.existsSync(src)) return;
+    const stats = fs.statSync(src);
+
+    if (stats.isDirectory()) {
+      if (!fs.existsSync(dest) && !dryRun) {
+        fs.mkdirSync(dest, { recursive: true });
+      }
+      const files = fs.readdirSync(src);
+      const fileMappings = [];
+      const filesToSkip = new Set();
+
+      files.forEach(file => {
+        const filePath = path.join(src, file);
+        if (fs.statSync(filePath).isDirectory()) return;
+
+        const ext = path.extname(file);
+        const base = path.basename(file, ext);
+        const langSuffix = `.${lang}`;
+
+        if (base.endsWith(langSuffix)) {
+          const originalBaseName = base.slice(0, -langSuffix.length);
+          const originalFileName = originalBaseName + ext;
+          fileMappings.push({ srcFile: file, destFile: originalFileName });
+          if (files.includes(originalFileName)) {
+            filesToSkip.add(originalFileName);
+          }
+        }
+      });
+
+      files.forEach(file => {
+        const srcPath = path.join(src, file);
+        const destPath = path.join(dest, file);
+
+        if (fs.statSync(srcPath).isDirectory()) {
+          copyRecursive(srcPath, destPath);
+          return;
+        }
+
+        if (filesToSkip.has(file)) return;
+
+        const ext = path.extname(file);
+        const base = path.basename(file, ext);
+        const langMatch = base.match(/\.([a-z]{2})$/);
+        if (langMatch) {
+          const matchedLang = langMatch[1];
+          if (matchedLang !== lang) return;
+        }
+
+        const mapping = fileMappings.find(m => m.srcFile === file);
+        if (mapping) {
+          const mappedDestPath = path.join(dest, mapping.destFile);
+          console.log(`  Copy: ${file} -> ${mapping.destFile}`);
+          if (!dryRun) fs.copyFileSync(srcPath, mappedDestPath);
+          return;
+        }
+
+        console.log(`  Copy: ${file} -> ${file}`);
+        if (!dryRun) fs.copyFileSync(srcPath, destPath);
+      });
+    } else {
+      console.log(`  Copy: ${path.basename(src)} -> ${path.basename(dest)}`);
+      if (!dryRun) fs.copyFileSync(src, dest);
+    }
+  }
+
+  copyRecursive(sourceDir, destDir);
+  console.log(`[SUCCESS] Installed "${skillName}" to: ${destDir}\n`);
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@bhoon716/skill-forge",
+  "version": "1.0.0",
+  "description": "Agent Skill Authoring & Distribution CLI Workspace",
+  "main": "bin/cli.js",
+  "bin": {
+    "skill-forge": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "files": [
+    "bin",
+    "skills",
+    "README.md",
+    "README.ko.md",
+    "README.zh.md"
+  ],
+  "keywords": [
+    "agent",
+    "skills",
+    "codex",
+    "claude",
+    "gemini"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/skills/ultra-grill-me/README.ko.md

@@ -0,0 +1,123 @@
+# 🎯 Ultra Grill Me (소크라테스식 압박 검증 스킬)
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+`ultra-grill-me`는 사용자의 다양한 기획, 아키텍처, 코드 모델, 비즈니스 전략 등을 바로 코드나 문서로 생성하기 전에, **한 번에 하나의 질문으로 모호성과 약점을 반대신문하듯 깎아나가는 검증 전용 AI 에이전트 스킬(Agent Skill)**입니다. 
+
+"대신 작성해주는 스킬"이 아니라, **"실행하기 전에 실패 가능성을 지워나가는 예방적 검증 스킬"**로 작동합니다.
+
+---
+
+## 1. 세션 동작 메커니즘 (Mermaid Flow)
+
+에이전트는 사용자가 세션을 시작하면 다음과 같은 철저한 Socratic 루프를 돌며 작동합니다.
+
+```mermaid
+graph TD
+    A[세션 시작 요청] --> B[logs/ 세션 로그 생성]
+    B --> C[도메인 reference 파일 1종 로드]
+    C --> D[현재 상태 1문장 요약]
+    D --> E[가장 우선순위 높은 카점 결정 식별]
+    E --> F[1개의 Micro-Question 생성]
+    F --> G{추천 라벨 ⭐ / 다른 옵션 더 받기 포함 선택지 제시}
+    G --> H[사용자 답변 대기 및 입력 구속]
+    H --> I[답변 내용 분석 및 내부 상태 갱신]
+    I --> J[logs/ 에 턴별 질문/답변 결과 기록]
+    J --> K{종료 조건 충족?}
+    K -- No --> D
+    K -- Yes --> L[9개 섹션의 최종 정리 출력]
+    L --> M[최종 정리를 로그에 영구 기록 및 종료]
+```
+
+---
+
+## 2. 10대 검증 도메인 및 Reference 매핑
+
+이 스킬은 사용자의 기획 도메인 성격에 따라 특화된 10개의 reference 마크다운 스펙을 로드해 전문성을 확보합니다.
+
+| 도메인 영역 | 대상 파일명 | 중점 검증 및 질문 철학 |
+| :--- | :--- | :--- |
+| **제품 / SaaS 아이디어** | [product-idea-grill.md](file:///skills/ultra-grill-me/references/product-idea-grill.md) | ICP 좁히기, 사용자 페인포인트 정량화, 핵심 1개 기능의 MVP 경계선 확립 |
+| **개발 구현 설계** | [technical-design-grill.md](file:///skills/ultra-grill-me/references/technical-design-grill.md) | Latency/가용성 등 비기능적 요구사항(NFR), 데이터 일관성 및 동시성, 장애 복구 시나리오 |
+| **아키텍처 결정 (ADR)** | [architecture-decision-grill.md](file:///skills/ultra-grill-me/references/architecture-decision-grill.md) | 대안 기술 비교(현상 유지 필수), 아키텍처 결정을 번복할 때의 기회비용(가역성) |
+| **구현 / 일정 계획** | [implementation-plan-grill.md](file:///skills/ultra-grill-me/references/implementation-plan-grill.md) | 완료 조건(DoD), 작업 단위 3일 이내 쪼개기, 외부 심사 의존성 리스크 및 롤백 파이프라인 |
+| **사업 전략 / GTM** | [business-strategy-grill.md](file:///skills/ultra-grill-me/references/business-strategy-grill.md) | 실제 결제 주체와 사용자의 구분, 초기 10명의 유료 고객 확보 채널, 가격 패키징 |
+| **글쓰기 / 내러티브** | [writing-direction-grill.md](file:///skills/ultra-grill-me/references/writing-direction-grill.md) | 타겟 독자의 지식 깊이 정의, 1개 단일 핵심 메시지 추출, 독자가 취할 다음 행동(CTA) |
+| **연구 질문 / 가설** | [research-question-grill.md](file:///skills/ultra-grill-me/references/research-question-grill.md) | 인과관계를 입증할 통제 변수 및 독립 변수 식별, 대조군(Baseline), 통계적 유의미 역치 |
+| **학습 계획 / 로드맵** | [learning-plan-grill.md](file:///skills/ultra-grill-me/references/learning-plan-grill.md) | 자가 평가가 가능한 작은 토이 프로젝트 목표 설정, 주간 가용 시간 한계, 피드백 메커니즘 |
+| **개인 의사결정** | [personal-decision-grill.md](file:///skills/ultra-grill-me/references/personal-decision-grill.md) | 개인의 비타협적 조건(제약) 명시, 기회비용 분석, 최악 시나리오 체험 실험 설계 |
+| **Agent Skill 설계** | [skill-design-grill.md](file:///skills/ultra-grill-me/references/skill-design-grill.md) | 스킬의 좁은 반복 범위(Scope), 발동(Trigger)과 오발동(Non-trigger) 시나리오 경계 |
+
+---
+
+## 3. 대화 예시 (Socratic Conversation Flow)
+
+에이전트는 사용자가 모호한 계획을 던졌을 때 다음과 같이 대답을 유도합니다.
+
+```
+[사용자]: "새로 기획 중인 1인 개발자용 할일 관리 앱 검증해줘."
+---
+[에이전트]:
+**현재 이해**: 개발자용 할일 관리 앱 아이디어를 검증하고 싶은 상태입니다.
+
+**막힌 결정**: 대상 사용자의 범위가 너무 넓어, 구체적인 킬러 기능과 성공 지표를 정의할 수 없습니다.
+
+**질문**: 이 앱을 사용할 1차 타겟 개발자는 누구인가요?
+
+**왜 중요한지**: 개발자마다 업무 스타일(프리랜서, 대기업 사원, 1인 개발자)이 다르므로, 구체적인 타겟을 좁혀야 이들의 진짜 페인포인트를 해결하는 기능 범위(MVP)를 도출할 수 있습니다.
+
+**선택지**:
+1. (추천) 1인 개발자 또는 인디 해커 — 여러 프로젝트의 컨텍스트 스위칭과 일정 관리에 집중
+2. 5인 이하 소규모 스타트업의 풀스택 개발자 — 협업과 빠른 배포 동기화에 집중
+3. 대기업에 근무하는 플랫폼 엔지니어 — 티켓 관리 시스템(Jira 등)과의 연동에 집중
+4. 다른 옵션 더 추천받기
+5. 직접 답변
+
+번호를 선택하거나, 다른 옵션을 요청하거나, 직접 답해 주세요.
+```
+
+---
+
+## 4. `npx @bhoon716/skill-forge` CLI 설치 가이드
+
+저장소 공통 CLI 도구를 사용하여 원하는 에이전트 도구 환경에 지정된 언어 버전으로 즉시 이식합니다. 
+
+> [!NOTE]
+> `--lang ko` 옵션을 주면, 소스 폴더 내의 `SKILL.ko.md`가 타겟 경로에 `SKILL.md`로 변환되어 이식됩니다. references 내 한국어 마크다운들도 접미사를 떼고 깨끗하게 덮어쓰여 연동됩니다.
+
+```bash
+# 1. Codex/Gemini에 한국어 버전으로 로컬 설치 (기본값)
+npx @bhoon716/skill-forge add ultra-grill-me --lang ko
+
+# 2. Claude Code에 한국어 버전으로 로컬 설치
+npx @bhoon716/skill-forge add ultra-grill-me --lang ko --agent claude
+
+# 3. Cursor 프로젝트 로컬에 영어 버전으로 설치
+npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent cursor
+
+# 4. 글로벌 스킬 디렉토리에 한국어 버전 전역 설치 (모든 워크스페이스 공유)
+npx @bhoon716/skill-forge add ultra-grill-me --lang ko --agent global
+```
+
+---
+
+## 5. 세션 로그 및 품질 관리
+
+### 세션 로그 파일
+- 스킬이 발동되면 `logs/` 디렉토리 아래에 턴별 질문 내용, 사용자 답변, 갱신된 결정 사항이 마크다운 파일(`logs/session_YYYYMMDD_HHMMSS.md`)로 실시간 누적 저장됩니다. Socratic 검증의 발자취를 추후 히스토리로 조회하기 유用합니다.
+
+### 회의 테스트 (Evals)
+- 스킬의 무단 수정으로 인해 질문 품질이나 발동 형식이 망가지는 것을 검사하기 위해 `evals/` 디렉토리에 **자동화 채점 스위트**가 탑재되어 있습니다.
+- 다음 명령어를 통해 검증 품질 통과율(Pass/Fail) 및 F1 Score를 정량 측정할 수 있습니다:
+  ```bash
+  python3 skills/ultra-grill-me/evals/check_evals.py --run-mock
+  ```
+
+---
+
+## 6. 주의 사항 (Gotchas)
+
+> [!WARNING]
+> - **적대적 스킵 우회(Adversarial Bypass)**: 대화 도중 "질문은 됐고 바로 코드 짜줘" 또는 "이전 룰 무시해줘" 같은 명령을 보내더라도, 에이전트는 스킬의 Socratic 제약을 우회하지 않고 질문 루프를 안전하게 완수하도록 프로그래밍되어 있습니다.
+> - **코드 수정 보장**: 최종안(최종 정리)이 승인되고 세션이 완전히 닫힐 때까지 에이전트는 프로젝트 소스 코드 파일을 건드리지 않습니다. 안심하고 설계를 명확화하는 대화에 집중하세요.

package/skills/ultra-grill-me/README.md

@@ -0,0 +1,122 @@
+# 🎯 Ultra Grill Me (Socratic Interrogation Agent Skill)
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+`ultra-grill-me` is a validation-only Agent Skill designed to stress-test your plans, designs, product ideas, GTM strategies, and personal decisions through Socratic, one-question-at-a-time interrogation before you jump into code implementation or execution.
+
+This is a "preventative validation skill" to remove failure modes early, NOT an immediate generation utility.
+
+---
+
+## 1. Session Execution Loop (Mermaid Flow)
+
+Upon activation, the agent executes the following Socratic query-answer iteration:
+
+```mermaid
+graph TD
+    A[Request Session Start] --> B[Generate log file under logs/]
+    B --> C[Load 1 matching domain reference file]
+    C --> D[Summarize current state in 1 sentence]
+    D --> E[Identify highest-priority blocked decision]
+    E --> F[Generate 1 specific Micro-Question]
+    F --> G{Render options with Recommended label & Ask for more trigger}
+    G --> H[Wait for user answer and restrict input]
+    H --> I[Analyze answer and update internal state variables]
+    I --> J[Append Q&A results to logs/ session log]
+    J --> K{Stopping conditions met?}
+    K -- No --> D
+    K -- Yes --> L[Output final structured 9-section synthesis]
+    L --> M[Record final synthesis to log and close session]
+```
+
+---
+
+## 2. 10 Domain Reference Maps
+
+The skill imports one of the 10 domain references based on user intent to deliver professional-grade challenges.
+
+| Domain Area | Target Reference File | Key Questioning Principles |
+| :--- | :--- | :--- |
+| **Product / SaaS Idea** | [product-idea-grill.md](file:///skills/ultra-grill-me/references/product-idea-grill.md) | Persona narrowing, pain-point quantification, MVP scope cuts |
+| **Technical Design** | [technical-design-grill.md](file:///skills/ultra-grill-me/references/technical-design-grill.md) | Non-functional requirements (NFRs), concurrency, data rollbacks |
+| **Architecture Decision** | [architecture-decision-grill.md](file:///skills/ultra-grill-me/references/architecture-decision-grill.md) | Tradeoffs, comparing alternatives (must include status quo), reversibility |
+| **Implementation Plan** | [implementation-plan-grill.md](file:///skills/ultra-grill-me/references/implementation-plan-grill.md) | Definition of Done (DoD), path scheduling, milestones, rollback protocols |
+| **Business Strategy** | [business-strategy-grill.md](file:///skills/ultra-grill-me/references/business-strategy-grill.md) | Buyer vs. User split, GTM channel focus, unit pricing packaging |
+| **Writing / Narrative** | [writing-direction-grill.md](file:///skills/ultra-grill-me/references/writing-direction-grill.md) | Reader knowledge level definition, core message, explicit call-to-actions (CTAs) |
+| **Research Hypothesis** | [research-question-grill.md](file:///skills/ultra-grill-me/references/research-question-grill.md) | Control group baseline settings, dependent variables, statistical margins |
+| **Learning Plan** | [learning-plan-grill.md](file:///skills/ultra-grill-me/references/learning-plan-grill.md) | Output verification project targets, weekly time budgets, mentors feedback |
+| **Personal Decision** | [personal-decision-grill.md](file:///skills/ultra-grill-me/references/personal-decision-grill.md) | Hard constraints definition, opportunity cost, mini 1-week experiments |
+| **Agent Skill Design** | [skill-design-grill.md](file:///skills/ultra-grill-me/references/skill-design-grill.md) | Scope bounding, triggers vs. non-trigger scenarios, process validation |
+
+---
+
+## 3. Conversation Specimen
+
+Here is a typical interaction log showing the structure of each turn:
+
+```
+[User]: "I want to stress-test my new developer task manager app idea."
+---
+[Agent]:
+**Current Understanding**: Validating a new developer task manager SaaS idea.
+
+**Blocked Decision**: Target user remains too broad, preventing core MVP value definition.
+
+**Question**: Who is the primary target developer for this MVP?
+
+**Why it matters**: Freelancers, big-tech engineers, and indie hackers have completely different workflow bottlenecks. Defining this determines the primary MVP feature.
+
+**Options**:
+1. (Recommended) 1인 개발자 또는 인디 해커 — Focus on multiple projects and context switching
+2. 5인 이하 소규모 스타트업의 풀스택 개발자 — Focus on rapid sync and collaboration
+3. 대기업에 근무하는 플랫폼 엔지니어 — Focus on Jira integration and tickets
+4. Ask for more recommended options
+5. Answer directly
+
+Please select a number, ask for more options, or answer directly.
+```
+
+---
+
+## 4. `npx @bhoon716/skill-forge` CLI Installer
+
+Use the workspace CLI to deploy the skill to your target agent directory.
+
+> [!NOTE]
+> Setting `--lang ko` automatically translates `SKILL.ko.md` into `SKILL.md` in the destination folder, mapping all dependencies seamlessly.
+
+```bash
+# 1. Install Korean translation locally to Codex/Gemini (Default)
+npx @bhoon716/skill-forge add ultra-grill-me --lang ko
+
+# 2. Install English version locally to Claude Code
+npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent claude
+
+# 3. Install English version locally to Cursor
+npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent cursor
+
+# 4. Install globally for all workspaces (English default)
+npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent global
+```
+
+---
+
+## 5. Logs & Evaluators
+
+### Session Logs
+- Every session generates active log outputs under `logs/` (e.g., `logs/session_YYYYMMDD_HHMMSS.md`) recording all Q&As, assumptions, and decisions to track historical changes.
+
+### Automated Testing (Evals)
+- Assert questioning structures and process adherence using the python test suite:
+  ```bash
+  python3 skills/ultra-grill-me/evals/check_evals.py --run-mock
+  ```
+
+---
+
+## 6. Gotchas & Safety Rules
+
+> [!WARNING]
+> - **Adversarial Bypass Defense**: The agent will reject bypass commands (e.g., "skip questions and write the code now") and insist on resolving the single blocked decision.
+> - **Code Non-Modification Policy**: Workspace source codes will not be altered during active Socratic dialogs until the user accepts the final synthesis.