/dev:unstuck — 막혔을 때 시각을 바꿔주는 "관점 전환 회의"#

같은 수정을 반복하다 막힌 작업을, 서로 다른 5명의 관점으로 다시 바라보게 해 주는 워크플로

한마디로#

작업이 같은 자리에서 계속 막혔을 때 — 같은 수정을 몇 번이나 시도했는데 똑같이 실패할 때 — 서로 다른 사고방식을 가진 5명의 "관점 전환가"를 불러 "다르게 보는 법" 을 받아오는 명령입니다. 막힌 문제 앞에서 친구 5명에게 "이거 어떻게 봐?"라고 물어보는 회의라고 생각하면 됩니다. 단, 답을 대신 정해주지는 않습니다 — 선택은 당신 몫입니다.

누가·언제 쓰나요#

• 같은 에러를 같은 방법으로 N번 고쳤는데도 계속 똑같이 실패할 때
• 두 수정 사이를 왔다 갔다(A 고치면 B 깨지고, B 고치면 A 깨지고) 하며 진동할 때
• "뭔가 사실 하나가 비어 있는데 그게 뭔지 모르겠다" 싶을 때
• 자동화 배치(/dev:batch)가 한 Story에서 같은 실패를 반복해 스스로 관점 전환을 호출할 때 (이때는 사람이 부르지 않아도 자동으로 호출됩니다)

👉 "더 열심히 다시 시도"가 아니라 "다른 각도로 다시 보기" 가 필요할 때 쓰는 도구입니다.

무엇을 해주나요#

5명의 관점(페르소나)으로 막힌 상황을 다시 바라봅니다. 각 페르소나는 한 가지 사고방식만 가집니다.

• HACKER — 같은 수리 그만하고, 막힌 지점을 떼어내 우회하라
• RESEARCHER — 노력이 아니라 사실 하나가 비어 있다, 가서 찾아와라
• SIMPLIFIER — 과하게 지어졌다, 더하지 말고 덜어내라
• ARCHITECT — 계속 왔다 갔다 한다, 구조가 틀렸으니 다시 짜라
• CONTRARIAN — (기본 폴백) 전제 자체를 의심하라

이 5명의 정의·질문은 한 곳(references/LATERAL_PERSONAS.md)에 모여 있어, 어디서 부르든 같은 페르소나가 같은 방식으로 동작합니다.

어떻게 쓰나요#

# 토론 모드 (기본) — 5명 전원이 각자 관점을 내고, 종합 정리
/dev:unstuck

# 솔로 모드 — 특정 페르소나 한 명만 불러 빠르게 관점 전환
/dev:unstuck solo hacker
/dev:unstuck solo architect

• 인자 없이 부르면 토론(debate) 모드 입니다 — 5명이 동시에 의견을 내고 마지막에 종합해 줍니다.
• solo <페르소나> 로 부르면 해당 페르소나 한 명만 빠르게 관점을 전환해 줍니다 (페르소나: hacker / researcher / simplifier / architect / contrarian).
• 어느 모드든 막힌 상황 정보(무엇을 하려 했나 / 무엇을 반복했나 / 무엇을 시도했고 어떻게 실패했나)를 함께 주면 더 정확합니다.

안에서 무슨 일이 벌어지나요#

1. 상황 정리 — "무엇을 하려는지(problem_context) / 어떤 방법을 반복했는지(current_approach) / 무엇을 시도했고 어떻게 실패했는지(failed_attempts)"를 모읍니다.
2. 관점 전환
   • 솔로 모드: 지정한 페르소나 정의를 읽고, 그 한 명의 시각으로 막힌 지점을 다시 진술합니다.
   • 토론 모드: 5명을 동시에(병렬) 불러 각자 reframing을 받아옵니다.
3. 종합 — 토론 모드는 5명의 의견을 선택지(Options) / 서로 엇갈린 지점(Disagreements) / 추천(Recommended) 으로 묶어 보여줍니다.
4. 멈춤 — 여기서 멈춥니다. 결론(verdict)은 자동으로 내지 않습니다 — 어떤 선택지를 택할지는 사람이 정합니다.

핵심: 이 명령은 선택지를 주는 것이지 결정을 내리는 것이 아닙니다.

끝나면 다음은?#

• 마음에 드는 선택지가 있으면 그 방향으로 직접 작업을 이어가면 됩니다.
• 그래도 안 풀리면 다른 페르소나로 한 번 더(solo) 돌리거나, 전제 자체가 의심되면 사고 복기(/debrief)로 넘어갑니다.
• 배치 자동화가 호출한 경우, 관점 전환을 다 써도 안 풀리면 해당 Story는 BLOCKED('unstuck_exhausted')로 표시되고 나머지 배치는 계속 진행됩니다 (Epic 전체가 멈추지 않습니다).

/dev:unstuck                      # debate 모드 (기본): 5 페르소나 병렬
/dev:unstuck solo  < persona >         # solo 모드: 단일 페르소나

1.  < persona >   검증 (5개 중 하나). 미지정/오타 → affinity 라우팅으로 추정(기본 CONTRARIAN)하고 무엇을 골랐는지 명시.
2. LATERAL_PERSONAS.md 에서 해당 페르소나 행 로드.
3. stuck context 에 페르소나 3 probing questions 적용.
4. reframing 1건 출력 (재시도 아님 — 종류가 다른 next move).
5. STOP. verdict 없음.

await Task({
  subagent_type:  " lateral-thinker " ,
  prompt: `
    persona: ${persona}            // e.g. HACKER
    problem_context: ${problem_context}
    current_approach: ${current_approach}
    failed_attempts: ${failed_attempts}
  `
});

const PERSONAS = [ " HACKER " ,  " RESEARCHER " ,  " SIMPLIFIER " ,  " ARCHITECT " ,  " CONTRARIAN " ];

// 5개 동시 실행 (한 메시지에서 병렬 Task)
const reframings = await Promise.all(
  PERSONAS.map((persona) = > 
     Task({
      subagent_type:  " lateral-thinker " ,   // 또는  " general-purpose " 
       prompt: `
        persona: ${persona}
        problem_context: ${problem_context}
        current_approach: ${current_approach}
        failed_attempts: ${failed_attempts}

        references/LATERAL_PERSONAS.md 의 ${persona} 정의를 읽고,
        이 stuck context 를 그 시각으로 reframing 하라. verdict 금지.
      `,
    })
  )
);

// 종합 (synthesize) → STOP

## /dev:unstuck — Debate Synthesis

### Options
- [HACKER] {next move}
- [RESEARCHER] {next move}
- [SIMPLIFIER] {next move}
- [ARCHITECT] {next move}
- [CONTRARIAN] {next move}

### Disagreements
- {페르소나 간 충돌하는 진단/제안 — 어디서 엇갈리는가}

### Recommended
- {상황상 가장 설득력 있는 선택지 1–2개 + 이유}

 >   Do not auto-emit a verdict; the verdict is the user ' s.