26.7.29(수) — MCP 툴 vision으로 등록 완료(서버 cody-vision, user 스코프, mcp_server.py).
이제 툴 목록에 뜨므로 발견성 문제는 해소. 단 등록 직후 세션에는 안 보인다 — 새 세션부터.
⚠로직은 vision.py 하나뿐이다 — MCP 서버는 그걸 import 해 쓰는 얇은 껍데기다. 기능 수정은 vision.py에만 하고
mcp_server.py에 로직을 복제하지 말 것(CLI와 MCP가 갈라지면 둘 중 하나는 반드시 낡는다).
발견 경로 문서 = rules/tooling.md 체크리스트 5번 + 전용 섹션. 사용법이 바뀌면 거기도 같이 고친다.
26.7.29(수) — 프롬프트에 재촉/억제 부사를 넣지 않는다. "빠짐없이"를 넣으면 없는 물체를 만들고("원 12→13", 2회 재현),
"두 번 쓰지 마라"를 넣으면 있는 물체를 지운다(12→11). 시킬 일만 담백하게 적는다.
프롬프트를 고쳤으면 추측하지 말고 bench.py(정답 확정 합성 이미지)로 숫자를 확인한 뒤 커밋한다.
26.7.29(수) — 모델에게 "하지 마라"로 막을 수 있다고 믿지 않는다. 축소본 세부 환각은 프롬프트 명시로도 안 막혔다 →
파이썬이 결과를 버리는 코드로 강제했다. enum(셈을 안 시킨다)과 같은 원리 = 못하는 일은 아예 안 맡긴다.
26.7.29(수) — 도구 이름은 cody-vision(구 see는 폐기 — 너무 범용이라 검색·구분이 안 됐다).
폴더 C:\dev\tools\cody-vision\ · devplan /cody-vision.html · 시드 projects/cody-vision/ · P1 진입점 vision.py · MCP 툴명 vision.
26.7.29(수) — API 키는 코드·프로젝트 .env에 적지 않는다. C:\dev\.secrets\.env 하나만 읽는다(전역 규칙 = rules/tooling.md "시크릿 파일 위치").
26.7.29(수) — cody-vision은 devplan 추적 프로젝트다. 매 답변 끝에 C:\dev\devplan\cody-vision.html의
계획\진행\완료 리스트·갱신 이력을 시드와 함께 갱신한다(누락 이력 없도록).
26.7.29(수) — 개수를 물어보는 이미지 작업은 모델에게 세라고 하지 않는다. 인스턴스마다 bbox를
찍게 하고(enum) 파이썬이 len()으로 센다. count 필드를 스키마에 두면 모델이 그걸 채우려고 세다가 틀린다.
26.7.29(수) — 벤치 재실행은 PYTHONUTF8=1 python C:/dev/tools/cody-vision/bench.py(합성·정답 확정) /
bench_real.py(실사진 3회 반복). 모델 선정을 바꾸려면 추측 말고 이걸 돌려서 숫자로 판단한다.
26.7.29(수) — devplan 페이지 신규 생성 시 </body> 직전 <script src="/assets/qahelper.js"></script> 필수,
카드 등록은 projects.json 편집 후 PYTHONUTF8=1 python build_hub.py(index.html 직접 편집 금지).