@jjlabsio/claude-crew 0.1.11 → 0.1.13

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "claude-crew",
       "source": "./",
       "description": "오케스트레이터 + PM, 플래너, 개발, QA, 마케팅 에이전트 팀으로 단일 제품의 개발과 마케팅을 통합 관리",
-      "version": "0.1.11",
+      "version": "0.1.13",
       "author": {
         "name": "Jaejin Song",
         "email": "wowlxx28@gmail.com"
@@ -28,5 +28,5 @@
       "category": "workflow"
     }
   ],
-  "version": "0.1.11"
+  "version": "0.1.13"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-crew",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": {
     "name": "Jaejin Song",

package/hooks/enforce-delegation.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * Delegation Enforcer — PreToolUse hook
+ *
+ * When an Agent/Task call includes subagent_type, auto-injects the model
+ * from the matching agent definition (agents/*.md frontmatter).
+ * If subagent_type is missing on an Agent/Task call, blocks with a warning.
+ */
+
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+
+// ---------------------------------------------------------------------------
+// Read stdin
+// ---------------------------------------------------------------------------
+async function readStdin(timeoutMs = 3000) {
+  if (process.stdin.isTTY) return null;
+  return new Promise((resolve) => {
+    let data = '';
+    const timer = setTimeout(() => resolve(data || null), timeoutMs);
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => { clearTimeout(timer); resolve(data || null); });
+    process.stdin.on('error', () => { clearTimeout(timer); resolve(null); });
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Load agent definitions from agents/*.md frontmatter
+// ---------------------------------------------------------------------------
+function loadAgentDefinitions(pluginRoot) {
+  const agentsDir = join(pluginRoot, 'agents');
+  const defs = {};
+
+  try {
+    const files = readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const content = readFileSync(join(agentsDir, file), 'utf-8');
+      const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+      if (!fmMatch) continue;
+
+      const fm = fmMatch[1];
+      const name = fm.match(/^name:\s*(.+)$/m)?.[1]?.trim();
+      const model = fm.match(/^model:\s*(.+)$/m)?.[1]?.trim();
+
+      if (name && model) {
+        defs[name] = model;
+      }
+    }
+  } catch { /* ignore */ }
+
+  return defs;
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  const raw = await readStdin();
+  if (!raw) {
+    console.log(JSON.stringify({ continue: true }));
+    return;
+  }
+
+  let event;
+  try { event = JSON.parse(raw); } catch {
+    console.log(JSON.stringify({ continue: true }));
+    return;
+  }
+
+  const toolName = (event.tool_name || '').toLowerCase();
+
+  // Only intercept Agent/Task calls
+  if (toolName !== 'agent' && toolName !== 'task') {
+    console.log(JSON.stringify({ continue: true }));
+    return;
+  }
+
+  const input = event.tool_input || {};
+
+  // If subagent_type is missing, pass through without modification
+  if (!input.subagent_type) {
+    console.log(JSON.stringify({ continue: true }));
+    return;
+  }
+
+  // Canonicalize subagent_type (strip plugin prefix if present)
+  const rawType = input.subagent_type.replace(/^claude-crew:/, '');
+
+  // Load agent definitions and auto-inject model if missing
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || dirname(import.meta.url.replace('file://', '')).replace('/hooks', '');
+  const agentDefs = loadAgentDefinitions(pluginRoot);
+
+  if (!input.model && agentDefs[rawType]) {
+    // Auto-inject model from agent definition
+    const injectedModel = agentDefs[rawType];
+    console.log(JSON.stringify({
+      continue: true,
+      modifiedInput: { ...input, model: injectedModel },
+      hookSpecificOutput: {
+        hookEventName: 'PreToolUse',
+        additionalContext: `model 자동 주입: ${rawType} → ${injectedModel}`,
+      },
+    }));
+    return;
+  }
+
+  console.log(JSON.stringify({ continue: true }));
+}
+
+main();

package/hooks/hooks.json

@@ -12,6 +12,18 @@
           }
         ]
       }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT/hooks/enforce-delegation.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   }
 }

package/hud/index.mjs

@@ -10,7 +10,7 @@
  */
 
 import { execSync } from 'node:child_process';
-import { readFileSync, existsSync } from 'node:fs';
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
 import { join, dirname, basename } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -57,6 +57,28 @@ function getVersion() {
   return '0.0.0';
 }
 
