Skip to main content
HEARTBEAT.md는 AI가 하트비트 때마다 읽는 작업 지시서입니다. 이 파일 하나로 AI의 능동적 행동을 완전히 제어할 수 있습니다.

기본 구조

섹션별 설계

체크 항목

AI가 라운드 로빈으로 순회할 항목들입니다:
항목이 많을수록 토큰 소모가 늘어납니다. 5개 이하로 유지하고, heartbeat-state.json으로 라운드 로빈 하세요.

판단 기준

AI가 언제 알려야 하는지 명확하게 지정합니다:

조용한 시간

조용한 시간을 설정하지 않으면 새벽 3시에도 알림이 올 수 있습니다. 반드시 설정하세요.

자율 작업

알림 없이 AI가 스스로 할 수 있는 작업:

고급: 임시 태스크 추가

HEARTBEAT.md에 임시 항목을 추가해서 단기 모니터링에 활용:
AI에게 직접 요청할 수도 있습니다:

실전 HEARTBEAT.md 템플릿

heartbeat-state.json 연동

AI는 이 JSON을 읽어서 가장 오래된 체크 항목을 우선 확인합니다. 매번 모든 걸 확인하지 않으므로 하트비트당 토큰 소모가 적습니다.

FAQ

AI가 HEARTBEAT.md를 직접 수정해도 되나요?

네! AI에게 “HEARTBEAT.md에 이거 추가해”라고 말하면 됩니다. 자율 작업 중 완료된 임시 태스크 삭제도 AI가 합니다.

하트비트 간격은 어떻게 바꾸나요?

config.yamlheartbeat.intervalMinutes를 수정하세요. 30분이 비용과 반응성의 좋은 균형점입니다.