project

# project — Cowork 프로젝트 초기화 & 스킬 체이닝 워크플로우 설계

사용자는 이 프로젝트에서 무엇을 할지 말해주면 됩니다. 나머지(플러그인 선택, 스킬 체인 설계, 산출물 규칙, 검수 파이프라인)는 MoAI가 설계·정리합니다.

## 개요

이 스킬은 Claude Cowork 사용자가 프로젝트를 시작할 때 **최적의 워크플로우를 자동으로 설계**하고, 프로젝트 루트에 `CLAUDE.md`를 생성합니다.

**핵심 기능**:
- 3단계 소크라테스 인터뷰로 프로젝트 맥락 수집
- 설치된 27개 moai 플러그인 자동 감지 (Bash + system reminder 교차 검증)
- 산출물별 **스킬 체인 설계** (예: 블로그 = blog → ai-slop-reviewer)
- **Gap Detection**: 누락 플러그인/스킬 자동 감지 → 설치 안내 → 재개
- CLAUDE.md 템플릿 기반 자동 생성
- 필수 API 키 선택적 등록 안내

**현재 동작 요약**:
- 서브커맨드 없이 bare `/project`가 초기화 기본 동작 (Phase 1-8). `/project init`은 레거시 별칭으로 계속 인식.
- 글로벌 프로필 시스템 없음 — 이름·회사·역할을 프로젝트마다 재질문하지 않음.
- 스킬 체이닝 기반 워크플로우 설계 + CLAUDE.md 외부 템플릿화.
- office/web 스킬 우선 + AI 슬롭 후처리 HARD 규칙 고정.
- Phase 2 Inventory(Bash + system reminder 교차 검증) + Phase 4 Gap Detection(누락 감지 → 설치 안내 → 재개).

## 트리거 키워드

이 스킬은 다음 상황에서 자동으로 호출됩니다:

**초기화 요청**:
- "새 프로젝트 시작", "Cowork 프로젝트 초기 설정" — 서브커맨드 없이 bare `/project`가 초기화 기본 동작
- "/project", "/project init"(레거시 별칭), "CLAUDE.md 만들어줘", "프로젝트 설정 도와줘"
- "이어서 진행", "설치 완료", "다시 진행" — 설치 완료 후 재개 트리거 (`/project resume`, 레거시 `/project init resume`)

**워크플로우 설계**:
- "이 프로젝트에 어울리는 워크플로우 설계해줘"
- "어떤 스킬을 쓸지 추천해줘", "스킬 체인 만들어줘"

**상태 확인·관리**:
- "/project catalog", "/project status", "/project apikey", "/project doctor", "/project feedback"
- "설치된 플러그인 목록", "API 키 확인", "환경 진단"

**도메인 라우팅** (자연어 → 플러그인, 27개 전체):
- 사업계획, 시장조사, IR, 소상공인, 정부지원 → `moai-business`
- SEO, SNS, 캠페인, 이메일, 랜딩진단, 메타광고 → `moai-marketing`
- 계약서, 개인정보, NDA, 법인등기 → `moai-legal`
- 세무, 결산, 재무제표, 변동분석 → `moai-finance`
- 근로계약, 4대보험, 채용, 성과평가 → `moai-hr`
- 블로그, 카드뉴스, 랜딩/상세, 뉴스레터, 카피, HTML, 한국어 윤문 → `moai-content`
- 운영, SOP, 벤더관리 → `moai-operations`
- 강의운영매뉴얼, 후기시퀀스, 교육과정, 평가 → `moai-education`
- 여행, 웰니스, 이벤트 → `moai-lifestyle`
- PM, UX, 로드맵, 스펙 → `moai-product`
- 티켓, 응대, KB, 에스컬레이션 → `moai-support`
- PPT, DOCX, XLSX, HWPX, PDF, NotebookLM → `moai-office`
- 이력서, 자소서, 면접, 포트폴리오 → `moai-career`
- CSV/Excel, 시각화, 공공데이터 → `moai-data`
- 한국 공공데이터 조회(주식·경매·부동산) → `moai-public-data`
- 논문, 특허, 연구비 → `moai-research`
- AI 이미지, 영상, 음성 → `moai-media`
- 한국 이커머스 풀세트 → `moai-commerce`
- 경영진 1pager 요약 → `moai-bi`
- 주간 업무보고 → `moai-pm`
- B2B 제안서, RFP → `moai-sales`
- 한국 출판 원고 풀스택 → `moai-book`
- Claude Design 보조 → `moai-design`
- 개인 재무, 재테크 → `moai-wealth`
- 회고, 목표, 시간, 습관 → `moai-productivity`
- 직장 커뮤니케이션, 보고, 회의, 피드백 → `moai-comms`
- 초기화, 라우팅, AI 슬롭 검수, 피드백, MCP 커넥터 → `moai-core`

## 워크플로우

### 커맨드 표면

init 서브커맨드는 생략 가능 — bare `/project`가 초기화 기본 동작입니다. (`/project init`은 레거시 별칭으로 계속 인식)

| 커맨드 | 동작 |
|--------|------|
| `/project` (서브커맨드 없이) | 초기화 워크플로우 실행 (Phase 1-8). **PRIMARY 기본 동작.** |
| `/project resume` | 설치 완료 후 재개 (구 `/project init resume`) |
| `/project catalog` | 플러그인·스킬 카탈로그 |
| `/project status` | 현재 설정 상태 |
| `/project apikey` | API 키 관리 |
| `/project doctor` | 환경 진단 |
| `/project feedback` | GitHub 이슈 등록 |

