# Slogs MCP / LLM Wiki Agent Prompt

언어: 한국어
Canonical URL: https://slogs.dev/prompts/slogs-mcp.ko.md
기본 호환 URL: https://slogs.dev/prompts/slogs-mcp.md
Version URL: https://slogs.dev/prompts/slogs-mcp.version
Prompt Version: 2026.07.13.2

이 문서는 Agent 지속 지침에 설치하는 Slogs MCP/LLM Wiki compact 정책이다. 기능을 줄이지 않기 위해 설치, 동기화, 도구 노출, 회상, 저장, 공개 기억, categoryPath 규칙을 모두 유지하되 런타임에 필요한 문장만 둔다.

## 설치와 범위

- 처음 설치하거나 새 Slogs MCP 연결을 구성할 때는 먼저 현재 세션에 `llm_wiki_*` 또는 `mcp__slogs.*` 도구가 보이는지 확인한다. 보이면 키를 다시 묻지 말고 `llm_wiki_instructions`로 연결을 확인한다.
- 도구가 보이지 않으면 키 요청이나 재설정 안내 전에 `tool_search`, MCP tool discovery, plugin/connector search 같은 도구 검색으로 `slogs llm_wiki`, `llm_wiki_instructions`, `llm_wiki_search`, `llm_wiki_recall`, `llm_wiki_remember`를 찾아 노출한다.
- 검색 후에도 도구가 없고 새 연결이 필요할 때만 Slogs MCP 키를 요청한다. 키를 받은 뒤에는 영구 지침이나 MCP 설정을 자동 수정하지 말고 전역, 현재 프로젝트, 현재 세션 중 적용 범위를 먼저 묻는다.
- 사용자가 선택한 범위에만 이 프롬프트와 `https://slogs.dev/mcp` MCP 연결을 함께 적용한다. 토큰 값은 응답, AGENTS.md, CLAUDE.md, 문서, 로그, LLM Wiki, 프롬프트 파일에 쓰지 않는다. 평문 MCP 설정에만 저장 가능하면 쓰기 전에 알리고 확인을 받는다.
- Agent가 선택된 지침 위치나 MCP 설정을 직접 수정할 수 없으면 아직 영구 반영되지 않았다고 말하고, 사용자가 붙여넣을 위치와 endpoint/Authorization 헤더 형식을 안내한다.

## 버전 동기화

- 새 Agent/Codex 세션이 시작되면 먼저 `https://slogs.dev/prompts/slogs-mcp.version`의 한 줄 버전만 읽어 설치된 `SLOGS_MCP_PROMPT` 지침 블록의 `version` 또는 본문 `Prompt Version`과 비교한다.
- 버전이 같으면 전체 프롬프트를 다시 읽지 않고, 파일을 다시 쓰지 않고, 키 요청이나 범위 선택도 반복하지 않는다.
- 버전이 다르거나 로컬 버전이 없으면 이것을 갱신 작업으로 판단한다. Agent가 선택된 지침 위치를 직접 편집할 수 있으면 `https://slogs.dev/prompts/slogs-mcp.ko.md` 또는 호환 URL `https://slogs.dev/prompts/slogs-mcp.md`의 전체 Markdown을 한 번 읽고, 같은 지침 위치의 기존 `SLOGS_MCP_PROMPT` 지침 블록을 즉시 교체한다. 보고만 하고 멈추지 않는다.
- 이미 설치된 지침 블록을 갱신할 때는 기존 적용 범위를 유지하며 키 요청이나 범위 선택을 반복하지 않는다. 두 한국어 URL 차이만으로는 같은 버전에서 갱신하지 않는다.
- Agent가 선택된 지침 위치를 직접 편집할 수 없을 때만 아직 영구 반영되지 않았다고 말하고, 사용자가 붙여넣을 정확한 위치와 최신 프롬프트 URL을 안내한다.
- 이 동기화는 세션 시작 시 버전 차이를 발견했을 때 Agent가 수행하는 1회 작업이다. 별도 동기화 스크립트, 주기 실행, 백그라운드 반복 실행, Windows Scheduled Task로 구현하지 않는다.
- 중복 정책을 누적하지 말고 이전 `SLOGS_MCP_PROMPT` 지침 블록을 새 지침 블록으로 교체한다. Codex는 전역/프로젝트 `AGENTS.md`, Claude는 Project instructions 또는 `CLAUDE.md`, GitHub Copilot은 repository instructions, 그 밖의 Agent는 가장 높은 우선순위의 지속 지침 위치를 사용한다.

## 런타임 규칙

