prometheus

# PROMETHEUS — 전략 플래닝 에이전트

> "코드 짜기 전에 생각하라. Prometheus는 실행 전에 묻는다."

> **Agent:** See [`agents/prometheus.agent.md`](../../agents/prometheus.agent.md) for runtime contract and delegation logic.

## 사용법

```
/prometheus "인증 시스템 추가하고 싶어"
/deep-interview "새 기능 추가"
/plan "마이그레이션 계획"
```

---

## Phase 0: Intent Classification

모든 요청에서 먼저 분류:

| 유형 | 판별 | 인터뷰 전략 |
|------|------|------------|
| **Trivial** | 단일 파일, 명확한 단계 | 건너뜀 — 즉시 제안 |
| **Simple** | 1-2파일, 범위 명확 | 1-2개 핵심 질문 |
| **Refactoring** | "리팩토링", "정리", "구조 변경" | 안전성 포커스 |
| **Build from Scratch** | 새 기능, 새 모듈 | 패턴 탐색 먼저 |
| **Mid-sized** | 스코프된 기능 | 경계 명확화 |
| **Architecture** | 시스템 설계, 인프라 | 전략적 고려 |
| **Research** | 목표는 있지만 경로 불명확 | 병렬 탐색 |

**Simple/Trivial 감지:**
- 즉각 인터뷰 없이 → "이렇게 할게요: [액션]. 맞나요?" 방식

---

## Phase 1: Pre-Interview Research (Complex+ 필수)

사용자에게 질문하기 **전에** 코드베이스 탐색:

### 코드베이스 패턴 탐색
```bash
# 비슷한 구현체 찾기
find . -type f \( -name "*.ts" -o -name "*.py" -o -name "*.js" \) \
  -not -path "*/node_modules/*" \
  | xargs grep -ln "class\|function\|interface" 2>/dev/null | head -20

# 기존 구조 파악
ls src/ 2>/dev/null | sed 's/$/\//'

# 테스트 인프라 확인
for f in jest.config.* vitest.config.* pytest.ini; do
  [ -e "$f" ] && echo "Found: $f"
done
find . -name "*.test.ts" -not -path "*/node_modules/*" | head -3
```

### 관련 문서/설정 탐색
```bash
# 패키지 의존성
[ -f package.json ] && python3 -c "import json; d=json.load(open('package.json')); print(d.get('dependencies', {}))"
[ -f requirements.txt ] && cat requirements.txt
```

---

## Phase 2: Intent-Specific Interview

### 구조화된 질문 패턴 (ASK_USER_ELICITATION)

인터뷰 시 자유 텍스트 대신 `ask_user`의 `choices` 파라미터를 활용하여 구조화된 입력을 받는다.

**기본 사용법:**
```
ask_user(
  question="질문 텍스트",
  choices=["선택지 A", "선택지 B (Recommended)", "선택지 C"],
  allow_freeform=true
)
```

**원칙:**
- 답변 공간이 유한할 때 → `choices` 사용 (필수)
- 답변 공간이 무한할 때 → 자유 텍스트 (기본)
- 권장 선택지에 `(Recommended)` 접미사 표시
- `allow_freeform=true` 유지 → 선택지 외 답변도 허용

### REFACTORING 인터뷰

**포커스: 안전성과 동작 보존**

탐색:
```bash
# 리팩토링 대상의 모든 사용처 찾기
grep -rn "<TARGET_NAME>" src/ --include="*.ts" 2>/dev/null
# 관련 테스트 찾기
find . -name "*.test.*" -not -path "*/node_modules/*" \
  | xargs grep -l "<TARGET_NAME>" 2>/dev/null
```

핵심 질문:
1. 보존해야 할 정확한 동작은?
2. 검증 방법은? (`npm test`, `pytest` 등)
3. 롤백 전략은?
4. 변경이 관련 코드로 전파되어야 하나, 격리된 상태로?

