@dusky-bluehour/agent-service 0.6.7 → 0.6.8

package/gemini/README.md

@@ -0,0 +1,104 @@
+# Gemini CLI 운영팩
+
+Gemini CLI의 Extension 표준에 맞춰 서비스 운영 전체를 실행 가능한 형태로 제공하는 패키지입니다.
+
+> 이 폴더의 파일은 `npm run generate`로 `common/*`에서 자동 생성됩니다. 직접 수정하지 마세요.
+
+## 폴더 구성
+
+```
+gemini/
+  gemini-extension.json              Extension 매니페스트
+  skills/<name>/SKILL.md             8개 운영 스킬
+  agents/agent-catalog.json          에이전트 역할 카탈로그
+  artifacts/artifact-catalog.json    단계별 Artifact 계약
+  workflows/
+    workflow-catalog.json            5개 워크플로우 정의
+    definitions/*.workflow.yaml      실행용 워크플로우 YAML
+  commands/
+    command-catalog.json             공통 명령 계약 (SSOT)
+    definitions/*.toml               20개 커스텀 명령 (TOML 형식)
+  instructions/GEMINI.template.md    GEMINI.md 자동 생성 템플릿
+  settings/editor-policy.json        에디터 보안/권한 정책
+```
+
+## 설치 시 생성 구조
+
+프로젝트에 설치하면 `.gemini/` 아래에 위 파일이 배치되고, 프로젝트 루트에 `GEMINI.md`가 생성됩니다.
+
+```
+<project>/
+  .gemini/
+    skills/change-safety-review/SKILL.md
+    skills/code-review-and-improvement/SKILL.md
+    ...
+    agents/agent-catalog.json
+    artifacts/artifact-catalog.json
+    workflows/workflow-catalog.json
+    workflows/definitions/WF-SERVICE-E2E.workflow.yaml
+    ...
+    commands/definitions/cmd-dev-be-api.toml
+    ...
+    gemini-extension.json
+    instructions/GEMINI.template.md
+    settings/editor-policy.json
+  GEMINI.md                          컨텍스트 파일 (기존 파일 유지)
+```
+
+## 사용 방법
+
+### 스킬 사용
+
+8개 스킬은 각각 자체적으로 실행 가능한 상세 절차를 포함합니다.
+
+| 스킬 | 역할 |
+|------|------|
+| `change-safety-review` | 변경사항 회귀 검증 + 코드 리뷰 |
+| `code-review-and-improvement` | 코드 품질 개선 + 기술부채 정리 |
+| `frontend-repetition-pack` | UI 컴포넌트화 → Hook 분리 → 성능 최적화 |
+| `incident-response` | 장애 트리아지 → 근본원인 수정 → 포스트모템 |
+| `prd-to-production-pipeline` | PRD 작성 → 순차 자동 구현 |
+| `release-and-operations` | CI/CD 게이트 → 배포 → 모니터링 |
+| `security-hardening` | 위협 모델링 → 취약점 감사 → 하드닝 |
+| `service-lifecycle-orchestration` | 전체 수명주기 오케스트레이션 |
+
+### 워크플로우 실행
+
+워크플로우는 Gemini CLI에서만 네이티브 지원됩니다.
+
+1. 목적에 맞는 워크플로우를 선택합니다:
+   - `WF-SERVICE-E2E` — 신규 서비스/기능 E2E 파이프라인
+   - `WF-FRONTEND-REFACTOR` — 프론트엔드 반복 개선
+   - `WF-SECURITY-HARDENING` — 보안 강화 배치
+   - `WF-INCIDENT-RESPONSE` — 장애 대응/재발 방지
+   - `WF-PRD-TO-PRODUCTION` — PRD 기반 자동 구현
+
+2. 각 단계의 `input_artifact` 검증 후 지정 `agent`가 작업을 수행합니다.
+3. `output_artifact` 검증을 통과해야 다음 단계로 진행됩니다.
+4. `exit_criteria`를 모두 충족하면 단계가 완료됩니다.
+
+`definitions/` 디렉토리에서 워크플로우 ID와 동일한 YAML 파일을 사용합니다.
+
+### 커스텀 명령 실행
+
+`commands/definitions/*.toml` 파일이 Gemini CLI Extension 커스텀 명령으로 로드됩니다. 명령 실행 시 `{{args}}`로 추가 컨텍스트를 전달할 수 있습니다.
+
+### 역할 분리 기준
+
+- UI 컴포넌트화: `frontend-repetition-agent`
+- Hook 분리: `frontend-repetition-agent`
+- 성능 최적화: `performance-agent`
+- 변경점 안전 검토: `change-safety-review` 스킬
+- PRD 작성: `prd-writer-agent`
+
+## 운영 규칙
+
+- Extension 에이전트(Manager)가 단계 전환 권한을 가집니다.
+- Artifact 검증 실패 시 단계 중단 후 원인 수정을 우선합니다.
+- 보안/배포 단계는 우회 없이 게이트를 통과해야 합니다.
+
+## 참고 문서
+
+- [Google Gemini CLI 발표](https://developers.googleblog.com/build-with-gemini-cli-our-new-agentic-development-platform/)
+- [Gemini CLI 공식 문서](https://googlegemini.wiki/gemini-cli)
+- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)

package/{antigravity/commands/definitions/cmd-dev-be-api.md → gemini/commands/definitions/cmd-dev-be-api.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DEV-BE-API - 백엔드 API 구현
-
-- phase: 개발
-- owner_role: backend-engineer
-
-## Purpose
+prompt = """CMD-DEV-BE-API - 백엔드 API 구현
+Phase: 개발 | Owner: backend-engineer
 
+[Purpose]
 명세 기반으로 안정적인 API와 데이터 접근 계층을 구현한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - API 계약
 - 도메인 모델
 - 에러 코드 정책
-
-### Optional
+Optional:
 - 기존 엔드포인트 호환 정책
 
-## Execution Contract
-
+[Execution Steps]
 1. 계약 우선 방식으로 DTO와 검증 규칙을 작성한다.
 2. 핸들러와 비즈니스 로직을 분리한다.
 3. 권한 검증과 감사 로그를 추가한다.
 4. 회귀 테스트를 작성한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 계약 테스트가 통과해야 한다.
 - 권한 누락 경로가 없어야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - API 구현 코드
 - 계약 테스트
 - 권한 매트릭스
 
-## Handoff
-
+[Handoff]
 - next_roles: qa-engineer, code-reviewer
 - blockers: 계약 불일치, 에러 코드 정책 위반
+
+Additional context: {{args}}"""
+description = "백엔드 API 구현 (개발 · backend-engineer)"

package/{antigravity/commands/definitions/cmd-dev-fe-hook-separate.md → gemini/commands/definitions/cmd-dev-fe-hook-separate.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DEV-FE-HOOK-SEPARATE - Hook 분리
-
-- phase: 개발
-- owner_role: hook-refactor-engineer
-
-## Purpose
+prompt = """CMD-DEV-FE-HOOK-SEPARATE - Hook 분리
+Phase: 개발 | Owner: hook-refactor-engineer
 
+[Purpose]
 컴포넌트 내부 상태/효과 로직을 재사용 가능한 Hook으로 분리한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 대상 컴포넌트
 - 상태 흐름
 - 부수효과 목록
-
-### Optional
+Optional:
 - 성능 프로파일 결과
 
-## Execution Contract
-
+[Execution Steps]
 1. UI 렌더링과 상태 오케스트레이션 경계를 식별한다.
 2. Hook의 입력/출력 타입 계약을 정의한다.
 3. 비동기/캐시/재시도 정책을 Hook 내부로 캡슐화한다.
 4. Hook 전용 테스트를 추가한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 컴포넌트 길이가 기준 대비 25% 이상 축소되어야 한다.
 - Hook은 단일 책임을 유지해야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 커스텀 Hook
 - Hook 테스트
 - 마이그레이션 노트
 
-## Handoff
-
+[Handoff]
 - next_roles: frontend-engineer, performance-engineer
 - blockers: Hook 간 순환 의존, 숨은 전역 상태 의존
+
+Additional context: {{args}}"""
+description = "Hook 분리 (개발 · hook-refactor-engineer)"

package/{antigravity/commands/definitions/cmd-dev-fe-ui-componentize.md → gemini/commands/definitions/cmd-dev-fe-ui-componentize.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DEV-FE-UI-COMPONENTIZE - UI 컴포넌트화
-
-- phase: 개발
-- owner_role: ui-component-engineer
-
-## Purpose
+prompt = """CMD-DEV-FE-UI-COMPONENTIZE - UI 컴포넌트화
+Phase: 개발 | Owner: ui-component-engineer
 
+[Purpose]
 반복 UI를 설계 토큰 기반의 재사용 컴포넌트로 분해한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 대상 화면
 - 중복 UI 목록
 - 디자인 토큰
-
-### Optional
+Optional:
 - 스토리북 규칙
 
-## Execution Contract
-
+[Execution Steps]
 1. 중복 UI를 패턴 단위로 그룹화한다.
 2. Props 계약을 최소화하고 명시적으로 정의한다.
 3. 프레젠테이션 로직과 데이터 로직을 분리한다.
 4. 스토리/스냅샷 테스트를 추가한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 컴포넌트 API 변경 시 하위 호환 전략이 있어야 한다.
 - 동일 UI 중복 코드가 기준 대비 30% 이상 감소해야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 공용 UI 컴포넌트
 - 사용 가이드
 - 스토리북 스토리
 
-## Handoff
-
+[Handoff]
 - next_roles: frontend-engineer, qa-engineer
 - blockers: 디자인 토큰 누락, 접근성 속성 누락
+
+Additional context: {{args}}"""
+description = "UI 컴포넌트화 (개발 · ui-component-engineer)"

package/{antigravity/commands/definitions/cmd-dev-perf-optimize.md → gemini/commands/definitions/cmd-dev-perf-optimize.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DEV-PERF-OPTIMIZE - 성능 최적화
-
-- phase: 개발
-- owner_role: performance-engineer
-
-## Purpose
+prompt = """CMD-DEV-PERF-OPTIMIZE - 성능 최적화
+Phase: 개발 | Owner: performance-engineer
 
+[Purpose]
 측정 기반으로 병목을 제거하고 사용자 체감 성능을 개선한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 성능 목표
 - 현재 측정치
 - 병목 후보
-
-### Optional
+Optional:
 - 트래픽 패턴
 
-## Execution Contract
-
+[Execution Steps]
 1. 기준 측정값을 고정한다.
 2. 병목 상위 3개만 우선 해결한다.
 3. 캐싱/메모이제이션/쿼리 최적화를 적용한다.
 4. 개선 후 동일 조건으로 재측정한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 핵심 지표가 목표 이상 개선되어야 한다.
 - 최적화로 인한 기능 회귀가 없어야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 전후 비교 리포트
 - 최적화 코드
 - 회귀 테스트
 
-## Handoff
-
+[Handoff]
 - next_roles: qa-engineer, sre-release-engineer
 - blockers: 측정 재현 불가, 최적화 효과 미미
+
+Additional context: {{args}}"""
+description = "성능 최적화 (개발 · performance-engineer)"

package/{antigravity/commands/definitions/cmd-dev-sequential-autorun.md → gemini/commands/definitions/cmd-dev-sequential-autorun.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DEV-SEQUENTIAL-AUTORUN - PRD 기반 순차 자동 구현
-
-- phase: 개발
-- owner_role: lead-orchestrator
-
-## Purpose
+prompt = """CMD-DEV-SEQUENTIAL-AUTORUN - PRD 기반 순차 자동 구현
+Phase: 개발 | Owner: lead-orchestrator
 
+[Purpose]
 확정된 세부 PRD 순서대로 구현, 테스트, 리뷰를 연쇄 실행한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 구현 배치 계획
 - 세부 PRD 묶음
 - 품질 게이트
-
-### Optional
+Optional:
 - 중간 승인 포인트
 
-## Execution Contract
-
+[Execution Steps]
 1. 배치 순서대로 기능 구현을 수행한다.
 2. 각 배치 종료 시 테스트와 리뷰를 자동 실행한다.
 3. UI 컴포넌트화/Hook 분리/성능 최적화/보안 점검을 각 배치에 적용한다.
 4. 최종 수동 설정 단계 직전까지 연속 실행한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 배치별 테스트/리뷰 통과 없이는 다음 배치로 이동하지 않는다.
 - 치명 보안 이슈 또는 차단 이슈 발생 시 즉시 중단한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 배치별 구현 로그
 - 중간 검증 리포트
 - 최종 수동 설정 전 체크리스트
 
-## Handoff
-
+[Handoff]
 - next_roles: qa-engineer, security-engineer, sre-release-engineer
 - blockers: 배치 검증 실패, 차단 이슈 미해결
+
+Additional context: {{args}}"""
+description = "PRD 기반 순차 자동 구현 (개발 · lead-orchestrator)"

package/{antigravity/commands/definitions/cmd-doc-handoff.md → gemini/commands/definitions/cmd-doc-handoff.toml}

@@ -1,44 +1,36 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-DOC-HANDOFF - 운영 인수인계 문서화
-
-- phase: 개선
-- owner_role: operations-owner
-
-## Purpose
+prompt = """CMD-DOC-HANDOFF - 운영 인수인계 문서화
+Phase: 개선 | Owner: operations-owner
 
+[Purpose]
 사람과 AI가 동일한 기준으로 서비스 상태를 이해하도록 지식을 구조화한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 최신 아키텍처
 - 운영 런북
 - 릴리즈 이력
-
-### Optional
+Optional:
 - FAQ
 - 온보딩 자료
 
-## Execution Contract
-
+[Execution Steps]
 1. 문서를 역할 기준으로 분리한다.
 2. 명령 ID와 워크플로우 ID를 교차 참조한다.
 3. 변경 이력을 날짜와 함께 기록한다.
 4. 월 1회 갱신 책임자를 지정한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 중요 문서는 최신 배포와 일치해야 한다.
 - 문서만으로 최소 운영 시나리오 재현이 가능해야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 운영 핸드북
 - 워크플로우 인덱스
 - 갱신 캘린더
 
-## Handoff
-
+[Handoff]
 - next_roles: all
 - blockers: 문서와 실제 동작 불일치
+
+Additional context: {{args}}"""
+description = "운영 인수인계 문서화 (개선 · operations-owner)"

package/{antigravity/commands/definitions/cmd-improve-techdebt.md → gemini/commands/definitions/cmd-improve-techdebt.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-IMPROVE-TECHDEBT - 기술 부채 정리
-
-- phase: 개선
-- owner_role: tech-debt-manager
-
-## Purpose
+prompt = """CMD-IMPROVE-TECHDEBT - 기술 부채 정리
+Phase: 개선 | Owner: tech-debt-manager
 
+[Purpose]
 장기 생산성을 저해하는 구조적 부채를 우선순위 기반으로 상환한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 부채 목록
 - 영향도
 - 상환 비용
-
-### Optional
+Optional:
 - 장애 연관 지표
 
-## Execution Contract
-
+[Execution Steps]
 1. 영향도/비용 기준으로 상환 순위를 정한다.
 2. 기능 개발과 충돌하지 않게 배치한다.
 3. 상환 항목별 완료 기준을 정의한다.
 4. 상환 후 구조 단순화 여부를 점검한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 상환 항목은 측정 가능한 결과를 가져야 한다.
 - 미완료 항목은 이유와 다음 시점을 기록해야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 부채 상환 백로그
 - 완료 리포트
 - 구조 개선 지표
 
-## Handoff
-
+[Handoff]
 - next_roles: product-planner, solution-architect
 - blockers: 상환 우선순위 불명확, 기능 일정과 충돌
+
+Additional context: {{args}}"""
+description = "기술 부채 정리 (개선 · tech-debt-manager)"

package/{antigravity/commands/definitions/cmd-incident-triage.md → gemini/commands/definitions/cmd-incident-triage.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-INCIDENT-TRIAGE - 장애 분류 및 대응
-
-- phase: 운영
-- owner_role: incident-commander
-
-## Purpose
+prompt = """CMD-INCIDENT-TRIAGE - 장애 분류 및 대응
+Phase: 운영 | Owner: incident-commander
 
+[Purpose]
 장애 영향 범위를 빠르게 파악하고 복구 우선순위를 설정한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 장애 알림
 - 영향 서비스
 - 현재 증상
-
-### Optional
+Optional:
 - 최근 배포 이력
 
-## Execution Contract
-
+[Execution Steps]
 1. 심각도와 고객 영향을 분류한다.
 2. 워룸 역할과 커뮤니케이션 채널을 고정한다.
 3. 복구 우선 경로를 실행한다.
 4. 복구 후 재발 방지 액션을 등록한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 심각도 기준이 일관되어야 한다.
 - 복구 후 RCA 일정이 지정되어야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 장애 타임라인
 - 복구 조치 기록
 - 재발 방지 액션
 
-## Handoff
-
+[Handoff]
 - next_roles: code-reviewer, security-engineer, operations-owner
 - blockers: 원인 미확정, 재발 방지 책임자 미지정
+
+Additional context: {{args}}"""
+description = "장애 분류 및 대응 (운영 · incident-commander)"

package/{antigravity/commands/definitions/cmd-ops-ci-cd-gate.md → gemini/commands/definitions/cmd-ops-ci-cd-gate.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-OPS-CI-CD-GATE - CI/CD 게이트 고정
-
-- phase: 배포
-- owner_role: sre-release-engineer
-
-## Purpose
+prompt = """CMD-OPS-CI-CD-GATE - CI/CD 게이트 고정
+Phase: 배포 | Owner: sre-release-engineer
 
+[Purpose]
 품질/보안 기준 미충족 변경이 배포되지 않도록 자동 차단한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 테스트 결과
 - 리뷰 상태
 - 보안 점검 상태
-
-### Optional
+Optional:
 - 성능 기준 리포트
 
-## Execution Contract
-
+[Execution Steps]
 1. 필수 체크를 파이프라인 게이트로 등록한다.
 2. 실패 시 자동 중단 및 알림을 설정한다.
 3. 배포 승인 정책을 역할 기반으로 고정한다.
 4. 릴리즈 노트 자동 생성을 연결한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 게이트 우회 경로가 없어야 한다.
 - 실패 원인이 추적 가능해야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 파이프라인 설정
 - 승인 정책
 - 릴리즈 노트 템플릿
 
-## Handoff
-
+[Handoff]
 - next_roles: sre-release-engineer
 - blockers: 필수 체크 누락, 알림 라우팅 오류
+
+Additional context: {{args}}"""
+description = "CI/CD 게이트 고정 (배포 · sre-release-engineer)"

package/{antigravity/commands/definitions/cmd-ops-deploy.md → gemini/commands/definitions/cmd-ops-deploy.toml}

@@ -1,43 +1,35 @@
-# generated by scripts/generate-from-common.mjs
-
-# CMD-OPS-DEPLOY - 배포 및 검증
-
-- phase: 배포
-- owner_role: sre-release-engineer
-
-## Purpose
+prompt = """CMD-OPS-DEPLOY - 배포 및 검증
+Phase: 배포 | Owner: sre-release-engineer
 
+[Purpose]
 점진 배포와 실시간 검증으로 릴리즈 리스크를 통제한다.
 
-## Input Contract
-
-### Required
+[Input Contract]
+Required:
 - 릴리즈 후보
 - 롤백 계획
 - 모니터링 대시보드
-
-### Optional
+Optional:
 - 점진 배포 비율 정책
 
-## Execution Contract
-
+[Execution Steps]
 1. 배포 전 백업과 롤백 경로를 검증한다.
 2. 카나리/블루그린 방식으로 점진 배포한다.
 3. 핵심 SLI를 감시한다.
 4. 임계치 초과 시 자동 또는 수동 롤백한다.
 
-## Quality Gates
-
+[Quality Gates]
 - 롤백 시나리오가 사전 검증되어야 한다.
 - 배포 후 핵심 지표가 기준 내여야 한다.
 
-## Output Contract
-
+[Output Artifacts]
 - 배포 로그
 - 검증 체크리스트
 - 롤백 결과(필요 시)
 
-## Handoff
-
+[Handoff]
 - next_roles: operations-owner
 - blockers: 핵심 지표 악화, 롤백 실패
+
+Additional context: {{args}}"""
+description = "배포 및 검증 (배포 · sre-release-engineer)"