지식

지식 탭: 프로젝트의 모든 메모리가 관련된 C4 요소 주위에 모여 있는 모습

지식 탭은 프로젝트의 공유 메모리를 하나의 지도로 보여 줍니다. 메모리는 코드가 알려 주지 못하는 것입니다. 누군가 프로덕션에서 겪은 함정, 팀이 합의한 규칙, 에이전트가 작업 세션을 마치며 남긴 메모 같은 것들이죠. 사람은 앱에서 작성하고, 에이전트는 harness(remember, finish_work_session)를 통해 작성합니다. 둘 다 같은 곳에 저장되며, 시스템의 같은 부분을 다루는 다음 에이전트에게 제공됩니다.

프로젝트 헤더(지식), 명령 팔레트, 또는 누군가 공유한 링크로 열 수 있습니다.

지도 읽기

  • 요소는 고리입니다. 지식이 다루는 C4 시스템, 컨테이너, 컴포넌트를 나타냅니다. 각 메모리는 고정된 요소 주위에 놓입니다.
  • 메모리는 점이며, 종류별로 색이 다릅니다: 함정, 규칙, 메모. 안쪽에 밝은 고리가 있는 점은 사람이 작성한 것이고, 나머지는 에이전트가 작성한 것입니다.
  • 결정(ADR)은 사각형이며, 메모리가 [[ADR-12]]처럼 링크하면 연결됩니다.
  • 점선 고스트는 아직 아무도 작성하지 않은 링크입니다. 어떤 메모리가 [[Rate limits]]를 언급하지만 그 제목의 메모리가 없는 경우입니다. 클릭하면 작성할 수 있습니다.

메모리가 수천 개가 되어도 지도는 읽기 쉽게 유지됩니다. 같은 사실을 말하는 메모리는 하나의 점으로 접히며, 세 개의 사본이 같은 내용이면 ×3으로 표시됩니다. 세션 결과는 기본적으로 숨겨져 있고 해당 요소에 개수로 표시됩니다. 도구 모음의 세션 버튼으로 켤 수 있습니다. 종류 범례는 필터 역할도 하며, 하단의 타임라인은 지식이 어떻게 쌓여 왔는지 다시 보여 줍니다.

점을 클릭하면 링크와 백링크를 포함해 메모리 전체를 읽을 수 있습니다. 요소를 클릭하면 거기에 고정된 모든 것을 보고, 그 요소에 대한 다음 메모리를 작성할 수 있습니다.

키보드: / 검색, N 메모리 작성, F 지도 전체 보기, Esc 한 단계 뒤로.

질문하기

프로젝트 메모리만으로 작성된 답변과, 그 근거가 된 메모리가 지도에 강조된 모습

검색 상자에 질문을 입력하고 질문을 누르세요(물음표 뒤에 Enter를 눌러도 됩니다). 답변은 프로젝트의 메모리만으로 작성되며, 에이전트와 같은 검색 방식을 사용합니다: 단어와 의미, 그리고 가장 잘 맞는 결과에 링크된 메모리까지. 모든 주장에는 출처가 번호로 표시되며, 번호를 클릭하면 지도에서 해당 메모리를 찾을 수 있고 인용된 메모리는 강조 표시됩니다.

해당 주제에 대해 메모리에 아무것도 없으면, 답변은 추측하지 않고 그렇다고 알려 줍니다. 바로 그때가 사실을 기록할 순간입니다. 다음 사람과 다음 에이전트가 그것을 찾게 됩니다. 사용할 수 있는 AI 제공자가 없으면 답변 대신 가장 가까운 메모리가 표시됩니다. 질문은 에이전트에게 메모리를 제공한 것으로 집계되지 않으므로, 아래에서 설명하는 사용량 수치를 왜곡하지 않습니다.

답변은 다른 harness 기능과 마찬가지로 조직의 AI 제공자를 사용합니다.

모순

프로젝트가 이미 알고 있는 사실과 어긋나는 사실을 작성하는 모습