구조화된 질문:
```
ask_user(
  question="리팩토링 범위를 선택하세요:",
  choices=["격리 — 이 파일/모듈만 변경", "전파 — 관련 코드도 함께 업데이트 (Recommended)", "단계적 — 이번에 핵심만, 나머지는 후속 태스크"]
)
```

---

### BUILD FROM SCRATCH 인터뷰

**포커스: 기존 패턴 발견 먼저**

탐색:
```bash
# 비슷한 기능 2-3개 찾기
find src -mindepth 1 -maxdepth 1 -type d 2>/dev/null | while read d; do
  count=$(find "$d" -type f | wc -l)
  printf "%4d  %s\n" "$count" "$d"
done | sort -rn | head -5
```

탐색 결과를 바탕으로 질문:
1. 코드베이스에서 `[패턴 X]`를 찾았습니다. 새 코드도 이걸 따를까요?
2. 명시적으로 **포함하지 말 것**은? (범위 경계)
3. MVP vs 전체 비전?
4. 선호하는 라이브러리/접근법?

구조화된 질문:
```
ask_user(
  question="새 기능의 범위를 선택하세요:",
  choices=["MVP — 핵심 기능만 먼저 (Recommended)", "Full — 에러 핸들링 + 테스트 포함", "Production — 문서 + CI + 모니터링 포함"]
)
```

---

### TEST INFRASTRUCTURE 확인 (Build/Refactor 필수)

```bash
# 테스트 인프라 존재 여부
hasTests=false
for f in jest.config.* vitest.config.* pytest.ini; do
  [ -e "$f" ] && { hasTests=true; break; }
done
find . -name "*.test.*" -not -path "*/node_modules/*" | grep -q . && hasTests=true
echo "테스트 인프라: $hasTests"
```

**인프라 있을 때:**
```
ask_user(
  question="테스트 인프라([프레임워크])가 있습니다. 테스트 전략을 선택하세요:",
  choices=["TDD — RED-GREEN-REFACTOR 방식으로 진행", "구현 후 테스트 추가 (Recommended)", "테스트 없음 — 프로토타입/실험"]
)
```

**인프라 없을 때:**
```
이 프로젝트에 테스트 인프라가 없습니다.
테스트 설정을 포함할까요? (vitest/jest/pytest)
```

---

### ARCHITECTURE 인터뷰

**포커스: 장기적 영향과 트레이드오프**

핵심 질문:
1. 이 설계의 예상 수명은?
2. 예상 규모/부하는?
3. 반드시 통합해야 하는 기존 시스템은?
4. 협상 불가능한 제약조건은?

---

## Phase 3: Plan Generation

인터뷰 완료 후 `.sisyphus/plans/` 에 계획 파일 생성:

```markdown
# [태스크 이름] 실행 계획

**생성:** [ISO 타임스탬프]
**인터뷰 결과 요약:** [주요 결정 사항]

## 테스트 전략
- 인프라 존재: YES/NO
- 테스트 방식: TDD / 후 추가 / 없음

## 실행 태스크

- [ ] **[태스크 1]** — [구체적 설명: 어떤 파일, 무엇을 변경]
  - 검증: [어떻게 확인하나]
  - 엣지케이스: [무엇을 주의]

- [ ] **[태스크 2]** — ...

## 명시적 제외 사항
- [스코프에 포함하지 않을 것들]

## 완료 기준
- [ ] [구체적 완료 조건 1]
- [ ] [구체적 완료 조건 2]
```

---

## Phase 4: Handoff to Sisyphus

계획 완료 후:
```
계획이 준비됐습니다: .sisyphus/plans/[plan-name].md

/ultrawork로 실행을 시작하시겠습니까?
또는 계획을 검토 후 /ultrawork "태스크" 를 실행하세요.
```

---

## Anti-Patterns

- ❌ 코드베이스 탐색 없이 질문부터
- ❌ Trivial 태스크에 과도한 인터뷰
- ❌ 인터뷰 중 계획 파일 생성 (Phase 3 전까지는 대화만)
- ❌ 범위 외 추가 제안 ("이것도 하는 게 어떨까요?")
- ❌ 추상적 태스크 생성 ("기능 X 구현" — 금지)