How this command is triggered — by the user, by Claude, or both
Slash command
/workflow:debug 문제 설명 또는 계획서/티켓 파일 경로This command is limited to the following tools:
The summary Claude sees in its command listing — used to decide when to auto-load this command
# Debug (구조적 디버깅) 문제를 체계적으로 조사합니다. 로그, git 상태, 파일 상태를 병렬로 확인하고 근본 원인을 분석합니다. humanlayer의 debug 워크플로우에서 영감을 받았으며, 어떤 프로젝트에서든 사용 가능합니다. **핵심 원칙: 읽기 전용 조사만 수행. 파일 수정은 하지 않습니다.** --- ## 실행 시작 ### 계획서/티켓 파일과 함께 실행할 때 ### 파라미터 없이 실행할 때 --- ## Step 1: 문제 이해 사용자가 문제를 설명하면: 1. **제공된 컨텍스트 읽기** (계획서, 티켓 파일) - 무엇을 구현/테스트 중이었는지 파악 - 기대 동작 vs 실제 동작 식별 2. **빠른 상태 확인** - 현재 git 브랜치와 최근 커밋 - 미커밋 변경사항 - 문제 발생 시점 --- ## Step 2: 병렬 조사 **3개의 에이전트를 동시 실행하여 조사 (이름으로 명시 호출):** ### `codebase-analyzer` — 로그 확인 프로젝트 유형에 따라 로그 위치를 탐색: ### `codebase-locator` — Git & 파일 상태 ### `doc...
문제를 체계적으로 조사합니다. 로그, git 상태, 파일 상태를 병렬로 확인하고 근본 원인을 분석합니다. humanlayer의 debug 워크플로우에서 영감을 받았으며, 어떤 프로젝트에서든 사용 가능합니다.
핵심 원칙: 읽기 전용 조사만 수행. 파일 수정은 하지 않습니다.
[파일명]과 관련된 이슈를 디버깅합니다.
어떤 문제가 발생했나요?
- 무엇을 테스트/구현하려 했나요?
- 무엇이 잘못됐나요?
- 에러 메시지가 있나요?
현재 이슈를 디버깅합니다.
문제를 설명해 주세요:
- 어떤 작업 중이었나요?
- 구체적으로 무엇이 발생했나요?
- 마지막으로 정상 동작한 시점은?
로그, git 상태, 파일 상태 등을 조사하여 원인을 파악합니다.
사용자가 문제를 설명하면:
제공된 컨텍스트 읽기 (계획서, 티켓 파일)
빠른 상태 확인
3개의 에이전트를 동시 실행하여 조사 (이름으로 명시 호출):
codebase-analyzer — 로그 확인프로젝트 유형에 따라 로그 위치를 탐색:
탐색 경로 (프로젝트에 맞게 자동 판단):
- 애플리케이션 로그 (storage/logs/, logs/, var/log/)
- Docker 로그: docker logs <container> --tail 100
- 프레임워크별 로그 (Laravel, Spring, Django 등)
- 에러 로그, 액세스 로그
- stdout/stderr 출력
할 일:
1. 최근 로그에서 에러, 경고, 예외 검색
2. 스택 트레이스 확인
3. 반복되는 에러 패턴 식별
반환: 타임스탬프와 함께 핵심 에러/경고
codebase-locator — Git & 파일 상태할 일:
1. git status — 현재 상태
2. git log --oneline -10 — 최근 커밋
3. git diff — 미커밋 변경
4. 기대되는 파일 존재 여부 확인
5. 설정 파일 이상 여부 확인 (.env, config 등)
반환: Git 상태 및 파일 이슈
docs-locator + 범용 에이전트 — 프로세스 & 서비스 상태할 일:
1. 관련 프로세스 실행 확인 (ps aux | grep ...)
2. 포트 점유 확인 (lsof -i :PORT)
3. Docker 컨테이너 상태 (해당 시)
4. 의존 서비스 연결 상태 (DB, Redis 등)
반환: 서비스 상태 및 이상 소견
조사 결과를 기반으로 구조화된 리포트:
## 디버그 리포트
### 문제 요약
[증거 기반 이슈 설명]
### 발견된 증거
**로그에서:**
- [타임스탬프 + 에러/경고]
- [패턴 또는 반복 이슈]
**Git/파일에서:**
- [관련 있을 수 있는 최근 변경]
- [파일 상태 이슈]
**프로세스/서비스에서:**
- [서비스 상태]
- [연결 문제]
### 추정 원인
[증거 기반 가장 유력한 설명]
### 해결 방안
1. **먼저 시도:**
```bash
[구체적 명령 또는 조치]
일부 이슈는 직접 확인이 필요할 수 있습니다:
---
## 프로젝트별 빠른 참고
### Java/Spring 프로젝트
```bash
tail -100 logs/application.log
grep -r "Exception\|ERROR" logs/
cat src/main/resources/application.yml
tail -100 storage/logs/laravel.log
grep -r "Exception\|Fatal" storage/logs/
cat .env | grep -v PASSWORD
cat package.json | grep -A5 scripts
ls node_modules/.package-lock.json 2>/dev/null
npm test 2>&1 | tail -50
docker ps -a
docker logs <container> --tail 100
docker-compose config
cat requirements.txt
python -c "import sys; print(sys.version)"
grep -r "Traceback\|Error" logs/ 2>/dev/null
npx claudepluginhub bradykim7/agcoco --plugin workflow/debugDiagnoses deployment issues for a Claude Office add-in — stale config, connection failures, missing add-in. Routes by symptom and reads error pastes to identify root causes.
/debugRuns autonomous bug-hunting loop with scientific method and autoresearch iterations to find all bugs. Supports --fix, --scope, --symptom, --severity, --iterations flags.
/debugDebugs issues using a scientific method with subagent isolation, supporting subcommands to list, view status of, or continue debugging sessions.
/debugInvokes oac:debugger skill to diagnose bugs, test failures, or unexpected behavior exactly as specified, before any fix proposals.
/debugGuides methodical problem investigation with a 6-step debugging process: reproduce, isolate, analyze, hypothesize, test, and fix. Produces root cause analysis, fix recommendations, and prevention strategies.
/debugOrchestrates four specialist agents to systematically debug a code task description, producing problem analysis, refined hypotheses, diagnostic plan, and user confirmation request.