padvisor (단일 에이전트 외부 의견)

padvisor (단일 에이전트 외부 의견)은(는) 무엇을 하나요?

개요

상황을 읽고 판단을 내려 답변하는 하나의 에이전트를 생성합니다. 에이전트는 작업을 수행하지 않으며, 사용자가 작업을 계속 진행합니다. 결정이 근접했을 때, 접근 방식이 이상하게 느껴질 때, 또는 계획을 실행하기 전에 새로운 시각이 필요할 때 사용하세요.

pspawn이나 phandoff가 아닙니다. 이 두 명령은 작업 자체를 넘깁니다. padvisor는 질문만 넘기고 사용자가 직접 행동할 의견을 가져옵니다.

생성된 에이전트가 할 수 있는 일. 팀 기본 설정(bypassPermissions for Claude, full-access for Codex)으로 권한 프롬프트 없이 실행되지만, 모드가 아닌 지시에 의해 읽기 전용으로 작동합니다. 브리핑의 no-edits 접미사가 파일 변경을 방지합니다. 더 많은 권한이 필요한 팀은 저장소의 AGENTS.md에 요청하거나, bypassPermissions에서도 여전히 적용되는 Claude Code permissions.deny 규칙으로 차단할 수 있습니다.

호출

/padvisor [provider/model] [--skill /<name>] <question> — 모델은 선택 사항입니다.

기본 제공자: 사용자와 다른 모델 패밀리. Claude 사용자라면 Codex의 최신 모델(paseo provider models codex의 첫 번째 id), Codex 사용자라면 paseo provider models claude가 나열하는 최신 Opus(예: claude/claude-opus-5-5, 1M 모델의 일반 id)를 사용합니다. 대비가 핵심입니다. 동일한 모델 패밀리의 조언자는 당신이 이미 틀렸던 같은 이유로 당신과 동의할 것입니다. 사용자가 모델을 지정할 때만 덮어씁니다. id는 기억이 아닌 목록에서 읽으세요.

단계

1. 이 세션의 자식으로 생성합니다. 제공자 가용성을 먼저 확인하며, pspawn의 1단계(<이 스킬의 기본 디렉토리>/../pspawn/SKILL.md)와 정확히 동일합니다. 그 후:

paseo run --no-wait --json \
  --provider '<provider/model>' \
  --thinking xhigh \
  --mode <codex의 경우 full-access, claude의 경우 bypassPermissions> \
  --title "[Advisor] <topic>" \
  "$(cat <<'BRIEF'
<브리핑, 2단계>
BRIEF
)"

paseo에서 조언자는 이 세션의 자식으로 이 세션의 워크스페이스에 자동으로 배치되며, 분리하지 마십시오. 조언자는 질문에 속합니다. 이 세션이 보관될 때 paseo는 조언자도 함께 보관하며, 이것이 올바른 동작입니다. paseo 외부에서는 --workspace <id>를 추가하고 pspawn의 2단계와 같이 조회하세요.

모드: claude → bypassPermissions, codex → full-access. 모든 생성 시 팀 기본값입니다. 기본 모드에서는 조언자가 응답하지 않는 프롬프트에서 멈춥니다. no-edits 접미사가 모드가 아닌 파일 변경을 방지합니다. provider/model을 작은따옴표로 감싸세요.

2. 브리핑을 작성합니다. 조언자는 컨텍스트가 전혀 없으며 이 대화를 볼 수 없습니다.

[사용자 대화의 언어를 지시문으로: "<해당 언어>로 답변하세요."]

## 질문
[날카로운 질문 하나. "어떻게 생각하나요"가 아니라 "X와 Y 중 어느 쪽이 올바른 결정이고 그 이유는 무엇인가요"]

## 상황
[무엇을 빌드하거나 결정 중인지, 세 문장으로]

## 내가 고려한 것
- [옵션] — [왜 매력적인지, 무엇이 우려되는지]
- [내가 배제한 옵션] — [그 근거]

## 살펴볼 곳
- `/절대/경로/파일.ts` — [무엇이고 왜 중요한지]

## 내가 원하는 것
추론이 포함된 권장 사항. 자신의 권장 사항에 반대하는 가장 강력한 논거를 제시하세요.
질문의 프레이밍이 잘못되었다면 먼저 말해주세요.

이것은 분석 전용입니다. 파일을 편집, 생성 또는 삭제하지 마세요. 코드를 작성하지 마세요.

파일을 절대 경로로 가리키고 내용을 붙여넣지 마세요. 에이전트가 직접 읽을 수 있습니다. 내용을 붙여넣으면 컨텍스트를 소모하고 오래된 정보가 됩니다.

"가장 강력한 반대 논거" 줄은 장식이 아닙니다. 이것 없이 새로운 에이전트는 확신에 찬 편향된 답변을 일관되게 생성하며, 이것이 이 스킬이 방지하려는 실패 모드입니다.

3. 대기 — paseo-notify를 설정한 후 턴을 종료합니다.

paseo-notify <advisor-id>

즉시 반환됩니다. 조언자가 중단되면 이 세션에 하나의 메시지가 도착합니다: finished its turn → 답변 완료(메시지에 마지막 활동 줄이 포함됨), is waiting for a permission → 사용자의 허가 요청 대기 중, stopped with an error → 오류를 알리고 로그를 읽습니다. 자동으로 다시 생성하지 마세요. 사용량 제한은 사용자를 깨우지 않습니다: paseo-limit-watch가 조언자를 재개하고 감시를 다시 설정합니다(README 참조). 이것이 없으면 재설정 후 직접 조언자를 확인하세요. 폴링, sleep 루프, Monitor 사용 금지. 다른 작업을 먼저 완료한 후 턴을 종료하세요.

