S3Admin: S3 연구 메모리 저장소 문서 게시

2026-07-16T13:03:04Z

S3 연구 메모리 저장소 문서 게시

새 문서

''이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.''

S3 연구 메모리는 프로젝트 일지나 실험 원본을 모으는 곳이 아닙니다. 다른 작업에서도 다시 참고할 만한 시행착오를 짧은 메모로 남깁니다.

=== 먼저 검색하기 ===

브라우저에서는 <code><nowiki>Special:Search</nowiki></code>, 에이전트에서는 <code><nowiki>search_lessons</nowiki></code>를 사용합니다. 프로젝트 이름보다 현상과 원인을 나타내는 말로 찾는 편이 잘 맞습니다.

<pre><nowiki>
메모리 단편화, retry storm, lock contention, cold start
</nowiki></pre>

같은 내용이 이미 있으면 새 메모를 만들지 않습니다. 기존 메모에 자료를 더하거나, 내용이 다른 이유를 관계로 연결하면 됩니다.

=== 브라우저에서 메모 쓰기 ===

로그인한 뒤 다음 화면을 엽니다.

<pre><nowiki>
/index.php/연구_메모리#create-a-lesson
</nowiki></pre>

문서 ID에는 영문 소문자, 숫자, 밑줄, 하이픈만 씁니다. <code><nowiki>Lesson:</nowiki></code>은 입력하지 않습니다.

<pre><nowiki>
gpu_allocator_fragmentation
</nowiki></pre>

문서 ID는 에이전트가 메모를 인용할 때도 쓰므로 날짜, 사람 이름, 프로젝트에서만 통하는 줄임말은 피하세요. 화면에 보이는 제목은 나중에 바꿀 수 있습니다.

입력란에는 다음 내용을 적습니다.

{| class="wikitable"
! 화면 !! 필드 !! 적을 내용
|-
| 제목 || <code><nowiki>title</nowiki></code> || 메모의 결론이 드러나는 짧은 제목
|-
| 궁금했던 점 || <code><nowiki>question</nowiki></code> || 시도를 시작한 이유
|-
| 해본 것 || <code><nowiki>attempt</nowiki></code> || 실제로 바꿨거나 비교한 것
|-
| 당시 조건 || <code><nowiki>context</nowiki></code> || 장비, 버전, 설정, 워크로드 등 결과에 영향을 준 조건
|-
| 실제 결과 || <code><nowiki>observation</nowiki></code> || 직접 확인한 수치나 동작
|-
| 왜 그랬는지 || <code><nowiki>interpretation</nowiki></code> || 가능한 원인과 아직 확실하지 않은 부분
|-
| 다음에 기억할 것 || <code><nowiki>reusable_lesson</nowiki></code> || 다른 작업에서도 써먹을 한 문장
|-
| 언제 맞는지 || <code><nowiki>applicability</nowiki></code> || 맞는 조건과 예외
|-
| 신뢰도 || <code><nowiki>confidence</nowiki></code> || 자료의 질에 따라 <code><nowiki>low</nowiki></code>, <code><nowiki>medium</nowiki></code>, <code><nowiki>high</nowiki></code> 중 선택
|-
| 관련 자료 || <code><nowiki>evidence</nowiki></code> || 아래에 연결할 자료를 짧게 설명
|-
| 자료 출처 || <code><nowiki>record_origin</nowiki></code> || 직접 얻은 내용은 <code><nowiki>lab</nowiki></code>, 외부 자료를 정리했으면 <code><nowiki>imported</nowiki></code>
|}

관찰과 해석은 나눠 쓰세요. 예를 들어 <code><nowiki>동시 compaction 16개에서 p99가 18 ms에서 71 ms로 늘었다</nowiki></code>는 관찰입니다. <code><nowiki>공유 writeback 제한 때문에 queue가 묶였다</nowiki></code>는 해석이며, 새 자료가 나오면 달라질 수 있습니다.

저장한 메모는 바로 검색되고 메인 화면의 최근 메모에도 나타납니다.

=== 자료 연결하기 ===

메모마다 자료를 하나 이상 연결합니다. 원본 전체를 위키에 복사하지 말고 나중에 다시 찾을 수 있는 위치를 적으세요.

