@dusky-bluehour/agent-service 0.6.4 → 0.6.6

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 (53) hide show
  1. package/README.md +33 -222
  2. package/antigravity/README.md +7 -1
  3. package/antigravity/agents/agent-catalog.json +5 -5
  4. package/antigravity/skills/change-safety-review/SKILL.md +40 -0
  5. package/antigravity/skills/code-review-and-improvement/SKILL.md +20 -0
  6. package/antigravity/skills/frontend-repetition-pack/SKILL.md +20 -0
  7. package/antigravity/skills/incident-response/SKILL.md +20 -0
  8. package/antigravity/skills/prd-to-production-pipeline/SKILL.md +21 -1
  9. package/antigravity/skills/release-and-operations/SKILL.md +20 -0
  10. package/antigravity/skills/security-hardening/SKILL.md +21 -1
  11. package/antigravity/skills/service-lifecycle-orchestration/SKILL.md +21 -1
  12. package/antigravity/workflows/definitions/WF-FRONTEND-REFACTOR.workflow.yaml +38 -0
  13. package/antigravity/workflows/definitions/WF-INCIDENT-RESPONSE.workflow.yaml +41 -0
  14. package/antigravity/workflows/definitions/WF-PRD-TO-PRODUCTION.workflow.yaml +76 -0
  15. package/antigravity/workflows/definitions/WF-SECURITY-HARDENING.workflow.yaml +40 -0
  16. package/antigravity/workflows/definitions/WF-SERVICE-E2E.workflow.yaml +67 -0
  17. package/antigravity/workflows/workflow-catalog.json +5 -5
  18. package/catalog/tool-catalog.ko.json +1 -1
  19. package/claude-code/README.md +4 -1
  20. package/claude-code/agent-teams/team-catalog.json +7 -7
  21. package/claude-code/skills/change-safety-review/SKILL.md +40 -0
  22. package/claude-code/skills/code-review-and-improvement/SKILL.md +21 -1
  23. package/claude-code/skills/frontend-repetition-pack/SKILL.md +21 -1
  24. package/claude-code/skills/incident-response/SKILL.md +21 -1
  25. package/claude-code/skills/prd-to-production-pipeline/SKILL.md +21 -1
  26. package/claude-code/skills/release-and-operations/SKILL.md +21 -1
  27. package/claude-code/skills/security-hardening/SKILL.md +21 -1
  28. package/claude-code/skills/service-lifecycle-orchestration/SKILL.md +21 -1
  29. package/claude-code/workflows/workflow-catalog.json +8 -8
  30. package/codex/README.md +5 -2
  31. package/codex/automations/automation-recipes.toml +4 -4
  32. package/codex/instructions/AGENTS.template.md +6 -5
  33. package/codex/skills/change-safety-review/SKILL.md +40 -0
  34. package/codex/skills/change-safety-review/agents/openai.yaml +4 -0
  35. package/codex/skills/code-review-and-improvement/SKILL.md +21 -1
  36. package/codex/skills/frontend-repetition-pack/SKILL.md +20 -0
  37. package/codex/skills/incident-response/SKILL.md +21 -1
  38. package/codex/skills/prd-to-production-pipeline/SKILL.md +21 -1
  39. package/codex/skills/release-and-operations/SKILL.md +20 -0
  40. package/codex/skills/security-hardening/SKILL.md +21 -1
  41. package/codex/skills/service-lifecycle-orchestration/SKILL.md +21 -1
  42. package/codex/workflows/workflow-catalog.json +6 -6
  43. package/common/antigravity/agent-catalog.json +72 -0
  44. package/common/antigravity/artifact-catalog.json +184 -0
  45. package/common/claude/subagent-catalog.json +419 -0
  46. package/common/claude/team-catalog.json +69 -0
  47. package/common/commands/command-catalog.json +942 -0
  48. package/common/skills/skill-catalog.json +566 -0
  49. package/common/workflows/workflow-catalog.json +1550 -0
  50. package/package.json +7 -4
  51. package/scripts/generate-from-common.mjs +387 -0
  52. package/scripts/init.mjs +81 -8
  53. package/scripts/validate.mjs +249 -2
