@dusky-bluehour/agent-service 0.6.6 → 0.6.7

package/catalog/tool-catalog.ko.json

@@ -52,6 +52,20 @@
           "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "입력/실행/품질게이트/산출물 계약이 고정된 명령 집합"
+        },
+        {
+          "id": "instructions",
+          "path": "instructions",
+          "install_path": "instructions",
+          "title": "프로젝트 규칙 템플릿",
+          "description": "프로젝트 루트 CLAUDE.md 자동 생성용 템플릿"
+        },
+        {
+          "id": "settings",
+          "path": "settings",
+          "install_path": "settings",
+          "title": "설정 템플릿",
+          "description": "프로젝트 단위 권한/보안 설정(settings.json) 템플릿"
         }
       ]
     },
@@ -101,6 +115,20 @@
           "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "공통 명령 계약"
+        },
+        {
+          "id": "instructions",
+          "path": "instructions",
+          "install_path": "instructions",
+          "title": "프로젝트 규칙 템플릿",
+          "description": ".agent/rules/workspace-core-rules.md 자동 생성용 템플릿"
+        },
+        {
+          "id": "settings",
+          "path": "settings",
+          "install_path": "settings",
+          "title": "에디터 설정 템플릿",
+          "description": "Antigravity 에디터 반영용 보안/권한 정책 템플릿"
         }
       ]
     },
@@ -151,6 +179,13 @@
           "install_path": "commands",
           "title": "명령 카탈로그",
           "description": "공통 명령 계약"
+        },
+        {
+          "id": "settings",
+          "path": "settings",
+          "install_path": "settings",
+          "title": "런타임 정책 템플릿",
+          "description": "Codex 프로젝트 권한/실행 정책 템플릿"
         }
       ]
     }
@@ -165,20 +200,25 @@
         "skills",
         "subagents",
         "workflows",
-        "commands"
+        "commands",
+        "instructions",
+        "settings"
       ],
       "antigravity": [
         "skills",
         "agents",
         "artifacts",
         "workflows",
-        "commands"
+        "commands",
+        "instructions",
+        "settings"
       ],
       "codex": [
         "skills",
         "instructions",
         "workflows",
-        "commands"
+        "commands",
+        "settings"
       ]
     }
   },
@@ -196,13 +236,16 @@
           "skills",
           "instructions",
           "workflows",
-          "commands"
+          "commands",
+          "settings"
         ],
         "claude-code": [
           "skills",
           "subagents",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ]
       }
     },
@@ -221,21 +264,26 @@
           "subagents",
           "agent-teams",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "antigravity": [
           "skills",
           "agents",
           "artifacts",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "codex": [
           "skills",
           "instructions",
           "automations",
           "workflows",
-          "commands"
+          "commands",
+          "settings"
         ]
       }
     },
@@ -253,19 +301,24 @@
           "skills",
           "subagents",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "antigravity": [
           "skills",
           "agents",
           "artifacts",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "codex": [
           "skills",
           "workflows",
-          "commands"
+          "commands",
+          "settings"
         ]
       }
     },
@@ -282,13 +335,16 @@
           "skills",
           "subagents",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "codex": [
           "skills",
           "instructions",
           "workflows",
-          "commands"
+          "commands",
+          "settings"
         ]
       }
     },
@@ -307,20 +363,25 @@
           "subagents",
           "agent-teams",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "antigravity": [
           "skills",
           "agents",
           "artifacts",
           "workflows",
-          "commands"
+          "commands",
+          "instructions",
+          "settings"
         ],
         "codex": [
           "skills",
           "instructions",
           "workflows",
-          "commands"
+          "commands",
+          "settings"
         ]
       }
     }

package/claude-code/README.md

@@ -11,6 +11,9 @@
 - `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`: 프로젝트/로컬 설정 파일 템플릿
 
 ## 빠른 시작
 
@@ -18,6 +21,30 @@
 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`입니다.
+
+## 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/settings.json`
+
 ## 역할 분리 기준
 
 - 반복 작업은 전문 역할로 분리합니다.

package/claude-code/commands/native/cmd-dev-be-api.md

@@ -0,0 +1,51 @@
+---
+description: "백엔드 API 구현 (CMD-DEV-BE-API)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DEV-BE-API` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+명세 기반으로 안정적인 API와 데이터 접근 계층을 구현한다.
+
+## 입력 계약
+
+### 필수 입력
+- API 계약
+- 도메인 모델
+- 에러 코드 정책
+
+### 선택 입력
+- 기존 엔드포인트 호환 정책
+
+## 실행 절차
+
+1. 계약 우선 방식으로 DTO와 검증 규칙을 작성한다.
+2. 핸들러와 비즈니스 로직을 분리한다.
+3. 권한 검증과 감사 로그를 추가한다.
+4. 회귀 테스트를 작성한다.
+
+## 품질 게이트
+
+- 계약 테스트가 통과해야 한다.
+- 권한 누락 경로가 없어야 한다.
+
+## 산출물
+
+- API 구현 코드
+- 계약 테스트
+- 권한 매트릭스
+
+## 핸드오프
+
+- 다음 역할: qa-engineer, code-reviewer
+- 차단 요인: 계약 불일치, 에러 코드 정책 위반
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-dev-fe-hook-separate.md

