npm - @dusky-bluehour/agent-service - Versions diffs - 0.6.7 → 0.6.8 - Mend

@dusky-bluehour/agent-service 0.6.7 → 0.6.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

package/claude-code/README.md CHANGED Viewed

@@ -1,76 +1,94 @@
 # Claude Code 운영팩
-이 폴더는 Claude Code에서 서비스 운영 전체(기획-개발-배포-운영-보안-개선)를 실행하실 수 있도록 스킬, 서브에이전트, 팀, 워크플로우 정의를 담고 있습니다.
-정의 원천은 저장소 `common/*`이며, 이 폴더의 파일은 생성 스크립트(`npm run generate`) 결과입니다.
-직접 수정 대신 공통 원천을 수정한 뒤 재생성해 주세요.
+Claude Code에서 서비스 운영 전체(기획-개발-배포-운영-보안-개선)를 실행할 수 있도록 스킬, 서브에이전트, 팀, 명령 정의를 제공합니다.
-## 폴더 구성
-- `skills/`: Claude Skills (`SKILL.md` 기반)
-- `subagents/`: 역할별 서브에이전트 프롬프트
-- `agent-teams/team-catalog.json`: 팀 구성과 기본 워크플로우 매핑
-- `workflows/workflow-catalog.json`: 단계형 실행 정의
-- `commands/command-catalog.json`: 공통 명령 계약
-- `commands/native/*.md`: Claude Custom Slash Command용 네이티브 명령 프롬프트
-- `instructions/CLAUDE.template.md`: 프로젝트 루트 `CLAUDE.md` 자동 생성용 템플릿
-- `settings/settings.json`, `settings/settings.local.json`: 프로젝트/로컬 설정 파일 템플릿
-## 빠른 시작
-1. 워크플로우를 선택해 주세요: `WF-SERVICE-E2E`(E2E), `WF-CODE-REVIEW-LOOP`(리뷰 루프), `WF-SECURITY-HARDENING`(보안), `WF-INCIDENT-RESPONSE`(장애 대응), `WF-PRD-TO-PRODUCTION`(PRD→구현)
-2. 단계별 명령을 실행해 주세요: 각 stage의 `commands` ID 순서대로 실행
-3. 품질 검증을 확인해 주세요: stage `exit_criteria`를 모두 충족해야 다음 단계로 이동
-## Claude 네이티브 커맨드 사용
-`commands/native/*.md`는 `common/commands/command-catalog.json`에서 자동 변환된 Claude Custom Slash Command 파일입니다.
-- 설치 경로: `<repo>/.claude/commands/*.md` 또는 `~/.claude/commands/*.md`
-- 실행 예시: `/cmd-plan-req-lock`, `/cmd-dev-be-api`
-- 추가 컨텍스트는 명령 뒤 인자로 전달합니다.
-`command-catalog.json`은 계약 원본(SSOT)이고, 실제 실행은 `commands/native/*.md`를 기준으로 하시면 됩니다.
-## 프로젝트 규칙 파일 (자동 생성)
-설치 시 프로젝트 루트에 `CLAUDE.md`가 자동 생성됩니다(기존 파일이 있으면 유지).
-템플릿 원본은 `instructions/CLAUDE.template.md`입니다.
+> 이 폴더의 파일은 `npm run generate`로 `common/*`에서 자동 생성됩니다. 직접 수정하지 마세요.
-## Claude 설정 템플릿 사용
-`settings/settings.json`을 프로젝트 기본 설정으로 사용하실 수 있습니다.
+## 폴더 구성
-- 설치 결과 템플릿: `<repo>/.claude/settings/settings.json`, `<repo>/.claude/settings/settings.local.json`
-- 프로젝트 공용(활성 파일): `<repo>/.claude/settings.json`
-- 개인 오버라이드(활성 파일): `<repo>/.claude/settings.local.json`
+```
+claude-code/
+  skills/<name>/SKILL.md             8개 운영 스킬
+  subagents/<role>.md                15개 서브에이전트 프롬프트
+  agent-teams/team-catalog.json      3개 팀 구성
+  commands/
+    command-catalog.json             공통 명령 계약 (SSOT)
+    native/*.md                      20개 네이티브 슬래시 명령
+  instructions/CLAUDE.template.md    CLAUDE.md 자동 생성 템플릿
+  settings/
+    settings.json                    프로젝트 설정 템플릿
+    settings.local.json              로컬 설정 템플릿
+```
+## 설치 시 생성 구조
+```
+<project>/
+  .claude/
+    skills/<name>/SKILL.md           스킬 자동 인식
+    agents/<role>.md                 서브에이전트 프롬프트
+    agent-teams/team-catalog.json    팀 카탈로그
+    commands/<name>.md               /cmd-* 슬래시 명령
+    instructions/CLAUDE.template.md
+    settings/settings.json
+  CLAUDE.md                          프로젝트 규칙 파일 (기존 파일 유지)
+```
+## 사용 방법
+### 스킬 사용
+`.claude/skills/<name>/SKILL.md`를 Claude Code가 자동 인식합니다. 사용자 요청에 매칭되면 스킬의 상세 절차를 실행합니다.
+| 스킬 | 역할 |
+|------|------|
+| `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` | 전체 수명주기 오케스트레이션 |
+### 네이티브 슬래시 명령
+`commands/native/*.md`가 Claude Custom Slash Command로 설치됩니다.
+```bash
+# 실행 예시
+/cmd-plan-req-lock
+/cmd-dev-be-api
+/cmd-review-code
+/cmd-sec-threat-model
+```
+명령 뒤에 추가 컨텍스트를 인자로 전달할 수 있습니다.
+### 서브에이전트 & 팀
+리드(`lead-orchestrator`)가 전문 서브에이전트에게 작업을 위임하는 구조입니다.
+**15개 서브에이전트:**
+`lead-orchestrator`, `backend-engineer`, `frontend-engineer`, `ui-component-engineer`, `hook-refactor-engineer`, `performance-engineer`, `security-engineer`, `code-reviewer`, `qa-engineer`, `product-planner`, `prd-writer`, `solution-architect`, `incident-commander`, `sre-release-engineer`, `operations-owner`
+**3개 팀:**
+| 팀 ID | 구성 | 용도 |
+|-------|------|------|
+| `TEAM-SVC-DELIVERY` | 리드 + 개발/QA/보안 | 서비스 딜리버리 |
+| `TEAM-SEC-HARDENING` | 리드 + 보안/개발/QA | 보안 강화 |
+| `TEAM-INCIDENT` | 리드 + 장애대응/개발/운영 | 장애 워룸 |
+`agent-teams/team-catalog.json`을 단일 진입점으로 사용합니다.
+### 설정 템플릿
+- 프로젝트 공용: `<repo>/.claude/settings.json`
+- 개인 오버라이드: `<repo>/.claude/settings.local.json`
 - 전역 공용: `~/.claude/settings.json`
