@dusky-bluehour/agent-service 0.6.6 → 0.6.7

package/README.md

@@ -1,46 +1,29 @@
 # tri-agent-manager
 
-```bash
-pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --interactive
-```
-
 `@dusky-bluehour/agent-service` 패키지로 Claude Code / Antigravity / Codex 운영팩을 설치/업데이트하는 CLI입니다.
 
-## 빠른 실행 (설치 없이)
-
-```bash
-pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --interactive
-```
+## 빠른 실행 (npx, 설치 없이)
 
 ```bash
 npx --yes --package @dusky-bluehour/agent-service tri-agent-manager --interactive
 ```
 
-## 패키지 다운로드 후 사용
-
-```bash
-# 프로젝트에 패키지 설치
-pnpm add -D @dusky-bluehour/agent-service@latest
-
-# 실행
-pnpm exec tri-agent-manager --interactive
-```
-
-npm 사용자:
-
-```bash
-npm install -D @dusky-bluehour/agent-service@latest
-npx tri-agent-manager --interactive
-```
-
 ## 자주 쓰는 명령
 
 ```bash
 # 업데이트 대화형
-pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager update --interactive
+npx --yes --package @dusky-bluehour/agent-service tri-agent-manager update --interactive
 
 # 도움말
-pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --help
+npx --yes --package @dusky-bluehour/agent-service tri-agent-manager --help
+
+# 규칙 파일 생성 정책 지정
+npx --yes --package @dusky-bluehour/agent-service tri-agent-manager install \
+  --tool antigravity \
+  --components skills,workflows \
+  --project-rules if-instructions \
+  --target . \
+  --yes
 ```
 
 ## 설치 결과
@@ -48,6 +31,7 @@ pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --help
 - Claude Code: `<target>/.claude/*`
 - Antigravity: `<target>/.agent/*`
 - Codex: `<target>/.codex/*`
+- 프로젝트 규칙 파일: `<target>/CLAUDE.md`, `<target>/AGENTS.md`, `<target>/<antigravity-install-root>/rules/workspace-core-rules.md` (`--project-rules` 정책 기준으로 생성/업데이트)
 - 가이드: `<target>/.tri-agent-manager/USAGE.ko.md`
 
 ## 개발자용 (정의 변경 시)
@@ -64,3 +48,11 @@ npm run validate
 
 - 공통 원천은 `common/*`에서만 수정합니다.
 - `claude-code/*`, `codex/*`, `antigravity/*`는 생성 결과로 취급합니다.
+- 명령은 공통 계약(`common/commands/command-catalog.json`)에서 툴별 네이티브 포맷으로 변환됩니다.
+  - Claude Code: `claude-code/commands/native/*.md`
+  - Codex: `codex/skills/cmd-*/`
+  - Antigravity: `antigravity/commands/definitions/*.md`
+- 설정은 공통 보안 정책(`common/settings/security-policy.json`)에서 툴별 템플릿으로 변환됩니다.
+  - Claude Code: `claude-code/settings/settings.json`, `claude-code/settings/settings.local.json`
+  - Codex: `codex/settings/runtime-policy.json`
+  - Antigravity: `antigravity/settings/editor-policy.json`

package/antigravity/README.md

@@ -12,6 +12,9 @@
 - `workflows/workflow-catalog.json`: 오케스트레이션 워크플로우
 - `workflows/definitions/*.workflow.yaml`: Antigravity 실행용 워크플로우 정의 파일
 - `commands/command-catalog.json`: 공통 명령 계약
+- `commands/definitions/*.md`: 공통 명령 계약에서 변환된 Antigravity 명령 정의 파일
+- `instructions/WORKSPACE-RULES.template.md`: `.agent/rules/workspace-core-rules.md` 자동 생성용 템플릿
+- `settings/editor-policy.json`: 에디터 반영용 보안/권한 정책 템플릿
 
 ## 빠른 시작
 