+// ---------------------------------------------------------------------------
+// Agent definitions (subagent_type → model)
+// ---------------------------------------------------------------------------
+function loadAgentModels() {
+  try {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const agentsDir = join(__dirname, '..', 'agents');
+    const models = {};
+    const files = readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const content = readFileSync(join(agentsDir, file), 'utf-8');
+      const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+      if (!fmMatch) continue;
+      const fm = fmMatch[1];
+      const name = fm.match(/^name:\s*(.+)$/m)?.[1]?.trim();
+      const model = fm.match(/^model:\s*(.+)$/m)?.[1]?.trim();
+      if (name && model) models[name] = model;
+    }
+    return models;
+  } catch { return {}; }
+}
+
 // ---------------------------------------------------------------------------
 // Git helpers
 // ---------------------------------------------------------------------------
@@ -144,6 +166,8 @@ function parseTranscript(transcriptPath) {
   const result = { agents: [], lastSkill: null, sessionStart: null };
   if (!transcriptPath || !existsSync(transcriptPath)) return result;
 
+  const agentModels = loadAgentModels();
+
   try {
     const content = readFileSync(transcriptPath, 'utf-8');
     const lines = content.split('\n').filter(Boolean);
@@ -178,7 +202,8 @@ function parseTranscript(transcriptPath) {
                 if (id) {
                   const input = block.input || {};
                   const agentType = input.subagent_type || input.type || 'general';
-                  const model = input.model || null;
+                  const rawType = agentType.replace(/^claude-crew:/, '');
+                  const model = input.model || agentModels[rawType] || null;
                   const description = input.description || input.prompt?.slice(0, 50) || '';
                   const ts = entry.timestamp || lastTimestamp;
                   agentMap.set(id, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jjlabsio/claude-crew",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": "Jaejin Song <wowlxx28@gmail.com>",
   "license": "MIT",

package/skills/crew-dev/SKILL.md

@@ -56,7 +56,7 @@ description: contract.md를 입력으로 받아 Dev + CodeReviewer + QA 파이
 | **CodeReviewer** | code-reviewer | git diff(직접 실행), 가드레일(인라인) | contract.md, plan.md, brief.md, spec.md, dev-log.md | 수용 기준 체리피킹 방지 (.crew/는 .gitignore 대상이므로 diff에 노출되지 않음) |
 | **QA** | qa | plan.md | contract.md, brief.md, spec.md | 검증 편향 방지 |
 
-**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. HUD에서 에이전트 타입을 식별하는 데 사용된다.
+**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. `subagent_type`이 없으면 PreToolUse hook이 호출을 차단한다. `model` 파라미터는 생략 가능 — hook이 에이전트 정의에서 자동 주입한다.
 
 ---
 
@@ -107,7 +107,11 @@ IN_PROGRESS — Dev 에이전트가 구현 중이다.
 
 **모델**: opus
 
-에이전트 호출 시 반드시 `subagent_type: "dev"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="dev", description="Dev: {task-id} 구현", prompt="...")
+```
 
 **첫 번째 실행 시 에이전트 프롬프트**:
 
@@ -188,7 +192,11 @@ CodeReviewer와 QA를 **동시에** Agent tool 2개로 호출한다.
 
 **모델**: opus
 
-에이전트 호출 시 반드시 `subagent_type: "code-reviewer"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="code-reviewer", description="CodeReviewer: {task-id} 코드 리뷰", prompt="...")
+```
 
 오케스트레이터가 해야 할 사전 작업:
 1. contract.md에서 가드레일 섹션(Must/Must NOT)만 추출한다.
@@ -233,7 +241,11 @@ contract.md, plan.md, brief.md, spec.md, dev-log.md는 읽지 않는다.
 
 **모델**: sonnet
 
-에이전트 호출 시 반드시 `subagent_type: "qa"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="qa", description="QA: {task-id} 검증", prompt="...")
+```
 
 에이전트 프롬프트:
 
@@ -274,8 +286,8 @@ contract.md, brief.md, spec.md는 읽지 않는다.
 오케스트레이터는 한 번의 메시지에서 두 개의 Agent tool 호출을 동시에 수행한다:
 
 ```
-Agent(name="code-reviewer", subagent_type="code-reviewer", model="opus", prompt="...")
-Agent(name="qa", subagent_type="qa", model="sonnet", prompt="...")
+Agent(subagent_type="code-reviewer", description="CodeReviewer: {task-id} 코드 리뷰", prompt="...")
+Agent(subagent_type="qa", description="QA: {task-id} 검증", prompt="...")
 ```
 
 ---

package/skills/crew-plan/SKILL.md

@@ -63,7 +63,11 @@ brief.md가 없거나 비어 있습니다. 계획 파이프라인을 시작할
 **모델**: opus
 **건너뛰기 조건**: 엔지니어링 유형이면 이 단계를 건너뛴다.
 
-에이전트 호출 시 반드시 `subagent_type: "pm"`을 지정한다.
+호출:
+
+```
+Agent(subagent_type="pm", description="PM: {task-id} 요구사항 정의", prompt="...")
+```
 
 에이전트 프롬프트:
 
@@ -101,7 +105,11 @@ PM 에이전트가 요구사항 정의에 실패했습니다.
 **모델**: opus
 **실행 조건**: 항상 (양쪽 유형 모두)
 
-에이전트 호출 시 반드시 `subagent_type: "techlead"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="techlead", description="TechLead: {task-id} 사전 분석", prompt="...")
+```
 
 에이전트 프롬프트:
 
@@ -114,14 +122,14 @@ PM 에이전트가 요구사항 정의에 실패했습니다.
 
 ## 서브에이전트 호출
 - Explorer (Haiku): 코드베이스 탐색. 항상 호출. 병렬 2-3개로 호출하라.
-  Agent(description="코드베이스 탐색", model="haiku", prompt="...")
+  Agent(subagent_type="explorer", description="코드베이스 탐색: {탐색 대상}", prompt="...")
   **필수 탐색 항목**: 테스트 인프라도 반드시 탐색한다. Explorer 중 1개는 다음을 확인:
   - 테스트 프레임워크 설정 파일 (jest.config.*, vitest.config.*, pytest.ini 등)
   - 대표적인 테스트 파일 2-3개의 패턴
   - 커버리지 설정 여부
   - 테스트 실행 스크립트 (package.json scripts 등)
 - Researcher (Sonnet): 외부 리서치. 필요시만 호출.
-  Agent(description="외부 리서치", model="sonnet", prompt="...")
+  Agent(subagent_type="researcher", description="외부 리서치: {리서치 대상}", prompt="...")
 
 ## 출력
 .crew/plans/{task-id}/analysis.md 를 작성하라.
@@ -183,7 +191,11 @@ TechLead의 analysis.md에서 테스트 인프라 섹션을 확인한 후, 오
 
 **모델**: opus
 
-에이전트 호출 시 반드시 `subagent_type: "planner"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="planner", description="Planner: {task-id} 구현 계획", prompt="...")
+```
 
 **첫 번째 실행 시 에이전트 프롬프트**:
 
@@ -260,7 +272,11 @@ plan.md 최상단에 "이전 피드백 반영" 섹션을 추가한다.
 
 **모델**: sonnet (하드 임계값 판정에서 Opus 합리화 방지)
 
-에이전트 호출 시 반드시 `subagent_type: "plan-evaluator"`를 지정한다.
+호출:
+
+```
+Agent(subagent_type="plan-evaluator", description="PlanEvaluator: {task-id} 계획 검증", prompt="...")
+```
 
 에이전트 프롬프트:
 
@@ -295,7 +311,7 @@ plan.md 최상단에 "이전 피드백 반영" 섹션을 추가한다.
 
 ## E3 코드 참조 확인
 Explorer 서브에이전트를 호출하여 plan.md에서 참조하는 파일/모듈이 존재하는지 확인하라.
-Agent(description="코드 참조 확인", model="haiku", prompt="plan.md에서 참조하는 다음 파일/모듈이 존재하는지 확인하라: {파일 목록}")
+Agent(subagent_type="explorer", description="코드 참조 확인: {파일 목록 요약}", prompt="plan.md에서 참조하는 다음 파일/모듈이 존재하는지 확인하라: {파일 목록}")
 
 ## 출력
 .crew/plans/{task-id}/review.md 를 작성하라.
@@ -458,7 +474,7 @@ Planner + PlanEvaluator 사이클은 최대 5회 (초기 1회 + retry 최대 4
 | Planner (retry) | planner | opus | spec.md (유저 가치 시) + analysis.md + review-{n}.md | brief.md |
 | PlanEvaluator | plan-evaluator | sonnet | spec.md/brief.md + analysis.md + plan.md | brief.md (유저 가치 시) |
 
-**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. HUD에서 에이전트 타입을 식별하는 데 사용된다.
+**중요**: 모든 에이전트 호출 시 반드시 `subagent_type` 파라미터를 지정해야 한다. `subagent_type`이 없으면 PreToolUse hook이 호출을 차단한다. `model` 파라미터는 생략 가능 — hook이 에이전트 정의에서 자동 주입한다.
 
 ---