PWRL Plan — 순수 스킬 오케스트레이터

실행 가능한 구현 계획을 생성하여 전달할 수 있도록 설계된 내구성 있는 계획 도구입니다. 범위 → 리서치 → 설계 → 생성의 결정론적 파이프라인을 오케스트레이션합니다. 에이전트 의존성 없음, 대체 경로 없음.

목적

계획은 실행 전에 결정, 구조, 접근 방식을 포착합니다. 이를 통해 다음이 가능합니다:

명확한 범위와 성공 기준
식별된 위험 및 종속성
구체적인 구현 단위와 수용 기준
관련 학습 내용을 통한 지식 재사용
작업이 이탈하지 않는다는 확신

핵심 워크플로우: 4단계 파이프라인

입력 (작업 설명)
  ↓
1단계: 범위 (pwrl-plan-scope)
  → 컨텍스트 수집, 도메인 검증, 요구 사항 부트스트래핑
  → 출력: 범위가 설정된 컨텍스트 산출물
  ↓
2단계: 리서치 (pwrl-plan-research)
  → 패턴 발견, 위험 식별, 외부 리서치 권장
  → 출력: 리서치 결과 산출물
  ↓
3단계: 설계 (pwrl-plan-design)
  → 단위로 분해, 종속성 매핑, 복잡도 평가
  → 출력: 단위 분해 설계 산출물
  ↓
4단계: 생성 (pwrl-plan-generate)
  → 티어 선택, 계획 렌더링, 학습 내용 포함, docs/plans/에 저장
  → 출력: 파일로 저장된 최종 계획 문서
  ↓
출력 (실행 준비 완료된 계획 파일)

단계별 상세 설명

1단계: 범위 (pwrl-plan-scope)

목적: 계획 워크플로우의 진입점입니다. 컨텍스트를 수집하고, 기존 계획 및 학습 내용을 확인하며, 도메인을 검증하고, 범위가 설정된 컨텍스트 객체를 반환합니다.

마이크로 스킬: pwrl-plan-scope

입력:

사용자가 작업 설명, 요구 사항 문서 또는 목표를 제공합니다.
빈 입력은 사용자에게 "무엇을 계획하시겠습니까?"라고 묻습니다.

처리:

docs/plans/에서 기존 계획 확인; 재개/검토/보관/삭제/새로 만들기 제안
도메인 검증 (소프트웨어 vs. 비소프트웨어)
문제 프레임, 의도된 동작, 성공 기준 부트스트래핑
docs/learnings/INDEX.md에서 관련 학습 내용 검색
docs/requirements/ 및 docs/brainstorms/에서 일치하는 문서 검색
사용자와 컨텍스트 확인
상호 작용 모드 질문:
- 상세: 각 단계에서 단계별 상호 작용 (검토, 확인, 조정)
- Yolo: 1단계부터 4단계까지 완전 자동화, 최종 확인만
interaction_mode가 포함된 범위 산출물 생성

출력: 범위가 설정된 컨텍스트 산출물 (다음 포함):

문제 프레임, 의도된 동작, 성공 기준
관련 학습 내용 (HIGH-관련성)
식별된 학습 격차
발견된 요구 사항
interaction_mode (상세 또는 yolo)

참조: pwrl-plan-scope/SKILL.md — 상세 워크플로우

2단계: 리서치 (pwrl-plan-research)

목적: 로컬 패턴, 기술 스택 및 고위험 영역을 발견합니다. 필요한 경우 외부 리서치를 권장합니다.

마이크로 스킬: pwrl-plan-research

입력: 1단계의 범위가 설정된 컨텍스트 산출물

처리:

package.json, Dockerfile, 코드베이스 구조에서 기술 스택 탐지
로컬 패턴 발견 (아키텍처, 비동기 스타일, 테스팅, 조직)
고위험 영역 식별 (보안, 성능, 마이그레이션, 분산 시스템, 규정 준수)
고위험 영역에 대한 외부 리서치 권장 (선택 사항)
관련 학습 내용의 통찰 통합
리서치 결과 컴파일

출력: 리서치 산출물 (다음 포함):

기술 스택 탐지
식별된 로컬 패턴
권장 사항이 포함된 위험 영역
외부 리서치 결과 (수행된 경우)
학습 내용 통합 노트

참조: pwrl-plan-research/SKILL.md — 상세 워크플로우

3단계: 설계 (pwrl-plan-design)

목적: 작업을 구현 단위로 분해하고, 종속성과 위험을 식별하며, 복잡도를 평가합니다.

마이크로 스킬: pwrl-plan-design

입력: 범위 컨텍스트 + 리서치 결과

처리:

성공 기준 및 위험 영역에서 작업 단위 식별
단위 간 종속성 매핑 (위상 정렬)
순환 종속성 탐지; 리팩토링 프롬프트
위험 완화 단위 생성
복잡한 워크플로우(5개 이상 단위)에 대한 Mermaid 다이어그램 생성
복잡도 평가 (LOW/MEDIUM/HIGH)
노력 추정
사용자와 분해 내용 확인