@@ -21,6 +24,10 @@
 4. `output_artifact` 검증 후 다음 단계로 진행해 주세요.
 
 워크플로우 카탈로그에서 선택한 ID와 동일한 이름의 정의 파일을 `workflows/definitions/`에서 사용하시면 됩니다. 예: `WF-SERVICE-E2E.workflow.yaml`
+명령 실행 시에는 `commands/definitions/`의 대응 파일(`cmd-*.md`)을 함께 참조해 입력/게이트/핸드오프를 고정해 주세요.
+
+에디터 권한 정책은 `settings/editor-policy.json`을 기준으로 팀 표준을 맞춰 반영해 주세요.
+설치 시 `<install-root>/rules/workspace-core-rules.md`가 자동 생성되며(기존 파일 유지), Manager 승인/운영 규칙 문서로 사용할 수 있습니다.
 
 ## 반복 작업 역할 분리
 

package/antigravity/commands/definitions/cmd-dev-be-api.md

@@ -0,0 +1,43 @@
+# generated by scripts/generate-from-common.mjs
+
+# CMD-DEV-BE-API - 백엔드 API 구현
+
+- phase: 개발
+- owner_role: backend-engineer
+
+## Purpose
+
+명세 기반으로 안정적인 API와 데이터 접근 계층을 구현한다.
+
+## Input Contract
+
+### Required
+- API 계약
+- 도메인 모델
+- 에러 코드 정책
+
+### Optional
+- 기존 엔드포인트 호환 정책
+
+## Execution Contract
+
+1. 계약 우선 방식으로 DTO와 검증 규칙을 작성한다.
+2. 핸들러와 비즈니스 로직을 분리한다.
+3. 권한 검증과 감사 로그를 추가한다.
+4. 회귀 테스트를 작성한다.
+
+## Quality Gates
+
+- 계약 테스트가 통과해야 한다.
+- 권한 누락 경로가 없어야 한다.
+
+## Output Contract
+
+- API 구현 코드
+- 계약 테스트
+- 권한 매트릭스
+
+## Handoff
+
+- next_roles: qa-engineer, code-reviewer
+- blockers: 계약 불일치, 에러 코드 정책 위반

package/antigravity/commands/definitions/cmd-dev-fe-hook-separate.md

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

package/antigravity/commands/definitions/cmd-dev-fe-ui-componentize.md

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

package/antigravity/commands/definitions/cmd-dev-perf-optimize.md

@@ -0,0 +1,43 @@
+# generated by scripts/generate-from-common.mjs
+
+# CMD-DEV-PERF-OPTIMIZE - 성능 최적화
+
+- phase: 개발
+- owner_role: performance-engineer
+
+## Purpose
+
+측정 기반으로 병목을 제거하고 사용자 체감 성능을 개선한다.
+
+## Input Contract
+
+### Required
+- 성능 목표
+- 현재 측정치
+- 병목 후보
+
+### Optional
+- 트래픽 패턴
+
+## Execution Contract
+
+1. 기준 측정값을 고정한다.
+2. 병목 상위 3개만 우선 해결한다.
+3. 캐싱/메모이제이션/쿼리 최적화를 적용한다.
+4. 개선 후 동일 조건으로 재측정한다.
+
+## Quality Gates
+
+- 핵심 지표가 목표 이상 개선되어야 한다.
+- 최적화로 인한 기능 회귀가 없어야 한다.
+
+## Output Contract
+
+- 전후 비교 리포트
+- 최적화 코드
+- 회귀 테스트
+
+## Handoff
+
+- next_roles: qa-engineer, sre-release-engineer
+- blockers: 측정 재현 불가, 최적화 효과 미미

package/antigravity/commands/definitions/cmd-dev-sequential-autorun.md

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

package/antigravity/commands/definitions/cmd-doc-handoff.md

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

package/antigravity/commands/definitions/cmd-improve-techdebt.md