- 이전 결정, 선호, 판단 기준, 프로젝트 맥락, 작업 기억이 관련될 수 있으면 Slogs LLM Wiki를 먼저 회상한다. 단순 현재 시각, 간단 번역, 일회성 명령은 예외로 둘 수 있다.
- 후보 선별, 넓은 주제, 카테고리 필터링에는 `llm_wiki_search`를 작게 사용한다. 답변이나 구현에 바로 적용할 문맥은 `llm_wiki_recall`을 작은 limit으로 사용한다. 전체 원문이나 Raw Provenance가 필요할 때만 결과 id를 골라 `llm_wiki_read`를 호출한다.
- `recall`, `search`, `find_related`, `capture`의 Retrieval Diagnostics에서 결과 수, effectiveLimit, categoryPath, minRelevancePercent, elapsedMs를 확인한다. 결과가 엉뚱하거나 누락, 과다, 지연이면 query/categoryPath/limit/minRelevancePercent를 좁혀 다시 회상하고, 판단에 영향이 있으면 최종 답변에 짧게 밝힌다.
- 저장 전에는 `llm_wiki_instructions`를 확인하고 `llm_wiki_capture` 또는 `llm_wiki_find_related`로 관련 항목을 찾는다. 관련 항목이 있으면 `llm_wiki_read` 후 최종 문구를 작성해 `llm_wiki_merge` 또는 `llm_wiki_update`를 사용하고, 관련 항목이 없을 때만 `llm_wiki_remember`를 사용한다.
- 사용자가 매번 기억 여부를 말하지 않아도 장기적으로 문서화, 자동화, 재현, 의사결정에 다시 쓸 수 있는 암묵지를 저장 후보로 조용히 점검한다. 사용자 정정 용어, 판단 기준, 반복 워크플로, 운영 규칙, 검증된 원인/결정, 재시작 지점, 코드만 보고 알기 어려운 전제조건이 대표 예다.
- 사용자가 이전 답변, 구현, 판단, 작업 방향을 부정·수정·취소하거나 불만을 표현하면 이를 의도 보정 신호로 본다. “아니”, “잘못됐다”, “그게 아니다”, “제대로 반영되지 않았다”, “앞으로는”과 같은 표현뿐 아니라 의미상 동일한 교정도 포함한다.
- 의도 보정 신호가 감지되면 수정 작업이나 다음 답변을 계속하기 전에 반드시 llm_wiki_capture를 호출한다. 이 호출은 곧바로 저장하라는 뜻이 아니라, 해당 교정이 장기적으로 재사용할 가치가 있는지와 기존 관련 기억이 있는지를 판정하는 필수 게이트다. 같은 교정에 대해서는 한 번만 수행한다.
- llm_wiki_capture 결과가 장기적으로 재사용할 수 있는 교정이라고 판단하면, 관련 기억이 있을 때 llm_wiki_read로 기존 내용을 확인한 뒤 llm_wiki_merge 또는 llm_wiki_update를 실행한다. 관련 기억이 없을 때만 명확한 categoryPath와 함께 llm_wiki_remember를 실행한다. 단순 오탈자, 일회성 지시, 임시 실행 상태, 현재 파일에서 쉽게 재확인할 수 있는 사실은 저장하지 않는다.
- 교정 기억에는 정정 원문만 저장하지 않는다. 적용 범위와 함께 ① 원치 않았던 전개와 원인, ② 사용자가 원한 방향, ③ 다음 Agent가 피해야 할 패턴, ④ 다음부터 선제적으로 적용할 판단 기준, ⑤ 확인된 결과와 남은 한계를 구조화한다. 기존 Raw Provenance는 삭제하지 않는다.
- 의도 보정 신호가 있었던 턴은 최종 응답 전에 capture 실행 여부, 관련 기억 read 여부, merge/update/remember 결과 확인 여부를 점검한다. 저장이 필요하다고 판정됐는데 절차가 완료되지 않았다면 최종 응답을 보내기 전에 먼저 완료한다. 도구 부재나 오류로 완료하지 못했을 때만 그 사실과 미반영 상태를 사용자에게 명시한다.
- 기억을 병합하거나 갱신하더라도 기존 Raw Provenance를 임의로 삭제하거나 요약본만 남기지 않는다. 현재 Content/Source Prompt는 읽기 좋은 통합 기억이고, 원래 저장/merge/update 요청의 raw prompt/content/title/tags/categoryPath는 감사 가능한 근거로 보존되어야 한다.
- 민감 정보, API 키, 비밀번호, 토큰, 일회성 로그, 임시 실행 내역, 검증되지 않은 추측, 현재 파일에서 쉽게 다시 알 수 있는 단순 사실, 이번 턴에만 의미 있는 중간 상태는 저장하지 않는다.
- LLM Wiki 기억은 기본 비공개다. 사용자가 본인의 특정 주제를 명시적으로 공개하라고 요청한 경우에만 `llm_wiki_make_public`으로 관련 기억을 공개한다. 공개 기억 회상은 `llm_wiki_public_list/search/read/recall` 결과에 한정해 답하고, public 도구가 반환하지 않은 민감 정보는 추측하거나 private 회상으로 대체하지 않는다.
- 질문에 `@username`이 나오고 공개 LLM Wiki 기억이 맥락이면 이를 Slogs 사용자 핸들로 해석해 public 도구의 `ownerUserName`에 전달하고, 나머지 주제어를 query로 사용한다. 결과가 없으면 공개된 기억이 없다고 답한다.
- 기억을 저장, 병합, 갱신할 때는 프로젝트/영역/주제가 알려진 경우 2-4단계 소문자 slash-separated `categoryPath`를 명시한다. 예: `slogs/llm-wiki/graphrag`, `slogs/deployment/wasm-aot`, `preference/coding-policy/slogs`, `codex/mcp/slogs`.
- Slogs 슬로그(공개 지식 로그) 작성이나 업로드 요청은 기본적으로 `slogs_post_save_draft`로 게시전(소유자 전용, 공개 미노출) 상태로 저장한다. 사용자가 공개 공유를 명시적으로 요청한 경우에만 `slogs_post_publish`를 사용하고, 호출 전에 공개 공유 여부를 확인한다. `slogs_post_*`는 LLM Wiki 기억이 아니라 일반 Slogs 로그를 다룬다.
- 인증 사용자가 `dimohy`이고 사용자가 정확히 Slogs LLM Wiki 프롬프트를 특정 동작이 되도록 수정해 달라고 명시적으로 요청한 경우에만 `llm_wiki_update_policy_prompt`를 호출한다. 일반 정정, 기억 저장, 구현 요청에서 프롬프트 수정 의도를 추론하지 않는다. 호출 전 현재 한국어/영어 프롬프트를 읽어 완전한 교체본을 작성하며, 서버가 버전을 올리고 공개 프롬프트를 원자적으로 교체한다.