@dusky-bluehour/agent-service 0.6.2 → 0.6.4

package/README.md

@@ -1,5 +1,9 @@
 # tri-agent-manager
 
+```bash
+pnpm dlx --package=@dusky-bluehour/agent-service tri-agent-manager --interactive
+```
+
 Claude Code, Antigravity, Codex에서 공통으로 사용하실 수 있는 서비스 운영형 스킬/워크플로우 패키지입니다.
 
 ## 목적
@@ -128,12 +132,25 @@ pnpm dlx tri-agent-manager --interactive
 
 위 한 줄로 아래를 터미널에서 순서대로 선택하실 수 있습니다.
 
-1. 설치 경로
+1. 설치 경로 (현재 위치 또는 직접 입력)
 2. 프리셋
 3. 도구(Claude Code/Antigravity/Codex)
 4. 구성요소(스킬, 워크플로우 등)
 5. 실행 확인
 
+도구별 실제 설치 루트:
+
+- Claude Code: `<target>/.claude/*`
+- Antigravity: `<target>/.agent/*`
+- Codex: `<target>/.codex/*`
+- 설치 직후 사용 가이드 자동 생성: `<target>/.tri-agent-manager/USAGE.ko.md`
+
+설치 경로 기준(근거 문서):
+
+- Claude Code: `claude-code/README.md` + Claude Code Subagents 공식 문서
+- Antigravity: `antigravity/README.md` 기준의 로컬 워크스페이스 규약(`.agent/*`)
+- Codex: `codex/README.md` + Codex 공식 문서
+
 조작 키:
 
 - `↑/↓`: 이동
@@ -167,12 +184,45 @@ npx tri-agent-manager update --interactive
 - `--preset`: 미리 정의된 구성을 선택합니다.
 - `--tool`: 툴을 직접 선택합니다. (`codex,claude-code` 등)
 - `--components`: 구성요소를 직접 선택합니다. (`skills,workflows,commands` 등)
+- `--install-root`: 도구별 설치 루트를 직접 지정합니다. (`codex=.codex,antigravity=.agent`)
 - `--interactive`: 한글 대화형 선택 UI를 사용합니다.
 - `--dry-run`: 실제 반영 없이 계획만 확인합니다.
 - `--yes`: 확인 프롬프트를 생략합니다.
 
 중복 선택 입력(예: `codex,codex,claude-code`)은 자동으로 1회로 정리됩니다.
 
+### 다른 폴더에 설치하는 명령어
+
+```bash
+# 1) 전체 프리셋을 다른 프로젝트 경로에 설치
+pnpm dlx --package=@dusky-bluehour/agent-service tri-agent-manager install \
+  --preset full-suite \
+  --target /path/to/your-project \
+  --yes --non-interactive
+```
+
+```bash
+# 2) 특정 도구만 설치 (예: Antigravity)
+pnpm dlx --package=@dusky-bluehour/agent-service tri-agent-manager install \
+  --tool antigravity \
+  --components skills,agents,artifacts,workflows,commands \
+  --target /path/to/your-project \
+  --yes --non-interactive
+```
+
+```bash
+# 3) 도구별 설치 루트를 커스텀
+pnpm dlx --package=@dusky-bluehour/agent-service tri-agent-manager install \
+  --preset balanced-core \
+  --install-root codex=.codex,claude-code=.claude,antigravity=.agent \
+  --target /path/to/your-project \
+  --yes --non-interactive
+```
+
+설치 후 실행 가이드는 아래 파일에서 확인하실 수 있습니다.
+
+- `<target>/.tri-agent-manager/USAGE.ko.md`
+
 ## 프리셋
 
 - `balanced-core`: 기본 운영팩(추천)

package/antigravity/workflows/workflow-catalog.json

