@dusky-bluehour/agent-service 0.6.2

package/codex/instructions/AGENTS.override.template.md

@@ -0,0 +1,21 @@
+# AGENTS.override.md 템플릿 (프로젝트별 오버라이드)
+
+## 프로젝트 컨텍스트
+- 도메인:
+- 핵심 사용자:
+- 배포 환경:
+
+## 워크플로우 오버라이드
+- 기본 워크플로우:
+- 추가 게이트:
+- 제외 명령 ID:
+
+## 역할 오버라이드
+- 리뷰 승인자:
+- 보안 책임자:
+- 운영 책임자:
+
+## 품질 기준 오버라이드
+- 테스트 최소 기준:
+- 성능 목표:
+- 보안 기준:

package/codex/instructions/AGENTS.template.md

@@ -0,0 +1,31 @@
+# AGENTS.md 템플릿 (서비스 운영형)
+
+## 1) 실행 원칙
+- 모든 작업은 `commands/command-catalog.json` 명령 ID를 근거로 수행한다.
+- 단계형 작업은 `workflows/workflow-catalog.json`의 `entry_criteria`와 `exit_criteria`를 따른다.
+- 추정 대신 측정값(테스트, 성능, 취약점 결과)을 우선한다.
+
+## 2) 기본 워크플로우 선택 규칙
+- 신규 서비스/대형 기능: `WF-SVC-001`
+- 일반 기능 개발: `WF-SVC-002`
+- 보안 점검/하드닝: `WF-SVC-003`
+- 배포/운영 전환: `WF-SVC-004`
+- 장애 대응: `WF-SVC-005`
+
+## 3) 스킬 라우팅 규칙
+- 범위/요구사항 정리: `service-lifecycle-orchestration`
+- 코드 리뷰/개선: `code-review-and-improvement`
+- 보안 검토: `security-hardening`
+- UI 컴포넌트화/Hook/최적화: `frontend-repetition-pack`
+- 배포/운영: `release-and-operations`
+- 장애 대응: `incident-response`
+
+## 4) 산출물 고정 포맷
+- 상태: `완료 | 미완료 | 차단요인`
+- 근거: `실행한 명령 ID`, `검증 결과`
+- 다음 행동: `담당 역할`, `마감 조건`
+
+## 5) 금지 규칙
+- 차단 이슈를 우회한 병합/배포 금지
+- 치명 취약점 잔존 상태 배포 금지
+- 테스트 실패 상태에서 완료 보고 금지

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

@@ -0,0 +1,16 @@
+---
+name: code-review-and-improvement
+description: 코드 리뷰로 결함을 식별하고 개선안을 반영해 재검증까지 완료한다. PR 리뷰, 품질 개선, 리팩터링 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `WF-SVC-002` 또는 `WF-SVC-005`의 리뷰 단계를 선택한다.
+2. `CMD-REVIEW-CODE`로 차단/권고 이슈를 분리한다.
+3. `CMD-IMPROVE-TECHDEBT`로 개선 우선순위를 고정한다.
+4. `/review`와 테스트를 다시 실행해 회귀를 확인한다.
+
+# 품질 규칙
+
+- 모든 지적은 파일 위치와 재현 경로를 포함한다.
+- 개선 후 재검증 결과를 반드시 남긴다.

package/codex/skills/code-review-and-improvement/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "코드 리뷰/개선"
+  short_description: "리뷰에서 개선 반영까지 닫는 루프"
+  default_prompt: "리뷰 이슈를 중대도별로 분류하고 개선안을 반영해 재검증해줘."

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

