Initial commit

commands/explain-code.md

@@ -0,0 +1,75 @@
+## 코드 설명
+
+코드의 동작을 상세히 해설합니다.
+
+### 사용법
+
+```bash
+# 파일 내용을 표시하고 Claude 에게 의뢰
+cat <file>
+"이 코드의 동작을 설명하세요"
+```
+
+### 기본 사용 예시
+
+```bash
+# Rust 의 소유권 이해
+cat main.rs
+"Rust 의 소유권과 라이프타임 관점으로 설명하세요"
+
+# 알고리즘 해설
+grep -A 50 "quicksort" sort.rs
+"이 정렬 알고리즘의 원리와 계산 복잡도를 설명하세요"
+
+# 디자인 패턴 설명
+cat factory.rs
+"사용된 디자인 패턴과 그 장점을 설명하세요"
+```
+
+### Claude 와의 연동
+
+```bash
+# 초보자 대상 해설
+cat complex_function.py
+"이 코드를 초보자도 이해하기 쉽게 한 줄씩 설명하세요"
+
+# 성능 분석
+cat algorithm.rs
+"이 코드의 성능상 문제점과 개선안을 제시하세요"
+
+# 도식 설명 포함
+cat state_machine.js
+"이 코드의 처리 흐름을 ASCII 아트 도식과 함께 설명하세요"
+
+# 보안 검토
+cat auth_handler.go
+"이 코드의 보안상 우려점을 지적하세요"
+```
+
+### 상세 사용 예시
+
+```bash
+# 복잡한 로직 해설
+cat recursive_parser.rs
+"이 재귀 파서의 동작을 다음 관점으로 설명해주세요:
+1. 전체 처리 플로
+2. 각 함수의 역할과 책임
+3. 엣지 케이스 처리
+4. 개선 가능한 점"
+
+# 비동기 처리 해설
+cat async_handler.ts
+"이 비동기 처리에 대해 다음을 설명해주세요:
+1. Promise 체인의 흐름
+2. 에러 핸들링 메커니즘
+3. 병렬 처리 여부
+4. 데드락 가능성"
+
+# 아키텍처 설명
+ls -la src/ && cat src/main.rs src/lib.rs
+"이 프로젝트의 아키텍처와 모듈 구성을 설명하세요"
+```
+
+### 주의사항
+
+코드 해설에서는 단순히 동작을 설명하는 것뿐만 아니라, 왜 그러한 구현이 되었는지, 어떤 장점이 있는지, 잠재적 문제점은 무엇인지 등 깊이 있는 통찰도 제공합니다.