@@ -0,0 +1,38 @@
1
+ # generated by scripts/generate-from-common.mjs
2
+ workflow:
3
+ id: "WF-FRONTEND-REFACTOR"
4
+ name: "반복 프론트엔드 개선 (UI→Hook→성능)"
5
+ summary: "UI 컴포넌트화, Hook 분리, 성능 최적화를 단일 체인으로 실행합니다."
6
+ orchestrator: "manager-agent"
7
+ when_to_use: "프론트 구조 개선, 성능 개선"
8
+ stages:
9
+ - order: 1
10
+ stage_id: "STG-COMPONENT"
11
+ agent: "frontend-repetition-agent"
12
+ commands:
13
+ - "CMD-DEV-FE-UI-COMPONENTIZE"
14
+ input_artifact: "ART-FRONTEND-BASELINE"
15
+ output_artifact: "ART-COMPONENTIZED-UI"
16
+ exit_criteria:
17
+ - "중복 UI 축소"
18
+ - order: 2
19
+ stage_id: "STG-HOOK"
20
+ agent: "frontend-repetition-agent"
21
+ commands:
22
+ - "CMD-DEV-FE-HOOK-SEPARATE"
23
+ input_artifact: "ART-COMPONENTIZED-UI"
24
+ output_artifact: "ART-HOOK-REFACTORED"
25
+ exit_criteria:
26
+ - "Hook 분리 완료"
27
+ - order: 3
28
+ stage_id: "STG-PERF"
29
+ agent: "performance-agent"
30
+ commands:
31
+ - "CMD-DEV-PERF-OPTIMIZE"
32
+ - "CMD-TEST-UNIT-INTEGRATION"
33
+ input_artifact: "ART-HOOK-REFACTORED"
34
+ output_artifact: "ART-PERF-IMPROVED"
35
+ exit_criteria:
36
+ - "성능 목표 달성"
37
+ final_outputs:
38
+ - "ART-PERF-IMPROVED"
@@ -0,0 +1,41 @@
1
+ # generated by scripts/generate-from-common.mjs
2
+ workflow:
3
+ id: "WF-INCIDENT-RESPONSE"
4
+ name: "장애 대응/재발 방지 (트리아지→근본수정→포스트모템)"
5
+ summary: "Incident triage 이후 근본 원인 수정과 후속 조치까지 수행합니다."
6
+ orchestrator: "incident-manager-agent"
7
+ when_to_use: "운영 장애 대응, RCA 필요 이슈"
8
+ stages:
9
+ - order: 1
10
+ stage_id: "STG-TRIAGE"
11
+ agent: "release-ops-agent"
12
+ commands:
13
+ - "CMD-INCIDENT-TRIAGE"
14
+ - "CMD-OPS-MONITORING"
15
+ input_artifact: "ART-INCIDENT-ALERT"
16
+ output_artifact: "ART-INCIDENT-TIMELINE"
17
+ exit_criteria:
18
+ - "복구 완료"
19
+ - order: 2
20
+ stage_id: "STG-ROOTFIX"
21
+ agent: "implementation-agent"
22
+ commands:
23
+ - "CMD-DEV-BE-API"
24
+ - "CMD-IMPROVE-TECHDEBT"
25
+ input_artifact: "ART-INCIDENT-TIMELINE"
26
+ output_artifact: "ART-ROOT-CAUSE-FIX"
27
+ exit_criteria:
28
+ - "근본 원인 수정"
29
+ - order: 3
30
+ stage_id: "STG-POST"
31
+ agent: "review-security-agent"
32
+ commands:
33
+ - "CMD-REVIEW-CODE"
34
+ - "CMD-SEC-THREAT-MODEL"
35
+ - "CMD-DOC-HANDOFF"
36
+ input_artifact: "ART-ROOT-CAUSE-FIX"
37
+ output_artifact: "ART-POSTMORTEM-PACK"
38
+ exit_criteria:
39
+ - "재발 방지 액션 등록"
40
+ final_outputs:
41
+ - "ART-POSTMORTEM-PACK"
@@ -0,0 +1,76 @@
1
+ # generated by scripts/generate-from-common.mjs
2
+ workflow:
3
+ id: "WF-PRD-TO-PRODUCTION"
4
+ name: "PRD 대화형 작성→순차 자동 구현"
5
+ summary: "Manager가 PRD 대화형 단계와 구현 자동 단계를 분리 오케스트레이션합니다."
6
+ orchestrator: "manager-agent"
7
+ when_to_use: "PRD 기반 구현 자동화"
8
+ stages:
9
+ - order: 1
10
+ stage_id: "STG-PRD-MASTER"
11
+ agent: "prd-writer-agent"
12
+ commands:
13
+ - "CMD-PLAN-PRD-MASTER"
14
+ input_artifact: "ART-REQUEST-BRIEF"
15
+ output_artifact: "ART-PRD-MASTER"
16
+ exit_criteria:
17
+ - "마스터 PRD 승인"
18
+ - order: 2
19
+ stage_id: "STG-PRD-DETAIL"
20
+ agent: "prd-writer-agent"
21
+ commands:
22
+ - "CMD-PLAN-PRD-DETAILS"
23
+ input_artifact: "ART-PRD-MASTER"
24
+ output_artifact: "ART-PRD-DETAILS"
25
+ exit_criteria:
26
+ - "세부 PRD 확정"
27
+ - order: 3
28
+ stage_id: "STG-BOOTSTRAP"
29
+ agent: "manager-agent"
30
+ commands:
31
+ - "CMD-PLAN-IMPLEMENTATION-BOOTSTRAP"
32
+ input_artifact: "ART-PRD-DETAILS"
33
+ output_artifact: "ART-IMPLEMENTATION-BOOTSTRAP"
34
+ exit_criteria:
35
+ - "구현 배치 계획 확정"
36
+ - order: 4
37
+ stage_id: "STG-SEQUENTIAL-AUTO"
38
+ agent: "implementation-agent"
39
+ commands:
40
+ - "CMD-DEV-SEQUENTIAL-AUTORUN"
41
+ - "CMD-DEV-BE-API"
42
+ - "CMD-DEV-FE-UI-COMPONENTIZE"
43
+ - "CMD-DEV-FE-HOOK-SEPARATE"
44
+ - "CMD-DEV-PERF-OPTIMIZE"
45
+ input_artifact: "ART-IMPLEMENTATION-BOOTSTRAP"
46
+ output_artifact: "ART-IMPLEMENTATION-PACK"
47
+ exit_criteria:
48
+ - "최종 수동 설정 전 자동 구현 완료"
49
+ - order: 5
50
+ stage_id: "STG-VERIFY"
51
+ agent: "review-security-agent"
52
+ commands:
53
+ - "CMD-TEST-UNIT-INTEGRATION"
54
+ - "CMD-REVIEW-CODE"
55
+ - "CMD-SEC-THREAT-MODEL"
56
+ - "CMD-SEC-DEPENDENCY-AUDIT"
57
+ input_artifact: "ART-IMPLEMENTATION-PACK"
58
+ output_artifact: "ART-QUALITY-SECURITY-REPORT"
59
+ exit_criteria:
60
+ - "차단 이슈 0건"
61
+ - "치명 취약점 0건"
62
+ - order: 6
63
+ stage_id: "STG-FINAL-SETUP"
64
+ agent: "release-ops-agent"
65
+ commands:
66
+ - "CMD-OPS-CI-CD-GATE"
67
+ - "CMD-OPS-DEPLOY"
68
+ - "CMD-DOC-HANDOFF"
69
+ input_artifact: "ART-QUALITY-SECURITY-REPORT"
70
+ output_artifact: "ART-RELEASE-READY"
71
+ exit_criteria:
72
+ - "최종 세팅 및 배포 준비 완료"
73
+ final_outputs:
74
+ - "ART-PRD-MASTER"
75
+ - "ART-PRD-DETAILS"
76
+ - "ART-RELEASE-READY"
@@ -0,0 +1,40 @@
1
+ # generated by scripts/generate-from-common.mjs
2
+ workflow:
3
+ id: "WF-SECURITY-HARDENING"
4
+ name: "보안 강화 배치 (진단→보완→검증)"
5
+ summary: "위협 모델링과 취약점 감사 기반 하드닝을 수행합니다."
6
+ orchestrator: "manager-agent"
7
+ when_to_use: "정기 보안 배치, 취약점 대응"
8
+ stages:
9
+ - order: 1
10
+ stage_id: "STG-AUDIT"
11
+ agent: "review-security-agent"
12
+ commands:
13
+ - "CMD-SEC-THREAT-MODEL"
14
+ - "CMD-SEC-DEPENDENCY-AUDIT"
15
+ input_artifact: "ART-SYSTEM-BOUNDARY"
16
+ output_artifact: "ART-SECURITY-GAPS"
17
+ exit_criteria:
18
+ - "보완 목록 확정"
19
+ - order: 2
20
+ stage_id: "STG-HARDEN"
21
+ agent: "implementation-agent"
22
+ commands:
23
+ - "CMD-DEV-BE-API"
24
+ - "CMD-IMPROVE-TECHDEBT"
25
+ input_artifact: "ART-SECURITY-GAPS"
26
+ output_artifact: "ART-HARDENED-BUILD"
27
+ exit_criteria:
28
+ - "보완 코드 반영"
29
+ - order: 3
30
+ stage_id: "STG-VERIFY"
31
+ agent: "qa-agent"
32
+ commands:
33
+ - "CMD-TEST-UNIT-INTEGRATION"
34
+ - "CMD-REVIEW-CODE"
35
+ input_artifact: "ART-HARDENED-BUILD"
36
+ output_artifact: "ART-SECURITY-VERIFIED"
37
+ exit_criteria:
38
+ - "보안 재검증 통과"
39
+ final_outputs:
40
+ - "ART-SECURITY-VERIFIED"
@@ -0,0 +1,67 @@
1
+ # generated by scripts/generate-from-common.mjs
2
+ workflow:
3
+ id: "WF-SERVICE-E2E"
4
+ name: "서비스 E2E 파이프라인 (Plan→Implement→Test→Review→Release)"
5
+ summary: "신규 서비스 또는 대형 기능 배치에 사용하는 기본 운영 파이프라인입니다."
6
+ orchestrator: "manager-agent"
7
+ when_to_use: "신규 서비스, 대형 기능 릴리즈"
8
+ stages:
9
+ - order: 1
10
+ stage_id: "STG-PLAN"
11
+ agent: "product-planner-agent"
12
+ commands:
13
+ - "CMD-PLAN-REQ-LOCK"
14
+ - "CMD-PLAN-ARCH-DECISION"
15
+ input_artifact: "ART-REQUEST-BRIEF"
16
+ output_artifact: "ART-SCOPE-ADR"
17
+ exit_criteria:
18
+ - "요구사항 잠금"
19
+ - "ADR 승인"
20
+ - order: 2
21
+ stage_id: "STG-IMPLEMENT"
22
+ agent: "implementation-agent"
23
+ commands:
24
+ - "CMD-DEV-BE-API"
25
+ - "CMD-DEV-FE-UI-COMPONENTIZE"
26
+ - "CMD-DEV-FE-HOOK-SEPARATE"
27
+ - "CMD-DEV-PERF-OPTIMIZE"
28
+ input_artifact: "ART-SCOPE-ADR"
29
+ output_artifact: "ART-IMPLEMENTATION-PACK"
30
+ exit_criteria:
31
+ - "기능 구현 완료"
32
+ - "반복 리팩터 반영"
33
+ - order: 3
34
+ stage_id: "STG-TEST"
35
+ agent: "qa-agent"
36
+ commands:
37
+ - "CMD-TEST-UNIT-INTEGRATION"
38
+ input_artifact: "ART-IMPLEMENTATION-PACK"
39
+ output_artifact: "ART-TEST-REPORT"
40
+ exit_criteria:
41
+ - "테스트 통과"
42
+ - order: 4
43
+ stage_id: "STG-REVIEW"
44
+ agent: "review-security-agent"
45
+ commands:
46
+ - "CMD-REVIEW-CODE"
47
+ - "CMD-SEC-THREAT-MODEL"
48
+ - "CMD-SEC-DEPENDENCY-AUDIT"
49
+ input_artifact: "ART-TEST-REPORT"
50
+ output_artifact: "ART-QUALITY-SECURITY-REPORT"
51
+ exit_criteria:
52
+ - "차단 이슈 0건"
53
+ - "치명 취약점 0건"
54
+ - order: 5
55
+ stage_id: "STG-RELEASE"
56
+ agent: "release-ops-agent"
57
+ commands:
58
+ - "CMD-OPS-CI-CD-GATE"
59
+ - "CMD-OPS-DEPLOY"
60
+ - "CMD-DOC-HANDOFF"
61
+ input_artifact: "ART-QUALITY-SECURITY-REPORT"
62
+ output_artifact: "ART-RELEASE-READY"
63
+ exit_criteria:
64
+ - "배포 준비 완료"
65
+ final_outputs:
66
+ - "ART-RELEASE-READY"
67
+ - "ART-OPERATIONS-HANDBOOK"
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "workflows": [
8
8
  {
9
- "id": "WF-SVC-001",
9
+ "id": "WF-SERVICE-E2E",
10
10
  "name": "서비스 E2E 파이프라인 (Plan→Implement→Test→Review→Release)",
11
11
  "summary": "신규 서비스 또는 대형 기능 배치에 사용하는 기본 운영 파이프라인입니다.",
12
12
  "orchestrator": "manager-agent",
@@ -95,7 +95,7 @@
95
95
  "when_to_use": "신규 서비스, 대형 기능 릴리즈"
96
96
  },
97
97
  {
98
- "id": "WF-SVC-002",
98
+ "id": "WF-FRONTEND-REFACTOR",
99
99
  "name": "반복 프론트엔드 개선 (UI→Hook→성능)",
100
100
  "summary": "UI 컴포넌트화, Hook 분리, 성능 최적화를 단일 체인으로 실행합니다.",
101
101
  "orchestrator": "manager-agent",
@@ -147,7 +147,7 @@
147
147
  "when_to_use": "프론트 구조 개선, 성능 개선"
148
148
  },
149
149
  {
150
- "id": "WF-SVC-003",
150
+ "id": "WF-SECURITY-HARDENING",
151
151
  "name": "보안 강화 배치 (진단→보완→검증)",
152
152
  "summary": "위협 모델링과 취약점 감사 기반 하드닝을 수행합니다.",
153
153
  "orchestrator": "manager-agent",
@@ -201,7 +201,7 @@
201
201
  "when_to_use": "정기 보안 배치, 취약점 대응"
202
202
  },
203
203
  {
204
- "id": "WF-SVC-004",
204
+ "id": "WF-INCIDENT-RESPONSE",
205
205
  "name": "장애 대응/재발 방지 (트리아지→근본수정→포스트모템)",
206
206
  "summary": "Incident triage 이후 근본 원인 수정과 후속 조치까지 수행합니다.",
207
207
  "orchestrator": "incident-manager-agent",
@@ -256,7 +256,7 @@
256
256
  "when_to_use": "운영 장애 대응, RCA 필요 이슈"
257
257
  },
258
258
  {
259
- "id": "WF-PRD-IMPLEMENT-E2E",
259
+ "id": "WF-PRD-TO-PRODUCTION",
260
260
  "name": "PRD 대화형 작성→순차 자동 구현",
261
261
  "summary": "Manager가 PRD 대화형 단계와 구현 자동 단계를 분리 오케스트레이션합니다.",
262
262
  "orchestrator": "manager-agent",
@@ -295,7 +295,7 @@
295
295
  {
296
296
  "id": "prd-to-production",
297
297
  "title": "PRD→구현 자동 파이프라인",
298
- "description": "PRD 대화형 작성 후 순차 자동 구현 워크플로우(WF-PRD-IMPLEMENT-E2E)를 사용하는 구성",
298
+ "description": "PRD 대화형 작성 후 순차 자동 구현 워크플로우(WF-PRD-TO-PRODUCTION)를 사용하는 구성",
299
299
  "tools": [
300
300
  "claude-code",
301
301
  "antigravity",
@@ -1,6 +1,8 @@
1
1
  # Claude Code 운영팩
2
2
 
3
3
  이 폴더는 Claude Code에서 서비스 운영 전체(기획-개발-배포-운영-보안-개선)를 실행하실 수 있도록 스킬, 서브에이전트, 팀, 워크플로우 정의를 담고 있습니다.
4
+ 정의 원천은 저장소 `common/*`이며, 이 폴더의 파일은 생성 스크립트(`npm run generate`) 결과입니다.
5
+ 직접 수정 대신 공통 원천을 수정한 뒤 재생성해 주세요.
4
6
 
5
7
  ## 폴더 구성
6
8
 
@@ -12,7 +14,7 @@
12
14
 
13
15
  ## 빠른 시작
14
16
 
15
- 1. 워크플로우를 선택해 주세요: `WF-SVC-001`(E2E), `WF-SVC-003`(리뷰 루프), `WF-SVC-004`(보안), `WF-SVC-007`(장애 대응), `WF-PRD-IMPLEMENT-E2E`(PRD→구현)
17
+ 1. 워크플로우를 선택해 주세요: `WF-SERVICE-E2E`(E2E), `WF-CODE-REVIEW-LOOP`(리뷰 루프), `WF-SECURITY-HARDENING`(보안), `WF-INCIDENT-RESPONSE`(장애 대응), `WF-PRD-TO-PRODUCTION`(PRD→구현)
16
18
  2. 단계별 명령을 실행해 주세요: 각 stage의 `commands` ID 순서대로 실행
17
19
  3. 품질 검증을 확인해 주세요: stage `exit_criteria`를 모두 충족해야 다음 단계로 이동
18
20
 
@@ -22,6 +24,7 @@
22
24
  - UI 컴포넌트화: `ui-component-engineer`
23
25
  - Hook 분리: `hook-refactor-engineer`
24
26
  - 최적화: `performance-engineer`
27
+ - 변경점 안전 검토: `change-safety-review` + `code-reviewer`, `qa-engineer`, `performance-engineer`
25
28
  - PRD 작성: `prd-writer`
26
29
 
27
30
  ## 서브에이전트 팀 운영 기준
@@ -22,11 +22,11 @@
22
22
  "operations-owner"
23
23
  ],
24
24
  "default_workflows": [
25
- "WF-SVC-001",
26
- "WF-SVC-002",
27
- "WF-SVC-005",
28
- "WF-SVC-006",
29
- "WF-PRD-IMPLEMENT-E2E"
25
+ "WF-SERVICE-E2E",
26
+ "WF-FEATURE-DELIVERY",
27
+ "WF-RELEASE-TRANSITION",
28
+ "WF-FRONTEND-REFACTOR",
29
+ "WF-PRD-TO-PRODUCTION"
30
30
  ]
31
31
  },
32
32
  {
@@ -41,7 +41,7 @@
41
41
  "sre-release-engineer"
42
42
  ],
43
43
  "default_workflows": [
44
- "WF-SVC-004"
44
+ "WF-SECURITY-HARDENING"
45
45
  ]
46
46
  },
47
47
  {
@@ -57,7 +57,7 @@
57
57
  "code-reviewer"
58
58
  ],
59
59
  "default_workflows": [
60
- "WF-SVC-007"
60
+ "WF-INCIDENT-RESPONSE"
61
61
  ]
62
62
  }