같은 요소에 대한 기존 메모리와 거의 같지만 다른 숫자를 말하는 메모리("8번 재시도" 대 "3번 재시도")를 작성하면, Archyl은 대화 상자를 닫기 전에 멈추고 둘을 함께 보여 줍니다. 서로 모순되는 두 개의 활성 메모리는 에이전트에게 제공될 수 있는 최악의 것이므로, 직접 선택합니다:

  • 이전 메모리 대체: 이전 메모리는 기록으로 이동합니다. 에이전트는 더 이상 보지 않으며, 지도에서는 대체한 메모리와 연결된 고스트로 남습니다.
  • 둘 다 유지: 둘 다 맞는 경우(두 환경, 두 테넌트 등) 둘 다 유지하고 차이를 명시하세요.
  • 내 메모리 삭제: 틀린 쪽이 내 메모리였던 경우입니다.

이미 있는 사실을 글자 그대로 다시 작성하면 두 번째 사본이 저장되지 않습니다. 대신 기존 메모리가 확인 처리되고, 대화 상자가 그 사실을 알려 줍니다. 에이전트도 API를 통해 같은 처리를 받으며, remember의 deduplicated와 conflicts 필드로 결과를 받습니다.

어떤 사실이든 링크하기

모든 메모리와 요소에는 고유한 주소가 있습니다. 읽기 패널의 링크로 주소를 복사할 수 있습니다. 풀 리퀘스트, ADR, Slack 스레드에 붙여 넣으면 해당 메모리와 이웃 메모리를 중심으로 지도가 열립니다. 메모리에 대한 링크는 중복 항목과 병합된 뒤에도 계속 작동하며, 이후 대체된 메모리에 대한 링크는 기록 보기를 열어 어디로든 도착하게 합니다.

중복 항목

에이전트가 같은 사실을 여러 방식으로 작성하면, 중복 항목 버튼이 각 그룹을 보여 줍니다. 하나로 병합은 가장 많이 확인된 사본을 남기고, 나머지는 은퇴시키며, 그 링크를 옮깁니다. 병합은 항상 사용자가 결정합니다. 서로 다른 두 요소에 대한 비슷한 표현이나 숫자가 다른 경우는 결코 중복으로 제안되지 않습니다.

재확인 필요

확인 이후 요소가 바뀐 메모리와 에이전트가 전혀 사용하지 않는 메모리

아무도 재확인하지 않는 메모리는 조용히 틀려집니다. 지도의 재확인 필요 보기는 사람이 살펴봐야 하는 메모리만 선명하게 남기고, 목록으로 보여 줍니다:

  • 요소가 바뀜: 메모리가 마지막으로 확인된 뒤 요소 아래의 코드가 달라졌습니다. 에이전트는 계속 이 메모리를 받지만 확인 필요로 표시됩니다. 여전히 맞다면 여전히 맞음으로 확인해 표시를 지우고, 그렇지 않다면 열어서 수정하거나 대체하세요.
  • 에이전트가 사용하지 않음: 다섯 번 이상의 세션에 제공되었지만 어떤 세션도 도움이 되었다고 하지 않았습니다. 열어서 더 명확하게 다듬거나, 올바른 요소에 고정하거나, 삭제하세요.

이 목록에서 자동으로 제거되는 것은 없습니다. 같은 항목이 주간 다이제스트로도 팀에 전달되므로, 누군가 탭을 열어야만 목록이 확인되는 것은 아닙니다.

사용량

에이전트에게 제공된 횟수에 따라 크기가 달라지는 메모리. 속이 빈 것은 제공되었지만 한 번도 사용되지 않은 것

사용량 보기는 각 메모리의 크기를 그 메모리가 제공된 에이전트 세션 수에 따라 정합니다. 속이 찬 점은 한 번 이상 사용된 것(에이전트가 세션을 마치며 usedMemories에 명시한 것), 속이 빈 점은 제공되었지만 사용되지 않은 것, 흐린 점은 한 번도 제공되지 않은 것입니다. 어떤 지식이 실제로 에이전트의 작업을 떠받치고 있고 어떤 것이 잡음인지, 두 가지 질문에 한눈에 답해 줍니다.

권한

프로젝트를 볼 수 있는 사람은 누구나 지도를 읽고 질문할 수 있습니다. 메모리 작성, 확인, 병합, 대체, 삭제에는 프로젝트 편집 권한이 필요합니다.