← 문서 맵으로

🧰 코퍼스·도감 유지보수 루프

스킬 /mealfred-food-mapping — 부르면 클로드가 전 과정을 수행한다(사람은 스크립트 안 돌림). 메뉴→식재료 매핑·음식/식재료 매트릭스·식재료 도감을 살아있는 데이터로 주기적으로 다듬는 큐레이션 루프.

1. 한 줄 요약

밀프레드의 데이터 자산(매핑 사전 · 궁합/키트 매트릭스 · 식재료 도감)은 한 번 만들고 끝이 아니라 계속 손봐야 정확해진다. 이 스킬은 그 유지보수를 한 단어로 묶은 것 — 부르면 ① 실데이터로 매핑을 튜닝하고 ② 코퍼스가 커졌으면 매트릭스를 다시 만들고 ③ 도감에 빠진 영양 식재료를 발굴·검증해 (승인 후) 채운다.

2. 자동화 경계 — 누가 뭘 하나

가장 헷갈리는 지점. 2시 크론과 이 스킬은 다른 층위다.

주체무엇왜 거기인가
2시 크론 자동이미 만든 사전·규칙으로 새 메뉴를 분해(learned_menus 백필) + 코칭 편지런타임 데이터만. 매일 도는 게 맞음
이 스킬 수동(부르면)빌드 산출물(정적 JSON: 사전·매트릭스·도감)을 재생성·개선정적 import라 크론이 못 함(커밋+재배포 필요). 매일 안 바뀜
도감 추가 자동 X식재료를 도감에 등재하는 것안전 검증·사람 승인 필수 — 인삼·함초가 자동 등재되면 안 됨
한 문장: 크론은 사전을 '적용'하고, 이 스킬은 사전·매트릭스·도감을 '개선'한다. 도감에 뭘 넣을지는 늘 사람이 결정한다.

3. Part A — 메뉴→식재료 매핑 사전 튜닝 매번 기본

엄마가 친 메뉴를 식재료로 푸는 사전을, 실제 입력 + 엄마들이 직접 고친 교정을 정답지 삼아 다듬는다.

예시 — "소고기무국"
현재: 소고기무국 → [소고기] ← '무'가 1글자라 오탐(무궁화·무침…) 위험으로 스캔에서 막혀 누락 판단: 무국인데 무가 빠졌다(빈약 의심) 조치: MENU_MAP에 '소고기무국': { ing:['소고기','무'] } 추가 결과: 이후 모든 '소고기무국' → [소고기, 무] (LLM 안 거치고 즉시·정확)
이렇게 자주 틀리는 걸 전역 사전으로 승격시키면 LLM 호출이 줄고 정확도는 오른다.

손보는 곳: lib/menuMap.ts(MENU_MAP·EXCLUDE) · lib/lexicon.ts(표기변형 소세지→소시지) · 회귀검증은 audit-menu.ts로 코퍼스 100% 유지 확인.

4. Part B — 코퍼스/매트릭스 재생성 코퍼스 컸을 때

learned_menus는 크론이 매일 채운다. 충분히 커졌으면(직전 +5% 또는 도감 변경 시) 빌드 산출물을 다시 만든다.

자산무엇생성
corpus-stats어드민 음식/식재료 카운트·32형태별 표gen-corpus-stats.mjs
궁합/사촌같이 쓰인 레시피(pair) + 맛·식감 닮은 사촌(bridge)gen-food-graph.py
음식×식재료키트 매트릭스 점수(LLM 정성 0~3)채점 워크플로(도감/형태 바뀐 경우만)

임계 미달이면 "재생성 불필요(증가 N건)"으로 솔직히 보고하고 스킵한다.

5. Part C — 도감 갭 점검·확장 승인 게이트

도감의 가치는 '많이'가 아니라 '자주 먹는 걸 정확히 덮는 것' + 💎 영양 보석(빈도 낮아도 영양 우수). 식약처/NEIS 전재료에서 도감에 안 걸리는 토큰을 스캔해 진짜 새 식재료를 찾는다.

예시 — 영양 식재료 발굴·검증 (실제 1회차)
발굴: 식품군별로 영양 우수 통째 식재료 제안 → 74개 검증: 후보별 적대 검증(영유아 안전·영양·💎·빈도) → ✅ 퀴노아(💎 식물성 완전단백질) → 🟡 잣·광어·목이버섯·망고…(영양 OK, 빈도 낮음) → ⛔ 인삼(한방)·함초(고나트륨)·꿀(돌 미만 금지)·곤약(저영양) ← 올바르게 기각 제시: add/maybe/💎 + 근거·안전노트 표를 사람에게 → 승인받은 것만 등재

승인되면 7개 파이프라인을 새 식재료에 전부 재생성해야 도감·궁합·키트·코칭이 정합한다:

① 풀 등재 · ② 영양 매핑(농진청 100g) · ③ 💎 영양 보석 · ④ 별등급(급식 빈도) · ⑤ 급여 용량 · ⑥ 제철 · ⑦ 궁합/사촌 + 음식×식재료 매트릭스 → kit-guide 재생성 → 배포.

⚠️ 이 단계는 절대 자동화하지 않는다. 발굴·검증까지는 워크플로가 하되, 도감에 실제로 올리는 건 사람 승인 뒤에만.

6. 마무리 리포트 형식

📋 유지보수 리포트 🔧 Part A 매핑: 무매핑 a→b · 룰+스캔 P%→Q% · 코퍼스 100% 유지 · 고친 것 M건 📊 Part B 매트릭스: learned N(+Δ) · 재생성 {…} 또는 '불필요(증가 적음)' 🌱 Part C 도감: 갭 스캔 K · 후보 제시 J(add/maybe/💎) 또는 '승인 후 J종 전배선' 🚨 치명 이슈 Top 3 · ⏸ 보류: 오타·1회성·승인 대기

숫자는 지어내지 않고 실행 출력에서만. 고친 게 0건이어도 0으로 솔직히 보고(규율이 작동한 결과).

🧭 한 줄 원리 — "실제 엄마들이 친 메뉴 + 엄마들이 고친 교정"이 가장 정확한 정답지다. 그걸 주기적으로 전역 사전·매트릭스·도감으로 승격시키는 게 이 스킬이다. 크론은 적용만, 개선은 여기서.