runbook-author

Claude Code 세션을 들여다보는 범용 렌즈. monitor-session: 세션/sub-agent jsonl 실시간 stream, optional --for "<목적>" 로 그 렌즈에 비춰 관련 라인만 surface.

세션 자기교정 — 이 세션의 행위를 CLAUDE.md 규칙(오라클)과 대조해 위반·잘된패턴을 식별하고 Lessons Learned 에 기록·유지한다. lore 구조 차용: 궤적·아티팩트 수집 → 분리된 critic 병렬 감사(self-bias 회피) → 종합·승인 → curator 가 scope 와 함께 기록·주기 재검증. 연구 근거: 순수 자기교정은 약하고 외부검증·오라클이 살린다.

미지/레거시 코드베이스를 규율 있는 탐색으로 학습해 자가유지 지식베이스를 쌓는 3-에이전트 묶음. Scout(발견) → Archivist(지휘·종합·기록) → Curator(기록된 지식 주기 재검증). 발견→기록→검증→재발견 루프.

로컬 Docker로 띄운 mcp-atlassian(ghcr.io/sooperset/mcp-atlassian) 컨테이너를 HTTP MCP 서버 'atlassian'(http://127.0.0.1:19100/mcp)으로 번들 등록. 컨테이너 자체는 관리하지 않음 — reference/docker-compose.snippet.yml 로 별도 기동 필요. 같은 이름의 유저/프로젝트 스코프 MCP가 있으면 그쪽이 우선(오버라이드 가능).

다른 Claude 세션에 일을 맡기고 결과를 받는 절차 — 이미 떠 있는 세션(SendMessage 후 턴 종료, 폴링 금지), herdr 로 새로 띄우는 세션, 다른 머신의 Remote Control 세션이 각각 다른 경로. 주소는 ListAgents 의 이름이고 관측자마다 달라지므로 --remote-control <이름> 으로 못박는다. herdr 로 조작할 세션은 --settings '{"tui":"default"}' 로 띄운다 — 풀스크린은 alternate screen 이라 pane read 가 현재 화면 이상을 못 읽는다(입력은 되고 읽기만 막혀 증상이 헷갈린다). 세션 교체(RC 끊기 → /exit → pane 재사용), 새 머신 부트스트랩, 회신을 그대로 옮기지 않고 검증하는 절차 포함.

Claude에겐 경과 시간을 느끼는 패시브 센서가 없다는 전제에서, 느끼는 대신 능동 조회·알람으로 바꾼다: date 프로브(clock.sh start/elapsed)로 경과를 측정하고, 백그라운드 트립와이어(sleep N → run_in_background 완료 시 재호출)를 알람으로 쓴다. 타이머로 되는 것(턴 사이 경과 체크·외부 장기작업 감시)과 안 되는 것(턴 내부 자기생성은 못 끊음, 워치독 서브에이전트는 결국 sleep과 동급)을 정직하게 구분하고, 타이머가 못 잡는 부분은 시간 프록시 최소화(왕복 횟수·빈 턴·출력량·우회 단계)로 관리한다.

한 머신에서 git/GitHub 계정이 2개 이상일 때, 전환(user.email 바꾸기·gh auth switch)을 자동화가 아니라 *제거*하는 설계 스킬. 레포 폴더 위치를 신원으로 못박아(includeIf gitdir + gh auth token --user credential helper) 커밋 author·GPG 서명·push 인증을 전역 gh active 상태와 무관하게 폴더별 자동 라우팅. 대안(OS 유저 분리·Docker·su·SSH) 평가와 includeIf 로드 순서 함정, 검증법 포함.

로컬 Docker의 slack-explorer-mcp 를 토큰 주입용 caddy 프록시(slack-mcp-proxy) 경유로 HTTP MCP 서버 'slack'(http://127.0.0.1:19091/mcp)으로 번들 등록. slack-explorer-mcp는 내부 네트워크에만 열려있고 프록시만 외부 노출 — 프록시가 X-Slack-User-Token 헤더를 자동 주입해 둘이 하나의 MCP 진입점을 이룬다. 컨테이너 자체는 관리하지 않음.

Claude Code 플러그인 마켓플레이스 — config-map: 설정 상속(cascade) 인스펙터

세션 시작마다 claude CLI 의 명령 이름 트리(409B · 18줄 · 명령 54개)를 컨텍스트에 주입. 놓치는 건 옵션 상세가 아니라 "그 명령이 존재한다"는 사실이므로(claude plugin update 를 몰라 install 만 반복한 사례) 이름만 담는다 — 옵션까지면 34KB. claude 는 commander.js 라 스키마 덤프가 없어 --help 를 파싱하며, 판별은 Usage 첫 줄의 경로 에코 하나로 끝난다. claude --version 을 키로 ~/.cache 캐시 — 평소 ~35ms 파일 읽기 한 번, 버전이 바뀔 때만 ~1.5s 재파싱이라 낡지 않는다. 훅 deadline 초과 시 조용히 무출력(세션 시작을 막지 않음). 함정 4개(없는 명령의 --help 가 조상 도움말로 폴백 / 소제목이 이름 자리 / 이름과 [options] 사이 한 칸 / 설명 속 예시 블록 조기 종료)를 박제한 도움말 fixtures 테스트와 깊이별 빠짐·잉여 전수 대조 검증 포함.