Rockheung/plugings

세션 시작마다 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 테스트와 깊이별 빠짐·잉여 전수 대조 검증 포함.

Claude Code 설정을 경로 상속(cascade)까지 해소해 인터랙티브 지형도(Artifact)로 시각화. collect.sh 가 ~/.claude(base)와 각 경로의 .claude/settings·CLAUDE.md·.mcp.json 을 읽기전용 실측 → base 대비 델타 계산 → 경로 트리를 고르면 그 지점의 유효 설정을 origin 배지(상속/추가/비활성)로 보여주는 DevTools computed-styles 형 인스펙터를 렌더. 민감값 마스킹. 추측 아닌 실측이 소스.

위험/비가역 Bash 명령을 15초 native 다이얼로그로 게이트. 무응답 시 명령 클래스별 기본값으로 자동 결정(lazy): 비가역=deny, 가역=allow. 한글 명령도 깨지지 않음.

한 머신에서 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 로드 순서 함정, 검증법 포함.

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

미지/레거시 코드베이스를 규율 있는 탐색으로 학습해 자가유지 지식베이스를 쌓는 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가 있으면 그쪽이 우선(오버라이드 가능).

로컬 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 진입점을 이룬다. 컨테이너 자체는 관리하지 않음.

PHP LSP(intelephense)를 stdio 프록시 멀티플렉서 뒤에서 구동. LSP 도구 호출의 파일 경로가 곧 워크스페이스 선택 — 요청 uri 의 git toplevel 별로 intelephense 인스턴스를 lazy spawn·라우팅(worktree 자동 인식), workspace/symbol 은 전 인스턴스 fan-out 병합, 인덱싱 완료 전 요청은 게이트로 보류(빈 결과 레이스 차단), JSON-RPC 전 구간 로깅으로 진단 가능. 커스텀 PHP 확장자(.cm .sub .cls)와 shortOpenTag 레거시 지원. ⚠ 하네스의 LSP 설정 변수 치환 미동작으로 경로 하드코딩 — 설치 후 plugin.json 경로 수정 필요(README).

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

한 세션에서 시행착오 끝에 성공한 절차(UI QA·E2E·인프라 조작)를 다음 세션이 재발견 없이 재사용하도록 런북 스킬로 박제하는 저작 방법론. 희소 자산 = 이 환경에서 통과한 구체(성공 코드 원문+실패 변형 병기, 낡는 값 대신 실측 절차, 사고 출처 명시 함정, 날짜 박힌 판정 기준선, 대기 예산). 성공 직후 그 세션이 즉시 작성, 스킬(전문)+메모리 포인터(발견 경로) 2층 구조, 서브에이전트 위임용 복붙 규격, 경배 아닌 검증 상속.

비밀값(로그인·API 키)을 memory 평문 대신 GPG 대칭키로 ~/.secrets/<name>.gpg 에 암호화 저장하는 스킬 + CLI(secret-store/get/list). passphrase 는 사람의 대화형 셸에서만 — Claude Code 등 비대화형 경로에선 pinentry 를 띄우지 않고(TUI 파손 방지) gpg-agent 캐시(12h)가 있을 때만 조회 성공, 없으면 직접 실행 안내.

다른 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과 동급)을 정직하게 구분하고, 타이머가 못 잡는 부분은 시간 프록시 최소화(왕복 횟수·빈 턴·출력량·우회 단계)로 관리한다.