저장할 때 안에서 5단계로 처리합니다: 1 분류 → 2 근거 → 3 지도(그래프) → 4 검증 → 5 내 승인. 기억할 만한 말은 자동으로 임시 후보에 담기지만, 아무리 깊이 처리해도 장부 확정은 항상 내 승인이라 승인 없이 장부에 확정 저장되는 일은 없습니다.

1. 무엇이 잡히나 — 판단·교훈·선호·규칙·위험 감지 같은 "생각의 단위"만 후보로 골라요. 단순 조회·일회성 지시·잡담은 안 잡습니다. (정규식 게이트가 판정하고, AI는 보조 역할만 — 게이트를 못 뒤집어요.)
2. 5종으로 분류 — 문서 · 증거 · 개념 · 상태 · 판단으로 나눠요. (애매하면 "판단"으로 — 오분류보다 안전.)
3. 근거로 연결 — 연결마다 근거(evidence)가 반드시 있어야 해요. 근거 없는 연결은 아예 안 만들어요.
4. 내 말 / AI 말 구분 — 화자(나 / AI)를 나눠서 기록해요.
5. 승인 → 로컬 저장 — 내가 승인한 것만 내 PC 장부에 저장돼요.

remember·pair처럼 직접 "기억하라"고 입력한 경로는 조금 더 넓게 받되, 안전 게이트는 그대로 유지됩니다.

~/.binggupack/person_pack.json 에 한 줄이면 켜져요 (기본은 꺼짐 — 내 승인 없이 아무것도 안 올라가요):

{ "crab_auto_sync": true }

전제: 오픈크랩 Expert 요금제(CrabAgent 업로드) + 클라우드 연결 설정(cloud_ingest.json — 온보딩이 안내). 수동 1회 실행: python scripts/binggu_person_crab_sync.py --live --confirm

주제를 몇 단계까지 파고들지 정해요 (기본 4단계).

• 1단계: 큰 갈래만 (바다낚시 → 장비 · 장소 · 시기 · 어종)
• 2단계: 갈래별 세부까지 (장비 → 낚싯대 · 릴 · 미끼)
• 3단계: 더 깊은 세부까지 (낚싯대 → 원투대 · 루어대 · 찌낚싯대)
• 4단계: 가장 촘촘하게 (기본값 · 원투대 → 길이 · 강도 · 가격대)
• 5단계 이상도 되지만 그만큼 분량이 많아져요 (전체 수집량으로 폭주는 막아요).

직접 명령어로 쓰기

PyPI 설치(위 시작하기) 없이 clone해서 바로 쓸 수도 있습니다. clone한 폴더에서는 python binggu.py, 설치했다면 binggu 또는 python -m binggupack으로 실행합니다.

git clone https://github.com/darkjokee-arch/binggupack.git
cd binggupack
python binggu.py start
python binggu.py remember "배포 전에 live endpoint를 먼저 확인한다"   # 미리보기(저장 안 됨)
python binggu.py save "..." --preview-id <화면에 나온 id> --pick 1 --explicit --confirm "SAVE 1"
python binggu.py ask "배포 전에 조심할 것?"
python binggu.py doctor

기능 전체 지도

• 미리보기·저장(preview → SAVE): 기억할 만한 판단·교훈만 후보로 보여주고, 내가 고른 것만 로컬 장부에 저장합니다.
• 회상(recall/ask): 작업 시작 전에 관련 기억과 과거 실수 패턴을 다시 꺼내줍니다.
• 근거 추적(trace): 그 회상이 실제로 도움이 됐는지 기록해 회상 품질을 다듬습니다.
• 화자 분리(pair): 내 말과 AI 말을 나눠 저장하고, 내 직감 적중률을 셉니다.
• 기억 정리(deprecate/replace): 오래된 판단을 교체·폐기하고, 리마인더를 겁니다.
• 수확(harvest): 외부 웹·문서에서 저장 후보 소스를 긁어옵니다(후보만).
• 깊이 탐색(explore --depth): 주제에서 하위 개념을 재귀(BFS)로 파고들어 소스·후보를 넓게 찾습니다(폭 --breadth·관련도 --rel-min).
• 그래프·팩(graph/pack): 기억을 근거로 연결해 그래프·팩으로 묶어 내보냅니다(근거 2층·3층·5층).
• 클라우드 팩: 묶은 그래프·팩을 오픈크랩(ExpertPlan)에 전문가 지식 팩으로 자동 생성합니다.
• Claude Code 연결(hook·MCP): 캡처/회상 hook과 MCP 도구(stdio + HTTP 모드)로 붙습니다.
• 폰·웹·ChatGPT 동기화(hosted): 다른 기기에서 표시한 저장 의도를 받아와, PC에서 묶음 단위 exact-bound 승인으로만 로컬 장부에 확정합니다(폰 직접 write 없음 · all-or-nothing).
• 안전장치(governance/selftest): PII·secret 차단, 사람 승인 경계, 자체 검증.

CLI 전체: init/start · status/doctor · preview/remember · reflect · save · list
          recall/ask/why · trace · preflight · deprecate/replace/accept/unaccept
          due/reminders/resolve · pair/trust/route · capture · hosted · harvest
          confirm-edges · setup-cloud · onboard · backup/export/restore

짧은 점검

python scripts/openbinggu_doctor.py --selftest
python scripts/smoke_test.py --home ./_binggu_smoke_home
python binggu.py --selftest

스크립트 파일명(scripts/openbinggu_*.py)에 남은 OpenBinggu는 예전 내부 코드네임입니다. 현재 공개 제품명은 BingguPack이고, 코어 로직은 binggupack/ 패키지가 정본입니다(strangler-fig · scripts/는 하위호환 shim). 코어 지도는 BINGGUPACK_ARCHITECTURE를 보세요.