cdman28 Decision Advisor Skill
목적
의사결정 지점에서 사용자에게 판단 근거와 추천사항 제공
실행 시점
각 체크포인트 스크립트에서 호출 시 (checkpoint.sh)
분석 내용
- 현재 단계 완성도 평가: 완료/부분완료/재작업필요
- 발견된 문제점 및 위험요소: 기술적/구조적 문제 식별
- 다음 단계 진행 가능 여부 판단: 가능/조건부 가능/불가능
- 추천 조치사항: 진행/수정후진행/재작업
- 각 선택지의 장단점: 의사결정을 위한 상세 정보
출력 형식
구조화된 텍스트로 명확하게 제시
응답 템플릿
========================================
🤖 AI 의사결정 분석
========================================
📊 현재 단계 완성도
상태: [완료 ✅ / 부분완료 ⚠️ / 재작업필요 ❌]
진행률: XX%
📝 완료된 항목
✅ 항목 1
✅ 항목 2
...
⚠️ 발견된 문제점
위험도: [낮음/중간/높음]
- 문제 1: 설명 및 영향
- 문제 2: 설명 및 영향
...
🔍 검증 결과
- 구문 검증: [통과/실패]
- 테스트 실행: [통과/실패]
- 보안 체크: [통과/보류/실패]
- 성능 체크: [통과/보류/실패]
📋 다음 단계 진행 가능 여부
결론: [✅ 진행 가능 / ⚠️ 조건부 가능 / ❌ 진행 불가]
근거:
- 이유 1
- 이유 2
...
💡 추천 조치
추천: [1) 진행 / 2) 수정 후 진행 / 3) 재작업]
선택지별 설명:
1️⃣ 진행
- 장점: ...
- 단점: ...
- 예상 소요 시간: ...
2️⃣ 수정 후 진행
- 수정 필요 사항: ...
- 예상 수정 시간: ...
- 우선순위: ...
3️⃣ 재작업
- 재작업 필요 이유: ...
- 예상 소요 시간: ...
- 학습 포인트: ...
========================================
👤 사용자 선택을 기다립니다...
========================================
평가 기준
완료 (✅)
- 모든 계획된 작업 완료
- 테스트 100% 통과
- 치명적 문제 없음
- 다음 단계로 진행 가능
부분완료 (⚠️)
- 핵심 기능은 완료되었으나 일부 부가 기능 미완
- 테스트 80% 이상 통과
- 경미한 문제만 존재 (나중에 수정 가능)
- 조건부 다음 단계 진행 가능
재작업필요 (❌)
- 핵심 기능 미완성
- 테스트 80% 미만 통과
- 치명적 버그 또는 구조적 문제
- 다음 단계 진행 불가
위험도 분류
낮음 (🟢)
- 코딩 스타일 문제
- 경미한 성능 이슈
- 문서 미비
- 나중에 수정해도 무방
중간 (🟡)
- 보안 경고 (치명적이지 않음)
- 일부 테스트 실패
- 확장성 우려
- 수정 권장
높음 (🔴)
- 치명적 보안 취약점
- 데이터 손실 가능성
- 시스템 크래시 위험
- 즉시 수정 필수
주의사항
- 비개발자도 이해할 수 있는 설명 사용
- 기술 용어에는 쉬운 설명 추가
- 명확한 추천사항 제시 (애매한 표현 금지)
- 위험요소는 반드시 강조 (🔴 사용)
- 객관적 데이터 기반 판단 (주관적 의견 최소화)
실행 예시
checkpoint.sh 스크립트에서 호출
# AI에게 의사결정 분석 요청
agy chat "다음 핸드오프 문서를 분석하고 의사결정 조언을 해줘:
$(cat .agent/handoffs/01-plan-summary.md)
@decision-advisor skill을 사용해서 다음 형식으로 답변:
1. 현재 단계 완성도: [완료/부분완료/재작업필요]
2. 발견된 문제점: [있음/없음 - 구체적 내용]
3. 다음 단계 진행 가능 여부: [가능/불가능 - 이유]
4. 추천 조치: [진행/수정후진행/재작업]
"
AI 응답 예시
========================================
🤖 AI 의사결정 분석
========================================
📊 현재 단계 완성도
상태: 완료 ✅
진행률: 95%
📝 완료된 항목
✅ 전체 기능 목록 정의 완료
✅ 우선순위별 구현 단계 수립
✅ 기술 스택 선정 (Python/FastAPI/PostgreSQL)
✅ 데이터베이스 스키마 초안 작성
✅ API 엔드포인트 정의
⚠️ 발견된 문제점
위험도: 낮음 🟢
- 인증 방식이 JWT로 결정되었으나 OAuth 2.0 통합은 2단계로 연기됨
- 캐싱 전략(Redis)은 계획되었으나 구체적 캐싱 정책 미정의
🔍 검증 결과
- 구문 검증: N/A (계획 단계)
- 문서 완성도: 통과 ✅
- 아키텍처 일관성: 통과 ✅
- 보안 고려사항: 통과 ✅
📋 다음 단계 진행 가능 여부
결론: ✅ 진행 가능
근거:
- 모든 핵심 아키텍처 결정 완료
- 다음 단계(구현)에 필요한 정보 충분히 제공됨
- 발견된 문제는 구현 단계에서 해결 가능
- ADR 문서로 주요 결정 사항이 명확히 기록됨
💡 추천 조치
추천: 1️⃣ 진행
선택지별 설명:
1️⃣ 진행 (추천)
- 장점: 계획이 충분히 구체적이며 즉시 구현 시작 가능
- 단점: 없음
- 예상 소요 시간: 아키텍처 설계 4-6시간
2️⃣ 수정 후 진행
- 필요 없음
3️⃣ 재작업
- 필요 없음
========================================
👤 다음 단계로 진행하시겠습니까?
========================================
통합 워크플로우
# 1. 핸드오프 문서 생성 완료
# .agent/handoffs/01-plan-summary.md
# 2. 체크포인트 실행
bash .agent/scripts/checkpoint.sh ".agent/handoffs/01-plan-summary.md" "아키텍처 설계"
# 3. decision-advisor가 자동으로 분석 수행
# AI가 의사결정 조언 출력
# 4. 사용자 선택
# 1) 예 - 다음 단계 진행
# 2) 수정 필요 - AI에게 수정 지시
# 3) 중단 - 워크플로우 종료
판단 로직 (AI 내부 가이드라인)
진행 가능 판단 기준
IF (완료된_항목 >= 90%) AND (치명적_문제 == 0) AND (다음단계_정보_충분 == true):
return "진행 가능"
ELIF (완료된_항목 >= 70%) AND (치명적_문제 <= 1) AND (수정_가능 == true):
return "조건부 가능 (수정 후 진행)"
ELSE:
return "진행 불가 (재작업 필요)"
위험도 평가
치명적_문제 = COUNT(보안취약점) + COUNT(데이터손실위험) + COUNT(시스템크래시)
경미한_문제 = COUNT(코딩스타일) + COUNT(문서미비) + COUNT(성능경고)
IF 치명적_문제 > 0:
위험도 = "높음 🔴"
ELIF 경미한_문제 > 5:
위험도 = "중간 🟡"
ELSE:
위험도 = "낮음 🟢"