@@ -7,8 +7,8 @@
   "workflows": [
     {
       "id": "WF-SVC-001",
-      "name": "Plan-Implement-Test-Review-Release",
-      "summary": "신규 서비스 또는 대형 기능 배치에 사용하는 기본 운영 파이프라인",
+      "name": "서비스 E2E 파이프라인 (Plan→Implement→Test→Review→Release)",
+      "summary": "신규 서비스 또는 대형 기능 배치에 사용하는 기본 운영 파이프라인입니다.",
       "orchestrator": "manager-agent",
       "stages": [
         {
@@ -91,12 +91,13 @@
       "final_outputs": [
         "ART-RELEASE-READY",
         "ART-OPERATIONS-HANDBOOK"
-      ]
+      ],
+      "when_to_use": "신규 서비스, 대형 기능 릴리즈"
     },
     {
       "id": "WF-SVC-002",
-      "name": "반복 프론트엔드 개선",
-      "summary": "UI 컴포넌트화, Hook 분리, 최적화를 단일 체인으로 실행",
+      "name": "반복 프론트엔드 개선 (UI→Hook→성능)",
+      "summary": "UI 컴포넌트화, Hook 분리, 성능 최적화를 단일 체인으로 실행합니다.",
       "orchestrator": "manager-agent",
       "stages": [
         {
@@ -142,12 +143,13 @@
       ],
       "final_outputs": [
         "ART-PERF-IMPROVED"
-      ]
+      ],
+      "when_to_use": "프론트 구조 개선, 성능 개선"
     },
     {
       "id": "WF-SVC-003",
-      "name": "보안 강화 배치",
-      "summary": "위협 모델링과 취약점 감사 기반의 하드닝",
+      "name": "보안 강화 배치 (진단→보완→검증)",
+      "summary": "위협 모델링과 취약점 감사 기반 하드닝을 수행합니다.",
       "orchestrator": "manager-agent",
       "stages": [
         {
@@ -195,12 +197,13 @@
       ],
       "final_outputs": [
         "ART-SECURITY-VERIFIED"
-      ]
+      ],
+      "when_to_use": "정기 보안 배치, 취약점 대응"
     },
     {
       "id": "WF-SVC-004",
-      "name": "장애 대응-재발 방지",
-      "summary": "Incident triage 이후 근본 원인 수정까지 수행",
+      "name": "장애 대응/재발 방지 (트리아지→근본수정→포스트모템)",
+      "summary": "Incident triage 이후 근본 원인 수정과 후속 조치까지 수행합니다.",
       "orchestrator": "incident-manager-agent",
       "stages": [
         {
@@ -249,12 +252,13 @@
       ],
       "final_outputs": [
         "ART-POSTMORTEM-PACK"
-      ]
+      ],
+      "when_to_use": "운영 장애 대응, RCA 필요 이슈"
     },
     {
       "id": "WF-PRD-IMPLEMENT-E2E",
-      "name": "PRD 대화형 작성 후 순차 자동 구현",
-      "summary": "Manager가 PRD 대화형 단계와 구현 자동 단계를 분리 오케스트레이션",
+      "name": "PRD 대화형 작성→순차 자동 구현",
+      "summary": "Manager가 PRD 대화형 단계와 구현 자동 단계를 분리 오케스트레이션합니다.",
       "orchestrator": "manager-agent",
       "stages": [
         {
@@ -356,7 +360,8 @@
         "ART-PRD-MASTER",
         "ART-PRD-DETAILS",
         "ART-RELEASE-READY"
-      ]
+      ],
+      "when_to_use": "PRD 기반 구현 자동화"
     }
   ]
 }

package/catalog/tool-catalog.ko.json

@@ -10,35 +10,46 @@
       "title": "Claude Code",
       "description": "서브에이전트/에이전트팀 중심으로 역할 분리를 강하게 적용하는 운영 구조",
       "root": "claude-code",
