meeting-progress

name	meeting-progress
description	현재 진행 중인 실험/연구의 상태를 미팅용으로 정리한 progress 스냅샷 MD를 생성한다. live 작업 폴더의 진행 결과, 실행 중 프로세스, 최신 status 문서를 스캔해서 타임스탬프 찍힌 리포트를 낸다. "progress report", "미팅 자료", "진행 상황 요약", "현재 어디까지 왔는지 정리해줘" 같은 요청에 사용.

meeting-progress

미팅에 그대로 들고 갈 수 있는 자족적인 markdown 리포트 하나를 생성. 현재 실험 상태를 스냅샷으로 찍는다.

경로

.env 에서 로드:

REPO            # 위키 git 저장소 루트
PROGRESS_ROOT   # progress_YYYYMMDD_HHMM.md 가 쌓이는 디렉토리 (권장: $REPO/progress)
WIKI            # 위키 본체
LIVE            # 실험이 실제 돌아가는 작업 폴더 (runs/, logs/, docs/ 가 있는 곳)
WIKI_LANG       # ko | en (기본 ko)
TZ              # 파일명 타임스탬프 타임존 (기본 system local)

출력 위치

• 대상: $PROGRESS_ROOT/progress_YYYYMMDD_HHMM.md
• 각 호출마다 새 파일 생성. 이전 리포트를 덮어쓰지 않음 (이력은 $PROGRESS_ROOT/ 에 누적).
• 파일명 타임스탬프는 TZ (또는 system local) 기준.

Live 작업 폴더

실제 데이터는 $LIVE 에 있음 (위키 git 미러가 아니라). 이 skill이 어디서 호출되든 runs/, logs/, docs/, 실행 중 프로세스는 항상 $LIVE 에서 읽는다.

생성할 섹션 (순서대로)

각 프로젝트의 이전 status 파일 포맷을 따르되, 기본 셰이프:

1. Title — # <Project name> Progress — YYYY-MM-DD HH:MM <TZ>
2. Context — 짧은 단락: 현재 무엇을 테스트 중인지, 방어/비교군은 무엇인지, 현재 연구 질문은 무엇인지. $LIVE/docs/ 에서 가장 최근의 *status*.md 있으면 그것의 Context 섹션에서, 없으면 최근 SESSION_BACKUP_*.md 에서 요약.
3. Done — 지난 세션에서 완료한 마일스톤 bullet 리스트. git log --oneline --since="7 days ago" 을 보조 신호로 사용.
4. Current Status (live) — 테이블 형태:

   | <subject> | <variant> | <context> | progress | <metric1> | <metric2> | ... |
   

   Progress 단위는 completed/expected 또는 n/total. 메트릭 컬럼은 PRIMARY_METRICS 에 지정된 순서를 따름 (미지정 시 프로젝트 자체 status 파일의 컬럼 순서). Populate는 $LIVE/runs/ 스캔 결과로 (아래 "Data gathering" 섹션).