-## 역할 분리 기준
-- 반복 작업은 전문 역할로 분리합니다.
-- UI 컴포넌트화: `ui-component-engineer`
-- Hook 분리: `hook-refactor-engineer`
-- 최적화: `performance-engineer`
-- 변경점 안전 검토: `change-safety-review` + `code-reviewer`, `qa-engineer`, `performance-engineer`
-- PRD 작성: `prd-writer`
-## 서브에이전트 팀 운영 기준
-- 리드: `lead-orchestrator`
-- 병렬 협업: `TEAM-SVC-DELIVERY`
-- 보안 배치: `TEAM-SEC-HARDENING`
-- 장애 워룸: `TEAM-INCIDENT`
-2026-02-17 기준으로 Agent Teams를 사용하시면 리드가 전문 에이전트에게 작업을 분배하는 구조를 안정적으로 구성하실 수 있습니다. 구현 시에는 `agent-teams/team-catalog.json`을 단일 진입점으로 사용해 주세요.
-## 실제 위치로 옮기실 때
-- Claude 사용자 전역: `~/.claude/agents/`, `~/.claude/skills/`
-- 프로젝트 로컬: `<repo>/.claude/agents/`, `<repo>/.claude/skills/`
-이 폴더의 하위 파일을 위 경로로 복사하신 뒤, 프로젝트의 팀 규칙에 맞게 도구 권한과 모델을 조정해 주세요.
-## 참고 문서 (검증일: 2026-02-17)
+## 참고 문서
 - [Claude Code Subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents)
 - [Claude Code Agent Teams](https://docs.anthropic.com/en/docs/claude-code/agent-teams)

package/codex/README.md CHANGED Viewed

@@ -1,53 +1,75 @@
 # Codex 운영팩
-이 폴더는 Codex에서 서비스 운영형 작업(기획-개발-검증-보안-배포-운영)을 반복 가능하게 구성하시도록 스킬/워크플로우/지침 세트를 제공합니다.
-정의 원천은 저장소 `common/*`이며, 이 폴더의 파일은 생성 스크립트(`npm run generate`) 결과입니다.
-직접 수정 대신 공통 원천을 수정한 뒤 재생성해 주세요.
+Codex에서 서비스 운영형 작업(기획-개발-검증-보안-배포-운영)을 반복 가능하게 구성하는 스킬/지침/자동화 세트를 제공합니다.
+> 이 폴더의 파일은 `npm run generate`로 `common/*`에서 자동 생성됩니다. 직접 수정하지 마세요.
 ## 폴더 구성
-- `skills/`: Codex Skills (`SKILL.md` + `agents/openai.yaml`)
-- `skills/cmd-*/`: 공통 명령 계약에서 변환된 Codex 명령 스킬
-- `workflows/workflow-catalog.json`: 단계형 실행 표준
-- `commands/command-catalog.json`: 공통 명령 계약
-- `settings/runtime-policy.json`: 프로젝트 권한/실행 정책 템플릿
-- `instructions/AGENTS.template.md`: 프로젝트용 AGENTS 템플릿
-- `instructions/AGENTS.permissions.generated.md`: 권한 정책용 AGENTS 스니펫(자동 생성)
-- `automations/automation-recipes.toml`: 반복 작업 자동화 레시피
+```
+codex/
+  skills/<name>/SKILL.md             8개 운영 스킬
+  skills/<name>/agents/openai.yaml   에이전트 정의
+  skills/cmd-*/SKILL.md              20개 명령 스킬 (공통 명령 변환)
+  skills/cmd-*/agents/openai.yaml    명령 스킬 에이전트 정의
+  automations/automation-recipes.toml  반복 작업 자동화 레시피
+  commands/command-catalog.json      공통 명령 계약 (SSOT)
+  instructions/
+    AGENTS.template.md               AGENTS.md 자동 생성 템플릿
+    AGENTS.permissions.generated.md  권한 정책 스니펫 (자동 생성)
+  settings/runtime-policy.json       런타임 권한 정책
+```
-## 빠른 시작
+## 설치 시 생성 구조
-1. 설치 시 프로젝트 루트에 `AGENTS.md`가 자동 생성됩니다(기존 파일이 있으면 유지). 필요 시 보완해 주세요.
-2. 작업 유형에 맞는 워크플로우(`WF-SERVICE-E2E`~`WF-INCIDENT-RESPONSE`, `WF-PRD-TO-PRODUCTION`)를 선택해 주세요.
-3. 명령 ID를 기준으로 실행하시고, 검증 단계에서 `/review`를 수행해 주세요.
-4. 명령 단위 실행이 필요하면 `cmd-*` 스킬(`skills/cmd-*/`)을 직접 호출해 주세요.
+```
+<project>/
+  .codex/
+    skills/<name>/SKILL.md           8개 스킬
+    skills/<name>/agents/openai.yaml
+    skills/cmd-*/SKILL.md            20개 명령 스킬
+    automations/automation-recipes.toml
+    commands/command-catalog.json
+    instructions/AGENTS.template.md
+    settings/runtime-policy.json
+  AGENTS.md                          프로젝트 규칙 파일 (기존 파일 유지)
+```
-## Codex 명령 실행 방식 (중요)
+## 사용 방법
-2026-02-19 기준 Codex는 Claude처럼 별도 커스텀 명령 폴더(`.codex/commands/*.md`)를 공식 포맷으로 제공하지 않습니다.
-이 패키지는 공통 명령 계약을 Codex 네이티브 방식으로 변환해 `skills/cmd-*/` 스킬로 제공합니다.
+### 스킬 사용
-- 계약 원본(SSOT): `commands/command-catalog.json`
-- Codex 실행 아티팩트: `skills/cmd-*/SKILL.md`, `skills/cmd-*/agents/openai.yaml`
+8개 운영 스킬 + 20개 명령 스킬이 Codex 네이티브 스킬 UI로 표시됩니다.
-## 스킬 설치 위치
+| 스킬 | 역할 |
+|------|------|
+| `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` | 전체 수명주기 오케스트레이션 |
-- 프로젝트 로컬: `<repo>/.codex/skills/<skill-name>/SKILL.md`
-- 사용자 전역: `~/.codex/skills/<skill-name>/SKILL.md`
+### 명령 실행
+Codex는 별도 커스텀 명령 폴더를 공식 지원하지 않으므로, 공통 명령 계약을 `skills/cmd-*/` 스킬로 변환하여 네이티브 실행 경로를 제공합니다.
-현재 폴더의 `skills/` 하위 디렉터리를 위 경로로 복사하시면 재사용하실 수 있습니다.
+- 계약 원본: `commands/command-catalog.json`
+- 실행 아티팩트: `skills/cmd-*/SKILL.md` + `agents/openai.yaml`
-## 반복 작업 역할 분리
+### 자동화 레시피
-- 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`
-- 변경점 안전 검토: `change-safety-review` + `CMD-TEST-UNIT-INTEGRATION`, `CMD-REVIEW-CODE`
-- PRD 파이프라인: `prd-to-production-pipeline` + `WF-PRD-TO-PRODUCTION`
+`automations/automation-recipes.toml`에 주기 점검, 보안 배치, 리뷰 자동화 프리셋이 포함됩니다.
+### 스킬 설치 위치
+- 프로젝트 로컬: `<repo>/.codex/skills/<skill-name>/SKILL.md`
+- 사용자 전역: `~/.codex/skills/<skill-name>/SKILL.md`
-## 참고 문서 (검증일: 2026-02-17)
+## 참고 문서
 - [Codex Agent Skills](https://developers.openai.com/codex/agents/)
-- [Codex Workflows](https://developers.openai.com/codex/workflows/)
 - [Codex AGENTS.md Guide](https://developers.openai.com/codex/config/)
 - [Codex Automations](https://developers.openai.com/codex/automations/)

package/common/settings/security-policy.json CHANGED Viewed

@@ -195,7 +195,7 @@
       "additional_directories": []
     }
   },
-  "antigravity": {
+  "gemini": {
     "editor_settings": {
       "autonomy_level": "balanced",
       "require_approval": {