ulp

Ultra Planning (ULP)

6단계 비판 기반 누적 루프. Stop 훅이 자동으로 루프를 강제합니다.

핵심 원칙

1. 실제 문제만 - 비판을 위한 비판 금지, 실패를 유발하는 문제만 다룸
2. 검증 기반 비판 - "이거 안 풀면 뭐가 실패하는가?"가 핵심 질문
3. 결과는 누적 - 이전 루프 결과를 유지하면서 개선

루프 구조

Phase 1: Problem Discovery (Loop 1-4)

Loop	목표	출력
1	Explore + WebSearch로 탐색	Problems v1
2	v1 검증 (실제 문제인가?)	Problems v2
3	v2 검증 (원인인가 증상인가?)	Problems v3
4	v3 최종 검토 + 분류	Final Problems

Phase 2: Planning (Loop 5-6)

Loop	목표	출력
5	Final Problems 기반 플랜 초안	Plan v1
6	Plan v1 검증 + 최종안	Conclave Note

동작 방식

1. /ulp <task> 호출 시 UserPromptSubmit 훅이 상태 파일 생성
2. 각 루프 완료 후 Stop 훅이 decision: block 반환
3. 다음 루프 지시가 reason으로 전달됨
4. Loop 6 완료 후 정상 종료

---

Loop 1: Discovery

Step 1: 요청 유형 파악

• Bug fix / Problem solving
• Refactoring
• New feature implementation
• Design / Architecture decision
• Exploration / Learning
• Mixed (primary 선택, secondary 메모)

Step 2: 유형별 문제 프레이밍

Type	문제의 의미
Bug/Problem	현재 뭐가 잘못 동작하는가, 재현 조건, 근본 원인
Refactoring	기술 부채, 유지보수 어려움, 확장성 제약
New Feature	사용자 페인포인트 + 구현 장애물 + 시스템 충돌
Design/Architecture	각 선택지의 단점, 리스크, 트레이드오프
Exploration	모르는 것, 조사가 필요한 것, 지식 갭

Step 3: 탐색 & 출력

• Task(Explore) 서브에이전트로 코드베이스 분석
• WebSearch로 베스트 프랙티스, 유사 사례 검색
• ## Problems v1 출력

---

Loop 2-4: 검증 기반 비판

각 문제에 대해 3가지 검증 질문 적용:

검증 체크리스트

질문	No일 때 조치
1. 이거 안 풀면 뭐가 실패하는가?	답 없으면 → 삭제 (실제 문제 아님)
2. 이거 풀면 원래 목표에 도달하는가?	No면 → 삭제 (범위 벗어남)
3. 이건 원인인가 증상인가?	증상이면 → 원인으로 교체

각 루프 초점

• Loop 2: 질문 1 집중 - 실패를 유발하지 않는 문제 제거
• Loop 3: 질문 3 집중 - 증상 → 원인 변환
• Loop 4: 최종 정리 - 중복 제거, 우선순위 정렬

변경 없음 허용

실질적 개선점이 없으면:

## Problems vN
(v{N-1}과 동일 - 검증 결과 모든 문제가 유효함)

형식적 비판 금지. 억지로 문제 만들지 말 것.

---

Loop 5: Plan Draft

Final Problems 각각에 대해:

• 해결 방안
• 구현 위치 (파일/모듈)
• 파일별 구체적 변경 사항 (추가/수정/삭제할 것)
• 실행 순서 및 의존성
• 검증 방법 (각 변경이 동작하는지 확인하는 방법)

## Plan v1으로 출력

---

Loop 6: Finalize

검증 질문:

1. 이 플랜대로 하면 Final Problems가 전부 해결되는가?
2. 더 단순한 방법은 없는가?
3. 누가 봐도 질문 없이 구현 가능한가?

플랜 형식: 청사진만. 코드/설정/문서 내용 포함 금지.

• ✅ 무엇을, 어디서, 왜, 어떤 순서로

Conclave Note 저장 (아래 별도 섹션 참조)

---

Conclave Note 저장 방법

Loop 6 완료 후:

1. search_nodes로 관련 Goal/Task 검색
2. 연결 결정:
   • parent: 가장 관련성 높은 Goal (없으면 생략)
   • reference: 관련 Task/Note
3. create_note 호출 (parentNodeId, referenceNodeIds 포함)

---

사용 예시

/ulp 사용자 인증 시스템 리팩토링
/ulp MCP 서버에 새 도구 추가
/ulp 성능 최적화 전략