출력: 설계 산출물 (다음 포함):

구현 단위 (U1, U2, ..., UX) — 테스트 시나리오 및 수용 기준 포함
종속성 그래프 및 위상 정렬 순서
위험 완화
Mermaid 다이어그램 (복잡한 경우)
복잡도 평가 및 노력 추정

참조: pwrl-plan-design/SKILL.md — 상세 워크플로우

4단계: 생성 (pwrl-plan-generate)

목적: 티어(Fast/Standard/Deep)를 선택하고, 티어 템플릿을 사용하여 계획을 렌더링하고, 학습 내용을 포함하며, docs/plans/에 저장합니다.

마이크로 스킬: pwrl-plan-generate

입력: 설계 산출물 (3단계) + 범위 산출물 (1단계)

처리:

복잡도/단위 수/노력에 따라 티어 자동 선택; 모호한 경우 프롬프트
- FAST: LOW 복잡도, 1-3개 단위, <5시간
- STANDARD: MEDIUM 복잡도, 4-8개 단위, 5-20시간
- DEEP: HIGH 복잡도, 9+개 단위, 20+시간
티어별 템플릿을 사용하여 계획 렌더링
범위에서 HIGH-관련성 학습 내용 상위 3-5개 포함
고유 파일명 생성: YYYY-MM-DD-NNN-<slug>.md
파일명 충돌 처리 (시퀀스 증가 또는 기존 파일 업데이트)
계획을 docs/plans/에 저장

출력: 파일로 저장된 계획 문서 (다음 포함):

문제 및 범위
성공 기준
구현 단위 (티어별 상세 수준)
위험 분석 (STANDARD/DEEP)
관련 학습 내용 (STANDARD/DEEP)
학습 격차 (DEEP)
롤아웃 노트 (STANDARD/DEEP)

참조: pwrl-plan-generate/SKILL.md — 상세 워크플로우

계획 티어

티어	최적 대상	파일 수	위험	시간
FAST	버그 수정, 소규모 조정	1-3	LOW	5-15분
STANDARD	대부분의 기능	4-8	MED	30-45분
DEEP	아키텍처, 보안, 마이그레이션	9+	HIGH	1-2시간

참조: references/planning-tiers.md — 전체 티어 결정 기준 및 템플릿 예시

핵심 원칙

결정론적 파이프라인: 단계는 항상 범위 → 리서치 → 설계 → 생성 순서로 실행됩니다 (분기 없음, 대체 경로 없음)
결정에 집중: 접근 방식, 구조, 위험 및 순서를 포착합니다 (코드 시뮬레이션이 아님)
적절한 크기: 작은 작업 → 짧은 계획; 복잡한 작업 → 더 많은 구조
계획과 실행 분리: 계획 중에 구현을 시뮬레이션하지 마십시오
구체적으로: 특정 파일, 구성 요소 및 종속성을 사용하십시오
이식성 유지: 저장소 상대 경로만 사용하십시오
투명한 산출물: 각 단계는 다음 단계를 위한 명시적인 출력 산출물을 생성합니다

오류 처리 및 복구

철학: 명시적으로 실패하고, 조용히 실패하지 마십시오. 각 단계는 복구 제안과 함께 명확한 오류 처리를 제공합니다.

1단계 (범위) 오류

빈 입력: 사용자에게 작업 설명을 요청하고 재시도
비소프트웨어 도메인: 오류 반환; 대체 도구 제안
모호한 입력: 명확한 질문을 하고 사용자 응답으로 부트스트래핑
학습 내용/요구 사항 없음: 계속 진행 (오류 아님)

복구: 사용자가 재시도, 설명 제공 또는 중단 가능

2단계 (리서치) 오류

코드베이스 분석 실패: 최소한의 기술 스택 정보로 계속 진행
고위험 영역 식별: 외부 리서치 권장; 사용자가 승인 또는 건너뛰기 가능

복구: 사용자가 리서치 승인, 건너뛰기 또는 수동 조사 가능

3단계 (설계) 오류

순환 종속성 탐지: 순환 경로 보고; 사용자에게 리팩토링 요청
너무 많은 단위 (15개 이상): 복잡성 경고; 통합 제안
세부 정보 부족: 테스트 시나리오 추가 또는 단위 분할 요청

복구: 사용자가 리팩토링, 통합 또는 인지한 상태로 진행 가능

4단계 (생성) 오류

파일명 충돌: 옵션 제공: 업데이트, 증분 또는 취소
티어 선택 모호: 사용자에게 티어 선택 요청
파일 쓰기 실패: 권한/디렉터리 확인; 재시도 또는 수동 저장 제안

복구: 사용자가 작업 선택 또는 수동 저장 가능

주요 출력

각 계획에는 다음이 포함됩니다 (티어에 따라 다름):

문제 및 범위: 명확한 문제 프레임 및 의도된 동작
성공 기준: 완료를 위한 1-3가지 구체적인 조건
구현 단위: 종속성, 파일, 접근 방식 및 수용 기준이 포함된 명명된 U-ID
관련 학습 내용: 적용 가능성 노트가 포함된 연결된 학습 파일 (STANDARD/DEEP)
학습 격차: 구현 후 문서화가 필요한 영역 (DEEP)
티어별 섹션: 위험 분석, 대안, 롤아웃 노트 (STANDARD/DEEP)