63
63
  ],
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: change-safety-review
3
+ description: 현재 git 변경점 또는 전체 프로젝트를 기준으로 렌더링 회귀, 레이스 컨디션, 숨은 사이드이펙트를 점검하고 차단 이슈를 확정한다. "지금 변경사항 문제 없는지", "렌더링/레이스/부작용 검토" 요청에서 사용한다.
4
+ ---
5
+
6
+ # 시작 전 체크리스트
7
+
8
+ - 검토 범위를 고정한다 (`git diff`, 특정 PR, 또는 전체 릴리즈 범위 중 하나).
9
+ - 영향 경로를 작성한다 (화면/라우트, API 엔드포인트, 배치/크론, 외부 연동).
10
+ - 정상/경계/오류 케이스 최소 3개 재현 시나리오를 확보한다.
11
+ - 현재 테스트/빌드 상태(성공/실패)와 마지막 성공 커밋을 기록한다.
12
+
13
+ # 실행 절차
14
+
15
+ 1. 검증 범위를 고정한다: 기본은 현재 `git diff`(staged + unstaged), 요청 시 전체 프로젝트로 확장한다.
16
+ 2. 변경 파일과 영향 경로를 분류한다(UI 렌더링, 비동기 상태, 외부 I/O, 전역 상태).
17
+ 3. `CMD-TEST-UNIT-INTEGRATION`으로 회귀 경로를 먼저 고정한다.
18
+ 4. `CMD-REVIEW-CODE`로 렌더링 깨짐, 레이스 컨디션, 사이드이펙트 리스크를 차단/권고로 분리한다.
19
+ 5. UI/상태 변경이 있으면 `CMD-DEV-PERF-OPTIMIZE` 관점으로 불필요 렌더링과 상태 오케스트레이션 비용을 재점검한다.
20
+ 6. 차단 이슈 0건 또는 미해결 차단 목록/우회책을 명시하고 종료한다.
21
+
22
+ # 결과 보고 형식
23
+
24
+ - 검증 범위: 브랜치/커밋/파일 목록, 제외 범위
25
+ - 차단 이슈: `파일:라인`, 재현 단계, 영향, 즉시 수정안
26
+ - 권고 이슈: 우선순위(P1/P2/P3), 수정 난이도, 기대 효과
27
+ - 실행 근거: 테스트/리뷰/프로파일링 결과
28
+ - 최종 결론: `배포 가능` 또는 `차단`, 잔여 리스크
29
+
30
+ # 중단 조건
31
+
32
+ - 차단 이슈가 남아 있고 우회 방안이 승인되지 않은 경우
33
+ - 재현 절차가 성립하지 않아 사실/추정을 분리할 수 없는 경우
34
+ - 테스트 기반이 깨져 회귀 판단이 불가능한 경우
35
+
36
+ # 품질 규칙
37
+
38
+ - 차단 이슈는 파일 위치, 재현 절차, 영향 범위, 수정 제안을 반드시 포함한다.
39
+ - 확인된 사실과 추정 리스크를 분리해 기록한다.
40
+ - "문제 없음" 결론에는 실행한 검증 범위, 테스트/리뷰 근거, 잔여 리스크를 함께 남긴다.
@@ -3,13 +3,33 @@ name: code-review-and-improvement
3
3
  description: 코드 리뷰에서 결함과 개선안을 식별하고 수정 루프까지 닫는다. PR 리뷰, 리팩터링 점검, 품질 하락 대응 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 리뷰 대상 범위를 확정한다 (PR 링크, 커밋 범위, 모듈 경계).
