02-구조

02. 구조 — 3종 파일과 그 도구

A. .omc/state/ — 실행 모드 상태

OMC AGENTS.md의 Mode lifecycle requirements:

• 모드 시작 시 state_write로 mode, active: true, started_at, 모드별 필드 기록.
• 단계/이터레이션 전환 시 current_phase/iteration 갱신.
• 완료 시 active: false, completed_at.
• 취소/중단 시 state_clear(mode="...").

권장 모드 필드:

모드	필드
ralph	active, iteration, max_iterations, current_phase, started_at, completed_at
autopilot	active, current_phase(expansion|planning|execution|qa|validation|complete), started_at, completed_at
ultrawork	active, reinforcement_count, started_at
team	active, current_phase, agent_count, team_name

용도: 세션이 끊겨도 실행 모드를 정확히 이어받기 위함.

B. .omc/notepad.md — 세션 노트

OMC 도구:

• notepad_read
• notepad_write_priority — 우선순위 높음(영구 가까움)
• notepad_write_working — 작업 메모
• notepad_write_manual — 사람이 직접 쓴 메모
• notepad_prune — 정리
• notepad_stats — 통계

매 작업 시작 시 갱신하라는 게 본 위키 절대 규칙 #12.

C. .omc/project-memory.json — 영구 프로젝트 지식

도구:

• project_memory_read
• project_memory_write
• project_memory_add_note
• project_memory_add_directive

세션을 넘는 결정 과 디렉티브 를 적는다. 코드 변경처럼 git에 들어가야 한다.

Anthropic Memory Tool과의 매핑

Anthropic Memory Tool	OMC 대응
파일 기반 영구 저장소	.omc/notepad.md + project-memory.json
세션을 넘는 read/write	notepad_read / project_memory_read
자동 정리(Context Editing)	notepad_prune + compact

OMC는 Memory Tool 없이도 같은 패턴을 파일·git으로 구현한다 — 더 투명하고, 더 쉽게 검토 가능.

<remember> 태그

OMC CLAUDE.md의 hook 패턴:

• <remember> — 7일 지속.
• <remember priority> — 영구.

훅이 컨텍스트에 주입한 메모를 모델이 기억하도록. 짧은 강조용.