@@ -0,0 +1,51 @@
+---
+description: "Hook 분리 (CMD-DEV-FE-HOOK-SEPARATE)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DEV-FE-HOOK-SEPARATE` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+컴포넌트 내부 상태/효과 로직을 재사용 가능한 Hook으로 분리한다.
+
+## 입력 계약
+
+### 필수 입력
+- 대상 컴포넌트
+- 상태 흐름
+- 부수효과 목록
+
+### 선택 입력
+- 성능 프로파일 결과
+
+## 실행 절차
+
+1. UI 렌더링과 상태 오케스트레이션 경계를 식별한다.
+2. Hook의 입력/출력 타입 계약을 정의한다.
+3. 비동기/캐시/재시도 정책을 Hook 내부로 캡슐화한다.
+4. Hook 전용 테스트를 추가한다.
+
+## 품질 게이트
+
+- 컴포넌트 길이가 기준 대비 25% 이상 축소되어야 한다.
+- Hook은 단일 책임을 유지해야 한다.
+
+## 산출물
+
+- 커스텀 Hook
+- Hook 테스트
+- 마이그레이션 노트
+
+## 핸드오프
+
+- 다음 역할: frontend-engineer, performance-engineer
+- 차단 요인: Hook 간 순환 의존, 숨은 전역 상태 의존
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-dev-fe-ui-componentize.md

@@ -0,0 +1,51 @@
+---
+description: "UI 컴포넌트화 (CMD-DEV-FE-UI-COMPONENTIZE)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DEV-FE-UI-COMPONENTIZE` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+반복 UI를 설계 토큰 기반의 재사용 컴포넌트로 분해한다.
+
+## 입력 계약
+
+### 필수 입력
+- 대상 화면
+- 중복 UI 목록
+- 디자인 토큰
+
+### 선택 입력
+- 스토리북 규칙
+
+## 실행 절차
+
+1. 중복 UI를 패턴 단위로 그룹화한다.
+2. Props 계약을 최소화하고 명시적으로 정의한다.
+3. 프레젠테이션 로직과 데이터 로직을 분리한다.
+4. 스토리/스냅샷 테스트를 추가한다.
+
+## 품질 게이트
+
+- 컴포넌트 API 변경 시 하위 호환 전략이 있어야 한다.
+- 동일 UI 중복 코드가 기준 대비 30% 이상 감소해야 한다.
+
+## 산출물
+
+- 공용 UI 컴포넌트
+- 사용 가이드
+- 스토리북 스토리
+
+## 핸드오프
+
+- 다음 역할: frontend-engineer, qa-engineer
+- 차단 요인: 디자인 토큰 누락, 접근성 속성 누락
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-dev-perf-optimize.md

@@ -0,0 +1,51 @@
+---
+description: "성능 최적화 (CMD-DEV-PERF-OPTIMIZE)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DEV-PERF-OPTIMIZE` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+측정 기반으로 병목을 제거하고 사용자 체감 성능을 개선한다.
+
+## 입력 계약
+
+### 필수 입력
+- 성능 목표
+- 현재 측정치
+- 병목 후보
+
+### 선택 입력
+- 트래픽 패턴
+
+## 실행 절차
+
+1. 기준 측정값을 고정한다.
+2. 병목 상위 3개만 우선 해결한다.
+3. 캐싱/메모이제이션/쿼리 최적화를 적용한다.
+4. 개선 후 동일 조건으로 재측정한다.
+
+## 품질 게이트
+
+- 핵심 지표가 목표 이상 개선되어야 한다.
+- 최적화로 인한 기능 회귀가 없어야 한다.
+
+## 산출물
+
+- 전후 비교 리포트
+- 최적화 코드
+- 회귀 테스트
+
+## 핸드오프
+
+- 다음 역할: qa-engineer, sre-release-engineer
+- 차단 요인: 측정 재현 불가, 최적화 효과 미미
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-dev-sequential-autorun.md

