여러분은 매일의 회고를 잘 하고 계신가요?

AI에게 상담하는 일이 늘어나면서, 어떤 내용을 상담하여 결정했는지, 이번 주에는 어떤 일들이 진행되었는지 추적하기 어려워지고 있다고 생각합니다.

여러 개의 터미널에서 병렬로 작업을 수행하면 작업 밀도가 높아져, 스스로도 어떤 컨텍스트(Context)에서 작업을 수행했는지 알 수 없게 될 것입니다.

채팅 이력을 거슬러 올라가면 기록은 남아 있겠지만, 여러 대의 PC나 여러 도구를 넘나들게 되면 금세 추적할 수 없게 됩니다. kioku-mesh를 사용하면 AI 에이전트가 남긴 관측(Observation)을 횡단 검색할 수 있으므로, "지난주의 decision을 전부 출력해줘", "오늘 버그를 수정한 기록을 찾아줘"와 같은 회고를 명령어 하나로 수행할 수 있습니다.

AI와의 작업 기록을 추적하기 어려운 이유

Pull Request(PR)나 Issue는 GitHub에 남습니다. 하지만 그 과정에서 AI에게 무엇을 상담했는지, 어떤 논의를 했는지, 왜 그 구현 방식을 선택했는지는 채팅 이력에만 남습니다.

• 다른 PC로 옮기면 이력을 불러올 수 없음
• 여러 에이전트(Claude Code + Codex CLI 등)를 사용하면 기록이 분산됨
• "그때 왜 이렇게 결정했었지?"를 나중에 추적할 수 없음

kioku-mesh는 에이전트가 save_observation을 통해 결정(Decision)·버그 수정·깨달음을 저장해둠으로써, 이 "AI와의 대화 기록"을 횡단 검색할 수 있는 공유 풀(Pool)을 만듭니다.

search_memory로 회고하기

kioku-mesh의 search_memory에는 since_iso 파라미터가 있어, 기간을 지정하여 관측을 가져올 수 있습니다.

# 오늘의 관측 확인
kioku-mesh search --since today
# 지난주의 decision만 필터링
...

MCP를 통해 Claude Code에서 호출하면 다음과 같이 기록이 나옵니다.

[decision][3] 2026-06-03T05:16:00Z (kioku-mesh) Dockerfile을 Glama 등록용으로 추가하는 방침
[bug][4] 2026-06-02T03:02:00Z (kioku-mesh) zenohd 실행 전에 port 7447의 충돌 체크를 추가
[pattern][2] 2026-06-01T14:35:00Z (kioku-mesh) PR / commit에 이모지를 사용하지 않음

이것을 프로젝트(Project)별·memory_type별로 정리하면 그대로 일보·주보가 됩니다.

mesh-mem-worklog 스킬로 자동화하기

저는 매번 수동으로 정리하는 것이 번거롭기 때문에, Claude Code의 스킬(Skill)로서 자동화하고 있습니다.

"kioku-mesh에서 오늘의 작업 로그를 만들어줘"라고 말하면:

• 대상 기간 확인 (또는 자동 판정)
• search_memory로 관측 취득
• 프로젝트별·memory_type별(decision → bug → pattern → note 순서)로 그룹화
• Obsidian의 Daily Note에 추가

※ Obsidian 부분은 개인 Documents의 경로로 설정해도 좋습니다.

실제 출력은 다음과 같은 형태가 됩니다.

## 10:30 kioku-mesh work log
### kioku-mesh
**decision**
...

GitHub의 PR/Issue에는 "무엇을 했는가"가 기록되고, kioku-mesh에는 "왜 그렇게 했는가·AI와 어떻게 논의했는가"가 기록됩니다. 이 두 가지가 갖춰지면 나중에 개발 경위를 상당히 정확하게 추적할 수 있게 됩니다.

스킬의 SKILL.md는 여기 있습니다:

사용법

1. kioku-mesh 설정

kioku-mesh가 아직 도입되지 않았다면 제1회·제2회를 참조해 주세요.

2. 스킬 배치하기

Gist에서 SKILL.md를 가져와서 Claude Code의 스킬 디렉토리에 둡니다.

mkdir -p ~/.claude/skills/mesh-mem-worklog
curl -sL https://gist.github.com/h-wata/943f5e9c9e0e7309b4ade63f9f3979bc/raw/SKILL.md \
-o ~/.claude/skills/mesh-mem-worklog/SKILL.md

이제 Claude Code에게 "kioku-mesh에서 오늘의 작업 로그를 만들어줘"라고 말하기만 하면 됩니다.

3. 에이전트에게 저장시키기

회고의 질은 에이전트가 관측(observation)을 얼마나 많이 저장하느냐에 달려 있습니다. Claude Code라면 kioku-mesh MCP가 활성화되어 있을 경우, 결정·버그 수정·발견 사항을 그때마다 save_observation으로 기록해 줍니다.

향후 하고 싶은 일

현재는 개인의 여러 PC 간 공유 단계이지만, 소규모 팀에서 메시(mesh)를 공유하는 것이 다음 단계라고 생각합니다. 팀 멤버 각자가 spoke로서 메시(mesh)에 참여하면, 누가 언제 어떤 결정을 내렸는지 팀 전체가 찾아볼 수 있게 됩니다. 풀 리퀘스트(PR) 코멘트에는 적히지 않는 "왜 이런 설계를 했는가"에 대한 문맥이 팀 전체의 공유 지식이 되는 이미지입니다.

링크

• kioku-mesh GitHub: https://github.com/h-wata/kioku-mesh
• mesh-mem-worklog SKILL.md: https://gist.github.com/h-wata/943f5e9c9e0e7309b4ade63f9f3979bc
• 연재 제1회: https://zenn.dev/h_wata/articles/kioku-mesh-01-intro
• 연재 제2회: https://zenn.dev/h_wata/articles/kioku-mesh-02-local-mcp

Discussion