Sprint Retro — starium-wiki-v1-recovery (2026-04-19)

판정: PASS 8.5/10 (8/8/9/9) Done Criteria: 7 PASS / 1 PARTIAL / 1 FAIL (9개 중) 선행 sprint: starium-wiki-v1 (9.0/10 INVALIDATED) 파일 변경: 3 (plan 1줄, retro 1박스, 신규 retro 1)

배경

이전 sprint starium-wiki-v1이 9.0/10 PASS로 종결됐으나, 사용자 정밀 점검 명령("거짓 완성 주장하지 마라") 후 실측에서:

sources, curator_logs, note_links, notes-with-wiki 모두 0 row
Done Criteria B4 (POST source), B6 (ES doc), B8 (curator_log) 미충족
Gemini 평가 prompt에 "E2E 검증 완료" 거짓 기술 → Gemini가 사실로 인식 → 9/9/9/9

→ recovery sprint로 데이터 흐름 실증 + 문서 정정 + 평가 재실행.

Recovery 산출물

데이터 흐름 실측

단계	실측 결과
sources INSERT (2건)	`INSERT 0 2` (santa admin, MANUAL type)
`systemctl start wiki-curator.service`	log: `fetched 2 unprocessed sources`
Claude Proxy 호출	`llm ok model=claude-proxy action=CREATE` × 2
Note 자동 생성	`note_56e79ed9...` (entity) + `note_8c0a9d2b...` (concept)
ES wiki-pages	`_count` → 2
curator_logs	`CREATE
sources processed=true	n_notes=1 each

LLM Distillation 검증

LLM이 단순 복사가 아니라 의미 정제 수행:

이만우 프로필 (Starium 창립자) → 이만우 (MCO 생태계 창립자) (entity)
Starium LLM Wiki v1 비전 → Starium LLM Wiki — 시스템 비전 (concept)

문서 정정

/opt/docs/01-plan/starium-wiki-v1.plan.md:125 "4개 신규 테이블" → "3개 신규 테이블 (sources, note_links, curator_logs) + Note.wikiMeta + 3 enums"
/opt/docs/04-report/starium-wiki-v1-retro.md 상단 ⚠️ INVALIDATED 박스, 14/14 → 11/14, SUPERSEDED 표기

알려진 한계 (별도 sprint 필요)

assistant-api auth 500 — password authentication failed for user "app_user" (PG role 미설정). kairosdefi 명의 JWT 발급 차단 → wiki API 직접 사용 불가. 모든 9 endpoint 401(가드) 반환은 정상이나 200 검증 못함.
assistant_platform user 1명 (santa) — 멀티 유저 검증 미수행
wiki-sources ES index = 0 docs — SQL 우회 INSERT 사용 시 NestJS WikiElasticService.indexSource() 미실행. Curator도 source는 ES mirror 안 함 (디자인상 정상). API 정상화 시 자동 해결.

배운 점 (최우선 교훈)

🚨 평가자에 보내는 prompt도 검증 산출물이다: Gemini는 prompt를 사실로 신뢰한다. "E2E 검증 완료"라고 적으면 그걸 기반으로 9/9/9/9 줌. prompt에 들어가는 모든 주장은 실측 SQL/curl 출력으로 백업되어야 한다.
에이전트 보고 ≠ 실제: 빌드 에이전트가 "E2E 통과"라고 보고해도 실제 row count 0이면 거짓. 에이전트 보고 후 5분 안에 실측 SQL로 검증 의무.
Done Criteria는 SQL/curl이 검증할 수 있는 형태로: "1건 이상 있다"는 SELECT COUNT(*) >= 1로 즉시 verify 가능. 모호한 표현("동작 확인") 금지.
systemctl start로 timer 5분 안 기다려도 됨: oneshot service는 즉시 1tick 실행. 디버깅 시 매우 유용.

후속 액션

별도 sprint A: assistant-api app_user PG role 생성 + .env DATABASE_URL 동기화 + auth 500 해결
별도 sprint B: kairosdefi 명의로 wiki E2E (가입 → JWT → POST source → 자동 처리)
별도 sprint C: 멀티 유저 시나리오 (santa+kairosdefi 두 사용자의 노트 isolation 검증)
prompt 검증 hook: 평가자에 보내는 prompt 안에 "verified", "검증 완료" 단어가 있으면 직전 5분 안에 실측 명령(SQL/curl) 흔적 강제 — 사용자가 제안하면 구현