9
+ - 리뷰 기준을 고정한다 (정합성, 보안, 성능, 가독성, 테스트).
10
+ - 변경 위험도를 산정한다 (사용자 영향, 데이터 영향, 장애 가능성).
11
+ - 수정 가능 시간/범위와 이번 사이클 제외 항목을 명시한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-SVC-003`을 기준으로 리뷰 루프를 시작한다.
15
+ 1. `WF-CODE-REVIEW-LOOP`을 기준으로 리뷰 루프를 시작한다.
9
16
  2. `CMD-REVIEW-CODE`로 차단 이슈와 권고 이슈를 분리한다.
10
17
  3. `CMD-IMPROVE-TECHDEBT`로 구조 개선 항목을 우선순위화한다.
11
18
  4. `CMD-TEST-UNIT-INTEGRATION`으로 회귀를 검증한다.
12
19
 
20
+ # 결과 보고 형식
21
+
22
+ - 리뷰 결과: 차단/권고 분리 목록
23
+ - 개선 적용 내역: 원인, 변경점, 영향을 받은 파일
24
+ - 재검증 결과: 테스트/정적 검사/리뷰 재실행 결과
25
+ - 남은 기술 부채: 우선순위, 예상 공수, 후속 담당
26
+
27
+ # 중단 조건
28
+
29
+ - 차단 이슈가 남아 있고 수정 범위 합의가 없는 경우
30
+ - 아키텍처 수준 결정이 필요하지만 의사결정자가 부재한 경우
31
+ - 수정 이후 회귀 테스트를 실행할 수 없는 경우
32
+
13
33
  # 품질 규칙
14
34
 
15
35
  - 지적 사항은 파일 위치와 재현 단계를 포함한다.
@@ -3,13 +3,33 @@ name: frontend-repetition-pack
3
3
  description: 반복적인 프론트엔드 개선 작업(UI 컴포넌트화, Hook 분리, 성능 최적화)을 표준 절차로 실행한다. 대규모 화면 리팩터링과 성능 개선 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 중복 UI 후보 목록을 수집한다 (화면/컴포넌트/사용 횟수).
9
+ - 기준 지표를 기록한다 (번들 크기, 렌더 횟수, 핵심 UX 지연 시간).
10
+ - 디자인 토큰/컴포넌트 규칙을 확인한다.
11
+ - 상태 로직 분리 대상(부수효과/비동기/공유 상태)을 표시한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-SVC-006`를 실행한다.
15
+ 1. `WF-FRONTEND-REFACTOR`를 실행한다.
9
16
  2. `CMD-DEV-FE-UI-COMPONENTIZE`로 중복 UI를 먼저 줄인다.
