Hook Management

프로젝트가 성장해도 Agent Hooks가 깔끔하게 정돈된 상태를 유지하도록 활성화·편집·삭제·수동 실행을 다루는 방법을 정리합니다.

왜 관리가 중요한가

Hook은 한 번 만들고 잊어버리는 것이 아닙니다. 코드베이스가 커지고 팀의 작업 방식이 바뀌면, 자동화 규칙도 그 흐름을 따라가야 합니다. 잘 관리된 Hook 세트는 불필요한 실행을 줄여 비용과 노이즈를 낮추고, 정말 필요한 순간에만 Agent가 개입하도록 만들어 줍니다.

모든 Hook은 Kiro 패널의 Agent Hooks 섹션에서 한곳에 모여 관리됩니다. 이 패널이 활성화·편집·삭제·수동 실행의 기준점이 됩니다.

Hook 활성화 / 비활성화

잠시 사용하지 않을 Hook은 삭제하지 않고 꺼두는 편이 좋습니다. 설정과 지시문은 그대로 보존되므로 다시 켜기만 하면 됩니다.

  1. 빠른 토글: Agent Hooks 패널에서 Hook 이름 옆의 eye icon을 클릭하면 즉시 켜고 끌 수 있습니다.
  2. Hook 상세 화면에서: 목록에서 Hook을 선택한 뒤, 우측 상단의 Hook Enabled 스위치로 상태를 바꿉니다.
팁. 데모나 일시적인 점검 중에는 활성화 상태만 잠시 꺼두면 동료가 만든 Hook을 망가뜨리지 않고도 안전하게 작업을 진행할 수 있습니다.

기존 Hook 편집

워크플로가 바뀌면 Hook도 함께 수정합니다. Agent Hooks 패널에서 대상 Hook을 선택하면 다음 항목을 자유롭게 갱신할 수 있습니다.

저장하면 변경 사항은 즉시 반영되며, 다음 트리거부터 새 설정이 적용됩니다.

Hook 삭제

  1. Agent Hooks 패널에서 삭제할 Hook을 선택합니다.
  2. 화면 하단의 Delete Hook 버튼을 클릭합니다.
  3. 확인 대화상자에서 delete를 한 번 더 눌러 실행을 확정합니다.
주의. 삭제는 되돌릴 수 없습니다. 다시 사용할 가능성이 조금이라도 있다면, 삭제 대신 비활성화를 먼저 고려하세요.

수동 트리거 Hook 실행

수동(Manual) 트리거로 설정된 Hook은 파일 이벤트가 아닌 사용자의 명시적 행동으로 실행됩니다. 두 가지 경로가 준비되어 있습니다.

  1. 빠른 실행: Agent Hooks 패널의 Hook 이름 옆에 있는 play button (▷)을 클릭하면 곧바로 시작됩니다.
  2. Hook 상세 화면에서: 목록에서 Hook을 선택하고 우측 상단의 Start Hook 버튼을 누릅니다.
팁. 릴리스 전 체크리스트나 문서 일괄 갱신처럼 가끔만 돌리는 작업은 수동 트리거로 만들어 두면, 의도한 시점에만 Agent를 호출할 수 있어 결과가 예측 가능해집니다.

일상적인 관리 루틴

Hook이 늘어날수록 다음과 같은 가벼운 점검 습관이 도움이 됩니다.