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

크라우니브레인 t1 확장 2호 — 형식변환·문서화 규칙엔진

개요

브레인 t1(하이쿠급) 티켓 상당분을 완전 한선씨 결정론 규칙엔진으로 직접 처리하는 1호(요약/정리)에 이어, 2호로 형식변환(PSV↔마크다운표↔JSON)과 문서 스캐폴드(CrownyDoc 표준 골격) 생성을 추가. 같은 프로토콜(더미줄 선행+단일 write, '¶' 개행치환+20000자 절단, 진단 출력줄 즉시사용)을 따름.

무엇을 했는지

  • 브레인변환.한선 작성: 모드(psv2md|md2psv|psv2json) 결정론 변환. psv2md/psv2json은 첫 줄을
헤더로 사용, md2psv는 구분줄(---)을 자동 스킵하고 셀 트림 후 PSV로 역변환. psv2json은 백슬래시→큰따옴표 순으로 이스케이프.
  • 브레인문서.한선 작성: 첫 항목=개요, 나머지는 한:/경:/이: 접두 분류(무접두는 '한일'로 폴백)
# 제목 → 개요 → 무엇을 했는지 → 관련 파일 → 잔여 이슈 5항목 마크다운 골격 생성.
  • 브레인t1.sh 확장: 변환 <psv2md|md2psv|psv2json> <파일|->, 문서 "<제목>" <파일|-> 서브커맨드
추가. 기존 요약/정리는 무손상(회귀 테스트 통과). 단, 변환/문서는 PSV 데이터 보존을 위해 '|' 제거를 하지 않음(기존 요약/정리만 '|' 제거).
  • 작업구분.sh t1 분기 확장: 문맥에 "변환"+psv/md/json 언급 시 브레인변환 선시도(psv2md/md2psv/
psv2json 방향은 키워드 등장 순서로 추론), "문서화" 언급 시 브레인문서 선시도(첫 ':' 앞을 제목, 뒤를 항목본문으로 분리). 원본 데이터(raw_ctx)를 정화 전에 별도 캡처해 '|'·'¶' 보존.
  • 두 신규 패턴 crownycode-brain.sh learn으로 학습(브레인변환_형식_t1, 브레인문서_스캐폴드_t1).

관련 파일

  • /Users/ef/.claude/scripts/브레인변환.한선 (+ 동반 RPN 정본 브레인변환.rpn.한선)
  • /Users/ef/.claude/scripts/브레인문서.한선 (+ 동반 RPN 정본 브레인문서.rpn.한선)
  • /Users/ef/.claude/scripts/브레인t1.sh (변환/문서 서브커맨드 추가)
  • /Users/ef/.claude/scripts/작업구분.sh (t1 분기 확장, raw_ctx 캡처)
  • /Users/ef/.claude/scripts/작업구분.한선 (미변경 — 키_t1에 "변환"/"문서화" 기존 등록 확인만)

검증

  • 컴파일: hanseonc_high 브레인변환.한선/브레인문서.한선 rc=0×2
  • RPN 변환: high2rpn.sh 브레인변환.한선/브레인문서.한선 rc=0×2 (실행정확성은 참고용, 미실행검증)
  • psv2md: 헤더+2행 PSV → 3행 마크다운 표(헤더+구분+데이터2) 정상
  • md2psv: 마크다운 표(헤더+구분줄+데이터) → PSV 왕복 필드 일치 확인
  • psv2json: 큰따옴표·백슬래시 포함 셀 → \"/\\ 이스케이프 정상 확인
  • 문서 골격: 5항목(제목/개요/한일/경로/이슈) 전부 출력 확인
  • 브레인t1.sh: 요약/정리/변환(3모드)/문서 전부 rc=0 스모크 통과 (기존 요약/정리 회귀 없음)
  • 작업구분.sh: "psv를 md 표로 변환해줘" → t1 분류 + 브레인변환(psv2md) 자동실행 성공,
"문서화해줘: ..." (t2 트리거 키워드 없는 클린 입력) → t1 분류 + 브레인문서 자동실행 성공, 기존 "목록 정리해줘" 회귀 테스트 정상
  • 학습: crownycode-brain.sh learn 브레인변환_형식_t1, 브레인문서_스캐폴드_t1 완료(lint 티 통과)

잔여 이슈

  • 작업구분.한선 코어는 "." 기준 단일 문장 분해 + 최고심각도 선택 방식이라, 문맥에 t2급 키워드
(작성/구현/코드 등)가 섞이면 "변환"/"문서화"가 있어도 t1이 아닌 상위 레벨로 분류돼 새 분기가 트리거되지 않음(기존 요약/정리도 동일 제약 — 신규 결함 아님).
  • 문서 스캐폴드의 제목 추출은 입력 문자열의 첫 ':' 앞부분을 그대로 사용(명령 동사 포함 가능) —
더 정교한 제목 정제(동사 제거 등)는 후속 개선 여지.
  • RPN 변환본은 컴파일만 검증(rc=0), hanseonc_rpn 실행 정확성은 별도 미검증(참고용 명시).