Inbox Sorter

00-inbox/ 폴더의 파일과 폴더를 분석하고, 적절한 목적지로 분류합니다. 모든 항목의 내용을 먼저 읽고 한 번에 분류 결과를 제시합니다.

WHEN TRIGGERED - EXECUTE IMMEDIATELY

00-inbox/ 폴더를 스캔하고 Step 1부터 시작합니다.

Workflow

Step 1: 프리플라이트 [script]

# inbox 존재 확인
ls ./00-inbox/ 2>/dev/null || echo "INBOX_NOT_FOUND"

# 도구 확인
command -v pandoc >/dev/null 2>&1 && echo "PANDOC=yes" || echo "PANDOC=no"
python3 -c "import openpyxl" 2>/dev/null && echo "OPENPYXL=yes" || echo "OPENPYXL=no"

inbox가 없으면: "00-inbox/ 폴더를 찾을 수 없습니다. 먼저 폴더를 만들고 파일을 넣어주세요." → 종료

항목 목록 수집:

# 숨김파일, 임시파일 제외. 파일과 폴더 모두 포함.
ls -1 ./00-inbox/ | grep -v '^\.' | grep -v '^~\$' | grep -v '.tmp$'

항목이 없으면: "00-inbox/가 비어있습니다. 정리할 파일을 넣어주세요." → 종료

지원 형식: pdf, docx, xlsx, pptx, csv, md, txt, hwp, jpg, png + 폴더 + 기타

Step 2: 내용 읽기 + 분류 [script + prompt]

모든 항목을 처음부터 내용까지 읽고 한 번에 분류한다. 중간 단계 없음.

항목 유형별 내용 읽기 방법

유형	방법	범위
폴더	`ls -1 ./00-inbox/폴더명/`	내부 파일 목록으로 성격 판단
`.pptx`	`pandoc -t plain "파일" \| head -30`	첫 슬라이드 텍스트
`.docx`	`pandoc -t plain "파일" \| head -50`	첫 50줄
`.xlsx`	`python3 -c "import openpyxl; ..."` (헤더+4행)	첫 시트 상단
`.pdf`	`Read(pages: "1")`	첫 1페이지
`.csv`	`head -5 "파일"`	헤더+4행
`.md`, `.txt`	`Read(limit: 30)`	첫 30줄
`.hwp`	파일명 기반 분류 (내용 추출 불가)	—
이미지	파일명 기반 분류	—

pandoc/openpyxl 미설치 시: 해당 형식은 파일명 기반 분류 + 신뢰도: 낮음. 대용량 파일 (50MB+): 내용 추출 생략. 파일명 기반 분류 + 신뢰도: 낮음. 읽기 실패 시: 에러 무시. 파일명 기반 fallback. 절대 중단하지 않는다.

병렬 실행: 항목이 5개 이상이면 Bash 호출을 최대한 병렬로 실행하여 속도를 높인다.

xlsx 읽기 스크립트

python3 -c "
import openpyxl
wb = openpyxl.load_workbook('파일경로')
ws = wb.active
for row in ws.iter_rows(max_row=5, values_only=True):
    print(row)
"

분류 목적지

폴더	자연어 표시	이런 항목이 갈 수 있음
`data/`	분석용 데이터	CSV, 원시 데이터, 측정값, 로그
`references/`	참고 자료	용어집, 가이드, 매뉴얼, 기준 문서, SOP
`reports/`	보고서/결과물	보고서, 분석 결과, 발표 자료, 대책서
`10-projects/`	프로젝트 문서	기획서, 제안서, 프로젝트 산출물, 검토 자료
`20-operations/`	운영/업무 자료	회의록, SOP, 양식, 프로세스 문서
`30-knowledge/`	학습/지식 자료	아티클, 학습 자료, 리서치, 인사이트
`50-resources/`	외부 참고 자료	외부 벤치마크, 샘플, 레퍼런스, teardown
`90-archive/`	보관	오래된 문서, 완료된 프로젝트 자료

분류 판단 순서:

파일명 키워드 + 내용을 함께 고려하여 최적 목적지를 판단
내용이 확인되면 파일명보다 내용 기반 판단을 우선
모든 항목에 대해 확정된 목적지를 결정 — "uncertain"으로 남기지 않는다
내용을 읽었지만 여전히 애매하면 가장 가까운 목적지 + 신뢰도: 낮음

