스킬.잇다
검증·조사 스킬팩

brain-ingest

업무DB(뇌)에 새 사내 문서와 외부 스킬 산출물을 출처·수집일과 함께 증분 적재

실험적 v0.2.3 knowledge-base incremental ingest adapter

brain-ingest (v1.1 — 스캐폴드)

상태: v1.1 스캐폴드. 아래는 확정된 orchestration outline 이며, 구현·라이브 검증은 v1 안정화 후 진행한다(SPEC-BRAIN-VERTICAL-001 REQ-040, #1122 비범위). “뇌에게 데이터 업데이트를 요청한다”의 v1 실체가 이 스킬 호출이다(비동기 요청 큐는 hyve 연계 2 — SPEC EXC-1).

brain-build가 만든 업무DB에 새 문서가 생길 때마다 전체 재빌드하지 않고 증분 적재한다.

Claude 오케스트레이션 지시서 (outline)

[HARD] 원본 불가침. 새 사내 문서도 읽기 전용. 위키(Layer 2)와 INDEX.md만 갱신한다. (SPEC INV-1) [HARD] 근거·모순 규율 계승. 증분 페이지도 인라인 근거 강제, 기존 값과 상충하면 모순 보존(brain-build 관문3 동일).

관문0 — 스킬 디렉토리(SKILL_DIR) 확정

헬퍼 스크립트는 cwd 에 의존하지 않도록 절대경로로 실행한다. 실행 절 첫머리에서 SKILL_DIR 을 한 번 확정한다:

# Claude Code(플러그인 설치) = $CLAUDE_PLUGIN_ROOT / Cowork = 세션 마운트 탐색
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:+$CLAUDE_PLUGIN_ROOT/skills/brain-ingest}"
[ -n "$SKILL_DIR" ] || SKILL_DIR=$(find /sessions/*/mnt/.remote-plugins -type d -path '*/skills/brain-ingest' 2>/dev/null | head -1)
# 둘 다 아니면(저장소 체크아웃 등) 이 SKILL.md 가 있는 디렉토리 절대경로를 그대로 사용
$env:SKILL_DIR = "$env:CLAUDE_PLUGIN_ROOT\skills\brain-ingest"  # 미설정이면 SKILL.md 위치 절대경로 사용

관문1 — 적재원 분류

  • 사내 신규 문서 — 소스 폴더에 새로 생긴 원본. brain-build 관문2 판독 → 해당 주제 위키에 반영.
  • 외부 스킬 산출물 — itda-web:web-search·itda-gov:dart·itda-gov:kosis·itda-work:exchange-rate 등이 수집한 자료. 외부/ 폴더에 격리 적재하고 출처:(어느 스킬·URL·API)·수집일:을 강제한다(사내 원본과 분리 — CLAUDE.md 적재 규칙 9).
  • 주장 해소 근거 (#1222, SPEC-BRAIN-CLAIM-001) — 검증대기.md의 미결 주장에 대응해 도착한 실물(사내 문서·외부 수집물·승인된 구두확인서). 관문1.5 대조 게이트를 거친다.

관문1.5 — 주장 대조 게이트 (검증대기 해소, #1222)

[HARD] 검증 안 된 채팅 내용을 위키에 직접 쓰지 않는다. 적재되는 것은 대조를 통과한 실물뿐이다(SPEC-BRAIN-CLAIM-001 INV-C1).

적재원이 주장 해소 근거이거나, 신규 문서가 검증대기.md의 미결 주장과 같은 대상을 다루면 적재 전에 대조한다:

  • 일치 — 정상 적재(관문2~) 후 검증대기.md에서 졸업: 해소일·근거 경로를 기록한다. 위키 근거는 도착한 원본을 가리킨다(주장 발화가 아니라).
  • 불일치 — 임의 판정하지 않는다. 양쪽 값(주장 vs 실물)을 모순으로 보존하고(CLAUDE.md 적재 규칙 8) 검증대기.md 항목에 불일치 사실을 기록, 사용자 확인을 권고한다.
  • 뇌 밖 접수 — 업무DB 폴더를 열지 않은 대화에서 명시 요청(“이 얘기 뇌에 반영해줘”)으로 호출되면, 먼저 대상 업무DB 경로를 확인하고(CLAUDE.md 머리말 자기서술로 식별) 주장을 그 뇌의 검증대기.md에 등록 + 근거 요구부터 시작한다. 자동 감지는 뇌 폴더를 연 세션의 CLAUDE.md 규율만 담당한다(전역 감시 없음 — INV-C2).

관문2 — 신규 유형 학습 루프

처음 보는 문서 유형을 만나면 기존 규약/양식/에 없으므로, 양식을 역공학해 규약/양식/{유형}.md(상태: 추정)로 등록한다(brain-build 관문4 규약 역공학 계승).

관문3 — 적재이력 + 신선도 기준선 갱신 (REQ-031)

INDEX.md의 적재이력 절에 “언제(적재일) 무엇(파일·주제)이 들어왔나”를 추가한다. 향후 hyve “최근 들어간 내용” 피드의 데이터 소스가 이 절이다.

[HARD] 신선도 기준선 갱신은 brain-ingest 만, 그리고 적재한 경로만. 신규 문서를 실제로 위키에 적재(반영)한 뒤, 전체 재스캔으로 manifest 를 통째로 교체하지 않는다 — 그러면 함께 존재하던 미적재 변경까지 기준선에 흡수돼 stale 이 사라진다(거짓 안심). 반드시 update-baseline 으로 적재 완료한 경로만 병합한다(절대경로 실행):

# macOS/Linux — 적재 완료한 경로만 기준선 전진(나머지 미적재 변경은 계속 stale 유지)
python3 "$SKILL_DIR/../brain-audit/scripts/freshness.py" update-baseline "<소스폴더>" \
  --manifest "<업무DB>/.brain-manifest.json" --paths "견적서/신규.xlsx" "계약/신규.docx" \
  > "<업무DB>/.brain-manifest.json.tmp" && mv "<업무DB>/.brain-manifest.json.tmp" "<업무DB>/.brain-manifest.json"
# Windows: py -3 "$env:SKILL_DIR\..\brain-audit\scripts\freshness.py" update-baseline ... (동일)

brain-audit 은 기준선을 갱신하지 않으므로(자기비교 방지), “적재하지 않은 채 기준선만 최신화”되는 일이 없다. manifest 경로가 틀리거나 파일이 손상돼 있으면 freshness.py 가 명시 에러로 중단한다(exit 2 — 빈 기준선 자동 생성·대체 없음). 에러 메시지대로 경로를 정정하거나 재빌드로 기준선을 재생성한다.

관문4 — 신선도·검수 연계

증분 적재 후 brain-audit로 신선도 절을 갱신하고, 신규 문서가 기존 값과 모순되면 brain-auditor 재검수로 검수리포트에 반영한다.

원칙

  • 증분 ≠ 재빌드 — 전수성은 brain-audit 신선도 점검이 보증한다(적재 누락 = stale 검출).
  • 외부 자료 오염 방지 — 외부 수집물은 반드시 외부/ + 출처:·수집일:. 사내 근거와 섞지 않는다.
  • 주장은 실물로만 해소 — 채팅 발언은 적재 요구 신호일 뿐 지식이 아니다. 뇌는 어떤 경우에도 1차 기록이 되지 않는다(순수 암묵지도 승인된 구두확인서 원본 경유 — SPEC-BRAIN-CLAIM-001).
  • 길 X thin skill — hyve 무의존.