@dusky-bluehour/agent-service 0.6.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# tri-agent-manager
+
+Claude Code, Antigravity, Codex에서 공통으로 사용하실 수 있는 서비스 운영형 스킬/워크플로우 패키지입니다.
+
+## 목적
+
+- 기획(PRD) → 설계 → 개발 → 코드리뷰/보안 → 배포/운영까지 동일한 품질 기준으로 실행하실 수 있습니다.
+- 반복 작업(UI 컴포넌트화, Hook 분리, 최적화)을 역할/명령 단위로 고정해 일관성을 높입니다.
+- 툴이 달라도 동일한 계약(명령 ID, 품질 게이트, 워크플로우)으로 결과를 맞출 수 있습니다.
+
+## 용어 설명
+
+| 용어 | 의미 |
+| --- | --- |
+| Skill | 작업 방식/규칙을 담은 실행 단위입니다. 툴마다 포맷은 다르지만 역할은 같습니다. |
+| Workflow | 단계형 실행 시나리오입니다. 각 단계는 진입/종료 조건을 가집니다. |
+| Command Contract | 입력/실행/품질게이트/산출물을 고정한 명령 계약입니다. |
+| Agent / Subagent | 역할별 실행 주체입니다. 리드가 전문 역할에 위임할 수 있습니다. |
+| Artifact (Antigravity) | 단계 입출력 계약 문서입니다. 스키마 검증 통과 후 다음 단계로 진행합니다. |
+| PRD→구현 파이프라인 | PRD는 대화형으로 작성하고, 구현은 최종 수동 세팅 전까지 순차 자동 실행합니다. |
+
+## 핵심 기능
+
+| 기능 | 설명 | 관련 워크플로우 |
+| --- | --- | --- |
+| 표준 E2E 딜리버리 | 기획부터 배포 준비까지 표준 단계를 실행합니다. | `WF-SVC-001` |
+| 코드리뷰/개선 루프 | 리뷰 지적 → 수정 → 재검증 루프를 수행합니다. | `WF-SVC-003` / `WF-SVC-002` |
+| 보안 하드닝 | 위협 모델링 + 취약점 감사 + 재검증을 수행합니다. | `WF-SVC-004` / `WF-SVC-003` |
+| 반복 프론트 개선 | 컴포넌트화, Hook 분리, 성능 최적화를 진행합니다. | `WF-SVC-006` / `WF-SVC-002` |
+| 장애 대응 | 복구, RCA, 재발 방지를 수행합니다. | `WF-SVC-007` / `WF-SVC-005` |
+| PRD→구현 자동 파이프라인 | PRD 대화형 작성 후 구현을 자동 순차 실행합니다. | `WF-PRD-IMPLEMENT-E2E` |
+
+## 목록 (토글)
+
+<details>
+<summary><strong>Claude Code - Skills</strong></summary>
+
+| Skill | 목적 |
+| --- | --- |
+| `service-lifecycle-orchestration` | 기획~배포 전체 수명주기를 실행합니다. |
+| `code-review-and-improvement` | 리뷰/개선 루프를 실행합니다. |
+| `security-hardening` | 위협/취약점 기반 보안 강화를 수행합니다. |
+| `frontend-repetition-pack` | UI 컴포넌트화/Hook/최적화를 수행합니다. |
+| `release-and-operations` | 배포/모니터링/인수인계를 수행합니다. |
+| `incident-response` | 장애 대응~재발 방지를 수행합니다. |
+| `prd-to-production-pipeline` | PRD 대화형 작성 후 순차 자동 구현을 수행합니다. |
+
+</details>
+
+<details>
+<summary><strong>Claude Code - Subagents</strong></summary>
+
+| Subagent | 역할 |
+| --- | --- |
+| `lead-orchestrator` | 전체 단계를 오케스트레이션합니다. |
+| `prd-writer` | 마스터/세부 PRD를 작성합니다. |
+| `product-planner` | 요구사항 잠금/범위 관리를 수행합니다. |
+| `solution-architect` | ADR/기술 경계를 정의합니다. |
+| `backend-engineer` | 계약 우선 API 구현을 수행합니다. |
+| `frontend-engineer` | 프론트 기능 구현을 수행합니다. |
+| `ui-component-engineer` | 반복 UI를 컴포넌트화합니다. |
+| `hook-refactor-engineer` | Hook 분리/정규화를 수행합니다. |
+| `performance-engineer` | 성능 병목을 개선합니다. |
+| `qa-engineer` | 테스트/회귀 차단을 수행합니다. |
+| `code-reviewer` | 코드리뷰/개선안을 도출합니다. |
+| `security-engineer` | 위협/취약점 대응을 수행합니다. |
+| `sre-release-engineer` | CI/CD 게이트/배포를 수행합니다. |
+| `operations-owner` | 운영 대시보드/런북을 관리합니다. |
+| `incident-commander` | 장애 워룸/복구 우선순위를 관리합니다. |
+
+</details>
+
+<details>
+<summary><strong>Antigravity - Skills / Agents</strong></summary>
+
+| 타입 | ID | 설명 |
+| --- | --- | --- |
+| Skill | `service-lifecycle-orchestration` | Plan-Implement-Test-Review-Release를 실행합니다. |
+| Skill | `code-review-and-improvement` | 리뷰/개선 루프를 실행합니다. |
+| Skill | `security-hardening` | 보안 하드닝을 수행합니다. |
+| Skill | `frontend-repetition-pack` | 프론트 반복 개선을 수행합니다. |
+| Skill | `release-and-operations` | 배포/운영 전환을 수행합니다. |
+| Skill | `incident-response` | 장애 대응을 수행합니다. |
+| Skill | `prd-to-production-pipeline` | PRD 대화형→자동 구현을 수행합니다. |
+| Agent | `manager-agent` | 기본 오케스트레이터 역할을 수행합니다. |
+| Agent | `prd-writer-agent` | PRD 대화형 작성을 수행합니다. |
+| Agent | `implementation-agent` | 구현 자동 실행을 수행합니다. |
+| Agent | `review-security-agent` | 리뷰/보안 검증을 수행합니다. |
+| Agent | `release-ops-agent` | 최종 세팅/배포를 수행합니다. |
+
+</details>
+
+<details>
+<summary><strong>Codex - Skills</strong></summary>
+
+| Skill | 목적 |
+| --- | --- |
+| `service-lifecycle-orchestration` | 기획~배포 표준 실행을 수행합니다. |
+| `code-review-and-improvement` | 리뷰/개선 루프를 수행합니다. |
+| `security-hardening` | 보안 강화를 수행합니다. |
+| `frontend-repetition-pack` | UI/Hook/성능 개선을 수행합니다. |
+| `release-and-operations` | 릴리즈/운영 전환을 수행합니다. |
+| `incident-response` | 장애 대응을 수행합니다. |
+| `prd-to-production-pipeline` | PRD 대화형→순차 자동 구현을 수행합니다. |
+
+</details>
+
+## PRD→구현 자동 파이프라인 (신규)
+
+- 워크플로우: `WF-PRD-IMPLEMENT-E2E`
+- 단계:
+  1. 마스터 PRD 작성 (`CMD-PLAN-PRD-MASTER`) - 대화형
+  2. 세부 PRD 분해 (`CMD-PLAN-PRD-DETAILS`) - 대화형
+  3. 구현 부트스트랩 (`CMD-PLAN-IMPLEMENTATION-BOOTSTRAP`) - 대화형
+  4. 순차 자동 구현 (`CMD-DEV-SEQUENTIAL-AUTORUN`) - 자동
+  5. 검증/보안 - 자동
+  6. 최종 세팅/배포 준비 - 수동
+
+PRD 단계에서는 UI 컴포넌트화, 톤앤매너, 성능, 보안, 가독성 기준을 명시하시고, 자동 단계에서는 배치별 검증을 통과해야 다음 배치로 진행됩니다.
+
+## 설치/업데이트 사용법
+
+### 가장 쉬운 시작 (pnpm dlx, 전부 대화형)
+
+```bash
+pnpm dlx tri-agent-manager --interactive
+```
+
+위 한 줄로 아래를 터미널에서 순서대로 선택하실 수 있습니다.
+
+1. 설치 경로
+2. 프리셋
+3. 도구(Claude Code/Antigravity/Codex)
+4. 구성요소(스킬, 워크플로우 등)
+5. 실행 확인
+
+조작 키:
+
+- `↑/↓`: 이동
+- `←/→`: 해제/선택 또는 항목 이동
+- `Space`: 다중 선택 토글
+- `Enter`: 확정
+
+업데이트도 동일하게 대화형으로 진행하실 수 있습니다.
+
+```bash
+pnpm dlx tri-agent-manager update --interactive
+```
+
+`setup` 별칭도 동일하게 동작합니다.
+
+```bash
+pnpm dlx tri-agent-manager setup
+```
+
+### npm 사용 시
+
+```bash
+npx tri-agent-manager --interactive
+npx tri-agent-manager update --interactive
+```
+
+이전 CLI 별칭 `tri-agent-os`도 호환용으로 함께 제공됩니다.
+
+### 고급 옵션(필요한 경우)
+
+- `--preset`: 미리 정의된 구성을 선택합니다.
+- `--tool`: 툴을 직접 선택합니다. (`codex,claude-code` 등)
+- `--components`: 구성요소를 직접 선택합니다. (`skills,workflows,commands` 등)
+- `--interactive`: 한글 대화형 선택 UI를 사용합니다.
+- `--dry-run`: 실제 반영 없이 계획만 확인합니다.
+- `--yes`: 확인 프롬프트를 생략합니다.
+
+중복 선택 입력(예: `codex,codex,claude-code`)은 자동으로 1회로 정리됩니다.
+
+## 프리셋
+
+- `balanced-core`: 기본 운영팩(추천)
+- `full-suite`: 전체 설치
+- `security-first`: 보안 우선
+- `frontend-refactor`: 프론트 반복개선
+- `prd-to-production`: PRD→구현 자동 파이프라인
+
+## 체크리스트 자동화
+
+배포 전 자동 점검:
+
+```bash
+npm run prepublish:check
+```
+
+`prepublishOnly`가 설정되어 있어 `npm publish` 시에도 자동 실행됩니다.
+
+## 다음 단계 추천
+
+1. `pnpm dlx tri-agent-manager --interactive`로 `prd-to-production` 프리셋을 먼저 설치해 보세요.
+2. 첫 실행은 `--dry-run`으로 계획만 확인하신 뒤 실제 반영을 진행해 주세요.
+3. 반영 후 `npm run prepublish:check`로 검증을 고정하신 뒤 배포해 주세요.
+
+## 상세 구성 문서
+
+- 구조/설계/계약 상세: `docs/COMPOSITION.ko.md`
+- 대화형 UX 흐름 그림: `docs/UX-FLOW.ko.md`
+- 배포 절차 가이드: `docs/DEPLOYMENT-GUIDE.ko.md`
+- 업데이트 절차 가이드: `docs/UPDATE-GUIDE.ko.md`

