debug-loop

name	debug-loop
description	버그 상황과 로그를 받아 재현을 최우선으로 수행하고, git 변경/프로젝트 문서 기반 원인 가설을 반복 검증해 해결한다. 방향 변경이 필요하면 사용자 승인 후 진행한다.
argument-hint	[bug-scenario] [log-path-or-snippet] [doc-path(optional)]
disable-model-invocation	true

Debug Loop

버그를 빠르게 고치기 위한 반복 디버깅 스킬이다.

핵심 원칙:

1. 재현 우선

• 가장 먼저 버그를 안정적으로 재현한다.
• 재현되지 않으면 추측 수정부터 하지 않는다.

2. 근거 기반 가설

• 현재 브랜치/변경 파일/git 이력, 로그, 프로젝트 문서를 함께 보고 가설을 세운다.

3. 승인 게이트

• 원 요청 범위를 벗어나거나 다른 방향 전환이 필요하면 반드시 사용자 승인 후 진행한다.

4. 루프 수행

• 가설 -> 수정/로깅 -> 재현 테스트 -> 실패 시 다음 가설로 반복한다.

입력 규칙

• $ARGUMENTS로 버그 상황과 로그(파일 경로 또는 요약 텍스트), 선택적 문서 경로를 받는다.
• 입력이 부족하면 아래를 요청하고 중단한다.
  • 재현 절차(명령/클릭 순서)
  • 기대 결과 vs 실제 결과
  • 오류 로그 원문/스택트레이스
  • 발생 환경(브랜치, OS, 런타임)

실행 워크플로우

1단계: 재현 시도 (최우선)

1. 입력받은 시나리오/로그로 재현 절차를 정리한다.
2. 재현 명령 또는 동작을 실행한다.
3. 재현 여부를 명확히 기록한다.

• 재현 성공: 2단계로 진행.
• 재현 실패: 추가 정보 요청 또는 재현용 로깅 추가안을 제시하고 승인 대기.

2단계: 컨텍스트 수집 (git + 문서 + 코드)