목차
2026-06-10 — handoff 주제별 분할 + BRIEF 캡 초과 해소
배경
- pfs BRIEF가 CHAR_CAP(12,000) 초과(18,421→재측정 19,225)로
build_brief.py SystemExit → 자동 재빌드 차단. handoff를 갱신해도 BRIEF.pfs.md(새 방이 읽는 시드)에 미반영 상태였음.
- 원인: build_brief는 handoff·memory를 category로 본문 전체 삽입, index(hub)는 발췌, design=발췌+포인터, archive·memory-detail=포인터만. handoff·memory·hub 비대가 캡을 밀어올림.
처방 (페페 지시: 주제별 분할·한 파일 6000자 미만·포인터 연결)
- 신규 분할 파일:
schema-estimate.md(3,133, category=memory-detail=BRIEF 포인터만) — 견적 타입·K/F·순서·UI컬럼·마진·RDS 실측 코드계 단일 출처.
traps.md(1,255, memory-detail) — 작업 함정(배포반영·도구·except침묵·Decimal·openpyxl).
archive-estimate.md(5,150, category=archive) — 견적 기능 완료 이력(엑셀 reference+4종·3버튼·sub-item·이미지+도장).
design-estimate-copy.md(2,322, category=design seed=false) — design §H 견적 구조 복사 설계 분리.
- 축소: handoff(스키마·완료·함정·인계 절을 포인터로)·memory(§5 디버깅 design 포인터, 노션 잔재 제거)·hub(노션 구성/운영규칙 제거, 2줄 진입점)·archive(견적·스키마 섹션 제거, OMC+패치만).
- 매니페스트: register_doc는 미등록 파일 있으면 전체 validate 롤백 → Python으로 직접 append. topic vocab 준수(kind=fact/spec; history·design 불가).
결과 (검증)
- BRIEF.pfs 11,292자(캡 이하), build_brief 정상(OVER CAP 0), validate 58 entries OK.
- pfs 전 .md 6,000자 미만(최대 handoff 5,709). 자동 재빌드 정상화 → 이후 handoff 갱신이 BRIEF에 반영됨.
함정 기록
build_brief.py CHAR_CAP 초과 시 SystemExit으로 전체 재빌드 차단 → handoff 갱신이 시드에 반영 안 됨. 캡 = handoff+memory 본문 전체 삽입 + hub 발췌 합산이라, 진입점(handoff)은 NOW만·상세는 memory-detail 포인터로 빼는 구조가 안전.