← 목록
기타 2026-07-25 4KB 읽기 5분

크라우니집사회 연결체 도구 3종 (세션 브릿지 + 워크플로 백본)

개요

/Users/ef/crowny-deacon/집사회-스펙.md의 "연결체(세션·워크플로 브릿지)" 절 산출물. deacon 집사회 API(서버·엔진 자체는 별도 작업)를 세션(터미널)과 Workflow 양쪽에서 쓸 수 있게 하는 커넥터 3종 + 사용법 문서 갱신.

무엇을 했는지

  1. ~/.claude/scripts/집사회.sh (실행권한 +x, 139줄) — deacon 집사회 API curl 래퍼.
- 미션 "제목" "목표문" / 수신 <모델> / 보고 <티켓ID> "결과" ["자식지시⏎..."] / 현황 - 키는 /Users/ef/crowny-deacon/data/집사회열쇠.txt에서 로드(없으면 [음] exit 3, 사용자 이관). - curl --max-time 5 — 서버 무응답은 [옴] exit 4, 403은 [타] exit 5. - bash 한글 변수명 함정 회피: 변수명 전부 ASCII(title/goal/model/ticket_id/summary/children/key/url 등) — macOS bash 3.2가 한글 변수 대입을 명령으로 오인하는 실측 함정(MEMORY 기록) 반영.

  1. ~/.claude/butler/집사회브릿지.한선 (121줄) — A의 판정 로직 동일 계승 한선씨 동반.
- 서브커맨드 라우터(집사회_실행) + 4상 판정(집사회_판정): 티=정상 / 옴=서버무응답(빈 응답) / 타=403·"Cannot GET/POST"(라우트 미배선) / 음=키없음. - 체계()로 curl 위임(v11 stdout 직접캡처), 요청 본문은 쓰기()로 임시파일 생성 후 --data-binary @file (셸 이스케이핑 회피). - CROWNY_STRICT=1 ./hanseonc_high 컴파일 경고 0.

  1. ~/.claude/workflows/butler-council.js (229줄) + butler-council.한선 (70줄, 동반) — Workflow 실행 백본.
- Workflow는 fs/네트워크 접근이 없으므로 args.tickets=[{id,model,level,type,prompt}]를 받아 모델별 agent()로 병렬 실행(parallel(), 동시성은 러너 캡 위임), [{id,result,children}]로 반환. - fable 티켓은 실행하지 않고 fable_required로 분리 반환(패블 실행자금지 규칙). - maxTickets(기본 12) 초과분은 log()로 명시하고 절삭(무언절삭 금지), 자식지시는 7개로 클램프, 레벨≥4(리프)는 자식지시 강제 0. - 동반 .한선은 순수 결정 로직(fable분리·models필터·maxTickets클램프·자식수클램프)만 재현(agent()/parallel()은 워크플로 런타임 전용이라 1:1 이식 불가 — 새포맷구축.한선과 동일 관례).

  1. ~/.claude/butler/dispatch-사용법.md에 "집사회 연동" 절 추가 — 터미널 흐름(집사회.sh 수신→작업→보고)과 Workflow 흐름(티켓 수집→butler-council.js→보고 반환) 각 5줄 내.

검증 결과

  • 집사회.sh: 서버(9772)는 이미 떠 있으나(기존 server.js) council API 라우트는 미배선 — 미션/수신/보고는 키 파일 부재로 [음] exit 3에서 즉시 정지(POST 미발행, 라이브 무접촉 준수), 현황(GET)은 rc=0으로 응답 수신·정상 출력.
  • 집사회브릿지.한선: CROWNY_STRICT=1 컴파일 경고 0. 실행 시 4상 판정(빈응답→옴, 403→타, "Cannot GET"→타, 정상텍스트→티) + 키읽기(빈파일→글자수0) + 실제 GET 1회(라우트 미배선 확인) 모두 기대대로 동작.
  • butler-council.js: node --check 통과.
  • butler-council.한선: CROWNY_STRICT=1 컴파일 경고 0. 6개 케이스(실행/패블이관/모델제외/절삭/리프자식수0/9→7클램프) 전부 JS 로직과 1:1 일치 실행 확인.
  • crownycode-learn.sh add로 두 .한선 패턴 학습 등록(집사회API판정4상, 집사회티켓클램프판정).

관련 파일

  • /Users/ef/.claude/scripts/집사회.sh
  • /Users/ef/.claude/butler/집사회브릿지.한선
  • /Users/ef/.claude/workflows/butler-council.js
  • /Users/ef/.claude/workflows/butler-council.한선
  • /Users/ef/.claude/butler/dispatch-사용법.md
  • 스펙: /Users/ef/crowny-deacon/집사회-스펙.md

잔여 이슈

  • crowny-deacon 서버 측(서버.한선, 집사회.한선, 규칙게이트.한선, 미션장부.한선, 집사회열쇠.txt 생성, public/집사회.html)은 이 작업 범위 밖 — 스펙에 정의돼 있으나 아직 별도 구현 필요(data/ 디렉토리가 비어 있어 미착수 확인).
  • 서버 구현 완료 후 E2E(미션→L1→claim→report→JIT L2~L4→stats 자립도) 실측은 서버 쪽 작업 완료 후 재검증 필요.