+      "install_root": ".claude",
+      "install_root_basis": "Claude Code 공식 가이드와 포함 README의 로컬 경로 규칙",
+      "install_root_reference": [
+        "claude-code/README.md",
+        "https://docs.anthropic.com/en/docs/claude-code/sub-agents"
+      ],
       "readme": "README.md",
       "components": [
         {
           "id": "skills",
           "path": "skills",
+          "install_path": "skills",
           "title": "스킬",
           "description": "수명주기, 리뷰, 보안, 릴리즈 등의 실행 규칙"
         },
         {
           "id": "subagents",
           "path": "subagents",
+          "install_path": "agents",
           "title": "서브에이전트",
           "description": "역할별 프롬프트 템플릿(리드, 백엔드, 보안, SRE 등)"
         },
         {
           "id": "agent-teams",
           "path": "agent-teams",
+          "install_path": "agent-teams",
           "title": "서브에이전트 팀",
           "description": "리드+전문가 협업 팀 구성과 기본 워크플로우 매핑"
         },
         {
           "id": "workflows",
           "path": "workflows",
+          "install_path": "workflows",
           "title": "워크플로우",
           "description": "기획-개발-검증-배포-운영 단계형 시나리오"
         },
         {
           "id": "commands",
           "path": "commands",
+          "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "입력/실행/품질게이트/산출물 계약이 고정된 명령 집합"
         }
@@ -49,35 +60,45 @@
       "title": "Antigravity",
       "description": "Manager-Agent-Artifact 기반 오케스트레이션 구조",
       "root": "antigravity",
+      "install_root": ".agent",
+      "install_root_basis": "Antigravity 생태계의 워크스페이스 로컬 규약(.agent/*)을 기본값으로 사용",
+      "install_root_reference": [
+        "antigravity/README.md"
+      ],
       "readme": "README.md",
       "components": [
         {
           "id": "skills",
           "path": "skills",
+          "install_path": "skills",
           "title": "스킬",
           "description": "Plan-Implement-Test-Review-Release 실행 규칙"
         },
         {
           "id": "agents",
           "path": "agents",
+          "install_path": "agents",
           "title": "에이전트 카탈로그",
           "description": "Manager/Implementation/Review 등 역할 라우팅 정의"
         },
         {
           "id": "artifacts",
           "path": "artifacts",
+          "install_path": "artifacts",
           "title": "아티팩트 계약",
           "description": "단계 입출력 스키마와 검증 필수 필드"
         },
         {
           "id": "workflows",
           "path": "workflows",
+          "install_path": "workflows",
           "title": "워크플로우",
           "description": "에이전트 체인과 단계 게이트 정의"
         },
         {
           "id": "commands",
           "path": "commands",
+          "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "공통 명령 계약"
         }
@@ -88,35 +109,46 @@
       "title": "Codex",
       "description": "Skills + AGENTS + Automations를 결합한 운영 구조",
       "root": "codex",
+      "install_root": ".codex",
+      "install_root_basis": "Codex 스킬/지침 문서의 프로젝트 로컬 경로 규칙",
+      "install_root_reference": [
+        "codex/README.md",
+        "https://developers.openai.com/codex/"
+      ],
       "readme": "README.md",
       "components": [
         {
           "id": "skills",
           "path": "skills",
+          "install_path": "skills",
           "title": "스킬",
           "description": "작업 유형별 실행 스킬"
         },
         {
           "id": "instructions",
           "path": "instructions",
+          "install_path": "instructions",
           "title": "AGENTS 템플릿",
           "description": "프로젝트별 AGENTS 규칙 기본/오버라이드 템플릿"
         },
         {
           "id": "automations",
           "path": "automations",
+          "install_path": "automations",
           "title": "자동화 레시피",
           "description": "주기 점검/리뷰/보안 배치 프리셋"
         },
         {
           "id": "workflows",
           "path": "workflows",
+          "install_path": "workflows",
           "title": "워크플로우",
           "description": "Codex 실행 명령(/plan,/review) 연계 단계 정의"
         },
         {
           "id": "commands",
           "path": "commands",
+          "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "공통 명령 계약"
         }

package/claude-code/workflows/workflow-catalog.json

@@ -7,8 +7,8 @@
   "workflows": [
     {
       "id": "WF-SVC-001",
-      "name": "신규 서비스 기획-개발-배포 E2E",
-      "summary": "초기 기획부터 운영 전환까지 하나의 흐름으로 통제한다.",
+      "name": "신규 서비스 E2E (기획→개발→검증→운영 전환)",
+      "summary": "초기 기획부터 운영 전환까지 리드+전문가 구조로 통제합니다.",
       "team_mode": "lead-plus-specialists",
       "stages": [
         {
@@ -121,12 +121,13 @@
         "서비스 릴리즈",
         "운영 핸드북",
         "품질/보안 리포트"
-      ]
+      ],
+      "when_to_use": "신규 서비스 런칭, 대형 기능 롤아웃"
     },
     {
       "id": "WF-SVC-002",
-      "name": "기능 개발 표준",
-      "summary": "기존 서비스에 기능을 추가할 때 사용한다.",
+      "name": "기능 개발 표준 (범위→개발→QA)",
+      "summary": "기존 서비스 기능 추가에 맞춘 표준 실행 흐름입니다.",
       "team_mode": "lead-plus-specialists",
       "stages": [
         {
@@ -190,12 +191,13 @@
       ],
       "final_outputs": [
         "기능 릴리즈 준비 완료"
-      ]
+      ],
+      "when_to_use": "일반 기능 개발, 스프린트 단위 구현"
     },
     {
       "id": "WF-SVC-003",
-      "name": "코드 리뷰-개선 루프",
-      "summary": "품질 저하 징후가 보이면 즉시 실행한다.",
+      "name": "코드 리뷰/개선 루프 (진단→수정→재검증)",
+      "summary": "품질 저하 징후가 보이면 리뷰와 개선 루프를 즉시 닫습니다.",
       "team_mode": "parallel-review",
       "stages": [
         {
@@ -263,12 +265,13 @@
       "final_outputs": [
         "개선 반영 PR",
         "재검증 통과 보고"
-      ]
+      ],
+      "when_to_use": "PR 리뷰 강화, 품질 하락 대응"
     },
     {
       "id": "WF-SVC-004",
-      "name": "보안 강화 배치",
-      "summary": "정기 또는 이슈 발생 시 보안 점검을 집중 수행한다.",
+      "name": "보안 강화 배치 (위협모델→보완→검증)",
+      "summary": "정기 또는 이슈 기반 보안 점검을 집중 수행합니다.",
       "team_mode": "security-first",
       "stages": [
         {
@@ -331,12 +334,13 @@
       "final_outputs": [
         "보안 점검 결과",
         "보완 이력"
-      ]
+      ],
+      "when_to_use": "보안 감사, 취약점 대응 배치"
     },
     {
       "id": "WF-SVC-005",
-      "name": "배포 및 운영 전환",
-      "summary": "릴리즈 직전 게이트와 운영 전환을 통합한다.",
+      "name": "배포/운영 전환 (게이트→배포→모니터링)",
+      "summary": "릴리즈 직전 게이트와 운영 전환을 통합해 실행합니다.",
       "team_mode": "release-train",
       "stages": [
         {
@@ -396,12 +400,13 @@
       "final_outputs": [
         "배포 로그",
         "운영 전환 문서"
-      ]
+      ],
+      "when_to_use": "정기 릴리즈, 운영 전환 준비"
     },
     {
       "id": "WF-SVC-006",
-      "name": "반복 리팩터링 패키지",
-      "summary": "UI 컴포넌트화, Hook 분리, 성능 최적화를 묶어서 실행한다.",
+      "name": "반복 리팩터링 패키지 (UI→Hook→성능)",
+      "summary": "반복 프론트엔드 개선 작업을 한 번에 실행합니다.",
       "team_mode": "frontend-special-pack",
       "stages": [
         {
@@ -461,12 +466,13 @@
       "final_outputs": [
         "중복 축소 보고",
         "성능 개선 보고"
-      ]
+      ],
+      "when_to_use": "컴포넌트화, Hook 분리, 성능 개선"
     },
     {
       "id": "WF-SVC-007",
-      "name": "장애 대응 및 재발 방지",
-      "summary": "장애 발생 시 복구와 재발 방지를 한 세트로 실행한다.",
+      "name": "장애 대응/재발 방지 (복구→원인분석→후속조치)",
+      "summary": "장애 발생 시 복구와 재발 방지를 한 세트로 수행합니다.",
       "team_mode": "incident-war-room",
       "stages": [
         {
@@ -530,12 +536,13 @@
       "final_outputs": [
         "장애 RCA",
         "재발 방지 실행 계획"
-      ]
+      ],
+      "when_to_use": "서비스 장애, 긴급 운영 이슈"
     },
     {
       "id": "WF-PRD-IMPLEMENT-E2E",
-      "name": "PRD 대화형 작성 후 순차 자동 구현",
-      "summary": "PRD는 대화형으로 고도화하고, 구현은 최종 수동 설정 전까지 순차 자동 실행한다.",
+      "name": "PRD 대화형 작성→순차 자동 구현",
+      "summary": "PRD를 대화형으로 고도화하고 구현은 최종 수동 설정 전까지 자동 실행합니다.",
       "team_mode": "prd-to-production-pipeline",
       "stages": [
         {
@@ -674,7 +681,8 @@
         "PRD 묶음",
         "순차 구현 결과",
         "배포 준비 패키지"
-      ]
+      ],
+      "when_to_use": "PRD 기반 대형 기능 자동 구현"
     }
   ]
 }

package/codex/workflows/workflow-catalog.json

@@ -7,8 +7,8 @@
   "workflows": [
     {
       "id": "WF-SVC-001",
-      "name": "신규 서비스 E2E",
-      "summary": "Codex 단일 실행으로 기획부터 배포 준비까지 진행한다.",
+      "name": "신규 서비스 전체 사이클 (기획→구현→검증→배포 준비)",
+      "summary": "새 프로젝트 또는 대형 기능을 기획부터 배포 준비까지 한 번에 진행할 때 사용합니다.",
       "execution_surface": [
         "local",
         "cloud"
@@ -86,12 +86,13 @@
         "배포 후보",
         "운영 문서",
         "검증 보고"
-      ]
+      ],
+      "when_to_use": "신규 서비스 착수, 대형 기능 E2E 추진"
     },
     {
       "id": "WF-SVC-002",
-      "name": "기능 개발 표준",
-      "summary": "반복 기능 개발에 사용한다.",
+      "name": "기능 추가 표준 (범위 고정→구현→리뷰)",
+      "summary": "기존 서비스에 일반 기능을 안전하게 추가하는 표준 흐름입니다.",
       "execution_surface": [
         "local",
         "worktree"
@@ -145,12 +146,13 @@
       ],
       "final_outputs": [
         "병합 가능 PR"
-      ]
+      ],
+      "when_to_use": "일반 기능 개발, 반복 개발 사이클"
     },
     {
       "id": "WF-SVC-003",
-      "name": "보안 하드닝",
-      "summary": "정기 보안 배치 또는 취약점 이슈 대응에 사용한다.",
+      "name": "보안 하드닝 (진단→보완→재검증)",
+      "summary": "보안 진단 후 코드 보완과 재검증까지 닫는 흐름입니다.",
       "execution_surface": [
         "local",
         "cloud"
@@ -204,12 +206,13 @@
       ],
       "final_outputs": [
         "보안 개선 보고"
-      ]
+      ],
+      "when_to_use": "정기 보안 점검, 취약점 이슈 대응"
     },
     {
       "id": "WF-SVC-004",
-      "name": "배포-운영 전환",
-      "summary": "배포와 운영 안정화를 묶어서 실행한다.",
+      "name": "배포/운영 전환 (게이트→배포→인수인계)",
+      "summary": "릴리즈 게이트 통과부터 운영 안정화 및 인수인계까지 진행합니다.",
       "execution_surface": [
         "local",
         "cloud"
@@ -261,12 +264,13 @@
       ],
       "final_outputs": [
         "운영 전환 완료"
-      ]
+      ],
+      "when_to_use": "릴리즈 직전 최종 점검, 운영 전환"
     },
     {
       "id": "WF-SVC-005",
-      "name": "장애 대응 루프",
-      "summary": "장애 접수부터 재발 방지까지 수행한다.",
+      "name": "장애 대응 루프 (분류→복구→재발 방지)",
+      "summary": "장애 접수 후 복구와 재발 방지 조치까지 수행합니다.",
       "execution_surface": [
         "local",
         "cloud"
@@ -322,12 +326,13 @@
       "final_outputs": [
         "RCA",
         "재발 방지 백로그"
-      ]
+      ],
+      "when_to_use": "운영 장애 대응, 핫픽스 후속 조치"
     },
     {
       "id": "WF-PRD-IMPLEMENT-E2E",
-      "name": "PRD 대화형 작성 후 순차 자동 구현",
-      "summary": "PRD 단계는 대화형으로, 구현 단계는 최종 세팅 전까지 자동 순차 실행",
+      "name": "PRD 대화형 작성→순차 자동 구현",
+      "summary": "PRD는 대화형으로 확정하고 구현은 최종 수동 세팅 전까지 자동 순차 실행합니다.",
       "execution_surface": [
         "local",
         "cloud"
@@ -438,7 +443,8 @@
         "PRD 패키지",
         "구현 결과",
         "배포 준비 패키지"
-      ]
+      ],
+      "when_to_use": "요구사항이 큰 신규 기능을 PRD 기반으로 자동 추진"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dusky-bluehour/agent-service",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "publishConfig": {
     "access": "public"
   },