@dusky-bluehour/agent-service 0.6.6 → 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/gemini/commands/definitions/cmd-dev-be-api.toml

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

package/gemini/commands/definitions/cmd-dev-fe-hook-separate.toml

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

package/gemini/commands/definitions/cmd-dev-fe-ui-componentize.toml

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

package/gemini/commands/definitions/cmd-dev-perf-optimize.toml

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

package/gemini/commands/definitions/cmd-dev-sequential-autorun.toml

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

package/gemini/commands/definitions/cmd-doc-handoff.toml

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

package/gemini/commands/definitions/cmd-improve-techdebt.toml

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

package/gemini/commands/definitions/cmd-incident-triage.toml

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

package/gemini/commands/definitions/cmd-ops-ci-cd-gate.toml

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

package/gemini/commands/definitions/cmd-ops-deploy.toml

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

package/gemini/commands/definitions/cmd-ops-monitoring.toml

@@ -0,0 +1,35 @@
+prompt = """CMD-OPS-MONITORING - 운영 모니터링 강화
+Phase: 운영 | Owner: operations-owner
+
+[Purpose]
+장애 징후를 조기에 탐지하고 대응 시간을 단축한다.
+
+[Input Contract]
+Required:
+- SLI/SLO
+- 알림 정책
+- 서비스 맵
+Optional:
+- 장애 포스트모템
+
+[Execution Steps]
+1. 핵심 지표와 에러 버짓을 대시보드화한다.
+2. 노이즈 알림을 정리하고 에스컬레이션을 명확화한다.
+3. 런북과 알림을 연결한다.
+4. 주간 점검으로 임계치 튜닝을 수행한다.
+
+[Quality Gates]
+- 알림은 실행 가능한 행동 지침을 포함해야 한다.
+- 미사용 대시보드는 제거한다.
+
+[Output Artifacts]
+- 운영 대시보드
+- 알림 정책
+- 런북
+
+[Handoff]
+- next_roles: incident-commander
+- blockers: 오탐 과다, 런북 미정
+
+Additional context: {{args}}"""
+description = "운영 모니터링 강화 (운영 · operations-owner)"

package/gemini/commands/definitions/cmd-plan-arch-decision.toml

@@ -0,0 +1,35 @@
+prompt = """CMD-PLAN-ARCH-DECISION - 아키텍처 의사결정 기록
+Phase: 설계 | Owner: solution-architect
+
+[Purpose]
+핵심 기술 선택과 트레이드오프를 ADR로 고정한다.
+
+[Input Contract]
+Required:
+- 요구사항 기준서
+- 시스템 제약
+- 비기능 요구사항
+Optional:
+- 기존 인프라 비용 정보
+
+[Execution Steps]
+1. 후보 아키텍처 2개 이상을 비교한다.
+2. 성능/비용/보안 관점의 선택 근거를 기록한다.
+3. 실패 시 롤백 전략을 포함한다.
+4. 데이터 모델과 API 경계를 확정한다.
+
+[Quality Gates]
+- 결정 근거가 수치 또는 사실로 설명되어야 한다.
+- 롤백 전략이 누락되면 실패로 처리한다.
+
+[Output Artifacts]
+- ADR 문서
+- 시스템 컨텍스트 다이어그램
+- 데이터 경계 정의
+
+[Handoff]
+- next_roles: backend-engineer, frontend-engineer
+- blockers: 의존 시스템 책임 경계 미정, 데이터 소유권 충돌
+
+Additional context: {{args}}"""
+description = "아키텍처 의사결정 기록 (설계 · solution-architect)"

package/gemini/commands/definitions/cmd-plan-implementation-bootstrap.toml

@@ -0,0 +1,35 @@
+prompt = """CMD-PLAN-IMPLEMENTATION-BOOTSTRAP - 구현 부트스트랩 확정
+Phase: 설계 | Owner: solution-architect
+
+[Purpose]
+세부 PRD 기반으로 구현 순서, 책임 역할, 자동 실행 범위를 고정한다.
+
+[Input Contract]
+Required:
+- 세부 PRD 묶음
+- 아키텍처 제약
+- 품질/보안 기준
+Optional:
+- 배포 일정
+
+[Execution Steps]
+1. 세부 PRD를 순차 실행 가능한 배치로 그룹화한다.
+2. 역할별 책임과 산출물을 고정한다.
+3. 자동 실행 단계와 수동 설정 단계(최종 세팅)를 분리한다.
+4. 각 배치의 검증 게이트를 정의한다.
+
+[Quality Gates]
+- 자동 실행 범위와 수동 단계가 명확히 분리되어야 한다.
+- 각 배치에 검증 게이트가 있어야 한다.
+
+[Output Artifacts]
+- 구현 배치 계획
+- 역할별 실행표
+- 수동 설정 체크리스트
+
+[Handoff]
+- next_roles: lead-orchestrator, backend-engineer, frontend-engineer
+- blockers: 배치 순서 미정, 수동/자동 경계 불명확
+
+Additional context: {{args}}"""
+description = "구현 부트스트랩 확정 (설계 · solution-architect)"