@@ -0,0 +1,15 @@
+---
+name: frontend-repetition-pack
+description: 반복적인 프론트엔드 개선(UI 컴포넌트화, Hook 분리, 성능 최적화)을 표준 명령으로 수행한다. 화면 리팩터링과 성능 개선 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `CMD-DEV-FE-UI-COMPONENTIZE`를 먼저 실행한다.
+2. `CMD-DEV-FE-HOOK-SEPARATE`로 로직 분리를 수행한다.
+3. `CMD-DEV-PERF-OPTIMIZE`와 테스트로 개선을 검증한다.
+
+# 품질 규칙
+
+- 전후 지표(중복률, 렌더링 시간)를 기록한다.
+- Hook 계약과 컴포넌트 계약을 문서화한다.

package/codex/skills/frontend-repetition-pack/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "프론트 반복개선"
+  short_description: "컴포넌트화, Hook 분리, 최적화"
+  default_prompt: "반복 프론트엔드 작업을 명령 계약 순서대로 실행해줘."

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

@@ -0,0 +1,16 @@
+---
+name: incident-response
+description: 장애 접수 후 복구, 원인 분석, 재발 방지까지 일괄 처리한다. 긴급 장애 대응과 핫픽스 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `WF-SVC-005`를 실행한다.
+2. `CMD-INCIDENT-TRIAGE`로 심각도/영향도를 확정한다.
+3. 수정 후 `/review`와 테스트로 재발 방지 여부를 검증한다.
+4. `CMD-DOC-HANDOFF`로 운영 런북을 갱신한다.
+
+# 품질 규칙
+
+- 복구 이후 RCA 일정과 책임자를 남긴다.
+- 재발 방지 액션 없는 종료를 금지한다.

package/codex/skills/incident-response/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "장애 대응"
+  short_description: "복구부터 재발 방지까지"
+  default_prompt: "장애 대응 워크플로우를 실행하고 재발 방지 계획까지 완료해줘."

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

@@ -0,0 +1,16 @@
+---
+name: prd-to-production-pipeline
+description: 대화형 PRD 작성 후 세부 PRD를 기준으로 구현을 순차 자동 실행한다. PRD 중심 구현 자동화 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `WF-PRD-IMPLEMENT-E2E`을 시작한다.
+2. PRD 단계는 `/plan`으로 대화형 확정한다.
+3. 구현 단계는 `CMD-DEV-SEQUENTIAL-AUTORUN` 중심으로 순차 실행한다.
+4. 마지막 수동 세팅 단계만 사람이 확인한다.
+
+# 품질 규칙
+
+- 세부 PRD마다 수용 기준을 명시한다.
+- 자동 구현 중 차단 이슈가 발생하면 즉시 중단하고 수정한다.

package/codex/skills/prd-to-production-pipeline/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "PRD→구현 파이프라인"
+  short_description: "대화형 PRD 후 순차 자동 구현"
+  default_prompt: "PRD를 먼저 대화형으로 완성하고, 세부 PRD 기준으로 순차 자동 구현 파이프라인을 실행해줘."

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

@@ -0,0 +1,15 @@
+---
+name: release-and-operations
+description: 배포 게이트 설정, 점진 배포, 모니터링 및 인수인계를 표준화한다. 릴리즈 준비와 운영 전환 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `CMD-OPS-CI-CD-GATE`로 차단 규칙을 고정한다.
+2. `CMD-OPS-DEPLOY`를 점진 배포 정책으로 실행한다.
+3. `CMD-OPS-MONITORING`과 `CMD-DOC-HANDOFF`로 운영 전환을 완료한다.
+
+# 품질 규칙
+
+- 롤백 전략 검증 없이 배포하지 않는다.
+- 운영 문서는 배포 직후 갱신한다.

package/codex/skills/release-and-operations/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "릴리즈/운영 전환"
+  short_description: "게이트-배포-모니터링 통합"
+  default_prompt: "릴리즈 게이트부터 운영 인수인계까지 순서대로 수행해줘."

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

