기본 구조
섹션별 설계
체크 항목
AI가 라운드 로빈으로 순회할 항목들입니다:판단 기준
AI가 언제 알려야 하는지 명확하게 지정합니다:조용한 시간
자율 작업
알림 없이 AI가 스스로 할 수 있는 작업:고급: 임시 태스크 추가
HEARTBEAT.md에 임시 항목을 추가해서 단기 모니터링에 활용:실전 HEARTBEAT.md 템플릿
heartbeat-state.json 연동
AI는 이 JSON을 읽어서 가장 오래된 체크 항목을 우선 확인합니다.
매번 모든 걸 확인하지 않으므로 하트비트당 토큰 소모가 적습니다.
FAQ
AI가 HEARTBEAT.md를 직접 수정해도 되나요?
네! AI에게 “HEARTBEAT.md에 이거 추가해”라고 말하면 됩니다.
자율 작업 중 완료된 임시 태스크 삭제도 AI가 합니다.
하트비트 간격은 어떻게 바꾸나요?
config.yaml의 heartbeat.intervalMinutes를 수정하세요.
30분이 비용과 반응성의 좋은 균형점입니다.