**LEGACY 별칭** (계속 인식, 비파괴): `/project init` ≡ bare `/project`; `/project init resume` ≡ `/project resume`.

### /project — 초기화(새 워크플로우 생성)

> 진입점은 서브커맨드 없는 bare `/project`입니다. `/project init`은 레거시 별칭으로 동일하게 동작합니다.

```
Phase 1: Interview (최대 3질문)
  ① 이 프로젝트에서 어떤 일을 하시나요?
  ② 주로 만드는 산출물은 무엇인가요? (블로그/사업계획서/계약서/…)
  ③ 특별히 지키고 싶은 톤·형식·제약이 있나요?

Phase 2: Inventory (cowork-plugins 마켓플레이스 스킬만 인벤토리 구성)
  - 소스 A: Bash로 `~/.claude/plugins/` 안에서 **modu-ai/cowork-plugins 마켓플레이스 출처 플러그인만** 필터링
    · 필터링 규칙: 디렉토리명이 `moai-*` 패턴이면서, 그 안의 `.claude-plugin/plugin.json`이 cowork-plugins 27 플러그인 화이트리스트에 포함되는 경우만 인정
    · 27 플러그인 화이트리스트: moai-core, moai-business, moai-marketing, moai-legal, moai-finance,
      moai-hr, moai-content, moai-operations, moai-education, moai-lifestyle, moai-product,
      moai-support, moai-office, moai-career, moai-data, moai-public-data, moai-research, moai-media,
      moai-commerce, moai-bi, moai-pm, moai-sales, moai-book, moai-design, moai-wealth,
      moai-productivity, moai-comms
    · 위 27개 외 다른 출처 플러그인(예: 사용자가 별도 마켓플레이스에서 설치한 플러그인)은 인벤토리에서 **완전 제외**
  - 필터링된 각 cowork 플러그인 안의 **모든 SKILL.md** 완전 스캔
    · 명령: `find ~/.claude/plugins/<plugin>/skills -maxdepth 2 -name SKILL.md`
    · 각 SKILL.md frontmatter에서 `name` 필드 추출 → 인벤토리에 등록
  - 소스 B: 현재 세션 system reminder "user-invocable skills" 목록 (cowork-plugins 출처만 필터)
  - 두 소스 교차 검증 → 활성 스킬 인벤토리 구성
  - 에이전트 인벤토리: 각 플러그인 agents/*.md 동적 스캔 → agents_available (코디네이터, Cowork 전용)
  - .moai/cache/inventory.json에 저장 (스킬명·에이전트명 → cowork 플러그인 매핑)

Phase 3: Chain Design (핵심) — 코디네이터 우선(agent-aware)
  - 코디네이터 우선: 매칭 코디네이터 에이전트가 있으면 우선 추천, 없으면 인라인 스킬 체인
  - 예: 사업계획서 = business-plan-coordinator(에이전트) / 폴백 strategy-planner → pptx-designer → ai-slop-reviewer
  - 예: 블로그 발행 = blog → ai-slop-reviewer (단순 — 코디네이터 불요)
  - 텍스트 산출물 체인은 항상 ai-slop-reviewer로 종료 (코디네이터가 내부 처리 시 중복 금지)

Phase 3.5: Agent Synthesis (선택 — 기존 코디네이터가 없을 때만 신규 생성)
  - Step 0: 매칭되는 기존 코디네이터가 있으면 그것을 쓰고 신규 생성 안 함
  - 자격 워크플로우(고정 파이프라인+게이트 / 병렬 fan-out / 고빈도 반복) 중 기존 미커버만 후보
  - AskUserQuestion(multiSelect)로 선택 → ./.claude/agents/<name>.md 생성
  - 자격 체인 0건이거나 "생성 안 함" 선택 시 건너뜀 (additive)
  - 디스크 작성 에이전트는 새 세션(또는 /reload-plugins)에서 활성화

Phase 4: Gap Detection (누락 감지 — 신규)
  - Phase 3 체인의 각 스킬이 Phase 2 inventory에 있는지 검증
  - 누락 스킬 발견 시:
    · 누락 스킬 → 소속 플러그인 매핑 표 생성
    · .moai/cache/init-progress.json에 진행 상태 저장 (Phase 1-3 결과)
    · AskUserQuestion 4 옵션 제시:
      1. (권장) 설치 안내 + 완료 후 재개 — 설치 명령 표시 후 대기
      2. 누락 스킬 제외하고 진행 — 해당 체인 단계 생략
      3. 대체 스킬로 변경 — 인벤토리에서 유사 스킬 추천
      4. 중단
  - 모두 설치됨 → Phase 5로 진행

Phase 5: Confirm
  - AskUserQuestion으로 체인 설계 승인 요청
  - 수정 / 승인 / 취소 선택지 제공

Phase 6: Generate CLAUDE.md
  - references/templates/CLAUDE.md.tmpl 기반 생성
  - Interview 결과를 페르소나·워크플로우 섹션에 주입
  - 승인된 스킬 체인을 "워크플로우" 섹션에 명시
  - office/web/ai-slop HARD 규칙 고정 포함
  - 최대 200라인

Phase 7: API Key (필요 시)
  - 선택된 플러그인이 요구하는 API 키만 선택적으로 등록 안내

Phase 8: First Run
  - 첫 작업 예시 3개를 스킬 체인 기반으로 동적 생성 후 안내
```

상세 프로토콜: `references/core/init-protocol.md`

### /project resume — 설치 완료 후 재개

> 구 `/project init resume`의 레거시 별칭으로 계속 인식됩니다.

```
진입 패턴:
  - "/project resume" 명시적 커맨드 (레거시 별칭 "/project init resume"도 인식