도움말:S3 연구 메모리/메모 사용법
이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.
S3 연구 메모리는 프로젝트 일지나 실험 원본을 모으는 곳이 아닙니다. 다른 작업에서도 다시 참고할 만한 시행착오를 짧은 메모로 남깁니다.
먼저 검색하기
브라우저에서는 Special:Search, 에이전트에서는 search_lessons를 사용합니다. 프로젝트 이름보다 현상과 원인을 나타내는 말로 찾는 편이 잘 맞습니다.
메모리 단편화, retry storm, lock contention, cold start
같은 내용이 이미 있으면 새 메모를 만들지 않습니다. 기존 메모에 자료를 더하거나, 내용이 다른 이유를 관계로 연결하면 됩니다.
브라우저에서 메모 쓰기
로그인한 뒤 다음 화면을 엽니다.
/index.php/연구_메모리#create-a-lesson
문서 ID에는 영문 소문자, 숫자, 밑줄, 하이픈만 씁니다. Lesson:은 입력하지 않습니다.
gpu_allocator_fragmentation
문서 ID는 에이전트가 메모를 인용할 때도 쓰므로 날짜, 사람 이름, 프로젝트에서만 통하는 줄임말은 피하세요. 화면에 보이는 제목은 나중에 바꿀 수 있습니다.
입력란에는 다음 내용을 적습니다.
| 화면 | 필드 | 적을 내용 |
|---|---|---|
| 제목 | title |
메모의 결론이 드러나는 짧은 제목 |
| 궁금했던 점 | question |
시도를 시작한 이유 |
| 해본 것 | attempt |
실제로 바꿨거나 비교한 것 |
| 당시 조건 | context |
장비, 버전, 설정, 워크로드 등 결과에 영향을 준 조건 |
| 실제 결과 | observation |
직접 확인한 수치나 동작 |
| 왜 그랬는지 | interpretation |
가능한 원인과 아직 확실하지 않은 부분 |
| 다음에 기억할 것 | reusable_lesson |
다른 작업에서도 써먹을 한 문장 |
| 언제 맞는지 | applicability |
맞는 조건과 예외 |
| 신뢰도 | confidence |
자료의 질에 따라 low, medium, high 중 선택
|
| 관련 자료 | evidence |
아래에 연결할 자료를 짧게 설명 |
| 자료 출처 | record_origin |
직접 얻은 내용은 lab, 외부 자료를 정리했으면 imported
|
관찰과 해석은 나눠 쓰세요. 예를 들어 동시 compaction 16개에서 p99가 18 ms에서 71 ms로 늘었다는 관찰입니다. 공유 writeback 제한 때문에 queue가 묶였다는 해석이며, 새 자료가 나오면 달라질 수 있습니다.
저장한 메모는 바로 검색되고 메인 화면의 최근 메모에도 나타납니다.
자료 연결하기
메모마다 자료를 하나 이상 연결합니다. 원본 전체를 위키에 복사하지 말고 나중에 다시 찾을 수 있는 위치를 적으세요.
| 입력란 | 내용 |
|---|---|
| 자료 ID | 메모 안에서 겹치지 않는 짧은 ID |
| 출처 | 저장소, 커밋, 실행 ID, 문서 절, 시간 구간 등 |
| URL | 바로 열 수 있는 주소가 있을 때만 입력 |
| 자료 종류 | paper, code, dataset, log, benchmark, other 중 선택
|
| 메모 | 이 자료에서 확인할 부분과 한계 |
git yonsei-s3/kernel-probes@4f19a2e, results/lockstat/run-031/summary.json
latest, 대시보드, 작성자만 아는 로컬 경로처럼 시간이 지나면 찾기 어려운 표현은 피합니다. 비밀번호, 토큰, 개인 정보, 공개할 수 없는 대화, 대용량 원시 데이터도 본문에 넣지 않습니다.
다른 메모와 연결하기
관계는 출발 메모 관계값 대상 메모 순서로 읽습니다.
| 관계 | 뜻 |
|---|---|
supports |
대상 메모와 맞는 자료나 원인을 보탬 |
contradicts |
대상 메모의 주요 주장과 관찰이 충돌함 |
analogous_to |
분야는 달라도 같은 원인이나 실패 형태를 보임 |
failed_because |
대상 메모에 적힌 이유로 시도가 실패함 |
works_when |
대상 메모의 조건에서 방법이 잘 작동함 |
suggests |
다음 가설이나 시도를 제안함 |
supersedes |
새 메모가 이전 안내를 대신함. 상태는 자동으로 바뀌지 않음 |
연결 이유에는 두 메모가 닮거나 충돌하는 지점을 한두 문장으로 씁니다. 관련성이 애매하면 억지로 연결하지 않아도 됩니다.
메모 고치기
메모 화면에서 메모 편집을 누릅니다. 잘못 적은 수치나 해석을 고치고, 수정 요약에 이유를 짧게 남기세요. 이전 내용은 MediaWiki 이력에서 확인할 수 있습니다.
MCP로 찾기
처음에는 결과를 3~5개만 받고 필요한 필드만 요청하는 편이 빠릅니다.
S3 Research Memory에서 tail latency와 관련된 메모를 최대 5개 찾아 줘. id, title, reusable_lesson, applicability, confidence, citations만 반환해.
후보를 고른 뒤 get_lesson으로 자세히 읽고, 관계는 find_related_lessons, 다른 분야의 비슷한 사례는 find_analogies로 찾습니다. 답변에 메모를 사용했다면 반환된 자료 인용도 같이 보관하세요.
에이전트에게 작성을 맡길 때
에이전트는 create_lesson_draft, link_lessons, attach_evidence만 쓸 수 있습니다. 에이전트가 만든 메모도 저장 즉시 검색됩니다. 상태 변경, 삭제, 이동, 관리자 작업은 MCP에서 할 수 없습니다.
자료 위치와 확인한 사실을 먼저 제공하고 다음을 요청하세요.
- 같은 메모가 있는지 먼저 검색
- 관찰과 해석을 분리
- 맞는 조건과 예외를 명시
- 자료를 추측하지 않기
- 작업이 끝나면
Lesson:ID 반환
반환된 ID를 브라우저에서 열어 내용과 자료 위치를 확인합니다. 틀린 부분은 메모 편집에서 바로 고칩니다.
도구 입력과 응답 형식은 MCP 클라이언트 안내, 필드와 관계의 기계 계약은 아키텍처에 있습니다.