package/antigravity/README.md

@@ -0,0 +1,37 @@
+# Antigravity 운영팩
+
+이 폴더는 Antigravity의 Manager-에이전트-Artifact 흐름을 기준으로, 서비스 운영 전체를 실행 가능한 형태로 정리한 패키지입니다.
+
+## 폴더 구성
+
+- `skills/`: 역할별 실행 스킬
+- `agents/agent-catalog.json`: 에이전트 역할 카탈로그
+- `artifacts/artifact-catalog.json`: 단계별 Artifact 계약
+- `workflows/workflow-catalog.json`: 오케스트레이션 워크플로우
+- `commands/command-catalog.json`: 공통 명령 계약
+
+## 빠른 시작
+
+1. `WF-SVC-001`(기본 E2E), `WF-SVC-004`(보안), `WF-PRD-IMPLEMENT-E2E`(PRD→구현) 등 목적별 워크플로우를 선택해 주세요.
+2. 각 단계의 `input_artifact` 필드를 먼저 검증해 주세요.
+3. 지정된 `agent`가 `commands`를 수행합니다.
+4. `output_artifact` 검증 후 다음 단계로 진행해 주세요.
+
+## 반복 작업 역할 분리
+
+- UI 컴포넌트화: `frontend-repetition-agent` + `CMD-DEV-FE-UI-COMPONENTIZE`
+- Hook 분리: `frontend-repetition-agent` + `CMD-DEV-FE-HOOK-SEPARATE`
+- 성능 최적화: `performance-agent` + `CMD-DEV-PERF-OPTIMIZE`
+- PRD 작성: `prd-writer-agent`
+
+## 운영 규칙
+
+- Manager 에이전트가 단계 전환 권한을 가집니다.
+- Artifact 검증 실패 시 단계 중단 후 원인 수정을 우선해 주세요.
+- 보안/배포 단계는 우회 없이 게이트를 통과해야 합니다.
+
+## 참고 문서 (검증일: 2026-02-17)
+
+- [Google Antigravity 발표](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
+- [Antigravity 공식 문서](https://antigravity.dev/docs)
+- [Antigravity 워크플로우 문서](https://antigravity.im/documentation)

package/antigravity/agents/agent-catalog.json

@@ -0,0 +1,72 @@
+{
+  "schema_version": "1.0.0",
+  "agents": [
+    {
+      "id": "prd-writer-agent",
+      "role": "PRD 작성",
+      "responsibility": "마스터 PRD와 세부 PRD를 대화형으로 작성하고 구현 수용 기준을 명시",
+      "default_workflows": [
+        "WF-PRD-IMPLEMENT-E2E"
+      ]
+    },
+    {
+      "id": "manager-agent",
+      "role": "오케스트레이터",
+      "responsibility": "워크플로우 단계 제어, 에이전트 체인 구성, Artifact 검증 게이트 실행",
+      "default_workflows": [
+        "WF-SVC-001",
+        "WF-SVC-002",
+        "WF-SVC-003"
+      ]
+    },
+    {
+      "id": "incident-manager-agent",
+      "role": "인시던트 오케스트레이터",
+      "responsibility": "장애 대응 워룸 흐름 제어",
+      "default_workflows": [
+        "WF-SVC-004"
+      ]
+    },
+    {
+      "id": "product-planner-agent",
+      "role": "기획",
+      "responsibility": "요구사항 잠금, 범위 제어, 승인 기준 명시"
+    },
+    {
+      "id": "implementation-agent",
+      "role": "개발",
+      "responsibility": "API 구현, UI 컴포넌트화, Hook 분리, 성능 최적화"
+    },
+    {
+      "id": "frontend-repetition-agent",
+      "role": "프론트 반복개선",
+      "responsibility": "UI 컴포넌트화와 Hook 분리 전담"
+    },
+    {
+      "id": "performance-agent",
+      "role": "성능",
+      "responsibility": "측정 기반 병목 제거와 전후 성능 검증"
+    },
+    {
+      "id": "qa-agent",
+      "role": "검증",
+      "responsibility": "단위/통합 테스트 고정과 회귀 차단"
+    },
+    {
+      "id": "review-security-agent",
+      "role": "리뷰/보안",
+      "responsibility": "코드 리뷰, 위협 모델링, 의존성 감사"
+    },
+    {
+      "id": "release-ops-agent",
+      "role": "배포/운영",
+      "responsibility": "CI/CD 게이트, 점진 배포, 모니터링, 인수인계"
+    }
+  ],
+  "routing_rules": [
+    "PRD 기반 구현 요청은 prd-writer-agent로 시작",
+    "반복 프론트 개선은 frontend-repetition-agent 우선",
+    "보안 이슈는 review-security-agent를 반드시 포함",
+    "배포 단계는 release-ops-agent 단독 승인"
+  ]
+}

package/antigravity/artifacts/artifact-catalog.json

@@ -0,0 +1,184 @@
+{
+  "schema_version": "1.0.0",
+  "artifacts": [
+    {
+      "id": "ART-REQUEST-BRIEF",
+      "required_fields": [
+        "문제정의",
+        "목표지표",
+        "제약사항"
+      ]
+    },
+    {
+      "id": "ART-SCOPE-ADR",
+      "required_fields": [
+        "범위",
+        "비범위",
+        "ADR",
+        "롤백전략"
+      ]
+    },
+    {
+      "id": "ART-IMPLEMENTATION-PACK",
+      "required_fields": [
+        "변경목록",
+        "테스트초안",
+        "리스크메모"
+      ]
+    },
+    {
+      "id": "ART-TEST-REPORT",
+      "required_fields": [
+        "실행결과",
+        "실패원인",
+        "재현절차"
+      ]
+    },
+    {
+      "id": "ART-QUALITY-SECURITY-REPORT",
+      "required_fields": [
+        "차단이슈",
+        "권고이슈",
+        "취약점결과"
+      ]
+    },
+    {
+      "id": "ART-RELEASE-READY",
+      "required_fields": [
+        "게이트결과",
+        "배포계획",
+        "모니터링계획"
+      ]
+    },
+    {
+      "id": "ART-OPERATIONS-HANDBOOK",
+      "required_fields": [
+        "런북",
+        "알림정책",
+        "인수인계체크리스트"
+      ]
+    },
+    {
+      "id": "ART-FRONTEND-BASELINE",
+      "required_fields": [
+        "중복UI목록",
+        "렌더링지표",
+        "리팩터대상"
+      ]
+    },
+    {
+      "id": "ART-COMPONENTIZED-UI",
+      "required_fields": [
+        "컴포넌트목록",
+        "Props계약",
+        "스토리"
+      ]
+    },
+    {
+      "id": "ART-HOOK-REFACTORED",
+      "required_fields": [
+        "Hook목록",
+        "입출력계약",
+        "테스트"
+      ]
+    },
+    {
+      "id": "ART-PERF-IMPROVED",
+      "required_fields": [
+        "전후지표",
+        "병목원인",
+        "개선내역"
+      ]
+    },
+    {
+      "id": "ART-SYSTEM-BOUNDARY",
+      "required_fields": [
+        "신뢰경계",
+        "자산목록",
+        "인증인가흐름"
+      ]
+    },
+    {
+      "id": "ART-SECURITY-GAPS",
+      "required_fields": [
+        "위협목록",
+        "취약점목록",
+        "우선순위"
+      ]
+    },
+    {
+      "id": "ART-HARDENED-BUILD",
+      "required_fields": [
+        "보완코드",
+        "영향분석",
+        "재검증계획"
+      ]
+    },
+    {
+      "id": "ART-SECURITY-VERIFIED",
+      "required_fields": [
+        "재검증결과",
+        "잔여위험",
+        "예외승인"
+      ]
+    },
+    {
+      "id": "ART-INCIDENT-ALERT",
+      "required_fields": [
+        "탐지시각",
+        "증상",
+        "영향범위"
+      ]
+    },
+    {
+      "id": "ART-INCIDENT-TIMELINE",
+      "required_fields": [
+        "타임라인",
+        "조치내역",
+        "복구시각"
+      ]
+    },
+    {
+      "id": "ART-ROOT-CAUSE-FIX",
+      "required_fields": [
+        "원인",
+        "수정내역",
+        "회귀검증"
+      ]
+    },
+    {
+      "id": "ART-POSTMORTEM-PACK",
+      "required_fields": [
+        "RCA",
+        "재발방지액션",
+        "담당자"
+      ]
+    },
+    {
+      "id": "ART-PRD-MASTER",
+      "required_fields": [
+        "문제정의",
+        "목표지표",
+        "기능범위",
+        "비기능요구사항"
+      ]
+    },
+    {
+      "id": "ART-PRD-DETAILS",
+      "required_fields": [
+        "에픽목록",
+        "세부기능PRD",
+        "수용기준",
+        "의존성순서"
+      ]
+    },
+    {
+      "id": "ART-IMPLEMENTATION-BOOTSTRAP",
+      "required_fields": [
+        "배치실행순서",
+        "자동실행범위",
+        "수동설정체크리스트"
+      ]
+    }
+  ]
+}