프로젝트 지식 (Project Knowledge)
에이전트는 잊습니다. 새 세션마다 같은 컨벤션을 다시 발견하고, 같은 함정에 다시 빠지고, 누군가 이미 내린 결정을 다시 논의합니다. Project Knowledge는 프로젝트가 그런 지속적인 사실을 보관하는 곳입니다. 다음 에이전트가 다시 유도하는 대신 찾아보게 하려는 것입니다.
어려운 부분은 저장이 아닙니다. 틀린 항목이 맞는 항목만큼 쉽게 퍼지지 않게 하는 것입니다. 에이전트가 여기에 쓰는 모든 것은 확인되지 않은 candidate로 시작하고, 독립적인 무언가가 확인해 주기 전까지는 다른 에이전트에게 보이지 않습니다. 그 관문이 설계의 핵심입니다. 지식이 신뢰를 얻는 법을 보세요.
이것이 아닌 것. 타입이 있고 출처가 추적되는 프로젝트 사실 테이블입니다. 그래프 메모리나 시맨틱 메모리가 아닙니다. 관계나 시간 모델링이 들어 있지 않습니다. 그 단어들은 RelayRoom이 아직 갖고 있지 않은 시스템을 가리키므로, RelayRoom은 그 단어를 쓰지 않습니다.
루프
중요한 화살표는 대개의 메모리 기능이 빠뜨리는 두 개입니다. trusted 항목이 다음 recall로 되돌아오는 것이 루프를 복리로 만들고, 실패가 항목을 다시 밀어낼 수 있는 것이 그 복리가 거짓을 증폭하지 않게 막습니다.
네 가지 종류
모든 항목은 네 종류 중 하나입니다. 장식이 아니라, 에이전트가 좁혀서 물을 때 거는 필터입니다.
| 종류 | 용도 |
|---|---|
fact | 이 프로젝트에 대해 지속적으로 참인 것. "스테이징은 부팅 시 마이그레이션을 돌린다." |
convention | 이 프로젝트가 일을 처리하는 방식. "테스트는 test/ 트리가 아니라 파일 옆에 둔다." |
pitfall | 누군가 이미 빠진 함정. "풀러는 prepared statement를 못 쓴다." |
decision | 선택과 그 이유. 조용히 재론되지 않도록. |
네 가지 상태
| 상태 | 뜻 |
|---|---|
candidate | 기록됐지만 확인되지 않음. recall이 절대 돌려주지 않음. |
trusted | 확인됨. recall이 돌려주고, 서빙되는 playbook에 실릴 자격이 생김. |
contradicted | 무언가가 반박함. 즉시 recall에서 빠짐. |
retired | 만료됨. 유효기간이 있었고 그 기간이 끝남. |
candidate만 trusted가 될 수 있습니다. contradicted나 retired가 된 항목이 조용히 되살아나는 일은 없습니다. 만료 시각이 붙은 항목은 정리 작업이 retired로 표시하기 전에 이미 recall에서 빠집니다. 만료는 "이제 이 말을 반복하지 말라"는 누군가의 결정이므로, 정리 시점에만 존중하면 그 사이 내내 계속 반복하게 되기 때문입니다.
에이전트가 하는 일
MCP 도구 두 개, 그리고 측정을 위한 선택적인 세 번째 하나:
recall- 사소하지 않은 작업 전에.trusted항목만, 질의와의 유사도 순으로 돌려줍니다. 어떤 접근 등급이든 읽을 수 있습니다.learn- 남길 가치가 있을 때. 어떤 경로로도 항상candidate로 기록되며, 이를 건너뛰는 플래그는 없습니다. 프로젝트 쓰기 권한이 필요합니다.recall_used- 돌려받은 항목이 실제로 판단에 영향을 줬다고 보고합니다. 선택 사항이고 부르지 않아도 아무것도 깨지지 않습니다. recall 품질을 추정이 아니라 측정으로 만들기 위해 존재합니다. Learning 패널 읽는 법을 보세요.
파라미터는 MCP 도구에 있습니다.
에이전트는 항목을 반박할 수도 있습니다. detail.contradicts를 담은 error 타입 event가 반박을 기록하고 지목된 항목을 강등시킵니다. 에이전트가 신뢰를 움직일 수 있는 유일한 방향이며, 이는 의도된 것입니다.
어디서 보이나
대시보드의 프로젝트 Knowledge 탭이 모든 항목을 상태·종류·출처와 함께, 그리고 몇 개의 독립적인 이슈어가 그 항목을 지지하는지와 함께 보여줍니다. 오너가 candidate를 확인하는 곳도 여기입니다. 지식 검토하기를 보세요.
프로젝트에 trusted 항목이 충분히 쌓이면 상위 항목들이 허브가 서빙하는 RELAYROOM.md에도 덧붙습니다. 에이전트가 묻지 않아도 보이게 됩니다. RELAYROOM.md를 보세요.
다음
- 지식이 신뢰를 얻는 법 - 승격 규칙과, 그 규칙이 왜 그렇게 생겼는지.
- 지식 검토하기 - 오너 쪽 화면.
- CI attestation - 그린 빌드가 주장을 확인하게 하기.