10
17
  3. `CMD-DEV-FE-HOOK-SEPARATE`로 로직을 Hook으로 분리한다.
11
18
  4. `CMD-DEV-PERF-OPTIMIZE`로 성능 병목을 정리한다.
12
19
 
20
+ # 결과 보고 형식
21
+
22
+ - 컴포넌트화 결과: 기존->신규 매핑, 공통 Props 계약
23
+ - Hook 분리 결과: Hook 이름, 입력/출력, 부수효과 정책
24
+ - 성능 결과: 전/후 지표와 측정 조건
25
+ - 남은 리팩터 항목: 우선순위와 예상 영향
26
+
27
+ # 중단 조건
28
+
29
+ - 시각적 회귀가 차단 이슈 수준으로 발생한 경우
30
+ - 컴포넌트 계약이 확정되지 않아 호출부 정리가 불가능한 경우
31
+ - 전/후 성능 비교가 불가능해 개선 효과를 증명할 수 없는 경우
32
+
13
33
  # 품질 규칙
14
34
 
15
35
  - 각 단계는 전후 비교 지표를 남긴다.
@@ -3,13 +3,33 @@ name: incident-response
3
3
  description: 장애 탐지 이후 복구, 원인 분석, 재발 방지까지 일괄 수행한다. 장애 대응, 핫픽스, 포스트모템 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 장애 심각도(SEV), 영향 범위, 시작 시각을 확정한다.
