@dusky-bluehour/agent-service 0.6.6 → 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.
- package/README.md +255 -36
- package/catalog/tool-catalog.ko.json +92 -57
- package/claude-code/README.md +75 -30
- package/claude-code/commands/native/cmd-dev-be-api.md +51 -0
- package/claude-code/commands/native/cmd-dev-fe-hook-separate.md +51 -0
- package/claude-code/commands/native/cmd-dev-fe-ui-componentize.md +51 -0
- package/claude-code/commands/native/cmd-dev-perf-optimize.md +51 -0
- package/claude-code/commands/native/cmd-dev-sequential-autorun.md +51 -0
- package/claude-code/commands/native/cmd-doc-handoff.md +52 -0
- package/claude-code/commands/native/cmd-improve-techdebt.md +51 -0
- package/claude-code/commands/native/cmd-incident-triage.md +51 -0
- package/claude-code/commands/native/cmd-ops-ci-cd-gate.md +51 -0
- package/claude-code/commands/native/cmd-ops-deploy.md +51 -0
- package/claude-code/commands/native/cmd-ops-monitoring.md +51 -0
- package/claude-code/commands/native/cmd-plan-arch-decision.md +51 -0
- package/claude-code/commands/native/cmd-plan-implementation-bootstrap.md +51 -0
- package/claude-code/commands/native/cmd-plan-prd-details.md +51 -0
- package/claude-code/commands/native/cmd-plan-prd-master.md +52 -0
- package/claude-code/commands/native/cmd-plan-req-lock.md +52 -0
- package/claude-code/commands/native/cmd-review-code.md +51 -0
- package/claude-code/commands/native/cmd-sec-dependency-audit.md +51 -0
- package/claude-code/commands/native/cmd-sec-threat-model.md +51 -0
- package/claude-code/commands/native/cmd-test-unit-integration.md +51 -0
- package/claude-code/instructions/CLAUDE.template.md +42 -0
- package/claude-code/settings/settings.json +183 -0
- package/claude-code/settings/settings.local.json +10 -0
- package/codex/README.md +58 -24
- package/codex/instructions/AGENTS.permissions.generated.md +121 -0
- package/codex/instructions/AGENTS.template.md +18 -3
- package/codex/settings/runtime-policy.json +188 -0
- package/codex/skills/cmd-dev-be-api/SKILL.md +43 -0
- package/codex/skills/cmd-dev-be-api/agents/openai.yaml +4 -0
- package/codex/skills/cmd-dev-fe-hook-separate/SKILL.md +43 -0
- package/codex/skills/cmd-dev-fe-hook-separate/agents/openai.yaml +4 -0
- package/codex/skills/cmd-dev-fe-ui-componentize/SKILL.md +43 -0
- package/codex/skills/cmd-dev-fe-ui-componentize/agents/openai.yaml +4 -0
- package/codex/skills/cmd-dev-perf-optimize/SKILL.md +43 -0
- package/codex/skills/cmd-dev-perf-optimize/agents/openai.yaml +4 -0
- package/codex/skills/cmd-dev-sequential-autorun/SKILL.md +43 -0
- package/codex/skills/cmd-dev-sequential-autorun/agents/openai.yaml +4 -0
- package/codex/skills/cmd-doc-handoff/SKILL.md +43 -0
- package/codex/skills/cmd-doc-handoff/agents/openai.yaml +4 -0
- package/codex/skills/cmd-improve-techdebt/SKILL.md +43 -0
- package/codex/skills/cmd-improve-techdebt/agents/openai.yaml +4 -0
- package/codex/skills/cmd-incident-triage/SKILL.md +43 -0
- package/codex/skills/cmd-incident-triage/agents/openai.yaml +4 -0
- package/codex/skills/cmd-ops-ci-cd-gate/SKILL.md +43 -0
- package/codex/skills/cmd-ops-ci-cd-gate/agents/openai.yaml +4 -0
- package/codex/skills/cmd-ops-deploy/SKILL.md +43 -0
- package/codex/skills/cmd-ops-deploy/agents/openai.yaml +4 -0
- package/codex/skills/cmd-ops-monitoring/SKILL.md +43 -0
- package/codex/skills/cmd-ops-monitoring/agents/openai.yaml +4 -0
- package/codex/skills/cmd-plan-arch-decision/SKILL.md +43 -0
- package/codex/skills/cmd-plan-arch-decision/agents/openai.yaml +4 -0
- package/codex/skills/cmd-plan-implementation-bootstrap/SKILL.md +43 -0
- package/codex/skills/cmd-plan-implementation-bootstrap/agents/openai.yaml +4 -0
- package/codex/skills/cmd-plan-prd-details/SKILL.md +43 -0
- package/codex/skills/cmd-plan-prd-details/agents/openai.yaml +4 -0
- package/codex/skills/cmd-plan-prd-master/SKILL.md +44 -0
- package/codex/skills/cmd-plan-prd-master/agents/openai.yaml +4 -0
- package/codex/skills/cmd-plan-req-lock/SKILL.md +44 -0
- package/codex/skills/cmd-plan-req-lock/agents/openai.yaml +4 -0
- package/codex/skills/cmd-review-code/SKILL.md +43 -0
- package/codex/skills/cmd-review-code/agents/openai.yaml +4 -0
- package/codex/skills/cmd-sec-dependency-audit/SKILL.md +43 -0
- package/codex/skills/cmd-sec-dependency-audit/agents/openai.yaml +4 -0
- package/codex/skills/cmd-sec-threat-model/SKILL.md +43 -0
- package/codex/skills/cmd-sec-threat-model/agents/openai.yaml +4 -0
- package/codex/skills/cmd-test-unit-integration/SKILL.md +43 -0
- package/codex/skills/cmd-test-unit-integration/agents/openai.yaml +4 -0
- package/common/settings/security-policy.json +221 -0
- package/common/skills/skill-catalog.json +368 -136
- package/common/workflows/workflow-catalog.json +89 -1238
- package/gemini/README.md +104 -0
- package/gemini/commands/definitions/cmd-dev-be-api.toml +35 -0
- package/gemini/commands/definitions/cmd-dev-fe-hook-separate.toml +35 -0
- package/gemini/commands/definitions/cmd-dev-fe-ui-componentize.toml +35 -0
- package/gemini/commands/definitions/cmd-dev-perf-optimize.toml +35 -0
- package/gemini/commands/definitions/cmd-dev-sequential-autorun.toml +35 -0
- package/gemini/commands/definitions/cmd-doc-handoff.toml +36 -0
- package/gemini/commands/definitions/cmd-improve-techdebt.toml +35 -0
- package/gemini/commands/definitions/cmd-incident-triage.toml +35 -0
- package/gemini/commands/definitions/cmd-ops-ci-cd-gate.toml +35 -0
- package/gemini/commands/definitions/cmd-ops-deploy.toml +35 -0
- package/gemini/commands/definitions/cmd-ops-monitoring.toml +35 -0
- package/gemini/commands/definitions/cmd-plan-arch-decision.toml +35 -0
- package/gemini/commands/definitions/cmd-plan-implementation-bootstrap.toml +35 -0
- package/gemini/commands/definitions/cmd-plan-prd-details.toml +35 -0
- package/gemini/commands/definitions/cmd-plan-prd-master.toml +36 -0
- package/gemini/commands/definitions/cmd-plan-req-lock.toml +36 -0
- package/gemini/commands/definitions/cmd-review-code.toml +35 -0
- package/gemini/commands/definitions/cmd-sec-dependency-audit.toml +35 -0
- package/gemini/commands/definitions/cmd-sec-threat-model.toml +35 -0
- package/gemini/commands/definitions/cmd-test-unit-integration.toml +35 -0
- package/gemini/gemini-extension.json +6 -0
- package/gemini/instructions/GEMINI.template.md +34 -0
- package/gemini/settings/editor-policy.json +193 -0
- package/{antigravity → gemini}/skills/change-safety-review/SKILL.md +8 -6
- package/{antigravity → gemini}/skills/code-review-and-improvement/SKILL.md +8 -3
- package/gemini/skills/frontend-repetition-pack/SKILL.md +44 -0
- package/gemini/skills/incident-response/SKILL.md +44 -0
- package/{antigravity → gemini}/skills/prd-to-production-pipeline/SKILL.md +13 -4
- package/{antigravity → gemini}/skills/release-and-operations/SKILL.md +11 -3
- package/gemini/skills/security-hardening/SKILL.md +43 -0
- package/gemini/skills/service-lifecycle-orchestration/SKILL.md +46 -0
- package/{antigravity → gemini}/workflows/workflow-catalog.json +1 -1
- package/package.json +4 -4
- package/scripts/generate-from-common.mjs +537 -23
- package/scripts/init.mjs +310 -41
- package/scripts/validate.mjs +264 -32
- package/antigravity/README.md +0 -43
- package/antigravity/skills/frontend-repetition-pack/SKILL.md +0 -35
- package/antigravity/skills/incident-response/SKILL.md +0 -35
- package/antigravity/skills/security-hardening/SKILL.md +0 -35
- package/antigravity/skills/service-lifecycle-orchestration/SKILL.md +0 -36
- package/claude-code/workflows/workflow-catalog.json +0 -688
- package/codex/workflows/workflow-catalog.json +0 -450
- /package/{antigravity/agents → common/gemini}/agent-catalog.json +0 -0
- /package/{antigravity/artifacts → common/gemini}/artifact-catalog.json +0 -0
- /package/{common/antigravity → gemini/agents}/agent-catalog.json +0 -0
- /package/{common/antigravity → gemini/artifacts}/artifact-catalog.json +0 -0
- /package/{antigravity → gemini}/commands/command-catalog.json +0 -0
- /package/{antigravity → gemini}/workflows/definitions/WF-FRONTEND-REFACTOR.workflow.yaml +0 -0
- /package/{antigravity → gemini}/workflows/definitions/WF-INCIDENT-RESPONSE.workflow.yaml +0 -0
- /package/{antigravity → gemini}/workflows/definitions/WF-PRD-TO-PRODUCTION.workflow.yaml +0 -0
- /package/{antigravity → gemini}/workflows/definitions/WF-SECURITY-HARDENING.workflow.yaml +0 -0
- /package/{antigravity → gemini}/workflows/definitions/WF-SERVICE-E2E.workflow.yaml +0 -0
package/claude-code/README.md
CHANGED
|
@@ -1,49 +1,94 @@
|
|
|
1
1
|
# Claude Code 운영팩
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
Claude Code에서 서비스 운영 전체(기획-개발-배포-운영-보안-개선)를 실행할 수 있도록 스킬, 서브에이전트, 팀, 명령 정의를 제공합니다.
|
|
4
|
+
|
|
5
|
+
> 이 폴더의 파일은 `npm run generate`로 `common/*`에서 자동 생성됩니다. 직접 수정하지 마세요.
|
|
6
6
|
|
|
7
7
|
## 폴더 구성
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
9
|
+
```
|
|
10
|
+
claude-code/
|
|
11
|
+
skills/<name>/SKILL.md 8개 운영 스킬
|
|
12
|
+
subagents/<role>.md 15개 서브에이전트 프롬프트
|
|
13
|
+
agent-teams/team-catalog.json 3개 팀 구성
|
|
14
|
+
commands/
|
|
15
|
+
command-catalog.json 공통 명령 계약 (SSOT)
|
|
16
|
+
native/*.md 20개 네이티브 슬래시 명령
|
|
17
|
+
instructions/CLAUDE.template.md CLAUDE.md 자동 생성 템플릿
|
|
18
|
+
settings/
|
|
19
|
+
settings.json 프로젝트 설정 템플릿
|
|
20
|
+
settings.local.json 로컬 설정 템플릿
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 설치 시 생성 구조
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
<project>/
|
|
27
|
+
.claude/
|
|
28
|
+
skills/<name>/SKILL.md 스킬 자동 인식
|
|
29
|
+
agents/<role>.md 서브에이전트 프롬프트
|
|
30
|
+
agent-teams/team-catalog.json 팀 카탈로그
|
|
31
|
+
commands/<name>.md /cmd-* 슬래시 명령
|
|
32
|
+
instructions/CLAUDE.template.md
|
|
33
|
+
settings/settings.json
|
|
34
|
+
CLAUDE.md 프로젝트 규칙 파일 (기존 파일 유지)
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## 사용 방법
|
|
38
|
+
|
|
39
|
+
### 스킬 사용
|
|
40
|
+
|
|
41
|
+
`.claude/skills/<name>/SKILL.md`를 Claude Code가 자동 인식합니다. 사용자 요청에 매칭되면 스킬의 상세 절차를 실행합니다.
|
|
42
|
+
|
|
43
|
+
| 스킬 | 역할 |
|
|
44
|
+
|------|------|
|
|
45
|
+
| `change-safety-review` | 변경사항 회귀 검증 + 코드 리뷰 |
|
|
46
|
+
| `code-review-and-improvement` | 코드 품질 개선 + 기술부채 정리 |
|
|
47
|
+
| `frontend-repetition-pack` | UI 컴포넌트화 → Hook 분리 → 성능 최적화 |
|
|
48
|
+
| `incident-response` | 장애 트리아지 → 근본원인 수정 → 포스트모템 |
|
|
49
|
+
| `prd-to-production-pipeline` | PRD 작성 → 순차 자동 구현 |
|
|
50
|
+
| `release-and-operations` | CI/CD 게이트 → 배포 → 모니터링 |
|
|
51
|
+
| `security-hardening` | 위협 모델링 → 취약점 감사 → 하드닝 |
|
|
52
|
+
| `service-lifecycle-orchestration` | 전체 수명주기 오케스트레이션 |
|
|
53
|
+
|
|
54
|
+
### 네이티브 슬래시 명령
|
|
55
|
+
|
|
56
|
+
`commands/native/*.md`가 Claude Custom Slash Command로 설치됩니다.
|
|
14
57
|
|
|
15
|
-
|
|
58
|
+
```bash
|
|
59
|
+
# 실행 예시
|
|
60
|
+
/cmd-plan-req-lock
|
|
61
|
+
/cmd-dev-be-api
|
|
62
|
+
/cmd-review-code
|
|
63
|
+
/cmd-sec-threat-model
|
|
64
|
+
```
|
|
16
65
|
|
|
17
|
-
|
|
18
|
-
2. 단계별 명령을 실행해 주세요: 각 stage의 `commands` ID 순서대로 실행
|
|
19
|
-
3. 품질 검증을 확인해 주세요: stage `exit_criteria`를 모두 충족해야 다음 단계로 이동
|
|
66
|
+
명령 뒤에 추가 컨텍스트를 인자로 전달할 수 있습니다.
|
|
20
67
|
|
|
21
|
-
|
|
68
|
+
### 서브에이전트 & 팀
|
|
22
69
|
|
|
23
|
-
-
|
|
24
|
-
- UI 컴포넌트화: `ui-component-engineer`
|
|
25
|
-
- Hook 분리: `hook-refactor-engineer`
|
|
26
|
-
- 최적화: `performance-engineer`
|
|
27
|
-
- 변경점 안전 검토: `change-safety-review` + `code-reviewer`, `qa-engineer`, `performance-engineer`
|
|
28
|
-
- PRD 작성: `prd-writer`
|
|
70
|
+
리드(`lead-orchestrator`)가 전문 서브에이전트에게 작업을 위임하는 구조입니다.
|
|
29
71
|
|
|
30
|
-
|
|
72
|
+
**15개 서브에이전트:**
|
|
73
|
+
`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`
|
|
31
74
|
|
|
32
|
-
|
|
33
|
-
- 병렬 협업: `TEAM-SVC-DELIVERY`
|
|
34
|
-
- 보안 배치: `TEAM-SEC-HARDENING`
|
|
35
|
-
- 장애 워룸: `TEAM-INCIDENT`
|
|
75
|
+
**3개 팀:**
|
|
36
76
|
|
|
37
|
-
|
|
77
|
+
| 팀 ID | 구성 | 용도 |
|
|
78
|
+
|-------|------|------|
|
|
79
|
+
| `TEAM-SVC-DELIVERY` | 리드 + 개발/QA/보안 | 서비스 딜리버리 |
|
|
80
|
+
| `TEAM-SEC-HARDENING` | 리드 + 보안/개발/QA | 보안 강화 |
|
|
81
|
+
| `TEAM-INCIDENT` | 리드 + 장애대응/개발/운영 | 장애 워룸 |
|
|
38
82
|
|
|
39
|
-
|
|
83
|
+
`agent-teams/team-catalog.json`을 단일 진입점으로 사용합니다.
|
|
40
84
|
|
|
41
|
-
|
|
42
|
-
- 프로젝트 로컬: `<repo>/.claude/agents/`, `<repo>/.claude/skills/`
|
|
85
|
+
### 설정 템플릿
|
|
43
86
|
|
|
44
|
-
|
|
87
|
+
- 프로젝트 공용: `<repo>/.claude/settings.json`
|
|
88
|
+
- 개인 오버라이드: `<repo>/.claude/settings.local.json`
|
|
89
|
+
- 전역 공용: `~/.claude/settings.json`
|
|
45
90
|
|
|
46
|
-
## 참고 문서
|
|
91
|
+
## 참고 문서
|
|
47
92
|
|
|
48
93
|
- [Claude Code Subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents)
|
|
49
94
|
- [Claude Code Agent Teams](https://docs.anthropic.com/en/docs/claude-code/agent-teams)
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "백엔드 API 구현 (CMD-DEV-BE-API)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DEV-BE-API` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
명세 기반으로 안정적인 API와 데이터 접근 계층을 구현한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- API 계약
|
|
17
|
+
- 도메인 모델
|
|
18
|
+
- 에러 코드 정책
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 기존 엔드포인트 호환 정책
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 계약 우선 방식으로 DTO와 검증 규칙을 작성한다.
|
|
26
|
+
2. 핸들러와 비즈니스 로직을 분리한다.
|
|
27
|
+
3. 권한 검증과 감사 로그를 추가한다.
|
|
28
|
+
4. 회귀 테스트를 작성한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 계약 테스트가 통과해야 한다.
|
|
33
|
+
- 권한 누락 경로가 없어야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- API 구현 코드
|
|
38
|
+
- 계약 테스트
|
|
39
|
+
- 권한 매트릭스
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: qa-engineer, code-reviewer
|
|
44
|
+
- 차단 요인: 계약 불일치, 에러 코드 정책 위반
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Hook 분리 (CMD-DEV-FE-HOOK-SEPARATE)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DEV-FE-HOOK-SEPARATE` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
컴포넌트 내부 상태/효과 로직을 재사용 가능한 Hook으로 분리한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 대상 컴포넌트
|
|
17
|
+
- 상태 흐름
|
|
18
|
+
- 부수효과 목록
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 성능 프로파일 결과
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. UI 렌더링과 상태 오케스트레이션 경계를 식별한다.
|
|
26
|
+
2. Hook의 입력/출력 타입 계약을 정의한다.
|
|
27
|
+
3. 비동기/캐시/재시도 정책을 Hook 내부로 캡슐화한다.
|
|
28
|
+
4. Hook 전용 테스트를 추가한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 컴포넌트 길이가 기준 대비 25% 이상 축소되어야 한다.
|
|
33
|
+
- Hook은 단일 책임을 유지해야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 커스텀 Hook
|
|
38
|
+
- Hook 테스트
|
|
39
|
+
- 마이그레이션 노트
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: frontend-engineer, performance-engineer
|
|
44
|
+
- 차단 요인: Hook 간 순환 의존, 숨은 전역 상태 의존
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "UI 컴포넌트화 (CMD-DEV-FE-UI-COMPONENTIZE)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DEV-FE-UI-COMPONENTIZE` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
반복 UI를 설계 토큰 기반의 재사용 컴포넌트로 분해한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 대상 화면
|
|
17
|
+
- 중복 UI 목록
|
|
18
|
+
- 디자인 토큰
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 스토리북 규칙
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 중복 UI를 패턴 단위로 그룹화한다.
|
|
26
|
+
2. Props 계약을 최소화하고 명시적으로 정의한다.
|
|
27
|
+
3. 프레젠테이션 로직과 데이터 로직을 분리한다.
|
|
28
|
+
4. 스토리/스냅샷 테스트를 추가한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 컴포넌트 API 변경 시 하위 호환 전략이 있어야 한다.
|
|
33
|
+
- 동일 UI 중복 코드가 기준 대비 30% 이상 감소해야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 공용 UI 컴포넌트
|
|
38
|
+
- 사용 가이드
|
|
39
|
+
- 스토리북 스토리
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: frontend-engineer, qa-engineer
|
|
44
|
+
- 차단 요인: 디자인 토큰 누락, 접근성 속성 누락
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "성능 최적화 (CMD-DEV-PERF-OPTIMIZE)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DEV-PERF-OPTIMIZE` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
측정 기반으로 병목을 제거하고 사용자 체감 성능을 개선한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 성능 목표
|
|
17
|
+
- 현재 측정치
|
|
18
|
+
- 병목 후보
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 트래픽 패턴
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 기준 측정값을 고정한다.
|
|
26
|
+
2. 병목 상위 3개만 우선 해결한다.
|
|
27
|
+
3. 캐싱/메모이제이션/쿼리 최적화를 적용한다.
|
|
28
|
+
4. 개선 후 동일 조건으로 재측정한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 핵심 지표가 목표 이상 개선되어야 한다.
|
|
33
|
+
- 최적화로 인한 기능 회귀가 없어야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 전후 비교 리포트
|
|
38
|
+
- 최적화 코드
|
|
39
|
+
- 회귀 테스트
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: qa-engineer, sre-release-engineer
|
|
44
|
+
- 차단 요인: 측정 재현 불가, 최적화 효과 미미
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "PRD 기반 순차 자동 구현 (CMD-DEV-SEQUENTIAL-AUTORUN)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DEV-SEQUENTIAL-AUTORUN` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
확정된 세부 PRD 순서대로 구현, 테스트, 리뷰를 연쇄 실행한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 구현 배치 계획
|
|
17
|
+
- 세부 PRD 묶음
|
|
18
|
+
- 품질 게이트
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 중간 승인 포인트
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 배치 순서대로 기능 구현을 수행한다.
|
|
26
|
+
2. 각 배치 종료 시 테스트와 리뷰를 자동 실행한다.
|
|
27
|
+
3. UI 컴포넌트화/Hook 분리/성능 최적화/보안 점검을 각 배치에 적용한다.
|
|
28
|
+
4. 최종 수동 설정 단계 직전까지 연속 실행한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 배치별 테스트/리뷰 통과 없이는 다음 배치로 이동하지 않는다.
|
|
33
|
+
- 치명 보안 이슈 또는 차단 이슈 발생 시 즉시 중단한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 배치별 구현 로그
|
|
38
|
+
- 중간 검증 리포트
|
|
39
|
+
- 최종 수동 설정 전 체크리스트
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: qa-engineer, security-engineer, sre-release-engineer
|
|
44
|
+
- 차단 요인: 배치 검증 실패, 차단 이슈 미해결
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "운영 인수인계 문서화 (CMD-DOC-HANDOFF)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-DOC-HANDOFF` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
사람과 AI가 동일한 기준으로 서비스 상태를 이해하도록 지식을 구조화한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 최신 아키텍처
|
|
17
|
+
- 운영 런북
|
|
18
|
+
- 릴리즈 이력
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- FAQ
|
|
22
|
+
- 온보딩 자료
|
|
23
|
+
|
|
24
|
+
## 실행 절차
|
|
25
|
+
|
|
26
|
+
1. 문서를 역할 기준으로 분리한다.
|
|
27
|
+
2. 명령 ID와 워크플로우 ID를 교차 참조한다.
|
|
28
|
+
3. 변경 이력을 날짜와 함께 기록한다.
|
|
29
|
+
4. 월 1회 갱신 책임자를 지정한다.
|
|
30
|
+
|
|
31
|
+
## 품질 게이트
|
|
32
|
+
|
|
33
|
+
- 중요 문서는 최신 배포와 일치해야 한다.
|
|
34
|
+
- 문서만으로 최소 운영 시나리오 재현이 가능해야 한다.
|
|
35
|
+
|
|
36
|
+
## 산출물
|
|
37
|
+
|
|
38
|
+
- 운영 핸드북
|
|
39
|
+
- 워크플로우 인덱스
|
|
40
|
+
- 갱신 캘린더
|
|
41
|
+
|
|
42
|
+
## 핸드오프
|
|
43
|
+
|
|
44
|
+
- 다음 역할: all
|
|
45
|
+
- 차단 요인: 문서와 실제 동작 불일치
|
|
46
|
+
|
|
47
|
+
## 결과 응답 형식
|
|
48
|
+
|
|
49
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
50
|
+
- 입력 검증(충족/누락 항목)
|
|
51
|
+
- 품질 게이트 통과 여부
|
|
52
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "기술 부채 정리 (CMD-IMPROVE-TECHDEBT)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-IMPROVE-TECHDEBT` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
장기 생산성을 저해하는 구조적 부채를 우선순위 기반으로 상환한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 부채 목록
|
|
17
|
+
- 영향도
|
|
18
|
+
- 상환 비용
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 장애 연관 지표
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 영향도/비용 기준으로 상환 순위를 정한다.
|
|
26
|
+
2. 기능 개발과 충돌하지 않게 배치한다.
|
|
27
|
+
3. 상환 항목별 완료 기준을 정의한다.
|
|
28
|
+
4. 상환 후 구조 단순화 여부를 점검한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 상환 항목은 측정 가능한 결과를 가져야 한다.
|
|
33
|
+
- 미완료 항목은 이유와 다음 시점을 기록해야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 부채 상환 백로그
|
|
38
|
+
- 완료 리포트
|
|
39
|
+
- 구조 개선 지표
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: product-planner, solution-architect
|
|
44
|
+
- 차단 요인: 상환 우선순위 불명확, 기능 일정과 충돌
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "장애 분류 및 대응 (CMD-INCIDENT-TRIAGE)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-INCIDENT-TRIAGE` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
장애 영향 범위를 빠르게 파악하고 복구 우선순위를 설정한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 장애 알림
|
|
17
|
+
- 영향 서비스
|
|
18
|
+
- 현재 증상
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 최근 배포 이력
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 심각도와 고객 영향을 분류한다.
|
|
26
|
+
2. 워룸 역할과 커뮤니케이션 채널을 고정한다.
|
|
27
|
+
3. 복구 우선 경로를 실행한다.
|
|
28
|
+
4. 복구 후 재발 방지 액션을 등록한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 심각도 기준이 일관되어야 한다.
|
|
33
|
+
- 복구 후 RCA 일정이 지정되어야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 장애 타임라인
|
|
38
|
+
- 복구 조치 기록
|
|
39
|
+
- 재발 방지 액션
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: code-reviewer, security-engineer, operations-owner
|
|
44
|
+
- 차단 요인: 원인 미확정, 재발 방지 책임자 미지정
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "CI/CD 게이트 고정 (CMD-OPS-CI-CD-GATE)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-OPS-CI-CD-GATE` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
품질/보안 기준 미충족 변경이 배포되지 않도록 자동 차단한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 테스트 결과
|
|
17
|
+
- 리뷰 상태
|
|
18
|
+
- 보안 점검 상태
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 성능 기준 리포트
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 필수 체크를 파이프라인 게이트로 등록한다.
|
|
26
|
+
2. 실패 시 자동 중단 및 알림을 설정한다.
|
|
27
|
+
3. 배포 승인 정책을 역할 기반으로 고정한다.
|
|
28
|
+
4. 릴리즈 노트 자동 생성을 연결한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 게이트 우회 경로가 없어야 한다.
|
|
33
|
+
- 실패 원인이 추적 가능해야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 파이프라인 설정
|
|
38
|
+
- 승인 정책
|
|
39
|
+
- 릴리즈 노트 템플릿
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: sre-release-engineer
|
|
44
|
+
- 차단 요인: 필수 체크 누락, 알림 라우팅 오류
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "배포 및 검증 (CMD-OPS-DEPLOY)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-OPS-DEPLOY` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
점진 배포와 실시간 검증으로 릴리즈 리스크를 통제한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- 릴리즈 후보
|
|
17
|
+
- 롤백 계획
|
|
18
|
+
- 모니터링 대시보드
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 점진 배포 비율 정책
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 배포 전 백업과 롤백 경로를 검증한다.
|
|
26
|
+
2. 카나리/블루그린 방식으로 점진 배포한다.
|
|
27
|
+
3. 핵심 SLI를 감시한다.
|
|
28
|
+
4. 임계치 초과 시 자동 또는 수동 롤백한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 롤백 시나리오가 사전 검증되어야 한다.
|
|
33
|
+
- 배포 후 핵심 지표가 기준 내여야 한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 배포 로그
|
|
38
|
+
- 검증 체크리스트
|
|
39
|
+
- 롤백 결과(필요 시)
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: operations-owner
|
|
44
|
+
- 차단 요인: 핵심 지표 악화, 롤백 실패
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "운영 모니터링 강화 (CMD-OPS-MONITORING)"
|
|
3
|
+
argument-hint: "[추가 컨텍스트]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
이 명령은 `CMD-OPS-MONITORING` 계약을 그대로 적용합니다.
|
|
7
|
+
추가 컨텍스트가 있으면 반영하세요: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## 목적
|
|
10
|
+
|
|
11
|
+
장애 징후를 조기에 탐지하고 대응 시간을 단축한다.
|
|
12
|
+
|
|
13
|
+
## 입력 계약
|
|
14
|
+
|
|
15
|
+
### 필수 입력
|
|
16
|
+
- SLI/SLO
|
|
17
|
+
- 알림 정책
|
|
18
|
+
- 서비스 맵
|
|
19
|
+
|
|
20
|
+
### 선택 입력
|
|
21
|
+
- 장애 포스트모템
|
|
22
|
+
|
|
23
|
+
## 실행 절차
|
|
24
|
+
|
|
25
|
+
1. 핵심 지표와 에러 버짓을 대시보드화한다.
|
|
26
|
+
2. 노이즈 알림을 정리하고 에스컬레이션을 명확화한다.
|
|
27
|
+
3. 런북과 알림을 연결한다.
|
|
28
|
+
4. 주간 점검으로 임계치 튜닝을 수행한다.
|
|
29
|
+
|
|
30
|
+
## 품질 게이트
|
|
31
|
+
|
|
32
|
+
- 알림은 실행 가능한 행동 지침을 포함해야 한다.
|
|
33
|
+
- 미사용 대시보드는 제거한다.
|
|
34
|
+
|
|
35
|
+
## 산출물
|
|
36
|
+
|
|
37
|
+
- 운영 대시보드
|
|
38
|
+
- 알림 정책
|
|
39
|
+
- 런북
|
|
40
|
+
|
|
41
|
+
## 핸드오프
|
|
42
|
+
|
|
43
|
+
- 다음 역할: incident-commander
|
|
44
|
+
- 차단 요인: 오탐 과다, 런북 미정
|
|
45
|
+
|
|
46
|
+
## 결과 응답 형식
|
|
47
|
+
|
|
48
|
+
- 실행 요약(무엇을 왜 수행했는지)
|
|
49
|
+
- 입력 검증(충족/누락 항목)
|
|
50
|
+
- 품질 게이트 통과 여부
|
|
51
|
+
- 산출물 및 다음 핸드오프
|