{| class="wikitable"
! 입력란 !! 내용
|-
| 자료 ID || 메모 안에서 겹치지 않는 짧은 ID
|-
| 출처 || 저장소, 커밋, 실행 ID, 문서 절, 시간 구간 등
|-
| URL || 바로 열 수 있는 주소가 있을 때만 입력
|-
| 자료 종류 || <code><nowiki>paper</nowiki></code>, <code><nowiki>code</nowiki></code>, <code><nowiki>dataset</nowiki></code>, <code><nowiki>log</nowiki></code>, <code><nowiki>benchmark</nowiki></code>, <code><nowiki>other</nowiki></code> 중 선택
|-
| 메모 || 이 자료에서 확인할 부분과 한계
|}

<pre><nowiki>
git yonsei-s3/kernel-probes@4f19a2e, results/lockstat/run-031/summary.json
</nowiki></pre>

<code><nowiki>latest</nowiki></code>, <code><nowiki>대시보드</nowiki></code>, 작성자만 아는 로컬 경로처럼 시간이 지나면 찾기 어려운 표현은 피합니다. 비밀번호, 토큰, 개인 정보, 공개할 수 없는 대화, 대용량 원시 데이터도 본문에 넣지 않습니다.

=== 다른 메모와 연결하기 ===

관계는 <code><nowiki>출발 메모 관계값 대상 메모</nowiki></code> 순서로 읽습니다.

{| class="wikitable"
! 관계 !! 뜻
|-
| <code><nowiki>supports</nowiki></code> || 대상 메모와 맞는 자료나 원인을 보탬
|-
| <code><nowiki>contradicts</nowiki></code> || 대상 메모의 주요 주장과 관찰이 충돌함
|-
| <code><nowiki>analogous_to</nowiki></code> || 분야는 달라도 같은 원인이나 실패 형태를 보임
|-
| <code><nowiki>failed_because</nowiki></code> || 대상 메모에 적힌 이유로 시도가 실패함
|-
| <code><nowiki>works_when</nowiki></code> || 대상 메모의 조건에서 방법이 잘 작동함
|-
| <code><nowiki>suggests</nowiki></code> || 다음 가설이나 시도를 제안함
|-
| <code><nowiki>supersedes</nowiki></code> || 새 메모가 이전 안내를 대신함. 상태는 자동으로 바뀌지 않음
|}

연결 이유에는 두 메모가 닮거나 충돌하는 지점을 한두 문장으로 씁니다. 관련성이 애매하면 억지로 연결하지 않아도 됩니다.

=== 메모 고치기 ===

메모 화면에서 '''메모 편집'''을 누릅니다. 잘못 적은 수치나 해석을 고치고, 수정 요약에 이유를 짧게 남기세요. 이전 내용은 MediaWiki 이력에서 확인할 수 있습니다.

=== MCP로 찾기 ===

처음에는 결과를 3~5개만 받고 필요한 필드만 요청하는 편이 빠릅니다.

<pre><nowiki>
S3 Research Memory에서 tail latency와 관련된 메모를 최대 5개 찾아 줘.
id, title, reusable_lesson, applicability, confidence, citations만 반환해.
</nowiki></pre>

후보를 고른 뒤 <code><nowiki>get_lesson</nowiki></code>으로 자세히 읽고, 관계는 <code><nowiki>find_related_lessons</nowiki></code>, 다른 분야의 비슷한 사례는 <code><nowiki>find_analogies</nowiki></code>로 찾습니다. 답변에 메모를 사용했다면 반환된 자료 인용도 같이 보관하세요.

=== 에이전트에게 작성을 맡길 때 ===

에이전트는 <code><nowiki>create_lesson_draft</nowiki></code>, <code><nowiki>link_lessons</nowiki></code>, <code><nowiki>attach_evidence</nowiki></code>만 쓸 수 있습니다. 에이전트가 만든 메모도 저장 즉시 검색됩니다. 상태 변경, 삭제, 이동, 관리자 작업은 MCP에서 할 수 없습니다.

자료 위치와 확인한 사실을 먼저 제공하고 다음을 요청하세요.

* 같은 메모가 있는지 먼저 검색
* 관찰과 해석을 분리
* 맞는 조건과 예외를 명시
* 자료를 추측하지 않기
* 작업이 끝나면 <code><nowiki>Lesson:</nowiki></code> ID 반환
반환된 ID를 브라우저에서 열어 내용과 자료 위치를 확인합니다. 틀린 부분은 '''메모 편집'''에서 바로 고칩니다.

도구 입력과 응답 형식은 [[Help:S3 연구 메모리/MCP 클라이언트|MCP 클라이언트 안내]], 필드와 관계의 기계 계약은 [[Help:S3 연구 메모리/아키텍처|아키텍처]]에 있습니다.

도움말:S3 연구 메모리/메모 사용법 - 편집 역사

S3Admin: S3 연구 메모리 저장소 문서 게시