# 작업 레벨 시스템 (Work Level System)

> 제이회장님 지시 (2026-03-05): 인포키워드 경험 기반. "더 디테일한 계획서 필요. 실행단까지 고민 필요."

## 핵심 원칙
**"어떻게 확인하지?"까지 답이 나온 후에 코딩 진입.**
- BAD: "네이버플레이스 있는지 확인 필요" → 바로 코딩
- GOOD: "네이버플레이스 확인 → HTML에서 `.se-placesMap` 클래스 탐색 + `data-linkdata`에서 `placeId` 키 존재 여부 체크" → 코딩

---

## 레벨 정의

### Lv.0 — 마이크로 수정 (Micro Fix)
**기준**: 상수/경로/설정값 1~2줄 변경. 로직 변경 없음. 판단 불필요.
**예시**: 상대경로→절대경로, 상수값 변경, 오타 수정, 설정 파일 1줄 수정
**프로세스**:
1. 아누가 수정 내용을 확정 (파일·라인·before/after)
2. **Task tool (model=haiku)로 직접 실행** — dispatch.py 불필요
3. 팀장(Opus) 개입 없음. 전체 QC 파이프라인 스킵. 단, 경량 QC 수행 (아래 참조).
3.5. **경량 QC (Lightweight QC)**: 수정 파일 이외에 영향받는 파일이 있는지 1줄 확인. "이 변경이 다른 파일에 영향을 미치는가?" — Yes면 Lv.1로 재분류.
4. task-timer 기록은 유지 (anu-direct)
**계획 깊이**: 파일명 + 라인 + 변경값만 명시
**토큰 절감**: Opus 팀장 세션 비용 0, Haiku만 사용

### Lv.1 — 단순 수정 (Simple Fix)
**기준**: 수정 위치와 방법이 명확. 파일 1~3개, 로직 변경 없음.
**예시**: 포트 번호 변경, 오타 수정, 색상/크기 조정, 환경변수 추가
**프로세스**:
1. 아누가 수정 대상 파일·라인 특정
2. 즉시 위임 (지시서에 정확한 변경 내용 명시)
3. 에이전트 미팅 불필요
**계획 깊이**: 파일명 + 라인번호 + before/after 명시

### Lv.2 — 기능 구현 (Feature Implementation)
**기준**: 기존 구조 안에서 기능 추가/개선. 설계 판단 필요하지만 아키텍처 변경 없음.
**예시**: 드래그앤드롭 추가, 모달 크기 조절, 셀렉터 수정, 새 API 엔드포인트
**프로세스**:
1. 아누가 현재 코드 구조 파악 (관련 파일 읽기)
2. **구현 방안 설계**: "무엇을" + "어떻게" + "어디서" 수준까지
   - 어떤 파일의 어떤 함수를 수정하는지
   - 어떤 라이브러리/API/셀렉터를 사용하는지
   - 엣지케이스 사전 식별
3. 배치안 보고 → 승인 후 위임
4. 에이전트 미팅: 선택적 (아누 판단 또는 제이회장님 지시)
**계획 깊이**: 파일별 변경 사항 + 구현 방식(함수/클래스/셀렉터) + 엣지케이스

### Lv.3 — 복합 기능 (Complex Feature)
**기준**: 여러 모듈에 걸쳐 변경. 설계 선택지가 여러 개. 잘못 고르면 되돌리기 어려움.
**예시**: 블로그 홍보성 판별 파이프라인, OAuth 인증 플로우, 대시보드 전체 개편
**프로세스**:
1. 아누가 관련 코드 + 외부 환경 조사 (API 문서, HTML 구조 등)
2. **에이전트 미팅 필수**: 관련 전문가 소집, 구현 방안 논의
   - "무엇을" + "어떻게" + "왜 이 방식인지" + "대안은?"
   - 각 구현 방안의 트레이드오프 비교
3. **Devil's Advocate 필수**: 매 사이클마다 1명 지정, 반대 입장에서 검증
   - 3대 질문: 실패 시나리오 / 후회 이유 / 더 단순한 대안
   - 반박이 나와야 합의 성립
4. 미팅 합의 기반 상세 지시서 작성
   - **실행 수준 디테일 필수**: 셀렉터, API 엔드포인트, 데이터 구조, 에러 처리 방식
5. 배치안 보고 → 승인 후 위임
**계획 깊이**: 구현 설계서 수준 (함수 시그니처, 데이터 플로우, 외부 의존성, 검증 방법)

