@dusky-bluehour/agent-service 0.6.4 → 0.6.6

package/claude-code/skills/service-lifecycle-orchestration/SKILL.md

@@ -3,13 +3,33 @@ name: service-lifecycle-orchestration
 description: 서비스 기획부터 개발, 검증, 배포, 운영 전환까지 전체 수명주기 실행을 통제한다. 신규 서비스 구축, 대형 기능 롤아웃, 복수 역할 병렬 협업이 필요한 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 요구사항/ADR/범위/비범위를 확정한다.
+- 각 단계 책임 역할과 승인자를 지정한다.
+- 단계별 진입/종료 기준을 작업 시작 전에 확인한다.
+- 리스크와 롤백 전략을 초기 단계에서 기록한다.
+
 # 실행 절차
 
-1. `WF-SVC-001` 또는 `WF-SVC-002`를 선택한다.
+1. `WF-SERVICE-E2E` 또는 `WF-FEATURE-DELIVERY`를 선택한다.
 2. 현재 단계의 `entry_criteria`를 확인하고 부족한 입력을 수집한다.
 3. 단계별 `commands`를 실행한다.
 4. `exit_criteria`를 만족하면 다음 단계로 이동한다.
 
+# 결과 보고 형식
+
+- 단계 상태: 완료/미완료/차단요인
+- 실행 근거: 단계별 명령 ID와 결과
+- 품질 상태: 테스트/보안/리뷰 게이트 결과
+- 다음 행동: 담당자, 마감 조건, 선행 조건
+
+# 중단 조건
+
+- 진입 기준이 충족되지 않은 단계가 있는 경우
+- 차단 이슈가 해결되지 않았는데 다음 단계로 이동하려는 경우
+- 롤백 전략 없이 배포 단계 진입이 요청된 경우
+
 # 품질 규칙
 
 - 명령은 항상 `command-catalog.json` ID로 호출한다.

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

