Syshin0116 홈
프로젝트 목록

업무 · BrainCrew

BrainCrew Wiki - LLM 팀 지식 자동화 시스템

AI 루틴 기반 Git-native 팀 위키 파이프라인

기간
2026.04 ~ 진행 중2026.04~05 구축, 2026.10~11 구조 개편
역할
1인 설계·구현 (Team RAG)
팀
사내 팀 (단독 설계·구현)
상태
진행 중
레포 커밋 중 단독 작성
159 / 1662026.11 기준
AgeMem noRL 재현 성능 변화
+8.7pp2개 백본, n=100, 신뢰구간 약 ±4pp

배경

LLM 기반 팀 지식 자동화 시스템을 단독 설계·구현. 팀원이 자유 형식으로 쌓은 메모를 AI 루틴이 cross-link된 위키 문서로 자동 정제·발행하는 Git-native 파이프라인으로, 사람(원본)과 AI(정제본)의 쓰기 권한을 단방향으로 분리했다. ingest/lint/reflect/migrate 4단계를 단일 실행으로 묶는 dispatcher를 만들었고, 초기 버전에는 결정론적 검증 게이트, pre-commit hook, auto-merge CI, Next.js 검색 웹이 있었으나 2026.10 구조 개편에서 정리했다. 별도로 Team RAG 활동으로 에이전트 메모리 논문(AgeMem)의 noRL 변형을 LangGraph로 재현해 2개 백본·100문항 조건에서 성능 변화를 측정했다.

한 일

담당 업무

wiki-curator 파이프라인

  • ingest→lint→reflect→migrate 4-op을 한 fire에서 순차 실행하는 single-fire dispatcher 설계
  • migrate 트리거를 LLM 판단에서 결정론적 조건(태그/타입 클러스터, 1-page 폴더 해체 등)으로 전환
  • 2-fire를 single-fire로 collapse하여 migrate-starvation·workflow_run 체인 제거

검증 게이트 및 소유 강제

  • 결정론적 검증 게이트 verify-wiki.py를 구현했다 (wikilink·frontmatter·필수 섹션 등 9종 체크, 실패 시 self-fix 후 abort, 2026.10 개편에서 제거)
  • lint·rebuild-index 스크립트를 TS→Python(uv inline-deps)로 전환
  • raw/wiki 단방향 소유를 pre-commit hook + path-guard CI로 이중 강제했다 (2026.10 개편에서 제거)
  • Routine bot을 plus-addressing git author로 식별해 봇/사람 커밋 분리

CI / 온보딩 / 웹 / 연구

  • routine/* PR auto-merge(squash-loop) + raw-verify CI를 구성했다 (2026.10 개편에서 제거)
  • 팀 공용 Claude Code skill(추가/검색) 분리 및 6단계 온보딩 스크립트 작성
  • Next.js 16 + Bun 위키 웹을 구현했다 (folder-index, backlink, pagefind 검색, d3 graph view, Vercel 자동 배포, 2026.10 개편에서 제거)
  • AgeMem(arXiv 2601.01885) noRL 변형을 LangGraph tool-calling 루프로 재현하고 2개 백본에서 성능 평가

결과

  • 시스템 설계부터 CI·웹 배포까지 end-to-end로 단독 구축
  • 단일 routine fire에서 5개 신규 위키 페이지 + 2개 cross-link 자동 생성으로 파이프라인 동작 검증

배운 점

  • 에이전트 자동화 설계: LLM 판단 vs 결정론적 트리거의 신뢰성 트레이드오프
  • 쓰기 권한 격리: 사람과 AI의 단방향 소유를 hook + CI로 강제하는 패턴
  • 논문 재현 연구: 메모리 구조의 효과를 백본별로 정량 비교

기술 스택

언어
Python
TypeScript
프레임워크
LangGraph
LangChain
개발 도구
uv (inline script deps)
GitHub Actions
Anthropic Routine
Claude Code skills
LLM
Anthropic Claude (wiki-curator routine)
설계 패턴
Karpathy LLM-wiki pattern
single-fire dispatcher
raw/wiki one-way ownership
개편 전 구성 (현재 제거)
Next.js 16 + React 19 위키 웹
Bun
pagefind
d3
Vercel
pre-commit githooks
verify-wiki.py