5. Running processes — PID / script / since 테이블. ps 을 관련 패턴(벤치마크 엔트리포인트, shell 스크립트)으로 필터.
6. Known incidents — 최신 docs/*status*.md 에 해당 섹션이 있으면 그대로 복사. 없으면 생략. 사건을 지어내지 않는다.
7. Pending / next steps — 최신 status 파일의 "Pending" 리스트에서. 없으면 최근 SESSION_BACKUP_*.md 의 "다음 할 일" 섹션에서.
8. Files & paths — 리포트가 어디에서 데이터를 긁어왔는지 간단히. 독자가 숫자를 audit 할 수 있도록.

Data gathering

Running processes

ps -eo pid,lstart,cmd | grep -E "<benchmark entrypoint pattern>|run_.*\.sh" | grep -v grep

PID, start time(lstart → "since" 컬럼), 스크립트명 또는 flag들(e.g. --attack, --defense) 추출. 벤치마크 엔트리포인트 패턴은 프로젝트별 (예: AgentDojo는 agentdojo.scripts.benchmark). 없으면 $LIVE/scripts/ 의 주요 실행 스크립트 이름으로 필터.

Run progress (per logdir)

$LIVE/runs/<dir>/ 중 최근 24시간 내 수정된 디렉토리마다 (또는 사용자가 명시적으로 요청한 것):

1. Expected total 을 프로젝트 규칙으로 결정. 예시: AgentDojo 전체 sweep은 suite별 고정 크기. Representative/sample 스윕은 샘플 정의 파일(e.g. $LIVE/scripts/representative_sample.json)의 엔트리 수.
2. 프로젝트가 제공하는 watcher 스크립트 를 사용 (재구현 금지). 예: $LIVE/scripts/watch_run.py. 없으면 runs/<dir>/ 내 trace 파일 수로 단순 count.
3. watcher는 보통 <logdir>/_live_metrics.json 같은 캐시를 씀. 그것을 읽어 progress, primary metrics 출력.

Status file lookup

• $LIVE/docs/*status*.md 중 mtime 최신.
• 여러 개면 현재 돌고 있는 실험 계열 이름이 파일명에 들어간 것 우선 (running-process 테이블에서 grep).

Session backup lookup

• $LIVE/SESSION_BACKUP_*.md 중 mtime 최신.

제약

• Output language. WIKI_LANG=ko 면 모든 섹션 제목/본문/bullet을 한국어. 기술 용어(메트릭 이름, suite 이름, 파일 경로, CLI 플래그 등)는 원문 유지하되 설명 문장은 한국어. 이전 progress 파일이 영어로 돼있어도 새 파일은 항상 WIKI_LANG 언어로.
• Don't fabricate numbers. logdir에 trace 파일이 아직 없으면 메트릭 —, progress 0/total.
• Primary metric 우선. PRIMARY_METRICS 에 지정된 첫 메트릭이 항상 테이블에서 먼저 노출. 숨기거나 재정렬 금지.
• Read-only. 새 실험을 시작하거나 서버/프로세스를 건드리지 않는다.
• 자족성. 외부 링크 없이 파일 경로만. 독자가 MD 하나로 미팅 가능해야 함.
• watch_run.py (또는 상응하는 watcher)가 특정 logdir에서 에러 내면 그 행을 짧은 노트와 함께 skip, 전체 리포트는 중단하지 않음.
• 해석 금지. no-hype 원칙 — 결론이 아니라 숫자를 보고.

출력 배달

파일을 쓴 후:

1. 절대경로 출력.
2. Current Status 테이블을 채팅에 인라인 출력 (빠른 검토용).
3. 자동 커밋 ($REPO 에서):

   cd $REPO
   git add progress/progress_YYYYMMDD_HHMM.md
   git commit -m "progress: YYYY-MM-DD HH:MM"
   

   • progress/ 밑의 새 파일만 git add. git add . 또는 -A 사용 금지 (관련없는 in-flight 작업이 함께 staging 되는 것 방지).
   • push 하지 않음. 사용자가 미팅 전 직접 push.
   • commit 실패(hook 실패, nothing to commit 등)면 에러 보고 후 중단. --amend 나 --no-verify 로 재시도하지 않음.
4. research-wiki 로 handoff.
   • 사용자의 이 호출 원 요청에 다음 중 하나라도 포함: wiki, ingest, 체이닝, ingest까지, 위키 — research-wiki ingest <방금 쓴 파일> 로 바로 이어감. 두 번째 프롬프트 불필요.
   • 그렇지 않으면 단계 3 후 한 줄 제안 출력:

     다음: `research-wiki ingest $PROGRESS_ROOT/progress_YYYYMMDD_HHMM.md` — wiki에 반영할까?
     

     멈춤. chaining 키워드 없으면 auto-trigger 하지 않음 (research-wiki 의 "Never auto-trigger" 규칙 존중).