ainote

테마

카테고리 / 폴더 구조 ​

Dev Docs 의 category 는 ainote vault 의 디렉토리 결정.

표준 카테고리 ​

category디렉토리용도
claudedev/claude/CLAUDE.md (Claude Code/Desktop)
cursordev/cursor/.cursorrules, .cursor/rules/*.md
windsurfdev/windsurf/.windsurfrules
copilotdev/copilot/.github/copilot-instructions.md
docsdev/docs/README, ARCHITECTURE.md, 기타
memorymemory/토픽 메모리 (4 type)

명명 규칙 ​

{project_name}-{purpose}.md
예시의미
global-claude-guidelines.md전역 (~/CLAUDE.md)
launchcrew-claude.mdlaunchcrew 프로젝트 CLAUDE.md
tennis-bracket-cursor.mdtennis_bracket .cursorrules
global-memory.md전역 메모리 인덱스
launchcrew-firebase.mdlaunchcrew Firebase 메모
personas-enhanced-activation.mdSuperClaude PERSONAS.md

snake_case → kebab-case ​

프로젝트 디렉토리가 snake 인 경우 kebab 변환:

~/tennis_bracket   → tennis-bracket-claude.md
~/krx_listing      → krx-listing-claude.md
~/krx_ai           → krx-ai-claude.md

이유: URL/파일명 가독성 + 일관성.

🔴 파일명 길이 — 인덱스 예산 ​

토픽 메모리 파일은 개별적으로는 로드되지 않는다. 로드되는 것은 인덱스(MEMORY.md) 하나이고, 여기에 한도(약 24KB) 가 있다. 초과분은 경고 없이 잘려서 뒤쪽 항목이 통째로 안 보이게 된다.

실측(2026-08-18, 토픽 670개 기준):

인덱스 구성바이트비중
파일명 자체18,77478%
[ ]·구분자2,0108%
섹션 헤더·훅3,02513%

즉 인덱스 예산의 대부분은 파일명이 먹는다. 항목당 평균 31B 이고 그중 28B 가 이름이다.

권고 ​

  1. 파일명 ≤ 24자 — 같은 한도에서 담을 수 있는 항목이 크게 달라진다. 670개를 24자로 맞추면 약 3.5KB(항목 130개분)가 남는다
  2. 새 항목은 기존 섹션에 이름만 한 줄 — 설명은 토픽 파일 본문에 쓴다
  3. 훅(한 줄 요약)은 라우팅 정보일 때만 — 접속 경로·정본 위치·금지사항처럼 "파일을 열기 전에 알아야 하는 것"에 한해 30바이트 이내
  4. "오늘 작업분" 같은 임시 섹션을 만들지 않는다 — 처음부터 해당 주제 섹션에 넣는다. 임시 섹션은 항목당 200B 를 넘기 쉬워 예산을 빠르게 소진한다

나쁜 예 / 좋은 예 ​

✗ feedback_integration_codex_false_alarm_double_guard.md   (51자)
✓ codex-false-alarm-guard.md                               (23자)

✗ investigation-target-may-be-uncommitted-peer-work.md      (49자)
✓ peer-uncommitted-work.md                                  (21자)

이름이 짧아도 인덱스의 소속 섹션이 문맥을 주므로 검색성은 떨어지지 않는다.

사용자 정의 카테고리 ​

표준 외 카테고리도 가능:

json
{
  "title": "my-custom-rule.md",
  "category": "custom-rules",
  "local_path": "..."
}

→ vault 에 dev/custom-rules/my-custom-rule.md 자동 생성.

list_dev_categories 가 동적으로 모든 사용 중인 카테고리 반환.

폴더 구조 권장 ​

옵션 A: 단순 (소수 프로젝트) ​

ainote vault
├── dev/
│   ├── claude/
│   └── cursor/
└── memory/

옵션 B: 프로젝트 우선 (다수 프로젝트, 17개+) ​

ainote vault
├── projects/
│   ├── launchcrew/
│   │   ├── CLAUDE.md
│   │   ├── .cursorrules
│   │   └── memory/
│   ├── tennis-bracket/
│   └── ...
└── global/
    ├── CLAUDE.md
    └── memory/

→ 단점: ainote 자동 카테고리화와 안 맞음, 수동 관리 필요. → 장점: 프로젝트별 한 폴더에서 모두 보임.

ainote-sync-redesign 가 후자 권장 (Phase 2 마이그레이션).

검색 ​

bash
# 카테고리별
ainote list_dev_docs '{"category":"claude"}'

# 프로젝트별 (검색)
ainote list_dev_docs '{"search":"launchcrew"}'

# 카테고리 목록
ainote list_dev_categories '{}'

다음 ​