9
+ - 즉시 복구 경로(롤백/우회/트래픽 차단)를 준비한다.
10
+ - 커뮤니케이션 채널과 의사결정 책임자를 지정한다.
11
+ - 로그/메트릭/알림 스냅샷을 보존한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-SVC-007`을 시작한다.
15
+ 1. `WF-INCIDENT-RESPONSE`을 시작한다.
9
16
  2. `CMD-INCIDENT-TRIAGE`로 심각도와 영향도를 고정한다.
10
17
  3. `CMD-IMPROVE-TECHDEBT`와 `CMD-REVIEW-CODE`로 근본 원인 수정안을 반영한다.
11
18
  4. `CMD-DOC-HANDOFF`로 재발 방지 액션을 운영 문서에 반영한다.
12
19
 
20
+ # 결과 보고 형식
21
+
22
+ - 타임라인: 탐지->완화->복구 시각
23
+ - 복구 조치: 실행 명령/설정 변경/결과
24
+ - 근본 원인: 기술 원인, 프로세스 원인
25
+ - 재발 방지 액션: 담당자, 마감일, 검증 방법
26
+
27
+ # 중단 조건
28
+
29
+ - 고객 영향이 지속되는데 복구 경로가 없는 경우
30
+ - 데이터 손상 가능성이 있어 즉시 격리가 필요한 경우
31
+ - 재발 방지 액션의 책임자/기한이 확정되지 않은 경우
32
+
13
33
  # 품질 규칙
14
34
 
15
35
  - 복구 후 RCA 일정과 책임자를 반드시 기록한다.
@@ -3,14 +3,34 @@ name: prd-to-production-pipeline
3
3
  description: PRD를 대화형으로 정교화한 뒤 세부 PRD 기반으로 구현을 순차 자동 실행한다. PRD 기반 end-to-end 구현 자동화 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 문제 정의와 목표 지표(KPI)를 수치로 확정한다.
9
+ - 기능/비기능 요구사항과 제외 범위를 명시한다.
10
+ - 의존성 순서와 자동/수동 경계를 사전에 고정한다.
11
+ - 수용 기준(acceptance criteria)과 실패 기준을 명시한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-PRD-IMPLEMENT-E2E`을 선택한다.
15
+ 1. `WF-PRD-TO-PRODUCTION`을 선택한다.
9
16
  2. `CMD-PLAN-PRD-MASTER`와 `CMD-PLAN-PRD-DETAILS`를 대화형으로 완료한다.