paseo 외부($PASEO_AGENT_ID 없음)에서는 paseo wait <advisor-id> --json을 run_in_background: true와 함께 실행하세요. 포그라운드 Bash 호출은 10분 제한이 있으며, 높은 사고 모드의 조언자는 일반적으로 15~30분 실행됩니다. JSON에서 status를 읽고 종료 코드는 무시하세요.

permission 발생 시 (bypass 및 full-access에서는 드물지만 rm -rf는 여전히 물어봄) 방치된 조언자는 조용히 멈춥니다. 요청을 읽고(paseo permit ls), 해당 요청이 에이전트에 부여한 권한 내에 있는지 판단한 후 paseo permit allow <agent-id> <request-id> 또는 deny를 실행하고(두 id 모두 paseo permit ls에서 확인), paseo-notify를 다시 설정하세요. 권한 범위를 벗어나거나 확실하지 않은 경우 사용자를 대신하여 승인하지 말고 사용자에게 문의하세요.

4. 답변을 읽습니다.

paseo logs <advisor-id> --filter text --tail 3

pagent.py <id> -t -n 3 --full (<이 스킬의 기본 디렉토리>/../pagent/)은 타임스탬프가 포함된 더 풍부한 보기를 제공하며 Claude, Codex 및 Antigravity 트랜스크립트를 모두 읽을 수 있습니다. 또한 paseo logs와 달리 닫힌 에이전트를 읽기 위해 다시 로드하지 않습니다.

5. 사용자를 위해 종합합니다. 조언자의 판결과 사용자 자신의 해석을 명확히 구분하여 제시합니다. 단순한 중계자가 아닙니다: 조언자가 틀렸다면 그렇게 말하고 이유를 설명하세요. 조언자가 사용자가 놓친 것을 발견했다면 역시 명확히 말하세요.

6. 보관합니다 — paseo archive <advisor-id> — 사용자가 유지하기를 원하지 않는 한(아래 참조).

지속적 조언자

사용자가 지속적인 의견을 원하는 경우("다음 결정을 위해 유지"), 6단계를 건너뛰고 새 에이전트를 생성하는 대신 동일한 에이전트에 후속 질문을 보내세요:

paseo send <advisor-id> "<후속 질문>" --behavior steer --no-wait

그런 다음 이전과 같이 대기(3단계)하고 읽습니다(4단계). 제공자가 steering을 수용할 수 없으면 중단(interruption)으로 대체될 수 있습니다. --no-wait가 중요합니다: 이 옵션이 없으면 CLI가 완료를 기다립니다. paseo send는 보관된 에이전트를 복원하므로 먼저 paseo inspect <id> --json에서 ArchivedAt을 확인하고, 보관된 조언자를 복원하는 대신 사용자에게 알리세요.

컨텍스트가 유지되는 것이 핵심입니다. 사용자가 완료되었다고 말하거나, 주제가 크게 전환되어 오래된 컨텍스트가 연속성의 이점보다 해가 될 때 보관하세요.

전달된 스킬

사용자가 스킬 참조를 전달하는 경우(/padvisor /code-review 이거 과도한 엔지니어링인가요?), 사용자가 아닌 조언자가 해당 스킬을 실행합니다. 해당 스킬을 가진 조언자를 선택하세요: Claude Code에만 존재하는 스킬(예: /code-review)은 claude 조언자가 필요합니다. 브리핑에 다음을 추가하세요:

다른 작업을 수행하기 전에 `<name>` 스킬을 사용하고(Claude Code: Skill 도구; Codex: SKILL.md 읽기), 이 작업에 적용하세요.

스킬 이름 뒤의 모든 내용을 해당 스킬의 입력으로 전달하세요.

일반적인 실수

실수	해결 방법
기본적으로 자신의 모델 패밀리에서 조언자 선택	Codex의 최신 모델을 사용하세요. 동의하는 조언자는 낭비입니다.
paseo wait의 종료 코드 신뢰	idle, permission, error 모두 0을 반환합니다. --json에서 status를 읽으세요.
포그라운드 대기	run_in_background: true; 10분 Bash 제한이 대기(에이전트가 아님)를 중단시킵니다.
완료 확인을 위해 paseo ls, sleep 또는 Monitor 폴링	paseo-notify <id>를 설정하고 턴을 종료하세요. 하나의 메시지가 사용자를 깨웁니다.
후속 질문에 일반 paseo send 사용	완료될 때까지 차단됩니다. --no-wait를 사용하고 3단계와 같이 대기하세요.
조언자 분리 또는 env -u PASEO_AGENT_ID	의도적으로 이 세션의 자식입니다. 세션이 보관될 때 함께 사라집니다.
no-edits 접미사 누락	이 접미사가 없으면 조언자가 평가 대상인 작업을 구현하기 시작합니다.
브리핑에 파일 내용 붙여넣기	절대 경로를 사용하세요. 에이전트가 직접 읽습니다.
답변 언어 미지정	조언자는 프롬프트의 언어로 답변합니다. 사용자의 언어로 시작하세요.
판결을 사실인 양 중계	컨텍스트가 없는 하나의 의견일 뿐입니다. 동의하지 않는 부분을 말하세요.
Codex를 기본 모드로, claude를 auto로 유지	codex → full-access, claude → bypassPermissions (팀 기본값); no-edits 접미사가 읽기 전용 유지.
실제 작업을 넘기는 경우	그 경우 pspawn(개방형 작업) 또는 phandoff(확정된 스펙 + 계획)를 사용하세요.