Quick Flow

/run은 변경된 앱을 실제로 실행하고 조작하는 skill, /verify는 빌드·실행·관찰로 변경 결과를 확인하는 skill입니다. 둘은 Claude Code 2.1.145 이상에서 별도 설정 없이 시작할 수 있으며, 프로젝트의 실행 절차가 복잡하면 /run-skill-generator가 그 절차를 프로젝트 skill로 기록합니다.

코드 변경
  -> test / type check: 빠른 회귀 확인
  -> /run: 실행 중인 앱을 직접 확인
  -> /verify: 기대한 사용자 결과를 관찰해 확인

실행법을 자주 추론하지 못함
  -> /run-skill-generator
  -> .claude/skills/run-<name>/에 실행 레시피 기록

실행과 검증

/run과 /verify는 테스트 통과만으로 끝내기 어려운 변경에 씁니다. 웹 UI, CLI 출력, TUI 흐름, 파일 생성처럼 실제로 실행해 봐야 알 수 있는 결과가 대상입니다. /run은 앱을 띄우고 상호작용하는 데 초점을 두며, /verify는 변경이 요구한 결과를 냈는지 빌드·실행·관찰로 확인합니다.

/run     -> "변경된 앱을 실제로 조작해 본다"
/verify  -> "변경한 요구가 실제 실행 결과에서 성립하는지 확인한다"
test     -> "알려진 자동 검사 조건이 깨지지 않았는지 확인한다"

세 수단은 대체 관계가 아닙니다. 테스트는 빠른 반복에, /run과 /verify는 실행 환경에서만 보이는 결과 확인에 강합니다. 반대로 데이터베이스를 지우거나 운영 API를 호출하는 실행 절차라면, 실행 검증보다 먼저 로컬 데이터·자격 증명·권한 경계를 안전하게 만듭니다.

실행 레시피 기록

기본 /run과 /verify는 README, package.json, Makefile, 프로젝트 종류를 보고 실행법을 추론합니다. 데이터베이스, env 파일, 여러 프로세스, 그래픽 세션, 다단계 빌드가 필요한 프로젝트에서는 이 추론이 불안정할 수 있습니다. /run-skill-generator는 깨끗한 환경에서 실제로 성공한 설치 명령·환경 변수·시작 절차를 .claude/skills/run-<name>/ 프로젝트 skill로 남겨 이후 실행이 같은 레시피를 따르게 합니다.

/run-skill-generator를 다시 실행할 때
- build 또는 start 명령이 바뀌었다
- 필요한 env 파일·서비스·포트가 바뀌었다
- 새 환경에서 실행이 재현되지 않는다

공유할 실행 레시피에는 개인 절대 경로, 실제 secret, 운영 데이터 접근 명령을 넣지 않습니다. 팀이 함께 재현해야 하는 명령과 placeholder만 커밋하고, 각자의 secret는 안전한 환경 변수 주입으로 분리합니다.

bundled skill의 범위

bundled skill은 고정 동작을 구현한 명령과 달리 Claude에게 상세 작업 절차를 제공하고 도구 사용을 조율하게 하는 prompt 기반 기능입니다. /run, /verify, /run-skill-generator 외에도 /simplify, /batch, /debug, /loop, /claude-api 등이 이 범주에 있습니다. 명령 목록에서 Skill로 표시되는지 확인하면 고정 CLI 제어와 구분할 수 있습니다.

프로젝트 고유 절차는 .claude/skills/<name>/SKILL.md로 따로 정의할 수 있습니다. 기본 skill의 이름을 덮어쓰거나 비슷한 이름을 여러 개 만들면 어떤 절차가 실행되는지 불명확해지므로, 실행 레시피는 run-<name>처럼 역할과 대상이 드러나는 이름을 사용합니다.

자주 틀리는 부분

• /run이 앱을 띄웠다고 요구 사항이 충족됐다고 판단하지 않습니다. 변경한 흐름을 실제로 조작하거나 /verify로 관찰합니다.
• 실행 레시피가 오래되면 실패 원인이 코드인지 설정인지 구분하기 어려워집니다. build/start 과정이 바뀔 때 generator를 다시 실행합니다.
• 로컬에서 허용되는 파일 쓰기·포트·API 호출을 CI나 운영 자격 증명에서 그대로 실행하지 않습니다.