@@ -0,0 +1,51 @@
+---
+description: "PRD 기반 순차 자동 구현 (CMD-DEV-SEQUENTIAL-AUTORUN)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DEV-SEQUENTIAL-AUTORUN` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+확정된 세부 PRD 순서대로 구현, 테스트, 리뷰를 연쇄 실행한다.
+
+## 입력 계약
+
+### 필수 입력
+- 구현 배치 계획
+- 세부 PRD 묶음
+- 품질 게이트
+
+### 선택 입력
+- 중간 승인 포인트
+
+## 실행 절차
+
+1. 배치 순서대로 기능 구현을 수행한다.
+2. 각 배치 종료 시 테스트와 리뷰를 자동 실행한다.
+3. UI 컴포넌트화/Hook 분리/성능 최적화/보안 점검을 각 배치에 적용한다.
+4. 최종 수동 설정 단계 직전까지 연속 실행한다.
+
+## 품질 게이트
+
+- 배치별 테스트/리뷰 통과 없이는 다음 배치로 이동하지 않는다.
+- 치명 보안 이슈 또는 차단 이슈 발생 시 즉시 중단한다.
+
+## 산출물
+
+- 배치별 구현 로그
+- 중간 검증 리포트
+- 최종 수동 설정 전 체크리스트
+
+## 핸드오프
+
+- 다음 역할: qa-engineer, security-engineer, sre-release-engineer
+- 차단 요인: 배치 검증 실패, 차단 이슈 미해결
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-doc-handoff.md

@@ -0,0 +1,52 @@
+---
+description: "운영 인수인계 문서화 (CMD-DOC-HANDOFF)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-DOC-HANDOFF` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+사람과 AI가 동일한 기준으로 서비스 상태를 이해하도록 지식을 구조화한다.
+
+## 입력 계약
+
+### 필수 입력
+- 최신 아키텍처
+- 운영 런북
+- 릴리즈 이력
+
+### 선택 입력
+- FAQ
+- 온보딩 자료
+
+## 실행 절차
+
+1. 문서를 역할 기준으로 분리한다.
+2. 명령 ID와 워크플로우 ID를 교차 참조한다.
+3. 변경 이력을 날짜와 함께 기록한다.
+4. 월 1회 갱신 책임자를 지정한다.
+
+## 품질 게이트
+
+- 중요 문서는 최신 배포와 일치해야 한다.
+- 문서만으로 최소 운영 시나리오 재현이 가능해야 한다.
+
+## 산출물
+
+- 운영 핸드북
+- 워크플로우 인덱스
+- 갱신 캘린더
+
+## 핸드오프
+
+- 다음 역할: all
+- 차단 요인: 문서와 실제 동작 불일치
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-improve-techdebt.md

@@ -0,0 +1,51 @@
+---
+description: "기술 부채 정리 (CMD-IMPROVE-TECHDEBT)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-IMPROVE-TECHDEBT` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+장기 생산성을 저해하는 구조적 부채를 우선순위 기반으로 상환한다.
+
+## 입력 계약
+
+### 필수 입력
+- 부채 목록
+- 영향도
+- 상환 비용
+
+### 선택 입력
+- 장애 연관 지표
+
+## 실행 절차
+
+1. 영향도/비용 기준으로 상환 순위를 정한다.
+2. 기능 개발과 충돌하지 않게 배치한다.
+3. 상환 항목별 완료 기준을 정의한다.
+4. 상환 후 구조 단순화 여부를 점검한다.
+
+## 품질 게이트
+
+- 상환 항목은 측정 가능한 결과를 가져야 한다.
+- 미완료 항목은 이유와 다음 시점을 기록해야 한다.
+
+## 산출물
+
+- 부채 상환 백로그
+- 완료 리포트
+- 구조 개선 지표
+
+## 핸드오프
+
+- 다음 역할: product-planner, solution-architect
+- 차단 요인: 상환 우선순위 불명확, 기능 일정과 충돌
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프

package/claude-code/commands/native/cmd-incident-triage.md

@@ -0,0 +1,51 @@
+---
+description: "장애 분류 및 대응 (CMD-INCIDENT-TRIAGE)"
+argument-hint: "[추가 컨텍스트]"
+---
+
+이 명령은 `CMD-INCIDENT-TRIAGE` 계약을 그대로 적용합니다.
+추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
+
+## 목적
+
+장애 영향 범위를 빠르게 파악하고 복구 우선순위를 설정한다.
+
+## 입력 계약
+
+### 필수 입력
+- 장애 알림
+- 영향 서비스
+- 현재 증상
+
+### 선택 입력
+- 최근 배포 이력
+
+## 실행 절차
+
+1. 심각도와 고객 영향을 분류한다.
+2. 워룸 역할과 커뮤니케이션 채널을 고정한다.
+3. 복구 우선 경로를 실행한다.
+4. 복구 후 재발 방지 액션을 등록한다.
+
+## 품질 게이트
+
+- 심각도 기준이 일관되어야 한다.
+- 복구 후 RCA 일정이 지정되어야 한다.
+
+## 산출물
+
+- 장애 타임라인
+- 복구 조치 기록
+- 재발 방지 액션
+
+## 핸드오프
+
+- 다음 역할: code-reviewer, security-engineer, operations-owner
+- 차단 요인: 원인 미확정, 재발 방지 책임자 미지정
+
+## 결과 응답 형식
+
+- 실행 요약(무엇을 왜 수행했는지)
+- 입력 검증(충족/누락 항목)
+- 품질 게이트 통과 여부
+- 산출물 및 다음 핸드오프