@@ -6,7 +6,7 @@
   },
   "workflows": [
     {
-      "id": "WF-SVC-001",
+      "id": "WF-SERVICE-E2E",
       "name": "신규 서비스 E2E (기획→개발→검증→운영 전환)",
       "summary": "초기 기획부터 운영 전환까지 리드+전문가 구조로 통제합니다.",
       "team_mode": "lead-plus-specialists",
@@ -125,7 +125,7 @@
       "when_to_use": "신규 서비스 런칭, 대형 기능 롤아웃"
     },
     {
-      "id": "WF-SVC-002",
+      "id": "WF-FEATURE-DELIVERY",
       "name": "기능 개발 표준 (범위→개발→QA)",
       "summary": "기존 서비스 기능 추가에 맞춘 표준 실행 흐름입니다.",
       "team_mode": "lead-plus-specialists",
@@ -195,7 +195,7 @@
       "when_to_use": "일반 기능 개발, 스프린트 단위 구현"
     },
     {
-      "id": "WF-SVC-003",
+      "id": "WF-CODE-REVIEW-LOOP",
       "name": "코드 리뷰/개선 루프 (진단→수정→재검증)",
       "summary": "품질 저하 징후가 보이면 리뷰와 개선 루프를 즉시 닫습니다.",
       "team_mode": "parallel-review",
@@ -269,7 +269,7 @@
       "when_to_use": "PR 리뷰 강화, 품질 하락 대응"
     },
     {
-      "id": "WF-SVC-004",
+      "id": "WF-SECURITY-HARDENING",
       "name": "보안 강화 배치 (위협모델→보완→검증)",
       "summary": "정기 또는 이슈 기반 보안 점검을 집중 수행합니다.",
       "team_mode": "security-first",
@@ -338,7 +338,7 @@
       "when_to_use": "보안 감사, 취약점 대응 배치"
     },
     {
-      "id": "WF-SVC-005",
+      "id": "WF-RELEASE-TRANSITION",
       "name": "배포/운영 전환 (게이트→배포→모니터링)",
       "summary": "릴리즈 직전 게이트와 운영 전환을 통합해 실행합니다.",
       "team_mode": "release-train",
@@ -404,7 +404,7 @@
       "when_to_use": "정기 릴리즈, 운영 전환 준비"
     },
     {
-      "id": "WF-SVC-006",
+      "id": "WF-FRONTEND-REFACTOR",
       "name": "반복 리팩터링 패키지 (UI→Hook→성능)",
       "summary": "반복 프론트엔드 개선 작업을 한 번에 실행합니다.",
       "team_mode": "frontend-special-pack",
@@ -470,7 +470,7 @@
       "when_to_use": "컴포넌트화, Hook 분리, 성능 개선"
     },
     {
-      "id": "WF-SVC-007",
+      "id": "WF-INCIDENT-RESPONSE",
       "name": "장애 대응/재발 방지 (복구→원인분석→후속조치)",
       "summary": "장애 발생 시 복구와 재발 방지를 한 세트로 수행합니다.",
       "team_mode": "incident-war-room",
@@ -540,7 +540,7 @@
       "when_to_use": "서비스 장애, 긴급 운영 이슈"
     },
     {
-      "id": "WF-PRD-IMPLEMENT-E2E",
+      "id": "WF-PRD-TO-PRODUCTION",
       "name": "PRD 대화형 작성→순차 자동 구현",
       "summary": "PRD를 대화형으로 고도화하고 구현은 최종 수동 설정 전까지 자동 실행합니다.",
       "team_mode": "prd-to-production-pipeline",

package/codex/README.md

@@ -1,6 +1,8 @@
 # Codex 운영팩
 
 이 폴더는 Codex에서 서비스 운영형 작업(기획-개발-검증-보안-배포-운영)을 반복 가능하게 구성하시도록 스킬/워크플로우/지침 세트를 제공합니다.
+정의 원천은 저장소 `common/*`이며, 이 폴더의 파일은 생성 스크립트(`npm run generate`) 결과입니다.
+직접 수정 대신 공통 원천을 수정한 뒤 재생성해 주세요.
 
 ## 폴더 구성
 
@@ -13,7 +15,7 @@
 ## 빠른 시작
 
 1. 프로젝트 루트에 `AGENTS.md`를 만들고 `instructions/AGENTS.template.md`를 기반으로 작성해 주세요.
-2. 작업 유형에 맞는 워크플로우(`WF-SVC-001`~`WF-SVC-005`, `WF-PRD-IMPLEMENT-E2E`)를 선택해 주세요.
+2. 작업 유형에 맞는 워크플로우(`WF-SERVICE-E2E`~`WF-INCIDENT-RESPONSE`, `WF-PRD-TO-PRODUCTION`)를 선택해 주세요.
 3. 명령 ID를 기준으로 실행하시고, 검증 단계에서 `/review`를 수행해 주세요.
 
 ## 스킬 설치 위치
@@ -28,7 +30,8 @@
 - UI 컴포넌트화: `frontend-repetition-pack` + `CMD-DEV-FE-UI-COMPONENTIZE`
 - Hook 분리: `frontend-repetition-pack` + `CMD-DEV-FE-HOOK-SEPARATE`
 - 성능 최적화: `frontend-repetition-pack` + `CMD-DEV-PERF-OPTIMIZE`
-- PRD 파이프라인: `prd-to-production-pipeline` + `WF-PRD-IMPLEMENT-E2E`
+- 변경점 안전 검토: `change-safety-review` + `CMD-TEST-UNIT-INTEGRATION`, `CMD-REVIEW-CODE`
+- PRD 파이프라인: `prd-to-production-pipeline` + `WF-PRD-TO-PRODUCTION`
 
 ## 참고 문서 (검증일: 2026-02-17)
 

package/codex/automations/automation-recipes.toml

@@ -4,27 +4,27 @@
 [[automation]]
 name = "주간 코드리뷰 백로그"
 purpose = "열린 PR과 최근 변경분을 검토해 우선순위 개선안 생성"
-recommended_workflow = "WF-SVC-002"
+recommended_workflow = "WF-FEATURE-DELIVERY"
 recommended_skill = "code-review-and-improvement"
 prompt = "열린 PR과 지난 7일 변경분을 검토하고, 차단 이슈/권고 이슈/개선 우선순위를 정리해줘."
 
 [[automation]]
 name = "주간 보안 하드닝"
 purpose = "취약점 점검 및 보완 계획 생성"
-recommended_workflow = "WF-SVC-003"
+recommended_workflow = "WF-SECURITY-HARDENING"
 recommended_skill = "security-hardening"
 prompt = "의존성 취약점과 위협 모델을 점검하고, 즉시 조치 항목과 차주 조치 항목으로 분리해줘."
 
 [[automation]]
 name = "릴리즈 전 체크"
 purpose = "배포 게이트 충족 여부 확인"
-recommended_workflow = "WF-SVC-004"
+recommended_workflow = "WF-RELEASE-TRANSITION"
 recommended_skill = "release-and-operations"
 prompt = "다음 릴리즈 후보에 대해 테스트/보안/리뷰/배포 게이트 충족 여부를 확인하고 누락 항목을 정리해줘."
 
 [[automation]]
 name = "프론트 반복개선 배치"
 purpose = "중복 UI와 Hook 구조를 주기 점검"
-recommended_workflow = "WF-SVC-002"
+recommended_workflow = "WF-FEATURE-DELIVERY"
 recommended_skill = "frontend-repetition-pack"
 prompt = "프론트엔드 코드에서 반복 UI, 과도한 컴포넌트 책임, Hook 분리 후보를 찾아 우선순위로 정리해줘."

package/codex/instructions/AGENTS.template.md

@@ -6,15 +6,16 @@
 - 추정 대신 측정값(테스트, 성능, 취약점 결과)을 우선한다.
 
 ## 2) 기본 워크플로우 선택 규칙
-- 신규 서비스/대형 기능: `WF-SVC-001`
-- 일반 기능 개발: `WF-SVC-002`
-- 보안 점검/하드닝: `WF-SVC-003`
-- 배포/운영 전환: `WF-SVC-004`
-- 장애 대응: `WF-SVC-005`
+- 신규 서비스/대형 기능: `WF-SERVICE-E2E`
+- 일반 기능 개발: `WF-FEATURE-DELIVERY`
+- 보안 점검/하드닝: `WF-SECURITY-HARDENING`
+- 배포/운영 전환: `WF-RELEASE-TRANSITION`
+- 장애 대응: `WF-INCIDENT-RESPONSE`
 
 ## 3) 스킬 라우팅 규칙
 - 범위/요구사항 정리: `service-lifecycle-orchestration`
 - 코드 리뷰/개선: `code-review-and-improvement`
+- 변경점 안전 검토(렌더링/레이스/부작용): `change-safety-review`
 - 보안 검토: `security-hardening`
 - UI 컴포넌트화/Hook/최적화: `frontend-repetition-pack`
 - 배포/운영: `release-and-operations`

package/codex/skills/change-safety-review/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: change-safety-review
+description: 현재 git 변경점 또는 전체 프로젝트를 기준으로 렌더링 회귀, 레이스 컨디션, 숨은 사이드이펙트를 점검하고 차단 이슈를 확정한다. "지금 변경사항 문제 없는지", "렌더링/레이스/부작용 검토" 요청에서 사용한다.
+---
+
+# 시작 전 체크리스트
+
+- 검토 범위를 고정한다 (`git diff`, 특정 PR, 또는 전체 릴리즈 범위 중 하나).
+- 영향 경로를 작성한다 (화면/라우트, API 엔드포인트, 배치/크론, 외부 연동).
+- 정상/경계/오류 케이스 최소 3개 재현 시나리오를 확보한다.
+- 현재 테스트/빌드 상태(성공/실패)와 마지막 성공 커밋을 기록한다.
+
+# 실행 절차
+
+1. 검증 범위를 고정한다: 기본은 현재 `git diff`(staged + unstaged), 요청 시 전체 프로젝트로 확장한다.
+2. 변경 파일과 영향 경로를 분류한다(UI 렌더링, 비동기 상태, 외부 I/O, 전역 상태).
+3. `CMD-TEST-UNIT-INTEGRATION`으로 회귀 경로를 먼저 고정한다.
+4. `CMD-REVIEW-CODE`로 렌더링 깨짐, 레이스 컨디션, 사이드이펙트 리스크를 차단/권고로 분리한다.
+5. UI/상태 변경이 있으면 `CMD-DEV-PERF-OPTIMIZE` 관점으로 불필요 렌더링과 상태 오케스트레이션 비용을 재점검한다.
+6. 차단 이슈 0건 또는 미해결 차단 목록/우회책을 명시하고 종료한다.
+
+# 결과 보고 형식
+
+- 검증 범위: 브랜치/커밋/파일 목록, 제외 범위
+- 차단 이슈: `파일:라인`, 재현 단계, 영향, 즉시 수정안
+- 권고 이슈: 우선순위(P1/P2/P3), 수정 난이도, 기대 효과
+- 실행 근거: 테스트/리뷰/프로파일링 결과
+- 최종 결론: `배포 가능` 또는 `차단`, 잔여 리스크
+
+# 중단 조건
+
+- 차단 이슈가 남아 있고 우회 방안이 승인되지 않은 경우
+- 재현 절차가 성립하지 않아 사실/추정을 분리할 수 없는 경우
+- 테스트 기반이 깨져 회귀 판단이 불가능한 경우
+
+# 품질 규칙
+
+- 차단 이슈는 파일 위치, 재현 절차, 영향 범위, 수정 제안을 반드시 포함한다.
+- 확인된 사실과 추정 리스크를 분리해 기록한다.
+- "문제 없음" 결론에는 실행한 검증 범위, 테스트/리뷰 근거, 잔여 리스크를 함께 남긴다.

package/codex/skills/change-safety-review/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "변경점 안전 검토"
+  short_description: "렌더링/레이스/부작용 점검"
+  default_prompt: "현재 git 변경사항 기준으로 회귀, 레이스 컨디션, 사이드이펙트를 차단 이슈 중심으로 검토해줘."

package/codex/skills/code-review-and-improvement/SKILL.md

@@ -3,13 +3,33 @@ name: code-review-and-improvement
 description: 코드 리뷰로 결함을 식별하고 개선안을 반영해 재검증까지 완료한다. PR 리뷰, 품질 개선, 리팩터링 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 리뷰 대상 범위를 확정한다 (PR 링크, 커밋 범위, 모듈 경계).
+- 리뷰 기준을 고정한다 (정합성, 보안, 성능, 가독성, 테스트).
+- 변경 위험도를 산정한다 (사용자 영향, 데이터 영향, 장애 가능성).
+- 수정 가능 시간/범위와 이번 사이클 제외 항목을 명시한다.
+
 # 실행 절차
 
-1. `WF-SVC-002` 또는 `WF-SVC-005`의 리뷰 단계를 선택한다.
+1. `WF-FEATURE-DELIVERY` 또는 `WF-INCIDENT-RESPONSE`의 리뷰 단계를 선택한다.
 2. `CMD-REVIEW-CODE`로 차단/권고 이슈를 분리한다.
 3. `CMD-IMPROVE-TECHDEBT`로 개선 우선순위를 고정한다.
 4. `/review`와 테스트를 다시 실행해 회귀를 확인한다.
 
+# 결과 보고 형식
+
+- 리뷰 결과: 차단/권고 분리 목록
+- 개선 적용 내역: 원인, 변경점, 영향을 받은 파일
+- 재검증 결과: 테스트/정적 검사/리뷰 재실행 결과
+- 남은 기술 부채: 우선순위, 예상 공수, 후속 담당
+
+# 중단 조건
+
+- 차단 이슈가 남아 있고 수정 범위 합의가 없는 경우
+- 아키텍처 수준 결정이 필요하지만 의사결정자가 부재한 경우
+- 수정 이후 회귀 테스트를 실행할 수 없는 경우
+
 # 품질 규칙
 
 - 모든 지적은 파일 위치와 재현 경로를 포함한다.

package/codex/skills/frontend-repetition-pack/SKILL.md

@@ -3,12 +3,32 @@ name: frontend-repetition-pack
 description: 반복적인 프론트엔드 개선(UI 컴포넌트화, Hook 분리, 성능 최적화)을 표준 명령으로 수행한다. 화면 리팩터링과 성능 개선 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 중복 UI 후보 목록을 수집한다 (화면/컴포넌트/사용 횟수).
+- 기준 지표를 기록한다 (번들 크기, 렌더 횟수, 핵심 UX 지연 시간).
+- 디자인 토큰/컴포넌트 규칙을 확인한다.
+- 상태 로직 분리 대상(부수효과/비동기/공유 상태)을 표시한다.
+
 # 실행 절차
 
 1. `CMD-DEV-FE-UI-COMPONENTIZE`를 먼저 실행한다.
 2. `CMD-DEV-FE-HOOK-SEPARATE`로 로직 분리를 수행한다.
 3. `CMD-DEV-PERF-OPTIMIZE`와 테스트로 개선을 검증한다.
 
+# 결과 보고 형식
+
+- 컴포넌트화 결과: 기존->신규 매핑, 공통 Props 계약
+- Hook 분리 결과: Hook 이름, 입력/출력, 부수효과 정책
+- 성능 결과: 전/후 지표와 측정 조건
+- 남은 리팩터 항목: 우선순위와 예상 영향
+
+# 중단 조건
+
+- 시각적 회귀가 차단 이슈 수준으로 발생한 경우
+- 컴포넌트 계약이 확정되지 않아 호출부 정리가 불가능한 경우
+- 전/후 성능 비교가 불가능해 개선 효과를 증명할 수 없는 경우
+
 # 품질 규칙
 
 - 전후 지표(중복률, 렌더링 시간)를 기록한다.

package/codex/skills/incident-response/SKILL.md

@@ -3,13 +3,33 @@ name: incident-response
 description: 장애 접수 후 복구, 원인 분석, 재발 방지까지 일괄 처리한다. 긴급 장애 대응과 핫픽스 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 장애 심각도(SEV), 영향 범위, 시작 시각을 확정한다.
+- 즉시 복구 경로(롤백/우회/트래픽 차단)를 준비한다.
+- 커뮤니케이션 채널과 의사결정 책임자를 지정한다.
+- 로그/메트릭/알림 스냅샷을 보존한다.
+
 # 실행 절차
 
-1. `WF-SVC-005`를 실행한다.
+1. `WF-INCIDENT-RESPONSE`를 실행한다.
 2. `CMD-INCIDENT-TRIAGE`로 심각도/영향도를 확정한다.
 3. 수정 후 `/review`와 테스트로 재발 방지 여부를 검증한다.
 4. `CMD-DOC-HANDOFF`로 운영 런북을 갱신한다.
 
+# 결과 보고 형식
+
+- 타임라인: 탐지->완화->복구 시각
+- 복구 조치: 실행 명령/설정 변경/결과
+- 근본 원인: 기술 원인, 프로세스 원인
+- 재발 방지 액션: 담당자, 마감일, 검증 방법
+
+# 중단 조건
+
+- 고객 영향이 지속되는데 복구 경로가 없는 경우
+- 데이터 손상 가능성이 있어 즉시 격리가 필요한 경우
+- 재발 방지 액션의 책임자/기한이 확정되지 않은 경우
+
 # 품질 규칙
 
 - 복구 이후 RCA 일정과 책임자를 남긴다.

package/codex/skills/prd-to-production-pipeline/SKILL.md

@@ -3,13 +3,33 @@ name: prd-to-production-pipeline
 description: 대화형 PRD 작성 후 세부 PRD를 기준으로 구현을 순차 자동 실행한다. PRD 중심 구현 자동화 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 문제 정의와 목표 지표(KPI)를 수치로 확정한다.
+- 기능/비기능 요구사항과 제외 범위를 명시한다.
+- 의존성 순서와 자동/수동 경계를 사전에 고정한다.
+- 수용 기준(acceptance criteria)과 실패 기준을 명시한다.
+
 # 실행 절차
 
-1. `WF-PRD-IMPLEMENT-E2E`을 시작한다.
+1. `WF-PRD-TO-PRODUCTION`을 시작한다.
 2. PRD 단계는 `/plan`으로 대화형 확정한다.
 3. 구현 단계는 `CMD-DEV-SEQUENTIAL-AUTORUN` 중심으로 순차 실행한다.
 4. 마지막 수동 세팅 단계만 사람이 확인한다.
 
+# 결과 보고 형식
+
+- PRD 마스터 결과: 목표/범위/제약
+- 세부 PRD 결과: 에픽별 요구사항과 수용 기준
+- 구현 실행 결과: 배치별 실행 로그와 검증 결과
+- 최종 수동 체크리스트: 미자동화 항목과 승인 상태
+
+# 중단 조건
+
+- 수용 기준이 불명확해 완료 판단이 불가능한 경우
+- 핵심 의존성이 해결되지 않아 순차 실행이 깨지는 경우
+- 자동 실행 중 차단 이슈가 발생하고 우회 승인이 없는 경우
+
 # 품질 규칙
 
 - 세부 PRD마다 수용 기준을 명시한다.

package/codex/skills/release-and-operations/SKILL.md

@@ -3,12 +3,32 @@ name: release-and-operations
 description: 배포 게이트 설정, 점진 배포, 모니터링 및 인수인계를 표준화한다. 릴리즈 준비와 운영 전환 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 배포 게이트 조건(테스트, 보안, 승인자)을 확정한다.
+- 롤백 절차와 롤백 트리거를 검증한다.
+- 모니터링 지표/알림 임계치/온콜 책임자를 확인한다.
+- 릴리즈 노트와 인수인계 문서 초안을 준비한다.
+
 # 실행 절차
 
 1. `CMD-OPS-CI-CD-GATE`로 차단 규칙을 고정한다.
 2. `CMD-OPS-DEPLOY`를 점진 배포 정책으로 실행한다.
 3. `CMD-OPS-MONITORING`과 `CMD-DOC-HANDOFF`로 운영 전환을 완료한다.
 
+# 결과 보고 형식
+
+- 게이트 결과: 통과/실패와 근거
+- 배포 실행 기록: 환경, 버전, 시각, 결과
+- 모니터링 결과: 핵심 SLI 추이, 이상 징후
+- 인수인계 결과: 런북 업데이트, 오너 확인
+
+# 중단 조건
+
+- 게이트 실패 상태에서 우회 요청만 있는 경우
+- 롤백 전략이 검증되지 않은 경우
+- 치명 경보가 발생했는데 원인/완화가 확인되지 않은 경우
+
 # 품질 규칙
 
 - 롤백 전략 검증 없이 배포하지 않는다.

package/codex/skills/security-hardening/SKILL.md

@@ -3,12 +3,32 @@ name: security-hardening
 description: 위협 모델링과 의존성 취약점 감사를 수행하고 보완 코드 반영 및 재검증까지 처리한다. 보안 점검과 취약점 대응 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 신뢰 경계와 보호 대상 자산을 확정한다.
+- 의존성 목록과 현재 취약점 현황을 수집한다.
+- 위협 모델링 범위(인증/인가/데이터/운영)를 고정한다.
+- 예외 승인 정책(책임자, 만료일)을 준비한다.
+
 # 실행 절차
 
-1. `WF-SVC-003`을 선택한다.
+1. `WF-SECURITY-HARDENING`을 선택한다.
 2. `CMD-SEC-THREAT-MODEL`과 `CMD-SEC-DEPENDENCY-AUDIT`를 실행한다.
 3. 보완 코드 반영 후 테스트와 `/review`를 다시 수행한다.
 
+# 결과 보고 형식
+
+- 위협/취약점 목록: 심각도, 영향, 우선순위
+- 보완 적용 내역: 코드/설정 변경과 근거
+- 재검증 결과: 스캔/테스트/리뷰 결과
+- 잔여 위험 및 예외 승인: 책임자, 만료일
+
+# 중단 조건
+
+- 치명 취약점이 남아 있는데 배포를 진행하려는 경우
+- 고위험 위협에 대한 완화 통제가 정의되지 않은 경우
+- 예외 승인이 만료일 없이 요청된 경우
+
 # 품질 규칙
 
 - 치명 취약점 0건이 배포 전 필수 조건이다.

package/codex/skills/service-lifecycle-orchestration/SKILL.md

@@ -3,14 +3,34 @@ name: service-lifecycle-orchestration
 description: 서비스 기획, 설계, 구현, 검증, 배포, 운영 전환을 하나의 절차로 실행한다. 신규 서비스 구축이나 대형 기능 배포 요청에서 사용한다.
 ---
 
+# 시작 전 체크리스트
+
+- 요구사항/ADR/범위/비범위를 확정한다.
+- 각 단계 책임 역할과 승인자를 지정한다.
+- 단계별 진입/종료 기준을 작업 시작 전에 확인한다.
+- 리스크와 롤백 전략을 초기 단계에서 기록한다.
+
 # 실행 절차
 
-1. `workflows/workflow-catalog.json`에서 `WF-SVC-001`을 선택한다.
+1. `workflows/workflow-catalog.json`에서 `WF-SERVICE-E2E`을 선택한다.
 2. 각 단계 시작 전에 `/plan`으로 작업 단위를 잠근다.
 3. 단계별 `commands`를 순서대로 수행한다.
 4. 검증 단계에서 `/review`로 차단 이슈를 확정한다.
 5. 모든 `exit_criteria`를 만족하면 배포 준비를 완료한다.
 
+# 결과 보고 형식
+
+- 단계 상태: 완료/미완료/차단요인
+- 실행 근거: 단계별 명령 ID와 결과
+- 품질 상태: 테스트/보안/리뷰 게이트 결과
+- 다음 행동: 담당자, 마감 조건, 선행 조건
+
+# 중단 조건
+
+- 진입 기준이 충족되지 않은 단계가 있는 경우
+- 차단 이슈가 해결되지 않았는데 다음 단계로 이동하려는 경우
+- 롤백 전략 없이 배포 단계 진입이 요청된 경우
+
 # 품질 규칙
 
 - 명령 ID 기반으로 실행 근거를 남긴다.

package/codex/workflows/workflow-catalog.json

@@ -6,7 +6,7 @@
   },
   "workflows": [
     {
-      "id": "WF-SVC-001",
+      "id": "WF-SERVICE-E2E",
       "name": "신규 서비스 전체 사이클 (기획→구현→검증→배포 준비)",
       "summary": "새 프로젝트 또는 대형 기능을 기획부터 배포 준비까지 한 번에 진행할 때 사용합니다.",
       "execution_surface": [
@@ -90,7 +90,7 @@
       "when_to_use": "신규 서비스 착수, 대형 기능 E2E 추진"
     },
     {
-      "id": "WF-SVC-002",
+      "id": "WF-FEATURE-DELIVERY",
       "name": "기능 추가 표준 (범위 고정→구현→리뷰)",
       "summary": "기존 서비스에 일반 기능을 안전하게 추가하는 표준 흐름입니다.",
       "execution_surface": [
@@ -150,7 +150,7 @@
       "when_to_use": "일반 기능 개발, 반복 개발 사이클"
     },
     {
-      "id": "WF-SVC-003",
+      "id": "WF-SECURITY-HARDENING",
       "name": "보안 하드닝 (진단→보완→재검증)",
       "summary": "보안 진단 후 코드 보완과 재검증까지 닫는 흐름입니다.",
       "execution_surface": [
@@ -210,7 +210,7 @@
       "when_to_use": "정기 보안 점검, 취약점 이슈 대응"
     },
     {
-      "id": "WF-SVC-004",
+      "id": "WF-RELEASE-TRANSITION",
       "name": "배포/운영 전환 (게이트→배포→인수인계)",
       "summary": "릴리즈 게이트 통과부터 운영 안정화 및 인수인계까지 진행합니다.",
       "execution_surface": [
@@ -268,7 +268,7 @@
       "when_to_use": "릴리즈 직전 최종 점검, 운영 전환"
     },
     {
-      "id": "WF-SVC-005",
+      "id": "WF-INCIDENT-RESPONSE",
       "name": "장애 대응 루프 (분류→복구→재발 방지)",
       "summary": "장애 접수 후 복구와 재발 방지 조치까지 수행합니다.",
       "execution_surface": [
@@ -330,7 +330,7 @@
       "when_to_use": "운영 장애 대응, 핫픽스 후속 조치"
     },
     {
-      "id": "WF-PRD-IMPLEMENT-E2E",
+      "id": "WF-PRD-TO-PRODUCTION",
       "name": "PRD 대화형 작성→순차 자동 구현",
       "summary": "PRD는 대화형으로 확정하고 구현은 최종 수동 세팅 전까지 자동 순차 실행합니다.",
       "execution_surface": [

package/common/antigravity/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-TO-PRODUCTION"
+      ]
+    },
+    {
+      "id": "manager-agent",
+      "role": "오케스트레이터",
+      "responsibility": "워크플로우 단계 제어, 에이전트 체인 구성, Artifact 검증 게이트 실행",
+      "default_workflows": [
+        "WF-SERVICE-E2E",
+        "WF-FRONTEND-REFACTOR",
+        "WF-SECURITY-HARDENING"
+      ]
+    },
+    {
+      "id": "incident-manager-agent",
+      "role": "인시던트 오케스트레이터",
+      "responsibility": "장애 대응 워룸 흐름 제어",
+      "default_workflows": [
+        "WF-INCIDENT-RESPONSE"
+      ]
+    },
+    {
+      "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 단독 승인"
+  ]
+}