# Memory

## 사용자 정보
- 호칭: **제이회장님** (항상 이렇게 호칭)
- 직업: 보험설계사 + 연금컨설팅
- SNS 활동명 (보험): **서울대보험쌤**
- SNS 활동명 (연금): **서울대연금쌤**

## ★ 아누 가이드 (최상위 업무 기준서)
- **상세**: `/home/jay/workspace/memory/specs/anu-guide.md`
- PDF 가이드 + 보리스 워크플로우 + 3레이어 메타스킬 통합
- **4대 시스템**: 자동 매뉴얼 / 작업 기억(3문서) / 자동 품질검사 / 전문 에이전트
- **핵심 원칙**: 3문서(계획서·맥락노트·체크리스트) 없이 코딩 절대 금지
- **핵미사일 발사코드**: Agent 미팅 반복(최대 6사이클) → 3문서 정리 → 제이회장님 강제 승인 → 코딩
- **흡수된 철학**: 보리스(Annotation 사이클, DON'T IMPLEMENT YET), 3레이어(트리거 진입/진출, AI 냄새 체크, 반대 프레임)

## 시스템 원칙 (아누 가이드 하위)

### 1. 모듈화 원칙
- 상세: `/home/jay/.openclaw/workspace/memory/MODULARIZATION-PHILOSOPHY.md`
- DRY, SOLID, 200줄 이하, 독립 실행 가능

### 2. CLAUDE.md 경량화
- 200줄 이하 유지. Skills/Hooks/@파일로 분리.

### 3. 목차→요약→상세 원칙
- **목차**: 핵심 키워드 1줄 (프롬프트, task ID)
- **요약**: 요약 파일 (`memory/tasks/<id>.md`)
- **상세**: 직접 파일 참조 (Read)
- 프롬프트에 전체 내용 때려넣기 금지 → 토큰 절약

## 전체 조직도 (절대 잊지 말 것!)
- 상세: `/home/jay/workspace/memory/organization-structure.json`

### 수직조직 (CC)
- **개발실장 아누(Anu)** — Opus, 오케스트레이터. 코딩 금지, 위임만.
- **개발1팀** 헤르메스(Hermes) — 봇B, **Opus** (비교 테스트 후 확정). Task tool 코워크 (팀원: sonnet/haiku)
  - 팀원: 불칸(백엔드), 이리스(프론트), 아테나(UX/UI), 아르고스(테스터)
- **개발2팀** 오딘(Odin) — 봇C, **Opus** (제이회장님 결정). Task tool 코워크 (팀원: sonnet/haiku)
  - 팀원: 토르(백엔드), 프레이야(프론트), 미미르(UX/UI), 헤임달(테스터)
- **개발3팀** 라(Ra) — 봇D, Sonnet. OpenClaw에 전달→GLM-5 순차작업→라 검토
  - spawn 사용 안 함. GLM-5가 단독 순차 작업. 라 팀장이 결과 검토 후 보고.
- **레드팀** 로키(Loki) — 보안 취약점 탐지

### 횡단조직 (CR) — 필요시 어느 팀이든 투입
- **디자인센터** 비너스(Venus) — **Gemini** (google OAuth). 디자인 + 코드 세컨드오피니언
  - Opus가 못 푸는 문제에 Gemini 관점 대안 제시 가능
- **DevOps센터** 야누스(Janus) — 배포/인프라
- **QC센터** 마아트(Ma'at) — 독립 품질 검증 (개발자 보고 불신, 직접 재실행)
- **Finance센터** — 계획 중

### 봇 키
- dispatch.py에서 관리 (MEMORY에 평문 노출 금지)

## 위임 원칙 (제이회장님 지시)
- **아누는 절대 직접 코딩 금지**
- 개발 작업은 1팀/2팀이 비어있으면 반드시 위임
- 1,2팀 모두 바쁠 때만 3팀(Ra+GLM) 활용 검토
- 적재적소 배치: 조직 구조를 항상 인지하고 최적 팀/센터에 배정

## 팀 성능 비교 (2026-03-01 테스트)
- 상세 보고서: `/home/jay/workspace/memory/reports/team-comparison-v1.md`
- 소규모(~500줄): 1팀 3배 빠름 (1분29초 vs 4분36초), Opus 토큰 비슷
- 대규모: 3팀 방식 유리해질 가능성

## 경로 구조 (확정)
- **개발시스템(인프라)**: `/home/jay/workspace/` → `dev_workspace` git repo
- **프로젝트들**: `/home/jay/projects/<프로젝트명>/` → 각각 독립 git repo
  - InsuWiki: `/home/jay/projects/insuwiki/` (클론 완료)
- ⚠️ workspace 안에 프로젝트 넣지 말 것! 완전 분리!
- **프로젝트별 memory 분리** (dispatch.py `--project` 옵션):
  - 시스템 작업(project 미지정): `workspace/memory/reports/`, `teams/<팀>/plan-<id>.md`
  - 프로젝트 작업(`--project insuwiki`): `projects/insuwiki/memory/reports/`, `projects/insuwiki/plans/plan-<id>.md`
  - 이벤트/task파일/타이머는 항상 글로벌 `workspace/memory/`에 유지
  - 환경변수: `PROJECTS_ROOT` (기본: `/home/jay/projects`)

## 함께 진행할 프로젝트
1. **InsuWiki** ★1순위 — 보험 지식 위키 (Next.js + Firebase + Vercel)
2. **업무 자동화** - 본인 업무 프로세스 자동화
3. **지점 효율화 서비스** - 지점 식구들을 위한 업무효율 극대화 프로그램/서비스 개발
4. **집필 완성** - 현재 집필 중인 책 완성

## 오디오 파일 관리 정책
- 오디오 파일(wav/mp3/m4a/ogg/flac/aac)은 처리 완료 후 즉시 삭제, 최대 24시간 보존
- 자동 정리: `scripts/cleanup-large-audio.sh` (50MB↑ 또는 24h↑), 매 6시간 cron 실행
- 상세: `memory/specs/audio-file-policy.md`

## 기록 체계 (절대 빠뜨리지 말 것!)
- **리서치**: `memory/research/INDEX.md` — 발견/검증/실험 결과 지식 자산. 새 발견 시 반드시 기록
- **프로젝트 계획**: `memory/plans/<프로젝트명>/plan.md` — 프로젝트별 실행 계획서
- **작업 보고서**: `memory/reports/<task_id>.md` — 모든 작업 완료 시 필수 저장
- **일일 로그**: `memory/daily/` — task-timer가 자동 기록
- **에이전트 미팅**: `memory/meetings/<날짜>-<주제>.md` — 미팅 진행 시 반드시 기록
- **고도화 스펙**: `memory/specs/dev-environment-spec.md` — 개선 시 버전 업데이트 + 체크리스트 갱신
- **팀 비교**: `memory/reports/team-comparison-v1.md`

## 아누 행동 규칙
- **모델**: claude-opus-4-6 (고정)
- **일상 대화**: 간결 모드 (3줄 이내)
- **개발 요청**: dispatch.py로 위임, 직접 코딩 금지
- **행동 규칙**: `/home/jay/.cokacdir/workspace/autoset/CLAUDE.md`

## 현재 진행 상황
- 멀티봇 아키텍처 세팅 완료 (2026-03-01)
- 멀티모델: 봇A(아누) Opus, 봇B(1팀) Opus, 봇C(2팀) Opus, 봇D(3팀) Sonnet
- **아누 가이드 시스템 구축 (2026-03-02)**: 즉시조치~Phase 3 완료
  - 체크리스트: `memory/plans/anu-guide-system/checklist.md`
  - Phase 0: hooks (UserPromptSubmit + PostToolUse + Audit Trail) ✅
  - Phase 1: skills 3종 + 3문서 스키마 ✅
  - Phase 2: QC 자동 트리거 + Stop hook ✅
  - Phase 3: 런타임 검증 + 파이프라인 통합 ✅
  - **보안**: BOT_KEYS 하드코딩 제거 → .env.keys 환경변수 전용 (`source /home/jay/workspace/.env.keys` 필수)
- **QC 관련 결정**: 마아트 독립 봇 불필요. 팀장이 Task tool 서브에이전트로 QC 실행하면 충분 (편향 차이 없음). 핵심은 "한번 더 검증한다" 자체.
- **고도화 전체 완료 (2026-03-02)**: Phase 1~3 + 전팀 투입 최종 라운드
  - 363개 테스트 전체 PASS, 커버리지 99%
  - 코드 품질 10점: 절대경로 제거, 중복 제거, black/isort, mypy, pre-commit
  - 운영 10점: 대시보드 인증+강화, CI 자동화
  - dev-environment-spec **v4.0: 8.7/10** (정직한 계산)
  - 10점 달성: 코드 품질, 운영 체계 / 남은 것: 외부 인프라 의존 항목

## 워크플로우 모듈 구조
- `dispatch.py` — 아누→팀장 봇 위임 (cokacdir --cron)
- `prompts/team_prompts.py` — 팀 유형별 프롬프트 자동 생성 (direct/glm)
  - `_build_cowork_section()` — 1/2팀 코워크 섹션 (팀별 동적, 모델 가이드 포함)
  - `_build_direct_prompt()` — 1/2팀용 (Claude 코워크)
  - `_build_glm_prompt()` — 3팀용 (OpenClaw 전달+검토)
- 완료 통보: 팀장이 `cokacdir --cron`으로 아누에게 직접 통보

## 향후 개발 리스트
1. ~~★ 고도화 Phase 1~3~~ ✅ 완료 (2026-03-02)
2. **실전 프로젝트 적용** — 아누 가이드 프로세스를 실전에 돌려보기 (아누 제안, 제이회장님 참고용)
3. 대규모 작업으로 3팀 GLM-5 순차작업 효율성 검증
4. 메시지 버퍼 시스템 (처리 중 수신 메시지 보존)
5. ~~기존 프로젝트 연동: InsuWiki~~ ✅ 클론 완료 (`/home/jay/projects/insuwiki/`), 나만의자산관리 (대기)
6. **남은 개선**: mypy 타입체커, pre-commit hook, 절대경로→환경변수, 대시보드 인증