AI 에이전트 조직 모델
휴넥시아 AI 에이전트 조직의 구조. CEO→팀장(orchestrator)→전문가 체계와 부문별 에이전트, Labs 표준 개발 체인을 정의.
기준일 2026-07-15. 방대한 전역 스킬 생태계를 휴넥시아 실무에 맞게 엄선(curation)한 결과. 핵심 전제: 대부분의 스킬은 이미 전역에 깔려 있다. 진짜 문제는 "설치"가 아니라 엄선·인증·공식 채택이다. 브랜드 톤(과장 없이 근거 제시)에 따라 "지금 당장"과 "조건부"를 명확히 구분한다.
| 구분 | 상태 |
|---|---|
| 활성 플러그인(7) | pr-review-toolkit · chrome-devtools-mcp · ui-ux-pro-max · remember · commit-commands · feature-dev · cloudflare — 2026-07-22 .claude/settings.json 실측(auth0는 제거됨, 8329cc9) |
| 커스텀 | /hire-agent·/org-review·/generate-proposal·/content-calendar·/automation-audit), 에이전트 13(data-analyst 영입)/report·/wiki·/linkedin-post·/work-order) · 에이전트 18. 정본은 CLAUDE.md §7·§8 |
.mcp.json |
없음. 프로젝트 단 MCP는 chrome-devtools 플러그인 경유가 유일 |
| §7 참조 MCP 실구성 | Notion ✅ 인증(2026-07-15). Google Workspace(Gmail·Calendar·Drive) 보류(Google Cloud OAuth 서버 셋업 필요). Supabase·Vercel·Figma는 미사용 결정 |
| hooks | 3개 — SessionStart: npm run -s docs:check 문서 신선도 점검 · UserPromptSubmit: .claude/hooks/route-orchestrator.mjs 이든 위임 안내 주입 · PreToolUse(matcher Write): .claude/hooks/doc-write-guard.mjs 문서 표준 쓰기 시점 가드 — 표준 5구획에 새 .md 가 태어날 때만 발화, 판정은 ask(차단 아님)이고 판정 규칙은 R17 정본(scripts/doc-schema.mjs·scanDocSchema) 재사용. 별건 7번, 2026-07-30 대표 승인(2026-07-30 .claude/settings.json 실측) |
역량 갭(해소 현황): ① 데이터 분석/리포트 담당 ✅ data-analyst 영입 ② 도윤/유나 웹 접근권 ✅ 부여 ③ MCP — Notion ✅, Google Workspace 보류.
이미 전역에 존재하거나 §7이 참조 중인 것들. "설치"보다 공식 채택(§7 등재)+인증이 본질.
| # | 항목 | 내용 | 효과 | 장점 | 단점/주의 |
|---|---|---|---|---|---|
| 1 | MCP 인증·설치 | Notion ✅ 인증(2026-07-15). Supabase·Vercel·Figma=미사용 결정. Gmail·Calendar·Drive=보류(Google Cloud OAuth 서버 셋업) | ops-pm 문서·automation-rag RAG 실동작 | Notion은 1회 인증으로 즉시 가동 | Google MCP는 Google Cloud OAuth 클라이언트 발급 필요(비용 중) |
| 2 | deep-research | 다중 소스 웹 검색 → 팩트체크 → 인용 보고서 | 진단·영업 근거·콘텐츠 신뢰도 ↑. 브랜드 톤 "과장 없이 근거 제시"와 직결 | ai-adoption·sales·content 전 부문 활용 | 토큰/시간 비용 큼 → 큰 질문에만 |
| 3 | dataviz | 차트/대시보드를 브랜드 중립 팔레트로 일관 생성 | 진단표·제안서·콘텐츠 시각화 품질 ↑. "데이터 분석 갭" 부분 메움 | automation-audit·generate-proposal이 이미 참조 | 팔레트를 Hunexia 토큰(navy/mint/violet)으로 교체 작업 필요 |
| 4 | make-pdf + document-generate | 마크다운 → 출판 품질 PDF / 누락 문서 자동 생성 | 고객 제안서·강의 교재 PDF 납품 가능 | generate-proposal·course-content이 이미 참조 | gstack 계열 의존도 증가 |
| 5 | commit-commands | 커밋/푸시/PR, gone 브랜치 정리 | 모든 조직 변경을 git HR 이력으로 남기는 워크플로 일원화 | people-ops 커밋 표준화 | 거의 없음 |
| 6 | fewer-permission-prompts | 사용 패턴 분석 → 읽기 전용 호출 허용목록 자동 제안 | 반복 권한 프롬프트 감소 | settings.local.json allow가 현재 1개뿐 → 효과 큼 | 초기 1회 스캔 필요 |
| 7 | skill-creator | 스킬 생성/수정/평가/최적화 | 5개 커스텀 스킬 유지보수·/org-review 시 스킬 진화 |
로드맵(agentskills.io 표준 이식) 부합 | 없음 |
| 8 | claude-md-management | CLAUDE.md 감사·개선 | 허브 문서 건전성 유지(§7 레지스트리 갱신 등) | 자동화 | 거의 없음 |
| 항목 | 트리거 | 내용 | 장점 | 단점/주의 |
|---|---|---|---|---|
| vercel suite(deploy·AI SDK·next 등) | 자체 웹 프로덕트 출시 시 | 배포·프리뷰·롤백·AI 앱 아키텍처 | Labs가 웹 서비스(사업 영역) 출시 시 핵심 | 현재는 디자인 시스템 패키지뿐 → 보류 |
| supabase 스킬 | RAG/백엔드 본격화 시 | Postgres 베스트프랙티스·스키마 | automation-rag의 pgvector 작업 정합 | MCP 인증은 Tier 1에서 이미 수행 |
| huggingface-skills | Labs 모델 연구 시 | 모델 선택·트레이닝·Spaces | RAG/모델 평가 지원 | 매우 무거움 → 필요 것만 선택 |
| chrome-devtools-mcp(방금 설치) | Labs 웹 QA | 실제 브라우저 디버그·성능/LCP | 웹 서비스 품질 검증 | playwright MCP와 기능 중복 → 하나로 통일 권장 |
| runway-api | 유튜브 영상 제작 본격화 시 | 비디오/이미지/오디오 생성 API | content-strategist 영상 자산 | 비용 + 브랜드 톤(과장 지양) → 신중 |
| hookify | 절차 자동화 필요 시 | 규칙을 hooks로 변환 | 브랜드 톤 자동 검증·승인 게이트를 훅으로 | 오설정 시 부작용 → careful/guard와 병행 |
| 플러그인 | 평가 | 근거 |
|---|---|---|
| pr-review-toolkit | ✅ 유지(Labs) | PR 리뷰(/review-pr)로 Labs 체인 보강. 단 feature-dev:code-reviewer·code-review·gstack:review와 기능 중복 → 팀 표준 1개로 통일 권장 |
| chrome-devtools-mcp | ✅ 유지(Labs 웹 QA) | 디버깅/성능 측정. 단 이미 전역에 playwright MCP가 있어 중복 → 역할 분담(playwright=자동화 / 크롬DT=디버그) 또는 하나로 통일 |
| auth0 | ⚠️ 적합성 의문 → 제거 권장 | 인증 SaaS를 직접 출시하지 않는 한 불필요. 현재 산출물=디자인 시스템 패키지. Phase 4 "Hunexia Agents" 제품화가 임박하지 않다면 제거(스킬 목록 60+ 항목 지저분함 ↓) |
코드 리뷰 중복 통합안: 전역에
code-review(탑레벨) ·code-review:code-review(pr-review-toolkit) ·gstack:review·feature-dev:code-reviewer(에이전트) 최소 4종. Labs 표준을 하나로 정해 혼선 방지. 표준:feature-dev:code-reviewer에이전트 +code-review스킬. (이 표준은 CLAUDE.md §7에 반영됨.)
ios-*: iOS 제품 없음.data-analyst)가 없음 → /hire-agent 권장./org-review로 도구를 추가(자체 리서치 허용)할지, content-strategist 경유 분업을 유지할지 결정./reload-plugins — 활성 플러그인 2개(pr-review-toolkit·chrome-devtools-mcp; auth0 제거 완료 8329cc9)..claude/settings.json에서 제거, 8329cc9)./hire-agent), 도윤/유나 웹 접근권 부여(/org-review).knowledge/org/skills-stack.md)로 durable 저장 — ✅ 완료.npm run typecheck 변동 없음./reload-plugins 후 3개 표시.각 에이전트 Process에 명시된 스킬. [핵심] = 이미 사용 가능(
Skill/Agent도구 추가로 자율 호출됨). (조건부) =/plugin install후 위임. Academy 스킬은education-agent-skills에서 frentis 조사본 (education-agent-skills-adoption) 기반 선별 — 파이프라인 구조는 미차용, 스킬 지식만 차용.
| 역할 | [핵심] 자율 호출 스킬 | (조건부·설치 시) |
|---|---|---|
| orchestrator | (라우팅 전담 — Agent 보유, 스킬 최소) |
— |
| people-ops | skill-creator·claude-md-management·remember/learn(Skill); agent-creator(Agent) |
— |
| content-strategist | deep-research·dataviz·make-pdf·frontend-design·/content-calendar |
exa/tavily(리서치)·postiz(SNS)·save-to-spotify(팟캐스트)·runway-api(영상) |
| brand-content-designer | frontend-design·ui-ux-pro-max·figma·playground·dataviz·make-pdf·design-system |
canva·adobe-for-creativity·miro·runway-api |
| sales-proposal-expert | deep-research·dataviz·make-pdf·/generate-proposal |
hunter/apollo/lusha(리드)·monday-crm/intercom(CRM) |
| ai-adoption-consultant | deep-research·dataviz·/automation-audit |
zapier(자동화매핑)·amplitude/windsor-ai(분석) |
| curriculum-architect | education 설계: backwards-design-unit-planner·scope-and-sequence-designer·curriculum-knowledge-architecture-designer·competency-unpacker·kud-chart-author·learning-target-authoring-guide·learning-progression-builder·criterion-referenced-rubric-generator·assessment-validity-checker·hinge-question-designer·formative-assessment-technique-selector·differentiation-adapter·udl-barrier-anticipator/udl-options-designer·project-brief-designer·coverage-audit·prompt-literacy-sequence-designer(AI과정) +deep-research·make-pdf |
— |
| course-content-writer | education 콘텐츠: explicit-instruction-sequence-builder·three-part-lesson-designer·lesson-opening-designer·think-aloud-script-generator·digital-worked-example-sequence·worked-example-fading-designer·practice-problem-sequence-designer·self-explanation-prompt-designer·cognitive-load-analyser·dual-coding-designer·retrieval-practice-generator·spaced-practice-scheduler·elaborative-interrogation-generator·feedback-quality-analyser·metacognitive-prompt-library·error-analysis-protocol·socratic-questioning-sequence-generator·ai-hallucination-fact-check-protocol(AI과정)·pedagogical-content-knowledge-developer(TPACK) +frontend-design·design-system·make-pdf |
— |
| principal-architect | feature-dev(architect/explorer)·gstack:spec·diagram·superpowers(writing-plans/brainstorming) |
greptile/sourcegraph/serena(코드검색) |
| implementation-lead | superpowers(test-driven-development/subagent-driven-development)·feature-dev:code-reviewer·code-review·simplify·verify·commit-commands·security-review |
typescript-lsp(TS 디자인시스템) |
| automation-rag-engineer | supabase·feature-dev(Agent)·deep-research |
huggingface-skills·pinecone/qdrant(벡터DB)·firecrawl/exa(웹수집)·zapier·mcp-server-dev |
| ops-pm | (Read/Write 잠금 — MCP 의존: notion/Calendar/Gmail) |
linear/asana(태스크추적) |
비고:
context7은 MCP서버(웹문서 조회)라Skill도구 호출 대상이 아님 — 최신 라이브러리/API 문서는WebFetch로 공식 문서를 확인(에이전트 실제 동작 방식,e470cb1반영). 표의 나머지 스킬은 전부Skill도구 호출.
implementation-lead에 security-review 추가 완료./hire-agent(data-analyst)로 별도 처리.dispatching-parallel-agents, course-writer→instructional-coaching/panel-review, ops-pm→document-generate. 차회 /org-review에서 재검토.