/cc-inspector:nav — 화면 이동(내비게이션) 점검 도구#

한마디로#

앱에서 화면이 왜 안 바뀌는지, 어디로 이동했는지를 실시간으로 들여다보는 도구입니다. 건물 안에서 "지금 내가 몇 층에 있고, 어떤 경로로 여기까지 왔는지" 확인하는 안내판과 같아요.

누가·언제 쓰나요#

앱을 만드는 개발자(또는 개발을 돕는 AI)가 다음과 같은 화면 이동 문제를 만났을 때 씁니다.

• 버튼을 눌러도 화면이 다음으로 넘어가지 않을 때
• 화면을 넘기면서 함께 전달해야 할 정보(파라미터)가 제대로 안 넘어갈 때
• 외부 링크(딥링크)로 들어왔을 때 엉뚱한 화면이 열릴 때

무엇을 해주나요#

지금 앱의 화면 이동 상태를 그대로 보여주고, 직접 이동시켜 볼 수도 있습니다.

• 현재 화면 위치 확인 (현재 route 정보)
• 지나온 화면 기록 확인 (navigation history 스택)
• 현재 화면에 넘어온 정보 확인 (route 파라미터)
• 원하는 화면으로 직접 이동/뒤로 가기/교체/초기화 테스트

어떻게 쓰나요#

# 지금 어느 화면에 있는지 확인
/inspector/nav current

# 지금까지 거쳐온 화면 기록 확인
/inspector/nav history

# 특정 경로(예: /home)로 이동 테스트
/inspector/nav go /home

current는 현재 위치, history는 이동 기록, go <경로>는 그 경로로 직접 이동해 보는 명령입니다.

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

문제 유형에 따라 아래 순서로 원인을 좁혀 갑니다.

• 화면이 안 넘어갈 때: 현재 위치를 확인하고 → 이동 기록 상태를 본 뒤 → 화면 경로 설정이 맞는지 점검합니다.
• 정보가 안 넘어올 때: 현재 화면에 들어온 파라미터를 확인하고 → 보내는 쪽 코드와 받는 쪽 해석 코드를 점검합니다.
• 뒤로 가기가 이상할 때: 이동 기록의 깊이를 확인하고 → 뒤로 가기를 테스트한 뒤 → 뒤로 가기 처리 로직을 점검합니다.

1. nav_get_current_route - >   Check current location
2. nav_get_history - >   Check stack state
3. Review route definitions

1. nav_get_params - >   Check current parameters
2. Review sending side code
3. Review receiving side parsing

1. nav_get_history - >   Check stack depth
2. Test nav_pop
3. Review popUntil logic

/inspector/nav current

/inspector/nav history

/inspector/nav go /home