@@ -0,0 +1,43 @@
+# generated by scripts/generate-from-common.mjs
+
+# CMD-IMPROVE-TECHDEBT - 기술 부채 정리
+
+- phase: 개선
+- owner_role: tech-debt-manager
+
+## Purpose
+
+장기 생산성을 저해하는 구조적 부채를 우선순위 기반으로 상환한다.
+
+## Input Contract
+
+### Required
+- 부채 목록
+- 영향도
+- 상환 비용
+
+### Optional
+- 장애 연관 지표
+
+## Execution Contract
+
+1. 영향도/비용 기준으로 상환 순위를 정한다.
+2. 기능 개발과 충돌하지 않게 배치한다.
+3. 상환 항목별 완료 기준을 정의한다.
+4. 상환 후 구조 단순화 여부를 점검한다.
+
+## Quality Gates
+
+- 상환 항목은 측정 가능한 결과를 가져야 한다.
+- 미완료 항목은 이유와 다음 시점을 기록해야 한다.
+
+## Output Contract
+
+- 부채 상환 백로그
+- 완료 리포트
+- 구조 개선 지표
+
+## Handoff
+
+- next_roles: product-planner, solution-architect
+- blockers: 상환 우선순위 불명확, 기능 일정과 충돌

package/antigravity/commands/definitions/cmd-incident-triage.md

@@ -0,0 +1,43 @@
+# generated by scripts/generate-from-common.mjs
+
+# CMD-INCIDENT-TRIAGE - 장애 분류 및 대응
+
+- phase: 운영
+- owner_role: incident-commander
+
+## Purpose
+
+장애 영향 범위를 빠르게 파악하고 복구 우선순위를 설정한다.
+
+## Input Contract
+
+### Required
+- 장애 알림
+- 영향 서비스
+- 현재 증상
+
+### Optional
+- 최근 배포 이력
+
+## Execution Contract
+
+1. 심각도와 고객 영향을 분류한다.
+2. 워룸 역할과 커뮤니케이션 채널을 고정한다.
+3. 복구 우선 경로를 실행한다.
+4. 복구 후 재발 방지 액션을 등록한다.
+
+## Quality Gates
+
+- 심각도 기준이 일관되어야 한다.
+- 복구 후 RCA 일정이 지정되어야 한다.
+
+## Output Contract
+
+- 장애 타임라인
+- 복구 조치 기록
+- 재발 방지 액션
+
+## Handoff
+
+- next_roles: code-reviewer, security-engineer, operations-owner
+- blockers: 원인 미확정, 재발 방지 책임자 미지정

package/antigravity/commands/definitions/cmd-ops-ci-cd-gate.md

@@ -0,0 +1,43 @@
+# generated by scripts/generate-from-common.mjs
+
+# CMD-OPS-CI-CD-GATE - CI/CD 게이트 고정
+
+- phase: 배포
+- owner_role: sre-release-engineer
+
+## Purpose
+
+품질/보안 기준 미충족 변경이 배포되지 않도록 자동 차단한다.
+
+## Input Contract
+
+### Required
+- 테스트 결과
+- 리뷰 상태
+- 보안 점검 상태
+
+### Optional
+- 성능 기준 리포트
+
+## Execution Contract
+
+1. 필수 체크를 파이프라인 게이트로 등록한다.
+2. 실패 시 자동 중단 및 알림을 설정한다.
+3. 배포 승인 정책을 역할 기반으로 고정한다.
+4. 릴리즈 노트 자동 생성을 연결한다.
+
+## Quality Gates
+
+- 게이트 우회 경로가 없어야 한다.
+- 실패 원인이 추적 가능해야 한다.
+
+## Output Contract
+
+- 파이프라인 설정
+- 승인 정책
+- 릴리즈 노트 템플릿
+
+## Handoff
+
+- next_roles: sre-release-engineer
+- blockers: 필수 체크 누락, 알림 라우팅 오류

package/antigravity/commands/definitions/cmd-ops-deploy.md

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

package/antigravity/commands/definitions/cmd-ops-monitoring.md

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

package/antigravity/commands/definitions/cmd-plan-arch-decision.md

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

package/antigravity/commands/definitions/cmd-plan-implementation-bootstrap.md

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