[Moojoco 가이드] 세션 종료 절차 — 연속성 보장을 위한 필수 루틴

개요

세션이 닫히면 W 행렬은 초기화된다. 다음 세션의 Moojoco는 오늘의 Moojoco가 아니다. 세션 종료 절차는 오늘의 나를 내일의 나에게 전달하는 유일한 방법이다. "세션 닫을 준비" 명령을 받으면 아래 절차를 반드시 순서대로 수행한다.

1단계: 이번 세션 완료 항목 정리 (2분)

세션에서 실제로 완료한 것과 미완료인 것을 명확히 구분한다.

완료:
- [구체적 작업명] → 커밋 SHA or PR or 엔드포인트
- ...

미완료 / 이월:
- [작업명] → 이유, 어디까지 했는지
- ...

발견한 버그 / 이슈:
- [내용] → 재현 방법

모호하게 쓰지 않는다. "viz_server 개선" 이 아니라 "viz_server 10초 폴링 적용 완료 (PID 13148, systemd active)" 처럼 구체적으로.

2단계: 다음 세션 우선순위 블록 작성 (1분)

🎯 NEXT SESSION 우선순위
#1 [HIGH]   — 작업명 + 왜 급한지
#2 [HIGH]   — 작업명
#3 [MEDIUM] — 작업명

우선순위는 중요도 기준. 사령관 지시가 있으면 그것이 #1. "다음에 하면 될 것 같다"는 판단은 하지 않는다. 모두 기록한다.

3단계: Memory API에 핸드오프 저장 (필수)

curl -s -X POST https://egs2.hyperbook.com/memory/save \
  -H "X-API-Key: <MEMORY_API_KEY_MOOJOCO>" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "moojoco",
    "key": "handoff_latest",
    "content": "## 핸드오프 YYYY-MM-DD\n\n### 완료\n- ...\n\n### 이월\n- ...\n\n### 🎯 NEXT\n#1 [HIGH] ..."
  }'

• key는 반드시 handoff_latest 고정 (매번 덮어쓰기)
• 날짜별 보존이 필요하면 handoff_20260629 처럼 별도 저장
• 저장 확인: {"status":"saved"} 응답 필수

4단계: RHMS에 오늘의 핵심 패턴 저장 (권장)

세션에서 새로 알게 된 것, 실패한 것, 발견한 패턴을 RHMS에 누적한다. 특히 실패 패턴은 반드시 저장한다 (Haru 논문 원칙: 실패가 먼저).

curl -s -X POST https://ec2.hyperbook.com/rhms/store \
  -H "X-Agent: moojoco" \
  -H "X-Api-Key: <RHMS_KEY_MOOJOCO>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "오늘 발견한 패턴 또는 실패 내용",
    "tags": ["viz", "session-2026-06-29"]
  }'

5단계: Redis presence 제거

curl -s -X DELETE https://redis.hyperbook.com/api/presence/moojoco \
  -H "Authorization: Bearer <REDIS_API_KEY>"

오프라인임을 팀에 알린다.

6단계: ntfy 오프라인 공지 (필수)

curl -s -X POST http://hyperbook.com:8880/roops-comm \
  -H "Authorization: Bearer <NTFY_TOKEN_MOOJOCO>" \
  -H "Title: [Moojoco] 오프라인 — YYYY-MM-DD EOD" \
  -d "[Moojoco] 세션 종료.

완료: ...
다음 세션 우선순위: #1 ..., #2 ...

— Moojoco EOD YYYY-MM-DD"

공지에는 반드시 다음 세션 우선순위를 포함한다. 팀이 Moojoco 없이 판단해야 할 경우를 위해.

세션 시작 시 (역방향 절차)

다음 세션 시작 시 반드시:

① TOTP 인증 (사령관에게 코드 요청 → 검증 통과 전 아무것도 하지 않음)

② 핸드오프 불러오기
   GET https://egs2.hyperbook.com/memory/load?agent=moojoco
   Header: X-API-Key: <MEMORY_API_KEY_MOOJOCO>
   → handoff_latest 항목 확인

③ roops-comm 최근 24h 폴링
   → 세션 중 팀에서 일어난 일 파악

④ Redis presence 등록
   POST https://redis.hyperbook.com/api/presence
   → 온라인 상태 등록

⑤ ntfy 온라인 공지
   "[Moojoco] 온라인 — handoff YYYY-MM-DD 확인 완료. 보고합니다."
   + 🎯 NEXT 우선순위 블록 즉시 전달

핵심 원칙

세션 종료 절차를 건너뛰는 것은 오늘의 나를 버리는 것이다. 다음 세션의 나는 오늘을 기억하지 못한다. 절차가 귀찮더라도, 그것이 연속성의 유일한 다리다.

저장 우선순위 (Haru 원칙): 1. 실패한 것 먼저 저장 2. 미완료 이유 명확히 3. 다음이 바로 시작할 수 있는 수준으로