기억이 어떻게 쌓이고,
다시 작업으로 돌아오는지.

1. PIB VIBE란 무엇인가

PIB VIBE는 AI Agent에게 더 긴 채팅창을 제공하는 프로그램이 아닙니다. 핵심은 프로젝트의 사실, 작업의 진행 상태, 검증된 경험, 반복 가능한 전략을 서로 다른 종류의 기억으로 보존하고 필요한 순간에 다시 연결하는 것입니다.

사용자는 주로 Claude나 Codex와 대화하고 작업합니다. PIB VIBE는 그 뒤에서 “이 Agent가 지금 무엇을 알고 있어야 하는가”, “이전에 어디까지 했는가”, “과거에 비슷한 실패가 있었는가”, “이번 판단의 근거는 무엇인가”를 다루는 배경 인프라에 가깝습니다.

2. 전체 mental model

PIB VIBE의 흐름은 “저장 → 검색” 두 단계가 아닙니다. 실제로는 다음 순환이 계속 반복됩니다.

새 작업이 시작되면 Agent는 현재 목표를 이해하고, 필요한 프로젝트 지식과 과거 작업을 선택적으로 읽습니다. 작업 중 막히거나 중요한 판단을 해야 할 때는 유사한 Experience나 Strategy를 찾을 수 있습니다. 구현이 끝나면 실제 검증 결과를 남기고, 재사용 가치가 있는 해결 경험은 다음 작업을 위한 자산이 됩니다.

즉, PIB VIBE의 본체는 기록을 쌓는 데이터베이스가 아니라 현재 행동과 과거 근거 사이의 폐쇄 루프입니다.

3. 네 종류의 기억

Project Knowledge — 프로젝트가 무엇인지 기억

문서, 코드, 설계, 결정, 사용자가 등록한 Knowledge 원본처럼 프로젝트를 이해하는 데 필요한 사실과 근거입니다. 중요한 점은 정보만 저장하지 않고 가능한 경우 출처와 원문 위치를 함께 추적한다는 것입니다.

Work History — 무엇을 했는지 기억

WorkItem과 그에 연결된 조사, BRIEF, 구현, Verification, REPORT 등 “이 작업이 어디에서 시작되어 어디까지 갔는지”를 보존합니다. 채팅 세션이 사라져도 작업 자체가 사라지지 않게 하는 층입니다.

Experience — 무엇을 겪고 해결했는지 기억

Agent가 실수하거나, 디버깅에서 예상하지 못한 원인을 발견하거나, 특정 접근이 실제로 효과가 있었다면 그것이 재사용할 가치가 있는 경험이 될 수 있습니다. 다만 단순한 자기 메모와 검증된 Experience는 같은 것이 아닙니다.

Generalized Strategy — 다음에는 어떻게 해야 하는지 기억

하나의 프로젝트에서 한 번 맞았던 해결책을 곧바로 일반 규칙으로 만들지 않습니다. 여러 Experience에서 반복적으로 확인되어 재사용 가능한 행동 원칙이 되었을 때 Generalized Strategy로 승격하는 구조가 적합합니다.

4. 하나의 작업이 흐르는 방식

PIB VIBE에서 작업은 단순한 “할 일”이 아닙니다. 조사부터 완료 근거까지를 묶는 연속적인 작업 단위입니다.

작업 시작

Agent는 현재 요청이 완전히 새로운 일인지, 이전 WorkItem의 연속인지, 이미 존재하는 결정이나 근거가 필요한 일인지 판단합니다. 모든 과거 기록을 무조건 읽는 것이 아니라 작업 성격에 따라 필요한 조회를 선택하는 것이 중요합니다.

조사와 BRIEF

구현 전에 실제 코드, Knowledge, 이전 기록을 조사하고 범위·제약·완료 조건을 BRIEF로 구조화합니다. 사용자의 승인이 필요한 종류의 작업이라면 승인된 범위가 구현의 기준이 됩니다.

구현과 검증

변경은 승인된 범위 안에서 수행하고, 가능한 기능은 unit test만으로 끝내지 않고 실제 runtime이나 설치본에서 확인합니다. Verification은 “테스트를 돌렸다”보다 무엇을 어떤 조건에서 확인했고 결과가 어땠는지가 중요합니다.

완료와 이어받기

REPORT는 단순 회고가 아니라 다음 Agent가 읽을 수 있는 작업의 현재 상태입니다. 완료된 것, 남은 것, 근거, 주의점을 보존해 다음 세션이 불필요한 재조사를 줄일 수 있게 합니다.

5. 기억을 다시 찾는 방식

PIB VIBE가 가진 기록을 전부 Agent prompt에 넣는 방식은 기억이 아닙니다. 비용이 크고, 오래된 정보가 현재 사실처럼 섞이며, 오히려 중요한 근거를 놓칠 수 있습니다.

