Ch5. Hooks 시스템

{
  "id": "lint-on-save",
  "name": "저장 시 린트 실행",
  "description": "TypeScript 파일 저장 시 자동으로 린트 검사",
  "eventType": "fileEdited",
  "hookAction": "askAgent",
  "filePatterns": "**/*.{ts,tsx}",
  "outputPrompt": "방금 수정된 파일에 대해 eslint를 실행하고 발견된 문제들을 수정해주세요."
}

{
  "id": "auto-format",
  "name": "자동 포매팅",
  "description": "에이전트 실행 완료 후 자동으로 Prettier 실행",
  "eventType": "agentStop", 
  "hookAction": "runCommand",
  "command": "npm run format"
}

.kiro/hooks/
├── lint-on-save.json
├── auto-test.json
└── deploy-check.json

~/.kiro/hooks/
├── global-format.json
└── backup.json

{
  "id": "typescript-lint",
  "name": "TypeScript 린트 검사",
  "description": "TS/TSX 파일 저장 시 자동으로 ESLint 실행 및 수정",
  "eventType": "fileEdited",
  "hookAction": "askAgent", 
  "filePatterns": "**/*.{ts,tsx}",
  "outputPrompt": "방금 수정된 TypeScript 파일에 대해 `npm run lint:fix`를 실행하고, 자동으로 수정되지 않는 문제가 있다면 코드를 직접 수정해주세요."
}

{
  "id": "run-new-tests",
  "name": "새 테스트 실행",
  "description": "테스트 파일 생성 시 자동으로 해당 테스트 실행",
  "eventType": "fileCreated",
  "hookAction": "askAgent",
  "filePatterns": "**/*.test.{ts,tsx,js,jsx}",
  "outputPrompt": "새로 생성된 테스트 파일을 실행해서 정상 동작하는지 확인해주세요. 실패하는 테스트가 있다면 수정해주세요."
}

{
  "id": "format-after-prompt",
  "name": "프롬프트 후 포매팅",
  "description": "프롬프트 제출 후 자동으로 Prettier 실행",
  "eventType": "promptSubmit",
  "hookAction": "runCommand",
  "command": "npx prettier --write . --ignore-path .gitignore"
}

{
  "id": "prepare-commit",
  "name": "커밋 준비",
  "description": "에이전트 실행 완료 후 변경사항 스테이징",
  "eventType": "agentStop",
  "hookAction": "runCommand", 
  "command": "git add . && git status"
}

{
  "id": "create-storybook",
  "name": "스토리북 파일 생성",
  "description": "React 컴포넌트 생성 시 자동으로 스토리북 파일 생성",
  "eventType": "fileCreated",
  "hookAction": "askAgent",
  "filePatterns": "src/components/**/*.tsx",
  "outputPrompt": "새로 생성된 React 컴포넌트에 대응하는 Storybook 스토리 파일(.stories.tsx)을 생성해주세요. 컴포넌트의 주요 props와 상태를 보여주는 기본적인 스토리들을 포함해주세요."
}

{
  "id": "project-review",
  "name": "프로젝트 전체 검토",
  "description": "수동으로 트리거하여 프로젝트 전체 코드 품질 검토",
  "eventType": "userTriggered",
  "hookAction": "askAgent",
  "outputPrompt": "프로젝트 전체를 검토하여 다음 사항들을 확인해주세요: 1) 코드 품질 및 일관성 2) 보안 취약점 3) 성능 최적화 기회 4) 문서화 누락 부분. 발견된 문제점들과 개선 제안을 정리해주세요."
}

Ctrl/Cmd + Shift + P
> Kiro: Manage Hooks
> Kiro: Create New Hook  
> Kiro: Trigger Hook

Ctrl/Cmd + Shift + P
> Kiro: Open Hook UI

{
  "id": "pre-task-setup",
  "name": "태스크 전 환경 확인",
  "description": "태스크 시작 전 의존성 및 환경 검증",
  "eventType": "preTaskExecution",
  "hookAction": "runCommand",
  "command": "npm run typecheck && npm run lint"
}

{
  "id": "post-task-notify",
  "name": "태스크 완료 알림",
  "description": "태스크 완료 후 Slack 알림 전송",
  "eventType": "postTaskExecution",
  "hookAction": "runCommand",
  "command": "curl -X POST $SLACK_WEBHOOK -d '{\"text\": \"Task completed\"}'"
}

{
  "id": "pre-write-check",
  "name": "파일 쓰기 전 검증",
  "eventType": "preToolUse",
  "hookAction": "runCommand",
  "toolCategory": "write",
  "command": "echo 'Validating write operation...'"
}

{
  "id": "post-shell-log",
  "name": "쉘 명령 로깅",
  "eventType": "postToolUse",
  "hookAction": "runCommand",
  "toolCategory": "shell",
  "command": "echo \"$(date): Shell command executed\" >> .kiro/audit.log"
}