@@ -0,0 +1,15 @@
+---
+name: security-hardening
+description: 위협 모델링과 의존성 취약점 감사를 수행하고 보완 코드 반영 및 재검증까지 처리한다. 보안 점검과 취약점 대응 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `WF-SVC-003`을 선택한다.
+2. `CMD-SEC-THREAT-MODEL`과 `CMD-SEC-DEPENDENCY-AUDIT`를 실행한다.
+3. 보완 코드 반영 후 테스트와 `/review`를 다시 수행한다.
+
+# 품질 규칙
+
+- 치명 취약점 0건이 배포 전 필수 조건이다.
+- 예외 수용은 책임자와 만료일을 포함한다.

package/codex/skills/security-hardening/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "보안 하드닝"
+  short_description: "위협 모델링부터 보완 검증까지"
+  default_prompt: "보안 점검 후 보완 코드와 재검증 결과까지 정리해줘."

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

@@ -0,0 +1,17 @@
+---
+name: service-lifecycle-orchestration
+description: 서비스 기획, 설계, 구현, 검증, 배포, 운영 전환을 하나의 절차로 실행한다. 신규 서비스 구축이나 대형 기능 배포 요청에서 사용한다.
+---
+
+# 실행 절차
+
+1. `workflows/workflow-catalog.json`에서 `WF-SVC-001`을 선택한다.
+2. 각 단계 시작 전에 `/plan`으로 작업 단위를 잠근다.
+3. 단계별 `commands`를 순서대로 수행한다.
+4. 검증 단계에서 `/review`로 차단 이슈를 확정한다.
+5. 모든 `exit_criteria`를 만족하면 배포 준비를 완료한다.
+
+# 품질 규칙
+
+- 명령 ID 기반으로 실행 근거를 남긴다.
+- 차단 이슈가 남아 있으면 다음 단계로 이동하지 않는다.

package/codex/skills/service-lifecycle-orchestration/agents/openai.yaml

@@ -0,0 +1,4 @@
+skill:
+  display_name: "서비스 수명주기 오케스트레이션"
+  short_description: "기획부터 배포까지 단계형 실행"
+  default_prompt: "워크플로우와 명령 ID를 기준으로 서비스 수명주기 작업을 진행해줘."

package/codex/workflows/workflow-catalog.json