상호 작용 방법

모든 결정에 플랫폼의 ask_user_questions 확장 사용
한 번에 하나의 질문만 하기
가능한 경우 객관식 질문 사용
입력이 비어 있으면 "무엇을 계획하시겠습니까? 작업 또는 프로젝트를 설명해 주세요."라고 질문
오류 발생 시 명확한 복구 제안 제공

아키텍처: 에이전트 라우팅 없음

이전 버전과의 차이점:

이전: 스킬이 에이전트 가용성을 감지한 후, 에이전트에 위임하거나 모놀리식 대체 경로를 실행 (두 코드 경로)

이후: 스킬이 마이크로 스킬을 순서대로 직접 호출—단일 결정론적 파이프라인, 분기 없음:

pwrl-plan 오케스트레이터
├── 1. pwrl-plan-scope 호출 → 범위 산출물 획득
├── 2. pwrl-plan-research 호출 → 리서치 산출물 획득
├── 3. pwrl-plan-design 호출 → 설계 산출물 획득
└── 4. pwrl-plan-generate 호출 → 계획 파일 저장

이점:

✅ 이해하기 쉬움 (단일 코드 경로)
✅ 테스트 용이 (분기 로직 없음)
✅ 유지보수 용이 (마이크로 스킬을 독립적으로 테스트 가능)
✅ 더 조립 가능 (다른 워크플로우에서 마이크로 스킬 재사용 가능)
✅ 더 나은 오류 처리 (각 단계에서 명시적)

마이크로 스킬 참조

pwrl-plan-scope — 컨텍스트 및 범위 수집
pwrl-plan-research — 패턴 발견 및 위험 식별
pwrl-plan-design — 단위 분해 및 종속성 매핑
pwrl-plan-generate — 계획 렌더링 및 파일 생성

테스트 및 검증

포괄적인 테스트 커버리지:

pwrl-plan-scope에 대한 30개 이상의 테스트 (U1.1)
pwrl-plan-research에 대한 25개 이상의 테스트 (U1.2)
pwrl-plan-design에 대한 35개 이상의 테스트 (U1.3)
pwrl-plan-generate에 대한 30개 이상의 테스트 (U1.4)
전체 오케스트레이션 파이프라인에 대한 30개 이상의 통합 테스트

하위 호환성:

이전 버전과 동일한 입력/출력 동작
기존 계획이 성공적으로 생성됨
사용자에게 중대한 변경 사항 없음

자주 묻는 질문

Q: 단계가 실패하면 어떻게 되나요? 건너뛰거나 재시도할 수 있나요?

A: 네. 각 단계에는 복구 제안과 함께 명시적인 오류 처리가 있습니다. 재시도, 설명 제공, 범위 수정 또는 중단할 수 있습니다. 조용한 실패는 없습니다.

Q: 단일 마이크로 스킬만 사용할 수 있나요 (예: 설계에서 생성만)?

A: 오케스트레이터는 네 단계를 모두 순서대로 호출할 것으로 예상합니다. 단일 마이크로 스킬을 사용하려면 이름으로 직접 호출하세요: /pwrl-plan-scope, /pwrl-plan-design 등.

Q: 왜 에이전트 라우팅이 없나요?

A: 에이전트는 가치 없이 복잡성만 추가했습니다. 마이크로 스킬 파이프라인은 결정론적이고, 테스트 가능하며, 이해하기 쉽습니다. 직접 스킬 호출이 더 간단하고 유지보수하기 쉽습니다.

Q: 다른 워크플로우를 위해 확장할 수 있나요?

A: 네! 마이크로 스킬은 재사용 가능합니다. 예를 들어, pwrl-work는 단위 분해를 위해 pwrl-plan-design을 사용할 수 있습니다. docs/guides/micro-skill-patterns.md를 참조하세요.

상태: 순수 스킬 파이프라인 (에이전트 라우팅 없음) 버전: 2.0 (에이전트 의존 아키텍처에서 리팩토링됨) 생성일: 2026-06-11

wicttor/pwrl

pwrl란 무엇인가요?

즐겨 사용하는 AI에게 물어보기

문서

PWRL Plan — 순수 스킬 오케스트레이터

목적

핵심 워크플로우: 4단계 파이프라인

단계별 상세 설명

1단계: 범위 (pwrl-plan-scope)

2단계: 리서치 (pwrl-plan-research)

3단계: 설계 (pwrl-plan-design)

4단계: 생성 (pwrl-plan-generate)

계획 티어

핵심 원칙

오류 처리 및 복구

1단계 (범위) 오류

2단계 (리서치) 오류

3단계 (설계) 오류

4단계 (생성) 오류

주요 출력

상호 작용 방법

아키텍처: 에이전트 라우팅 없음

마이크로 스킬 참조

관련 문서

테스트 및 검증

자주 묻는 질문

관련 스킬

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me