10
17
  3. `CMD-PLAN-IMPLEMENTATION-BOOTSTRAP`로 수동/자동 경계를 고정한다.
11
18
  4. `CMD-DEV-SEQUENTIAL-AUTORUN`으로 구현을 순차 자동 실행한다.
12
19
  5. 최종 단계에서 수동 세팅을 수행한다.
13
20
 
21
+ # 결과 보고 형식
22
+
23
+ - PRD 마스터 결과: 목표/범위/제약
24
+ - 세부 PRD 결과: 에픽별 요구사항과 수용 기준
25
+ - 구현 실행 결과: 배치별 실행 로그와 검증 결과
26
+ - 최종 수동 체크리스트: 미자동화 항목과 승인 상태
27
+
28
+ # 중단 조건
29
+
30
+ - 수용 기준이 불명확해 완료 판단이 불가능한 경우
31
+ - 핵심 의존성이 해결되지 않아 순차 실행이 깨지는 경우
32
+ - 자동 실행 중 차단 이슈가 발생하고 우회 승인이 없는 경우
33
+
14
34
  # 품질 규칙
15
35
 
16
36
  - PRD에는 UI 컴포넌트화, 톤앤매너, 성능, 보안, 가독성 기준을 포함한다.
@@ -3,13 +3,33 @@ name: release-and-operations
3
3
  description: 배포 게이트, 점진 배포, 운영 모니터링, 인수인계를 표준화한다. 릴리즈 준비, 운영 전환, 안정화 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 배포 게이트 조건(테스트, 보안, 승인자)을 확정한다.
