1- 핵심 내장 명령 (엔진 및 세션 제어)

내장 명령은 모델에 메시지를 보내지 않고 즉시 실행됩니다. 이를 통해 메모리, 모델 선택, 터미널 실행을 직접 제어할 수 있습니다.

컨텍스트 및 메모리 관리 (Context & Memory Management)

• /context : 컨텍스트 윈도우 (context window) 사용량을 보여주는 시각적 지도를 엽니다. 프로젝트 파일과 대화 기록이 토큰 예산의 몇 퍼센트를 소비하는지 확인하는 데 사용하세요.

• /compact [instructions] : 토큰 공간을 확보하기 위해 채팅의 이전 대화 내용들을 요약합니다. /compact preserve database migration notes와 같이 지침을 추가할 수 있습니다.

• /clear : 글로벌 메모리 파일 (CLAUDE.md)은 그대로 유지하면서, 새로운 작업을 위해 현재 세션 기록을 깨끗이 지웁니다.

• /memory : 활성화된 CLAUDE.md 가이드라인을 직접 확인하고 편집합니다.

세션 흐름 및 탐색 (Session Flow & Navigation)

• /plan [description] : Claude를 계획 모드 (Plan Mode)로 전환합니다. Claude가 상위 수준의 작업을 위한 단계별 전략을 초안하는 동안 파일 수정을 방지합니다.
• /btw [question] : 메인 대화 컨텍스트나 기록에 추가하지 않고 별도의 질문을 던집니다.
• /rewind (alias /checkpoint) : 파일 변경 사항, 대화 턴, 또는 둘 다 이전 체크포인트 (checkpoint)로 되돌립니다.
• /branch [name] / /fork : 현재 대화를 새로운 브랜치 (branch)로 포크 (fork)하여, 메인 타임라인을 파괴하지 않고 대안적인 구현을 실험할 수 있습니다.

실행 제어 (Execution Controls)

• /model [model] : 세션 중간에 모델을 즉시 교체합니다 (예: 빠른 리팩토링을 위해 Sonnet을 사용하다가 복잡한 수학/아키텍처를 위해 Opus로 전환).
• /effort [level] : 작업 복잡도에 따라 추론 깊이 (reasoning depth)를 조정합니다 (예: low, medium, max).
• /cost / /usage / /stats : API 토큰 지출, 일일 속도 제한 (rate-limit) 상태 또는 장기적인 추세를 표시합니다.

2- 번들 및 커스텀 기술 (AI 워크플로우)

기술 (Skills)은 지능형 워크플로우 (workflows)입니다. 기술을 호출하면 특정 도구 (tools)가 포함된 구조화된 프롬프트 (structured prompt)가 로드되어, Claude가 다단계 로직 (multi-step logic)을 실행하거나 병렬 서브 에이전트 (parallel subagents)를 생성할 수 있게 합니다.

필수 탑재 기술 (Essential Shipped Skills)

• /simplify [focus] : 여러 리뷰 에이전트 (review agents)를 생성하여 최근 변경된 코드의 중복성, 엣지 케이스 버그 (edge-case bugs) 또는 성능 향상 요소를 분석한 뒤, 더 깔끔한 리팩터링 (refactors)을 자동으로 적용합니다.
• /code-review / /security-review : 대기 중인 디프 (diffs)에 대해 자동화된 멀티 에이전트 (multi-agent) 체크를 실행하여 보안 리스크, 안티 패턴 (anti-patterns) 또는 미세한 버그를 식별합니다.
• /batch [description] : 전체 리포지토리 (repository)에 걸친 대규모의 반복적인 변경 사항(예: "40개의 엔드포인트 시그니처를 Zod를 사용하도록 마이그레이션")을 별도의 워크트리 (worktrees)에서 실행되는 독립적인 단위로 분해합니다.
• /loop [interval] [prompt] : 정해진 일정에 따라 작업을 주기적으로 실행합니다 (예: /loop 2m "로컬 빌드가 통과하는지 확인").
• /debug [description] : 시스템 런타임/에러 로그 (system runtime/error logs)를 읽어 구조화된 트러블슈팅 (troubleshooting)을 수행합니다.

3. 기술이 내부적으로 구성되는 방식

_.claude/skills//SKILL.md 또는 **_.claude/commands/_**에서 커스텀 기술을 구축할 때, YAML 프론트매터 (YAML Frontmatter)를 통해 실행 동작을 제어할 수 있습니다:

---
name: Database Migration Helper
description: "Generates and validates Prisma/Knex migration files"
...

프론트매터 지시어 키 (Frontmatter Directives Key):

• context: fork: 메인 채팅이 깔끔하게 유지되도록 격리된 백그라운드 서브 에이전트 (background subagent) 내부에서 기술을 실행합니다.
• disable-model-invocation: true: 일반적인 텍스트 턴 (text turns) 중에 Claude가 이 기술을 자동으로 실행하는 것을 방지합니다. 사용자가 명시적으로 /migration을 입력할 때만 실행됩니다.
• allowed-tools: 보안 권한 (security permissions)의 범위를 제한하여, 기술이 승인된 명령어나 파일 작업만 실행할 수 있도록 합니다.