# 00_AI작업규약.md — 어떤 AI든 이 파일부터 읽고 작업하라

> 목적: 이 시스템은 특정 AI(클로드 등)에 종속되지 않는다. 로컬 AI·타사 AI·사람 누구든
> 이 규약만 따르면 작업을 이어받을 수 있다. (CEO 방침 2026-07-18)
> 최종 목표: 로컬 AI가 시스템 안에서 학습·개선하며 기업별 솔루션으로 진화한다.

---

## 1. 시작 절차 (순서 고정)

1. `git log --oneline -10` — 지금까지 뭐가 됐는지 확인
2. `VERIFIED_LOCK.md` — 검증 완료된 값(동결값) 확인. **이 값들은 절대 수정 금지**
3. `README.md` — 시스템 구조 이해
4. 서버 기동 확인:
   - `python dzw_server.py` → http://localhost:8090 (개발 확인용, 로컬 전용)
   - `python dzw_phone_server.py` → https://desktop-da88jsg.taile11e65.ts.net:8444 (태블릿/폰용)

## 2. 검증 관문 (가장 중요한 규칙)

**모든 판단은 사람 눈이 아니라 기계 검증으로 한다.**

```
cd 05_BROWSER_TESTS
python run_all_gate.py          # 전체 6종 (약 3분)
python run_all_gate.py --quick  # 핵심 4종
```

- 뷰어 핵심 파일(DOZIKWORKS_OS_v5_locked·dzw_ar·dozikworks_edgepath_v5 등)을
  커밋하려면 **15분 내 관문 통과 기록이 필수** (훅이 강제함)
- 새 기능을 만들면 **판정 문자열 "PASS"를 출력하는 테스트를 같이 만들어**
  `run_all_gate.py`의 목록에 추가하라 — 그래야 다음 AI가 네 기능을 안 깨뜨린다

## 3. 절대 규칙 (위반 시 롤백)

1. 성공하면 즉시 커밋, 실패하면 즉시 롤백 (`git reset --hard 직전커밋`)
2. 동결값 수정 금지: 로봇 자세·펄스↔각도 계수·TCP(WIRE_TCP)·검증된 IK/JBI·정반 Z(-577.4, 와이어끝 기준)
3. 원인 규명 없이 숫자(임계값·오프셋) 바꾸기 금지
4. 한 턴에 한 곳만 수정
5. 같은 기능 파일 중복 생성 금지 (v2/final 사본 금지 — 기존 파일 수정)
6. "됐다"는 실행 결과(콘솔/테스트 출력)로만 말한다 — 화면 추측 금지
7. CEO(대표) 화면이 최종 기준 — 기계 검증 통과 후에도 실기 확인 전엔 "완료" 단정 금지
8. **실서비스 파일로 파괴 시험 금지** — 깨뜨리는 시험은 반드시 복사본(별도 폴더/브랜치)에서만.
   CEO가 쓰고 있을 수 있는 파일을 고의로 깨는 행위 일체 금지 (2026-07-18 실사고 후 제정)

## 4. 보안·IP (외부 전송 AI에만 해당)

- `01_특허정본`·`나래 ip지원사업`·`가점제출 파일`·`미출원` 폴더는 **읽기 금지**
  (클라우드 AI는 대화 내용이 외부 서버로 전송됨 — 로컬 AI만 접근 가능)
- 발주처 도면 원본(PDF/DXF/DWG)은 AI에 넣지 않는다. 값 확인용으로만 본다
- 서버는 로컬(127.0.0.1) 또는 Tailscale 주소에만 바인딩 — 공인 IP 노출 금지

## 5. 시스템 지도 (2026-07-18 기준)

| 파일 | 역할 |
|---|---|
| `DOZIKWORKS_OS_v5_locked.dc.html` | 메인 뷰어 (3D·티칭·JBI 재생) — 유일본 |
| `dzw_ar.js` | AR 정합 (고정 카메라, 8+8점 PnP+렌즈보정) |
| `dzw_ar_xr.js` | AR 추적 (WebXR — 움직여도 CAD 고정, 안드로이드 크롬 전용) |
| `dozikworks_edgepath_v5.js` | 용접선 추출·판A/판B·경로 생성 |
| `dozikworks_data_v5.js` | 검증된 수치 데이터 (동결값 포함) |
| `dzw_server.py` / `dzw_phone_server.py` | 8090 로컬 / 8444 태블릿(HTTPS) |
| `05_BROWSER_TESTS/run_all_gate.py` | 검증 관문 — 커밋 전 필수 |
| `06_GEOMETRY/make_ar_assets.py` | OBJ→GLB 자산 재생성 |

## 6. 미해결 과제 (우선순위순)

1. **정합 정확도 실측** — CEO가 태블릿으로 8점 정합 후 오차(mm) 확인. 측정된 적 없음
2. **AR추적 실기 검증** — WebXR 모드(dzw_ar_xr.js)는 수학 검증만 됨. 실폰 검증 필요
3. **로봇 통신** — 야스카와 이더넷 옵션 미결제(031-784-7844 견적 선행). 현재 USB 전용
4. **BASE↔U 자기충돌** — 7/13·7/14 로그 반복, 미해결
5. **로컬 AI 심기** — SHIN(8093 지식서버)+Ollama가 이 규약을 읽고 자율 작업하는 단계로

## 7. 세션 종료 시

- 작업 내역을 `E:\지식정제시스템\logs\sessions\`에 날짜별 기록
- 다음 작업자를 위해 이 파일의 6절(미해결 과제)을 갱신