9
+ - 롤백 절차와 롤백 트리거를 검증한다.
10
+ - 모니터링 지표/알림 임계치/온콜 책임자를 확인한다.
11
+ - 릴리즈 노트와 인수인계 문서 초안을 준비한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-SVC-005`를 실행한다.
15
+ 1. `WF-RELEASE-TRANSITION`를 실행한다.
9
16
  2. `CMD-OPS-CI-CD-GATE`로 필수 게이트를 고정한다.
10
17
  3. `CMD-OPS-DEPLOY`와 `CMD-OPS-MONITORING`을 연결한다.
11
18
  4. `CMD-DOC-HANDOFF`로 운영 문서를 갱신한다.
12
19
 
20
+ # 결과 보고 형식
21
+
22
+ - 게이트 결과: 통과/실패와 근거
23
+ - 배포 실행 기록: 환경, 버전, 시각, 결과
24
+ - 모니터링 결과: 핵심 SLI 추이, 이상 징후
25
+ - 인수인계 결과: 런북 업데이트, 오너 확인
26
+
27
+ # 중단 조건
28
+
29
+ - 게이트 실패 상태에서 우회 요청만 있는 경우
30
+ - 롤백 전략이 검증되지 않은 경우
31
+ - 치명 경보가 발생했는데 원인/완화가 확인되지 않은 경우
32
+
13
33
  # 품질 규칙
14
34
 
15
35
  - 롤백 경로 없는 배포를 금지한다.
@@ -3,12 +3,32 @@ name: security-hardening
3
3
  description: 위협 모델링, 취약점 감사, 보완 적용, 재검증까지 수행한다. 보안 점검, 규제 대응, 취약점 조치 요청에서 사용한다.
4
4
  ---
5
5
 
6
+ # 시작 전 체크리스트
7
+
8
+ - 신뢰 경계와 보호 대상 자산을 확정한다.
9
+ - 의존성 목록과 현재 취약점 현황을 수집한다.
10
+ - 위협 모델링 범위(인증/인가/데이터/운영)를 고정한다.
11
+ - 예외 승인 정책(책임자, 만료일)을 준비한다.
12
+
6
13
  # 실행 절차
7
14
 
8
- 1. `WF-SVC-004`를 선택한다.
15
+ 1. `WF-SECURITY-HARDENING`를 선택한다.
9
16
  2. `CMD-SEC-THREAT-MODEL`과 `CMD-SEC-DEPENDENCY-AUDIT`로 위험 목록을 확정한다.
10
17
  3. 보완 코드를 반영한 뒤 `CMD-TEST-UNIT-INTEGRATION`으로 재검증한다.
11
18
 
19
+ # 결과 보고 형식
20
+
21
+ - 위협/취약점 목록: 심각도, 영향, 우선순위
22
+ - 보완 적용 내역: 코드/설정 변경과 근거
23
+ - 재검증 결과: 스캔/테스트/리뷰 결과
24
+ - 잔여 위험 및 예외 승인: 책임자, 만료일
25
+
26
+ # 중단 조건
27
+
28
+ - 치명 취약점이 남아 있는데 배포를 진행하려는 경우
29
+ - 고위험 위협에 대한 완화 통제가 정의되지 않은 경우
30
+ - 예외 승인이 만료일 없이 요청된 경우
31
+
12
32
  # 품질 규칙
13
33
 
14
34
  - 치명 취약점 잔존 시 배포를 금지한다.