@dusky-bluehour/agent-service 0.6.5 → 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.
- package/README.md +19 -0
- package/antigravity/README.md +7 -1
- package/antigravity/agents/agent-catalog.json +5 -5
- package/antigravity/skills/change-safety-review/SKILL.md +40 -0
- package/antigravity/skills/code-review-and-improvement/SKILL.md +20 -0
- package/antigravity/skills/frontend-repetition-pack/SKILL.md +20 -0
- package/antigravity/skills/incident-response/SKILL.md +20 -0
- package/antigravity/skills/prd-to-production-pipeline/SKILL.md +21 -1
- package/antigravity/skills/release-and-operations/SKILL.md +20 -0
- package/antigravity/skills/security-hardening/SKILL.md +21 -1
- package/antigravity/skills/service-lifecycle-orchestration/SKILL.md +21 -1
- package/antigravity/workflows/definitions/WF-FRONTEND-REFACTOR.workflow.yaml +38 -0
- package/antigravity/workflows/definitions/WF-INCIDENT-RESPONSE.workflow.yaml +41 -0
- package/antigravity/workflows/definitions/WF-PRD-TO-PRODUCTION.workflow.yaml +76 -0
- package/antigravity/workflows/definitions/WF-SECURITY-HARDENING.workflow.yaml +40 -0
- package/antigravity/workflows/definitions/WF-SERVICE-E2E.workflow.yaml +67 -0
- package/antigravity/workflows/workflow-catalog.json +5 -5
- package/catalog/tool-catalog.ko.json +1 -1
- package/claude-code/README.md +4 -1
- package/claude-code/agent-teams/team-catalog.json +7 -7
- package/claude-code/skills/change-safety-review/SKILL.md +40 -0
- package/claude-code/skills/code-review-and-improvement/SKILL.md +21 -1
- package/claude-code/skills/frontend-repetition-pack/SKILL.md +21 -1
- package/claude-code/skills/incident-response/SKILL.md +21 -1
- package/claude-code/skills/prd-to-production-pipeline/SKILL.md +21 -1
- package/claude-code/skills/release-and-operations/SKILL.md +21 -1
- package/claude-code/skills/security-hardening/SKILL.md +21 -1
- package/claude-code/skills/service-lifecycle-orchestration/SKILL.md +21 -1
- package/claude-code/workflows/workflow-catalog.json +8 -8
- package/codex/README.md +5 -2
- package/codex/automations/automation-recipes.toml +4 -4
- package/codex/instructions/AGENTS.template.md +6 -5
- package/codex/skills/change-safety-review/SKILL.md +40 -0
- package/codex/skills/change-safety-review/agents/openai.yaml +4 -0
- package/codex/skills/code-review-and-improvement/SKILL.md +21 -1
- package/codex/skills/frontend-repetition-pack/SKILL.md +20 -0
- package/codex/skills/incident-response/SKILL.md +21 -1
- package/codex/skills/prd-to-production-pipeline/SKILL.md +21 -1
- package/codex/skills/release-and-operations/SKILL.md +20 -0
- package/codex/skills/security-hardening/SKILL.md +21 -1
- package/codex/skills/service-lifecycle-orchestration/SKILL.md +21 -1
- package/codex/workflows/workflow-catalog.json +6 -6
- package/common/antigravity/agent-catalog.json +72 -0
- package/common/antigravity/artifact-catalog.json +184 -0
- package/common/claude/subagent-catalog.json +419 -0
- package/common/claude/team-catalog.json +69 -0
- package/common/commands/command-catalog.json +942 -0
- package/common/skills/skill-catalog.json +566 -0
- package/common/workflows/workflow-catalog.json +1550 -0
- package/package.json +6 -2
- package/scripts/generate-from-common.mjs +387 -0
- package/scripts/init.mjs +10 -0
- package/scripts/validate.mjs +243 -1
package/README.md
CHANGED
|
@@ -12,6 +12,10 @@ pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --inte
|
|
|
12
12
|
pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --interactive
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
+
```bash
|
|
16
|
+
npx --yes --package @dusky-bluehour/agent-service tri-agent-manager --interactive
|
|
17
|
+
```
|
|
18
|
+
|
|
15
19
|
## 패키지 다운로드 후 사용
|
|
16
20
|
|
|
17
21
|
```bash
|
|
@@ -45,3 +49,18 @@ pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --help
|
|
|
45
49
|
- Antigravity: `<target>/.agent/*`
|
|
46
50
|
- Codex: `<target>/.codex/*`
|
|
47
51
|
- 가이드: `<target>/.tri-agent-manager/USAGE.ko.md`
|
|
52
|
+
|
|
53
|
+
## 개발자용 (정의 변경 시)
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# common 정의를 툴별 파일로 생성
|
|
57
|
+
npm run generate
|
|
58
|
+
|
|
59
|
+
# 생성 결과가 최신인지 확인 + 전체 검증
|
|
60
|
+
npm run validate
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
원칙:
|
|
64
|
+
|
|
65
|
+
- 공통 원천은 `common/*`에서만 수정합니다.
|
|
66
|
+
- `claude-code/*`, `codex/*`, `antigravity/*`는 생성 결과로 취급합니다.
|
package/antigravity/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# Antigravity 운영팩
|
|
2
2
|
|
|
3
3
|
이 폴더는 Antigravity의 Manager-에이전트-Artifact 흐름을 기준으로, 서비스 운영 전체를 실행 가능한 형태로 정리한 패키지입니다.
|
|
4
|
+
정의 원천은 저장소 `common/*`이며, 이 폴더의 파일은 생성 스크립트(`npm run generate`) 결과입니다.
|
|
5
|
+
직접 수정 대신 공통 원천을 수정한 뒤 재생성해 주세요.
|
|
4
6
|
|
|
5
7
|
## 폴더 구성
|
|
6
8
|
|
|
@@ -8,20 +10,24 @@
|
|
|
8
10
|
- `agents/agent-catalog.json`: 에이전트 역할 카탈로그
|
|
9
11
|
- `artifacts/artifact-catalog.json`: 단계별 Artifact 계약
|
|
10
12
|
- `workflows/workflow-catalog.json`: 오케스트레이션 워크플로우
|
|
13
|
+
- `workflows/definitions/*.workflow.yaml`: Antigravity 실행용 워크플로우 정의 파일
|
|
11
14
|
- `commands/command-catalog.json`: 공통 명령 계약
|
|
12
15
|
|
|
13
16
|
## 빠른 시작
|
|
14
17
|
|
|
15
|
-
1. `WF-
|
|
18
|
+
1. `WF-SERVICE-E2E`(기본 E2E), `WF-SECURITY-HARDENING`(보안), `WF-INCIDENT-RESPONSE`(장애 대응), `WF-PRD-TO-PRODUCTION`(PRD→구현) 등 목적별 워크플로우를 선택해 주세요.
|
|
16
19
|
2. 각 단계의 `input_artifact` 필드를 먼저 검증해 주세요.
|
|
17
20
|
3. 지정된 `agent`가 `commands`를 수행합니다.
|
|
18
21
|
4. `output_artifact` 검증 후 다음 단계로 진행해 주세요.
|
|
19
22
|
|
|
23
|
+
워크플로우 카탈로그에서 선택한 ID와 동일한 이름의 정의 파일을 `workflows/definitions/`에서 사용하시면 됩니다. 예: `WF-SERVICE-E2E.workflow.yaml`
|
|
24
|
+
|
|
20
25
|
## 반복 작업 역할 분리
|
|
21
26
|
|
|
22
27
|
- UI 컴포넌트화: `frontend-repetition-agent` + `CMD-DEV-FE-UI-COMPONENTIZE`
|
|
23
28
|
- Hook 분리: `frontend-repetition-agent` + `CMD-DEV-FE-HOOK-SEPARATE`
|
|
24
29
|
- 성능 최적화: `performance-agent` + `CMD-DEV-PERF-OPTIMIZE`
|
|
30
|
+
- 변경점 안전 검토: `change-safety-review` + `CMD-TEST-UNIT-INTEGRATION`, `CMD-REVIEW-CODE`
|
|
25
31
|
- PRD 작성: `prd-writer-agent`
|
|
26
32
|
|
|
27
33
|
## 운영 규칙
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"role": "PRD 작성",
|
|
7
7
|
"responsibility": "마스터 PRD와 세부 PRD를 대화형으로 작성하고 구현 수용 기준을 명시",
|
|
8
8
|
"default_workflows": [
|
|
9
|
-
"WF-PRD-
|
|
9
|
+
"WF-PRD-TO-PRODUCTION"
|
|
10
10
|
]
|
|
11
11
|
},
|
|
12
12
|
{
|
|
@@ -14,9 +14,9 @@
|
|
|
14
14
|
"role": "오케스트레이터",
|
|
15
15
|
"responsibility": "워크플로우 단계 제어, 에이전트 체인 구성, Artifact 검증 게이트 실행",
|
|
16
16
|
"default_workflows": [
|
|
17
|
-
"WF-
|
|
18
|
-
"WF-
|
|
19
|
-
"WF-
|
|
17
|
+
"WF-SERVICE-E2E",
|
|
18
|
+
"WF-FRONTEND-REFACTOR",
|
|
19
|
+
"WF-SECURITY-HARDENING"
|
|
20
20
|
]
|
|
21
21
|
},
|
|
22
22
|
{
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"role": "인시던트 오케스트레이터",
|
|
25
25
|
"responsibility": "장애 대응 워룸 흐름 제어",
|
|
26
26
|
"default_workflows": [
|
|
27
|
-
"WF-
|
|
27
|
+
"WF-INCIDENT-RESPONSE"
|
|
28
28
|
]
|
|
29
29
|
},
|
|
30
30
|
{
|
|
@@ -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,12 +3,32 @@ name: code-review-and-improvement
|
|
|
3
3
|
description: 코드 리뷰와 개선 반영을 아티팩트 기반으로 관리한다. 품질 점검과 리팩터링 개선 요청에서 사용한다.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
# 시작 전 체크리스트
|
|
7
|
+
|
|
8
|
+
- 리뷰 대상 범위를 확정한다 (PR 링크, 커밋 범위, 모듈 경계).
|
|
9
|
+
- 리뷰 기준을 고정한다 (정합성, 보안, 성능, 가독성, 테스트).
|
|
10
|
+
- 변경 위험도를 산정한다 (사용자 영향, 데이터 영향, 장애 가능성).
|
|
11
|
+
- 수정 가능 시간/범위와 이번 사이클 제외 항목을 명시한다.
|
|
12
|
+
|
|
6
13
|
# 실행 절차
|
|
7
14
|
|
|
8
15
|
1. `CMD-REVIEW-CODE`로 이슈를 분류한다.
|
|
9
16
|
2. `CMD-IMPROVE-TECHDEBT`로 개선안을 우선순위화한다.
|
|
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
|
- 차단 이슈와 권고 이슈를 분리한다.
|
|
@@ -3,12 +3,32 @@ 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
15
|
1. `CMD-DEV-FE-UI-COMPONENTIZE`
|
|
9
16
|
2. `CMD-DEV-FE-HOOK-SEPARATE`
|
|
10
17
|
3. `CMD-DEV-PERF-OPTIMIZE`
|
|
11
18
|
|
|
19
|
+
# 결과 보고 형식
|
|
20
|
+
|
|
21
|
+
- 컴포넌트화 결과: 기존->신규 매핑, 공통 Props 계약
|
|
22
|
+
- Hook 분리 결과: Hook 이름, 입력/출력, 부수효과 정책
|
|
23
|
+
- 성능 결과: 전/후 지표와 측정 조건
|
|
24
|
+
- 남은 리팩터 항목: 우선순위와 예상 영향
|
|
25
|
+
|
|
26
|
+
# 중단 조건
|
|
27
|
+
|
|
28
|
+
- 시각적 회귀가 차단 이슈 수준으로 발생한 경우
|
|
29
|
+
- 컴포넌트 계약이 확정되지 않아 호출부 정리가 불가능한 경우
|
|
30
|
+
- 전/후 성능 비교가 불가능해 개선 효과를 증명할 수 없는 경우
|
|
31
|
+
|
|
12
32
|
# 품질 규칙
|
|
13
33
|
|
|
14
34
|
- 단계별 전후 지표를 Artifact에 남긴다.
|
|
@@ -3,12 +3,32 @@ name: incident-response
|
|
|
3
3
|
description: 장애 대응, 근본 원인 수정, 재발 방지까지 수행한다. 운영 장애 및 핫픽스 대응에서 사용한다.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
# 시작 전 체크리스트
|
|
7
|
+
|
|
8
|
+
- 장애 심각도(SEV), 영향 범위, 시작 시각을 확정한다.
|
|
9
|
+
- 즉시 복구 경로(롤백/우회/트래픽 차단)를 준비한다.
|
|
10
|
+
- 커뮤니케이션 채널과 의사결정 책임자를 지정한다.
|
|
11
|
+
- 로그/메트릭/알림 스냅샷을 보존한다.
|
|
12
|
+
|
|
6
13
|
# 실행 절차
|
|
7
14
|
|
|
8
15
|
1. `CMD-INCIDENT-TRIAGE`로 복구 우선
|
|
9
16
|
2. `CMD-IMPROVE-TECHDEBT`로 근본 원인 보완
|
|
10
17
|
3. `CMD-DOC-HANDOFF`로 재발 방지 문서화
|
|
11
18
|
|
|
19
|
+
# 결과 보고 형식
|
|
20
|
+
|
|
21
|
+
- 타임라인: 탐지->완화->복구 시각
|
|
22
|
+
- 복구 조치: 실행 명령/설정 변경/결과
|
|
23
|
+
- 근본 원인: 기술 원인, 프로세스 원인
|
|
24
|
+
- 재발 방지 액션: 담당자, 마감일, 검증 방법
|
|
25
|
+
|
|
26
|
+
# 중단 조건
|
|
27
|
+
|
|
28
|
+
- 고객 영향이 지속되는데 복구 경로가 없는 경우
|
|
29
|
+
- 데이터 손상 가능성이 있어 즉시 격리가 필요한 경우
|
|
30
|
+
- 재발 방지 액션의 책임자/기한이 확정되지 않은 경우
|
|
31
|
+
|
|
12
32
|
# 품질 규칙
|
|
13
33
|
|
|
14
34
|
- RCA와 재발 방지 액션 없는 종료 금지
|
|
@@ -3,13 +3,33 @@ name: prd-to-production-pipeline
|
|
|
3
3
|
description: PRD 작성 단계를 대화형으로 수행하고 구현 단계를 순차 자동 오케스트레이션한다. Manager-Agent-Artifact 기반 PRD→구현 자동화 요청에서 사용한다.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
# 시작 전 체크리스트
|
|
7
|
+
|
|
8
|
+
- 문제 정의와 목표 지표(KPI)를 수치로 확정한다.
|
|
9
|
+
- 기능/비기능 요구사항과 제외 범위를 명시한다.
|
|
10
|
+
- 의존성 순서와 자동/수동 경계를 사전에 고정한다.
|
|
11
|
+
- 수용 기준(acceptance criteria)과 실패 기준을 명시한다.
|
|
12
|
+
|
|
6
13
|
# 실행 절차
|
|
7
14
|
|
|
8
|
-
1. `WF-PRD-
|
|
15
|
+
1. `WF-PRD-TO-PRODUCTION` 실행
|
|
9
16
|
2. `ART-PRD-MASTER`, `ART-PRD-DETAILS`를 대화형 단계에서 확정
|
|
10
17
|
3. `ART-IMPLEMENTATION-BOOTSTRAP` 이후 구현을 자동 순차 실행
|
|
11
18
|
4. 최종 세팅 단계에서 수동 검토 후 배포 준비 완료
|
|
12
19
|
|
|
20
|
+
# 결과 보고 형식
|
|
21
|
+
|
|
22
|
+
- PRD 마스터 결과: 목표/범위/제약
|
|
23
|
+
- 세부 PRD 결과: 에픽별 요구사항과 수용 기준
|
|
24
|
+
- 구현 실행 결과: 배치별 실행 로그와 검증 결과
|
|
25
|
+
- 최종 수동 체크리스트: 미자동화 항목과 승인 상태
|
|
26
|
+
|
|
27
|
+
# 중단 조건
|
|
28
|
+
|
|
29
|
+
- 수용 기준이 불명확해 완료 판단이 불가능한 경우
|
|
30
|
+
- 핵심 의존성이 해결되지 않아 순차 실행이 깨지는 경우
|
|
31
|
+
- 자동 실행 중 차단 이슈가 발생하고 우회 승인이 없는 경우
|
|
32
|
+
|
|
13
33
|
# 품질 규칙
|
|
14
34
|
|
|
15
35
|
- PRD 아티팩트는 수용 기준과 비기능 요구사항을 포함한다.
|
|
@@ -3,12 +3,32 @@ name: release-and-operations
|
|
|
3
3
|
description: 배포 게이트와 운영 전환을 Manager 주도로 실행한다. 릴리즈 및 안정화 요청에서 사용한다.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
# 시작 전 체크리스트
|
|
7
|
+
|
|
8
|
+
- 배포 게이트 조건(테스트, 보안, 승인자)을 확정한다.
|
|
9
|
+
- 롤백 절차와 롤백 트리거를 검증한다.
|
|
10
|
+
- 모니터링 지표/알림 임계치/온콜 책임자를 확인한다.
|
|
11
|
+
- 릴리즈 노트와 인수인계 문서 초안을 준비한다.
|
|
12
|
+
|
|
6
13
|
# 실행 절차
|
|
7
14
|
|
|
8
15
|
1. `CMD-OPS-CI-CD-GATE`
|
|
9
16
|
2. `CMD-OPS-DEPLOY`
|
|
10
17
|
3. `CMD-OPS-MONITORING`, `CMD-DOC-HANDOFF`
|
|
11
18
|
|
|
19
|
+
# 결과 보고 형식
|
|
20
|
+
|
|
21
|
+
- 게이트 결과: 통과/실패와 근거
|
|
22
|
+
- 배포 실행 기록: 환경, 버전, 시각, 결과
|
|
23
|
+
- 모니터링 결과: 핵심 SLI 추이, 이상 징후
|
|
24
|
+
- 인수인계 결과: 런북 업데이트, 오너 확인
|
|
25
|
+
|
|
26
|
+
# 중단 조건
|
|
27
|
+
|
|
28
|
+
- 게이트 실패 상태에서 우회 요청만 있는 경우
|
|
29
|
+
- 롤백 전략이 검증되지 않은 경우
|
|
30
|
+
- 치명 경보가 발생했는데 원인/완화가 확인되지 않은 경우
|
|
31
|
+
|
|
12
32
|
# 품질 규칙
|
|
13
33
|
|
|
14
34
|
- 롤백 검증 없는 배포 금지
|
|
@@ -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-
|
|
15
|
+
1. `WF-SECURITY-HARDENING` 실행
|
|
9
16
|
2. `CMD-SEC-THREAT-MODEL`, `CMD-SEC-DEPENDENCY-AUDIT` 수행
|
|
10
17
|
3. 보완 반영 후 테스트/리뷰 재실행
|
|
11
18
|
|
|
19
|
+
# 결과 보고 형식
|
|
20
|
+
|
|
21
|
+
- 위협/취약점 목록: 심각도, 영향, 우선순위
|
|
22
|
+
- 보완 적용 내역: 코드/설정 변경과 근거
|
|
23
|
+
- 재검증 결과: 스캔/테스트/리뷰 결과
|
|
24
|
+
- 잔여 위험 및 예외 승인: 책임자, 만료일
|
|
25
|
+
|
|
26
|
+
# 중단 조건
|
|
27
|
+
|
|
28
|
+
- 치명 취약점이 남아 있는데 배포를 진행하려는 경우
|
|
29
|
+
- 고위험 위협에 대한 완화 통제가 정의되지 않은 경우
|
|
30
|
+
- 예외 승인이 만료일 없이 요청된 경우
|
|
31
|
+
|
|
12
32
|
# 품질 규칙
|
|
13
33
|
|
|
14
34
|
- 치명 취약점 0건 전까지 종료 금지
|
|
@@ -3,13 +3,33 @@ name: service-lifecycle-orchestration
|
|
|
3
3
|
description: Plan-Implement-Test-Review-Release 흐름을 Manager 중심으로 실행한다. 신규 서비스 구축 및 대형 기능 출시에 사용한다.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
# 시작 전 체크리스트
|
|
7
|
+
|
|
8
|
+
- 요구사항/ADR/범위/비범위를 확정한다.
|
|
9
|
+
- 각 단계 책임 역할과 승인자를 지정한다.
|
|
10
|
+
- 단계별 진입/종료 기준을 작업 시작 전에 확인한다.
|
|
11
|
+
- 리스크와 롤백 전략을 초기 단계에서 기록한다.
|
|
12
|
+
|
|
6
13
|
# 실행 절차
|
|
7
14
|
|
|
8
|
-
1. `WF-
|
|
15
|
+
1. `WF-SERVICE-E2E`를 선택한다.
|
|
9
16
|
2. 단계별 입력 Artifact 스키마를 검증한다.
|
|
10
17
|
3. 해당 단계 에이전트가 명령 ID를 수행한다.
|
|
11
18
|
4. 출력 Artifact 검증 후 다음 단계로 진행한다.
|
|
12
19
|
|
|
20
|
+
# 결과 보고 형식
|
|
21
|
+
|
|
22
|
+
- 단계 상태: 완료/미완료/차단요인
|
|
23
|
+
- 실행 근거: 단계별 명령 ID와 결과
|
|
24
|
+
- 품질 상태: 테스트/보안/리뷰 게이트 결과
|
|
25
|
+
- 다음 행동: 담당자, 마감 조건, 선행 조건
|
|
26
|
+
|
|
27
|
+
# 중단 조건
|
|
28
|
+
|
|
29
|
+
- 진입 기준이 충족되지 않은 단계가 있는 경우
|
|
30
|
+
- 차단 이슈가 해결되지 않았는데 다음 단계로 이동하려는 경우
|
|
31
|
+
- 롤백 전략 없이 배포 단계 진입이 요청된 경우
|
|
32
|
+
|
|
13
33
|
# 품질 규칙
|
|
14
34
|
|
|
15
35
|
- Artifact 검증 실패 시 단계 진행 금지
|
|
@@ -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"
|