Step 3: 분류표 제안 + 승인 게이트 [review]

중복 체크 먼저: 각 항목의 목적지에 같은 이름이 있는지 확인:

test -e "./목적지/항목명" && echo "CONFLICT"

최종 분류표 출력 (한 번만):

■ 인박스 분류 결과

| # | 항목명 | → 목적지 | 판단 근거 | 신뢰도 |
|---|--------|---------|---------|--------|
| 1 | 월간보고서_3월.xlsx | 보고서/결과물 (reports/) | 내용: 실적 집계 | 높음 |
| 2 | meeting_0405.docx | 운영/업무 (20-operations/) | 내용: 회의 안건 | 높음 |
| 3 | 설계리뷰/ | 프로젝트 문서 (10-projects/) | 내부 파일: 도면, 검토서 | 중간 |

이대로 이동할까요? 수정할 항목이 있으면 번호로 알려주세요.

주의: 중간 과정(1차 분류, uncertain 목록 등)을 사용자에게 보여주지 않는다. 최종 결과만 한 번 깔끔하게 제시한다.

사용자 응답 처리:

"이대로" / "확인" / "ㅇㅇ" → Step 4 실행
번호 지정 → 해당 항목 목적지 변경 후 다시 표시
"취소" → 종료 (항목 그대로)

Step 4: 실행 + 결과 보고 [script]

이동 실행:

mv "./00-inbox/항목명" "./목적지/항목명"

이동 규칙:

모든 경로는 쌍따옴표로 감싼다 (한글, 공백 대응)
폴더도 mv로 동일하게 이동 (재귀 이동됨)
충돌 항목은 사용자 선택에 따라 처리 (덮어쓰기 / 항목명_2.확장자 / 건너뛰기)
이동 실패한 항목은 건너뛰고 계속 진행 (부분 실패 허용)
삭제는 절대 하지 않는다

결과 보고:

인박스 정리 완료

이동 완료: N개
- 보고서/결과물 (reports/): 3개
- 분석용 데이터 (data/): 2개

건너뜀: M개 (있을 경우만)
이동 실패: K개 (있을 경우만)
00-inbox/ 남은 항목: X개

메모리 기록: 분류 결과를 memory/MEMORY.md의 ## Unsorted에 한 줄 기록: - YYYY-MM-DD: inbox-sorter 실행, N개 항목 분류 (reports/ 3, data/ 2, ...)

ONBOARDING_MODE 추가 저장:

onboarding 스킬이 ONBOARDING_MODE로 호출하면 (인수 또는 컨텍스트 플래그), 분류 결과를 JSON으로 별도 저장:

cat > ./memory/state/onboarding-inbox-snapshot.json << 'EOF'
{
  "run_at": "2026-04-09T14:23:11Z",
  "items": [
    {"name": "월간보고_4월.xlsx", "dest": "reports/", "reason": "실적 집계", "confidence": "높음"},
    {"name": "defect_2603.csv", "dest": "data/", "reason": "원시 데이터", "confidence": "높음"}
  ],
  "dest_counts": {"reports/": 3, "data/": 2, "references/": 1}
}
EOF

그리고 결과 메시지 끝에 한 줄 추가:

→ 온보딩 Phase 4로 돌아갑니다. 이 분류 결과를 기반으로 직무 해석을 제안할게요.

onboarding 스킬은 이 JSON을 Read하여 Phase 4 재해석의 근거로 활용합니다.

Edge Cases

사용자가 새 목적지를 원하면: "다른 폴더에 넣고 싶으면 경로를 알려주세요" → 분류표에서 수정.

항목이 매우 많으면 (내부 처리): 15개 이상이면, Agent 도구로 5개씩 배치 병렬 처리. 각 Agent에게 항목 목록을 명시적으로 파티셔닝하여 중복 처리 방지. 사용자에게는 투명하게 — 결과만 보여줌.

목적지 폴더가 없으면: mkdir -p로 생성 후 이동.

Integration Points

council: 분류 판단이 애매한 항목에 대해 다관점 분석 요청 가능
data-analyst: 분류 후 data/ 폴더의 CSV를 바로 분석
content-draft: 분류 후 references/의 문서를 참조하여 보고서 초안
cross-check: 분류 결과의 신뢰도를 교차 검증

inbox-sorter

Files1

SKILL.md.claude/skills/inbox-sorter/SKILL.md