@@ -0,0 +1,444 @@
+{
+  "schema_version": "1.0.0",
+  "workflow_policy": {
+    "execution_rule": "각 단계 시작 전에 /plan으로 작업 단위를 잠그고, 단계 종료 시 /review 또는 검증 명령으로 품질을 확인한다.",
+    "mode_rule": "로컬-워크트리-클라우드 모드를 작업 성격에 맞게 선택한다."
+  },
+  "workflows": [
+    {
+      "id": "WF-SVC-001",
+      "name": "신규 서비스 E2E",
+      "summary": "Codex 단일 실행으로 기획부터 배포 준비까지 진행한다.",
+      "execution_surface": [
+        "local",
+        "cloud"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-PLAN",
+          "owner_role": "product-planner-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-PLAN-REQ-LOCK",
+            "CMD-PLAN-ARCH-DECISION"
+          ],
+          "exit_criteria": [
+            "요구사항과 ADR 확정"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-BUILD",
+          "owner_role": "implementation-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-DEV-BE-API",
+            "CMD-DEV-FE-UI-COMPONENTIZE",
+            "CMD-DEV-FE-HOOK-SEPARATE",
+            "CMD-DEV-PERF-OPTIMIZE"
+          ],
+          "exit_criteria": [
+            "핵심 기능 구현",
+            "반복 리팩터 적용"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-VERIFY",
+          "owner_role": "quality-security-skill",
+          "codex_commands": [
+            "/review"
+          ],
+          "commands": [
+            "CMD-TEST-UNIT-INTEGRATION",
+            "CMD-REVIEW-CODE",
+            "CMD-SEC-THREAT-MODEL",
+            "CMD-SEC-DEPENDENCY-AUDIT"
+          ],
+          "exit_criteria": [
+            "차단 이슈 0건",
+            "치명 취약점 0건"
+          ]
+        },
+        {
+          "order": 4,
+          "stage_id": "STG-RELEASE",
+          "owner_role": "release-ops-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-OPS-CI-CD-GATE",
+            "CMD-OPS-DEPLOY",
+            "CMD-DOC-HANDOFF"
+          ],
+          "exit_criteria": [
+            "배포 준비 완료"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "배포 후보",
+        "운영 문서",
+        "검증 보고"
+      ]
+    },
+    {
+      "id": "WF-SVC-002",
+      "name": "기능 개발 표준",
+      "summary": "반복 기능 개발에 사용한다.",
+      "execution_surface": [
+        "local",
+        "worktree"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-SCOPE",
+          "owner_role": "product-planner-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-PLAN-REQ-LOCK"
+          ],
+          "exit_criteria": [
+            "범위 고정"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-IMPLEMENT",
+          "owner_role": "implementation-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-DEV-BE-API",
+            "CMD-DEV-FE-UI-COMPONENTIZE",
+            "CMD-DEV-FE-HOOK-SEPARATE"
+          ],
+          "exit_criteria": [
+            "기능 구현 완료"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-REVIEW",
+          "owner_role": "quality-security-skill",
+          "codex_commands": [
+            "/review"
+          ],
+          "commands": [
+            "CMD-TEST-UNIT-INTEGRATION",
+            "CMD-REVIEW-CODE"
+          ],
+          "exit_criteria": [
+            "리뷰 통과"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "병합 가능 PR"
+      ]
+    },
+    {
+      "id": "WF-SVC-003",
+      "name": "보안 하드닝",
+      "summary": "정기 보안 배치 또는 취약점 이슈 대응에 사용한다.",
+      "execution_surface": [
+        "local",
+        "cloud"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-AUDIT",
+          "owner_role": "quality-security-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-SEC-THREAT-MODEL",
+            "CMD-SEC-DEPENDENCY-AUDIT"
+          ],
+          "exit_criteria": [
+            "보완 목록 확정"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-HARDEN",
+          "owner_role": "implementation-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-DEV-BE-API",
+            "CMD-IMPROVE-TECHDEBT"
+          ],
+          "exit_criteria": [
+            "보완 코드 반영"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-RECHECK",
+          "owner_role": "quality-security-skill",
+          "codex_commands": [
+            "/review"
+          ],
+          "commands": [
+            "CMD-TEST-UNIT-INTEGRATION",
+            "CMD-REVIEW-CODE"
+          ],
+          "exit_criteria": [
+            "치명/고위험 0건"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "보안 개선 보고"
+      ]
+    },
+    {
+      "id": "WF-SVC-004",
+      "name": "배포-운영 전환",
+      "summary": "배포와 운영 안정화를 묶어서 실행한다.",
+      "execution_surface": [
+        "local",
+        "cloud"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-GATE",
+          "owner_role": "release-ops-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-OPS-CI-CD-GATE"
+          ],
+          "exit_criteria": [
+            "배포 게이트 통과"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-DEPLOY",
+          "owner_role": "release-ops-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-OPS-DEPLOY",
+            "CMD-OPS-MONITORING"
+          ],
+          "exit_criteria": [
+            "배포 안정화"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-HANDOFF",
+          "owner_role": "release-ops-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-DOC-HANDOFF"
+          ],
+          "exit_criteria": [
+            "운영 인수인계 완료"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "운영 전환 완료"
+      ]
+    },
+    {
+      "id": "WF-SVC-005",
+      "name": "장애 대응 루프",
+      "summary": "장애 접수부터 재발 방지까지 수행한다.",
+      "execution_surface": [
+        "local",
+        "cloud"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-TRIAGE",
+          "owner_role": "release-ops-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-INCIDENT-TRIAGE",
+            "CMD-OPS-MONITORING"
+          ],
+          "exit_criteria": [
+            "복구 완료"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-FIX",
+          "owner_role": "implementation-skill",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-IMPROVE-TECHDEBT",
+            "CMD-DEV-BE-API"
+          ],
+          "exit_criteria": [
+            "근본 원인 수정"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-POST",
+          "owner_role": "quality-security-skill",
+          "codex_commands": [
+            "/review"
+          ],
+          "commands": [
+            "CMD-REVIEW-CODE",
+            "CMD-SEC-THREAT-MODEL",
+            "CMD-DOC-HANDOFF"
+          ],
+          "exit_criteria": [
+            "재발 방지 조치 확정"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "RCA",
+        "재발 방지 백로그"
+      ]
+    },
+    {
+      "id": "WF-PRD-IMPLEMENT-E2E",
+      "name": "PRD 대화형 작성 후 순차 자동 구현",
+      "summary": "PRD 단계는 대화형으로, 구현 단계는 최종 세팅 전까지 자동 순차 실행",
+      "execution_surface": [
+        "local",
+        "cloud"
+      ],
+      "stages": [
+        {
+          "order": 1,
+          "stage_id": "STG-PRD-MASTER",
+          "owner_role": "prd-orchestration-skill",
+          "interaction_mode": "interactive",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-PLAN-PRD-MASTER"
+          ],
+          "exit_criteria": [
+            "마스터 PRD 승인"
+          ]
+        },
+        {
+          "order": 2,
+          "stage_id": "STG-PRD-DETAIL",
+          "owner_role": "prd-orchestration-skill",
+          "interaction_mode": "interactive",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-PLAN-PRD-DETAILS"
+          ],
+          "exit_criteria": [
+            "세부 PRD 확정"
+          ]
+        },
+        {
+          "order": 3,
+          "stage_id": "STG-BOOTSTRAP",
+          "owner_role": "prd-orchestration-skill",
+          "interaction_mode": "interactive",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-PLAN-IMPLEMENTATION-BOOTSTRAP"
+          ],
+          "exit_criteria": [
+            "구현 배치 계획 확정"
+          ]
+        },
+        {
+          "order": 4,
+          "stage_id": "STG-SEQUENTIAL-AUTO",
+          "owner_role": "implementation-skill",
+          "interaction_mode": "autonomous-sequential",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-DEV-SEQUENTIAL-AUTORUN",
+            "CMD-DEV-BE-API",
+            "CMD-DEV-FE-UI-COMPONENTIZE",
+            "CMD-DEV-FE-HOOK-SEPARATE",
+            "CMD-DEV-PERF-OPTIMIZE"
+          ],
+          "exit_criteria": [
+            "최종 수동 설정 전 자동 구현 완료"
+          ]
+        },
+        {
+          "order": 5,
+          "stage_id": "STG-VERIFY",
+          "owner_role": "quality-security-skill",
+          "interaction_mode": "autonomous-sequential",
+          "codex_commands": [
+            "/review"
+          ],
+          "commands": [
+            "CMD-TEST-UNIT-INTEGRATION",
+            "CMD-REVIEW-CODE",
+            "CMD-SEC-THREAT-MODEL",
+            "CMD-SEC-DEPENDENCY-AUDIT"
+          ],
+          "exit_criteria": [
+            "차단 이슈 0건",
+            "치명 취약점 0건"
+          ]
+        },
+        {
+          "order": 6,
+          "stage_id": "STG-FINAL-SETUP",
+          "owner_role": "release-ops-skill",
+          "interaction_mode": "manual-final-setup",
+          "codex_commands": [
+            "/plan"
+          ],
+          "commands": [
+            "CMD-OPS-CI-CD-GATE",
+            "CMD-OPS-DEPLOY",
+            "CMD-DOC-HANDOFF"
+          ],
+          "exit_criteria": [
+            "최종 세팅 및 배포 준비 완료"
+          ]
+        }
+      ],
+      "final_outputs": [
+        "PRD 패키지",
+        "구현 결과",
+        "배포 준비 패키지"
+      ]
+    }
+  ]
+}