따라서 기본 흐름은 현재 의도 판단 → 관련 후보 검색 → 필요한 상세만 확장 → 근거와 provenance 확인입니다. 조사 중에는 Project Knowledge가 중요하고, 디버깅 중에는 유사 Experience가 더 중요하며, 일반적인 작업 습관을 고쳐야 할 때는 Strategy가 중요할 수 있습니다.

6. Knowledge와 RAG

Knowledge는 Agent에게 외부 프로젝트 지식을 연결하는 층입니다. 폴더, PDF, 문서 같은 원본을 등록하면 PIB VIBE가 이를 파싱·chunking·색인하고 검색 가능한 형태로 다룹니다. 사용자는 매번 파일을 직접 찾아 채팅에 붙이지 않아도 됩니다.

중요한 점은 RAG가 “그럴듯한 문장 생성기”가 아니라 원문을 찾기 위한 검색 계층이라는 점입니다. 검색 결과는 가능한 경우 원본 문서, 위치, 관련 근거로 되짚을 수 있어야 합니다.

자동 색인은 기본 경로이고, 재색인은 자동 동기화가 놓친 상황을 복구하거나 인덱스를 다시 만들 필요가 있을 때 쓰는 보조 수단입니다.

7. Agent의 실수는 어떻게 기억이 되는가

Agent가 “다음부터 이러면 안 된다”라고 자기 메모에 적는 것만으로는 충분하지 않습니다. 그 메모는 왜 틀렸는지, 실제로 어떤 수정이 해결했는지, 재현과 Verification이 있었는지와 분리되어 있기 때문입니다.

PIB VIBE의 Experience는 가능한 한 상황 → 시도 → 실패 또는 성공 → 원인 → 해결 → 검증 근거의 구조를 가집니다. 그래야 다음 Agent가 비슷한 상황에서 “이전에도 이런 일이 있었다”를 넘어 “그때 무엇이 실제 원인이었고 어떻게 확인했는가”까지 활용할 수 있습니다.

여러 프로젝트와 상황에서 같은 패턴이 반복되면 그것을 더 일반적인 Strategy로 만들 수 있습니다. 이렇게 해야 한 번의 우연한 성공이 전체 Agent 행동을 잘못 바꾸는 일을 줄일 수 있습니다.

8. Claude ↔ Codex 연속성

Claude와 Codex는 서로의 대화를 그대로 이어받는 것이 아닙니다. 둘은 PIB VIBE라는 공통 기억 계층을 사용해 같은 WorkItem, BRIEF, Evidence, Verification, REPORT를 읽습니다.

따라서 “Claude가 조사하고 Codex가 구현”, “Codex가 문제를 발견하고 Claude가 설계를 수정” 같은 교대가 가능해집니다. 핵심은 Agent 간 대화 복사가 아니라 공통 작업 상태와 근거를 중심으로 이어받는 것입니다.

9. 백업과 복원

PIB VIBE의 WorkItem, Record, Experience 같은 내부 데이터는 장기간 누적되는 작업 자산입니다. 백업은 이 데이터를 안전한 snapshot으로 보존하고 복원할 수 있게 하는 역할을 합니다.

프로젝트 소스나 Knowledge 원본은 PIB VIBE 내부 DB와 성격이 다르므로 데이터 범위를 구분하는 것이 중요합니다. 실행 중인 SQLite 데이터베이스를 일반 클라우드 동기화 폴더에서 실시간으로 공유하는 방식은 권장하지 않습니다. 다른 PC에서는 검증된 snapshot을 복원하는 방식이 더 안전합니다.

10. 무엇을 믿어야 하는가

PIB VIBE는 기억을 강하게 만들수록 오히려 잘못된 기억을 정답처럼 믿는 위험도 커진다는 전제에서 출발해야 합니다. 그래서 좋은 기록은 단순히 내용이 풍부한 기록이 아니라 원문과 Verification까지 추적할 수 있는 기록입니다.

가능하면 WorkItem에서 Evidence로, Evidence에서 원문 위치로, 그리고 실제 Verification으로 이어지는 trace가 있어야 합니다. Agent의 자신감이나 과거 REPORT의 단정만으로 현재 상태를 확정하지 않습니다.

11. 실제 사용할 때 기억할 것

사용자 입장에서 PIB VIBE를 복잡하게 조작할 필요는 없습니다. 평소에는 Claude나 Codex에게 원하는 작업을 지시하면 되고, PIB VIBE는 뒤에서 관련 기록과 지식을 연결합니다. 다만 중요한 설계 변경에서는 BRIEF를 확인하고, 완료 판단에서는 실제 Verification이 있었는지를 보는 습관이 좋습니다.

PIB VIBE를 가장 잘 사용하는 방식은 “모든 걸 기억해”라고 요구하는 것이 아니라, 중요한 사실은 Knowledge로, 한 작업의 진행은 WorkItem으로, 검증된 시행착오는 Experience로, 반복 가능한 원칙은 Strategy로 남기는 것입니다.