@walwal-harness/cli 1.2.0 → 1.3.0

package/README.md

@@ -170,6 +170,17 @@ your-project/
 | Unit Testing | Jest (BE) + Vitest (FE) |
 | Database | PostgreSQL / SQLite |
 
+## 권장 외부 스킬
+
+하네스는 자체 reference 파일로 기본 가이드를 제공하지만, 아래 외부 스킬을 설치하면 품질이 향상됩니다. 초기화 시 자동으로 설치 여부를 체크하고 안내합니다.
+
+| 스킬 | 설명 | 사용 에이전트 |
+|------|------|-------------|
+| **vercel** | Vercel/Next.js 배포, 성능 최적화, AI SDK | Generator-FE |
+| **web-design-guidelines** | UI/UX 접근성, Web Interface Guidelines | Evaluator-Visual, Generator-FE |
+| **taste-skill** | AI 생성 UI 디자인 품질, AI슬롭 감지 | Evaluator-Visual, Generator-FE |
+| **supanova-design-skill** | 디자인 시스템 규칙, 시각적 일관성 | Evaluator-Visual, Generator-FE |
+
 ## Playwright MCP 설정
 
 Evaluator가 브라우저 테스트를 수행하려면 Playwright MCP가 필요합니다. `~/.mcp.json`에 추가:

package/assets/templates/config.json

@@ -84,6 +84,33 @@
     "gotchas": ".harness/gotchas",
     "progress": ".harness/progress.txt"
   },
+  "recommended_skills": {
+    "comment": "Claude Code에 설치하면 하네스 품질이 향상되는 외부 스킬 목록",
+    "vercel": {
+      "description": "Vercel/Next.js 배포, 성능 최적화, AI SDK 가이드",
+      "used_by": ["generator-frontend"],
+      "install": "claude skill install vercel",
+      "check_path": ".claude/skills/vercel"
+    },
+    "web-design-guidelines": {
+      "description": "UI/UX 접근성, 디자인 리뷰, Web Interface Guidelines",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "claude skill install web-design-guidelines",
+      "check_path": ".claude/skills/web-design-guidelines"
+    },
+    "taste-skill": {
+      "description": "AI 생성 UI의 디자인 품질 검증, AI슬롭 패턴 감지",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "npx claude-skill install leonxlnx/taste-skill",
+      "check_path": ".claude/skills/taste-skill"
+    },
+    "supanova-design-skill": {
+      "description": "디자인 시스템 규칙, 컴포넌트 패턴, 시각적 일관성",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "npx claude-skill install uxjoseph/supanova-design-skill",
+      "check_path": ".claude/skills/supanova-design-skill"
+    }
+  },
   "tech_stack": {
     "backend": {
       "framework": "NestJS (TypeScript)",

package/bin/init.js

@@ -283,6 +283,60 @@ function checkPlaywrightMcp() {
   log('');
 }
 
+// ─────────────────────────────────────────
+// 6. Recommended skills check
+// ─────────────────────────────────────────
+function checkRecommendedSkills() {
+  const configPath = path.join(HARNESS_DIR, 'config.json');
+  if (!fileExists(configPath)) return;
+
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  } catch (e) { return; }
+
+  const skills = config.recommended_skills;
+  if (!skills) return;
+
+  const missing = [];
+  const found = [];
+
+  for (const [name, info] of Object.entries(skills)) {
+    if (name === 'comment') continue;
+    const checkPath = path.join(PROJECT_ROOT, info.check_path);
+    if (fileExists(checkPath)) {
+      found.push(name);
+    } else {
+      missing.push({ name, ...info });
+    }
+  }
+
+  if (found.length > 0) {
+    log(`Recommended skills installed: ${found.join(', ')}`);
+  }
+
+  if (missing.length > 0) {
+    console.log('');
+    log('╔═══════════════════════════════════════════════════════════╗');
+    log('║  Recommended skills (not installed)                      ║');
+    log('╠═══════════════════════════════════════════════════════════╣');
+    for (const skill of missing) {
+      const agents = skill.used_by.join(', ');
+      log(`║  ${skill.name}`);
+      log(`║    ${skill.description}`);
+      log(`║    Used by: ${agents}`);
+      log(`║    Install: ${skill.install}`);
+      log('║');
+    }
+    log('║  These skills are optional but improve output quality.   ║');
+    log('║  Harness reference files provide baseline guidance       ║');
+    log('║  even without these skills installed.                    ║');
+    log('╚═══════════════════════════════════════════════════════════╝');
+  } else if (found.length > 0) {
+    log('All recommended skills are installed!');
+  }
+}
+
 // ─────────────────────────────────────────
 // Help
 // ─────────────────────────────────────────
@@ -305,6 +359,7 @@ What it does:
   3. Copies helper scripts to scripts/
   4. Creates AGENTS.md + CLAUDE.md symlink
   5. Checks Playwright MCP configuration
+  6. Checks recommended external skills (Vercel, design skills)
 
 After init:
   1. Restart Claude Code session (exit and re-enter) for skills to load
@@ -337,6 +392,7 @@ function main() {
   installScripts();
   setupAgentsMd();
   checkPlaywrightMcp();
+  checkRecommendedSkills();
 
   console.log('');
   log('═══ Initialization Complete ═══');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual) with Gotcha management",
   "bin": {
     "walwal-harness": "bin/init.js"