package/gemini/commands/definitions/cmd-plan-prd-details.toml

@@ -0,0 +1,35 @@
+prompt = """CMD-PLAN-PRD-DETAILS - 세부 PRD 분해 작성
+Phase: 기획 | Owner: prd-writer
+
+[Purpose]
+마스터 PRD를 기능 단위 PRD들로 분해해 구현 가능한 작업 단위로 고정한다.
+
+[Input Contract]
+Required:
+- 마스터 PRD
+- 기능 범위
+- 품질 기준
+Optional:
+- 기술 스택 제약
+
+[Execution Steps]
+1. 에픽/기능 단위로 PRD를 분해한다.
+2. 각 세부 PRD에 수용 기준을 명시한다.
+3. UI 컴포넌트화 전략, 톤앤매너, 성능/보안 기준을 각 항목에 반영한다.
+4. 구현 순서와 의존성을 명확히 기록한다.
+
+[Quality Gates]
+- 모든 세부 PRD가 수용 기준(DoD)을 포함해야 한다.
+- 구현 순서와 의존성이 누락되면 실패 처리한다.
+
+[Output Artifacts]
+- 세부 PRD 묶음
+- 구현 순서도
+- 수용 기준 매트릭스
+
+[Handoff]
+- next_roles: solution-architect, backend-engineer, frontend-engineer
+- blockers: 수용 기준 누락, 의존성 충돌
+
+Additional context: {{args}}"""
+description = "세부 PRD 분해 작성 (기획 · prd-writer)"

package/gemini/commands/definitions/cmd-plan-prd-master.toml

@@ -0,0 +1,36 @@
+prompt = """CMD-PLAN-PRD-MASTER - 마스터 PRD 작성
+Phase: 기획 | Owner: prd-writer
+
+[Purpose]
+서비스 목표, 사용자, 기능 범위, 비기능 요구사항을 포함한 상위 PRD를 대화형으로 작성한다.
+
+[Input Contract]
+Required:
+- 사업 목표
+- 대상 사용자
+- 문제 정의
+Optional:
+- 브랜드 가이드
+- 레퍼런스 서비스
+
+[Execution Steps]
+1. 핵심 문제와 기대 성과를 정량화한다.
+2. 사용자 세그먼트와 핵심 시나리오를 정리한다.
+3. 기능 범위와 비범위를 구분한다.
+4. 보안/성능/가독성/운영 기준을 PRD에 포함한다.
+
+[Quality Gates]
+- 모든 목표는 측정 가능한 지표를 가져야 한다.
+- 비기능 요구사항(성능/보안/접근성/유지보수성)이 누락되면 실패 처리한다.
+
+[Output Artifacts]
+- 마스터 PRD
+- 핵심 지표 표
+- 범위/비범위 목록
+
+[Handoff]
+- next_roles: prd-writer, solution-architect
+- blockers: 문제 정의 불명확, 성공 지표 미정
+
+Additional context: {{args}}"""
+description = "마스터 PRD 작성 (기획 · prd-writer)"

package/gemini/commands/definitions/cmd-plan-req-lock.toml

@@ -0,0 +1,36 @@
+prompt = """CMD-PLAN-REQ-LOCK - 요구사항 잠금
+Phase: 기획 | Owner: product-planner
+
+[Purpose]
+범위 변동을 줄이고 구현 가능한 요구사항 기준선을 확정한다.
+
+[Input Contract]
+Required:
+- 비즈니스 목표
+- 성공 지표
+- 제약사항
+Optional:
+- 기존 레거시 제약
+- 마감 일정
+
+[Execution Steps]
+1. 목표를 정량 지표로 환산한다.
+2. 사용자 시나리오를 우선순위로 정렬한다.
+3. 범위 밖 항목을 명시한다.
+4. 승인 기준과 거부 기준을 함께 기록한다.
+
+[Quality Gates]
+- 모든 요구사항이 측정 가능해야 한다.
+- 모호한 표현(빠르게, 충분히 등)이 없어야 한다.
+
+[Output Artifacts]
+- 요구사항 기준서
+- 범위 제외 목록
+- 승인 기준표
+
+[Handoff]
+- next_roles: solution-architect
+- blockers: 측정 불가능한 목표, 우선순위 미정
+
+Additional context: {{args}}"""
+description = "요구사항 잠금 (기획 · product-planner)"