메모리 / Dev Docs 개요
ainote 의 두 번째 1급 시민 — Claude/Cursor/Windsurf 가 공유하는 마크다운 메모리.
두 가지 개념
1. 토픽 메모리 (자유 형식)
Claude 가 대화 중 자동으로 저장하는 작은 사실들. ainote 는 이를 4가지 type 으로 마크다운 frontmatter 에서 분류 — 단, MCP 서버 자체가 type 필드를 색인하지는 않음. 분류는 사용자/Claude 가 frontmatter 로 관리.
| 타입 | 무엇 | 예시 |
|---|---|---|
| user | 사용자 정체성/선호 | "한국어로 응답, 파이썬 10년차" |
| feedback | 작업 가이드 | "테스트 mock 금지 — 작년 prod 사고" |
| project | 진행중 컨텍스트 | "2026-03-05 mobile freeze" |
| reference | 외부 시스템 포인터 | "Linear 'INGEST' 프로젝트 = pipeline 버그" |
2. Dev Docs (구조화 문서)
프로젝트별 룰/가이드를 중앙 관리:
claude—CLAUDE.mdcursor—.cursorrules,.cursor/rules/*.mdwindsurf—.windsurfrulescopilot—.github/copilot-instructions.mddocs— 일반 문서
서버는 모두 category 필드 하나로 구분 (디렉토리 분리).
왜 이걸 ainote 에 두나
문제: 17개 프로젝트의 CLAUDE.md 가 노트북마다 따로 놂. 맥미니에서 수정 → 맥북엔 반영 안 됨.
해결: ainote 가 source of truth.
create_dev_doc— 새로 등록 (한 번만)update_dev_doc— 변경 시 pushpull_dev_docs— 새 기기에서 한 방에 복원 (local_path기준)
MCP 도구 7개
| 도구 | 용도 |
|---|---|
create_dev_doc | 새 문서 등록 |
update_dev_doc | 수정 (replace/append/prepend) |
delete_dev_doc | Soft delete |
get_dev_doc | 단일 문서 조회 |
list_dev_docs | category + search 필터 |
list_dev_categories | 카테고리 목록 |
pull_dev_docs | local_path 로 일괄 복원 |
자동 디렉토리 분류
category 자동으로 dev/ 아래 정리:
ainote 클라우드
├── dev/
│ ├── claude/
│ │ ├── global-claude-guidelines.md → ~/CLAUDE.md
│ │ ├── tennis-bracket-claude.md → ~/tennis_bracket/CLAUDE.md
│ │ └── launchcrew-claude.md → ~/launchcrew/CLAUDE.md
│ ├── cursor/
│ ├── windsurf/
│ └── docs/
└── memory/
├── global-MEMORY.md
└── launchcrew-MEMORY.mdlocal_path — 복원의 핵심
문서 등록 시 local_path 항상 명시:
json
{
"title": "tennis-bracket-claude.md",
"category": "claude",
"local_path": "/Users/seunghan/tennis_bracket/CLAUDE.md",
"content": "..."
}pull_dev_docs 가 이 경로 기준으로 파일을 만듭니다. 없으면 복원 불가능.
크로스 플랫폼 경로 매핑 자동: macOS ~/... ↔ WSL ~/... ↔ Linux ~/....
메모리 저장 베스트 프랙티스
✅ 저장할 것
- 사용자 가르쳐 준 사실 ("나는 X 회사 다님")
- 코드에서 derive 안 되는 결정 근거 ("왜 mongo 대신 postgres")
- 외부 시스템 포인터 (Slack 채널, Linear 프로젝트, 대시보드 URL)
- 과거 사고 / 학습
❌ 저장 X
- 코드에서 보이는 것 (파일 구조, 함수 시그니처)
- git log 로 알 수 있는 것
- 디버깅 결과 / 임시 상태
- CLAUDE.md 에 이미 있는 것