### Lv.4 — 대규모 프로젝트 (Major Project)
**기준**: 새 서비스/시스템 구축. 다수 모듈, 여러 Phase에 걸친 작업.
**예시**: InsuWiki 신규 구축, ThreadAuto 전체 개발, 나만의자산관리 서비스
**프로세스**:
1. 3문서 시스템 적용 (계획서 + 맥락노트 + 체크리스트)
2. **에이전트 미팅 무한 반복**: 모든 에이전트 만장일치할 때까지
   - Phase별로 쪼갠 후 각 Phase마다 구현 수준 설계
   - 모든 "어떻게?"에 답이 나올 때까지 미팅 반복
   - 한 명이라도 이의 제기하면 재논의
3. **Devil's Advocate 필수**: 매 사이클마다 순환 지정, 만장일치 전 반드시 통과
4. 만장일치 후 3문서 확정 → 핵미사일 발사코드 (제이회장님 승인)
5. Phase별 순차 위임 (Phase 분리 원칙 적용)
**계획 깊이**: 전체 아키텍처 + Phase별 상세 구현 설계 + 모듈 간 인터페이스 정의

---

## ★ 리서치-구현 분리 원칙 (2026-03-27 추가)

**리서치와 구현은 반드시 별도 Phase로 분리한다.** 한 세션에 몰아넣으면 리서치 블랙홀 위험.
- 상세: `memory/specs/research-impl-separation.md`
- Lv.2 이상에서 리서치가 필요한 작업은 **Phase 1: 리서치(task_type=research) → Phase 2: 구현** 순서
- 사고 사례: task-1106.1 — 리서치+구현 혼합 → 1시간 13분 산출물 0건 → 강제종료

---

## brainstorming 사전 실행 (Lv.3-4 기능 변경 시)

Lv.3-4 작업 중 기능 변경(신규 기능, UX 변경)이 포함된 경우:
1. 위임 전에 반드시 `/brainstorming` 스킬을 실행하여 UX 사전 설계를 완료
2. 설계 결과를 제이회장님께 보고하고 승인 후 위임
3. brainstorming 결과물을 위임 지시서에 첨부

> 참조: /brainstorming 스킬 — 구조화 브레인스토밍 + Visual Companion 와이어프레임

---

## 레벨 판정 기준

아누는 작업 접수 시 아래 질문으로 레벨을 판정한다:

1. **상수/경로/설정 1~2줄 변경인가?** → Yes: Lv.0 (Haiku 직접 실행)
2. **수정 위치가 명확한가?** → Yes: Lv.1 검토
2. **아키텍처 변경이 있는가?** → No: Lv.2 검토, Yes: Lv.3 이상
3. **여러 모듈에 걸치는가?** → Yes: Lv.3 검토
4. **새 서비스/시스템인가?** → Yes: Lv.4
5. **제이회장님이 레벨을 지정한 경우** → 그대로 따름

---

## "어떻게?" 체크 (Lv.2 이상 필수)

위임 전 아누가 반드시 검증하는 체크리스트:

- [ ] **탐지/감지 방법**: 어떤 셀렉터/API/패턴으로 감지하는가?
- [ ] **데이터 흐름**: 입력 → 처리 → 출력 경로가 명확한가?
- [ ] **외부 의존성**: 외부 API/HTML 구조가 변경되면 어디가 깨지는가?
- [ ] **엣지케이스**: 빈 값, 대용량, 형식 오류 시 어떻게 처리하는가?
- [ ] **검증 방법**: 구현 후 어떻게 동작을 확인하는가?

이 중 하나라도 "모르겠다"이면 → 리서치 먼저 (코드 읽기, 외부 조사, 미팅 소집)

---

## 실패 사례 (인포키워드 교훈)

| 상황 | 문제 | 원인 | 올바른 접근 |
|------|------|------|-----------|
| 네이버플레이스 감지 | `.se-placesMap` 못 찾음 | "플레이스 감지"만 지시, HTML 구조 미조사 | Lv.3: 실제 블로그 HTML 분석 → 셀렉터 특정 후 위임 |
| 블로그 검색 0건 | 네이버 HTML 변경 | 셀렉터 하드코딩, 변경 감지 없음 | Lv.2: 네이버 현재 HTML 먼저 확인 → 셀렉터 목록 작성 |
| CCL 오탐 | creativecommons.org 링크 | 네이버 템플릿 자동삽입 미파악 | Lv.2: 실제 블로그 외부링크 전수조사 후 제외 목록 |

---

**버전**: v2.1
**작성일**: 2026-03-26 (Lv.0 경량 QC 추가)
**이전**: v1.0 (2026-03-05)
**지시자**: 제이회장님
**작성자**: 아누 (개발실장)