# 근거를 연결하고 같은 기준으로 수정하기 [색인](/llms.txt) · [구조 검사](/docs/agents/tasks/inspection.md) · [계산 한계](/docs/agents/performance.md) 논문·특허·제조사 자료에서 가져온 주장, 그 주장을 표현하기 위해 선택한 형상, 실제 계산 결과를 구분합니다. 자료를 읽었다는 사실과 원하는 소자가 구현됐다는 결론 사이에는 구조 검사가 필요합니다. ## 지원 경로 | 작업 | 웹 UI | 브라우저 API 1.0 | MCP / 로컬 개발 | | --- | --- | --- | --- | | 자료 검색·원문 검토 | 사용자가 별도로 수행 | 없음 | 호스트의 검색·문서 도구. Arpelier 검사 서버는 외부 자료를 대신 검증하지 않음 | | 현재 문서 수정 | 공정·재료·마스크 편집 | `getFlow` → `validate` → `setFlow` | Flow 1.0 문서를 고쳐 `arpelier_validate_flow` → `arpelier_compute_flow` (저장·적용 없음) | | 근거·요구·검사 연결 | 이름·메모에 맥락 보존 | 전용 blueprint API 없음 | 전용 도구 없음. 이름·메모에 맥락 보존 | | 후보 비교 | 별도 저장 사본 또는 Undo | 별도 테스트 프로젝트와 수치 단면 | 후보 Flow마다 계산·단면 비교, 로컬 합성 회귀 예제 | 새 필드나 API를 추측해 저장 문서에 넣지 마세요. MCP 서버에서는 `arpelier_read_docs`로 이 문서들을 읽습니다. 없는 서버 도구를 브라우저 API로 호출할 수는 없습니다. ## 반복 가능한 작업 순서 1. 실제 원문의 위치와 관찰을 기록합니다. 제목·URL만으로 검증됐다고 쓰지 말고 절·도면·표 등 근거 위치와 해당 주장이 적용되는 조건을 적습니다. 2. 목표, 구조, source claim, 모듈, 마스크, 공정, 검사 기준을 연결합니다. 직접 정한 치수와 단순화는 `assumptions`와 `adaptations`, 미해결 문제는 `gaps`로 구분합니다. 3. 검사 기준은 수정 전에 정합니다. 예를 들어 “창 안의 산화막 제거, 바깥 산화막 보존, 기판 유지”를 서로 다른 위치의 검사로 정의합니다. 4. 실제 문서의 최신 fingerprint로 계산·검사합니다. 실행 성공과 checks 성공, 아직 남은 검토 상태를 각각 읽습니다. 5. 실패한 문서와 결과를 보존하고, 원인 가설에 필요한 최소 공정·마스크 변경을 준비합니다. 다음 검사에는 이전 `acceptanceFingerprint`를 `expectedAcceptanceFingerprint`로 전달해 같은 기준을 유지합니다. 6. 중간 모듈뿐 아니라 후속 통합 이후 최종 단계에서 다시 확인합니다. 구조 검사가 통과해도 source 검토·물리적 타당성·전기 성능은 별도입니다. 잘못 놓인 probe를 고쳐야 한다면 근거와 변경을 명시하고, 원래 문서와 수정 후보를 모두 새 probe로 다시 검사합니다. 실패를 없애기 위해 허용 범위를 늘리거나 필요한 접촉 검사를 삭제하지 마세요. ## 실행 비교: 잘못된 마스크 반전만 고치기 다음은 저장소 루트에서 실행하는 실제 native authoring·GridEngine 검사 예제입니다. Node.js와 설치된 프로젝트 의존성이 필요합니다. 원격 프로젝트를 저장하거나 workspace를 수정하지 않습니다. ```powershell node --test --test-name-pattern="new source-planned seed|same source-linked checks" dev/apps/chatgpt/tests/research-workflow.verify.mjs ``` 두 테스트를 함께 실행해야 첫 테스트가 만드는 baseline과 candidate를 다음 테스트가 비교할 수 있습니다. | 비교 | 변경 또는 기대 결과 | | --- | --- | | baseline | 80 × 60 nm 도메인, Si 30 nm, 산화막 10 nm, 중앙 20 × 20 nm 직사각형 | | 잘못된 후보 | ETCH 직접 마스크의 반전 false. 계산은 완료되지만 창·보호 영역 검사 실패 | | 최소 수정 | `process.patch`로 해당 ETCH의 `maskPolarityInverted: true`만 변경 | | 동일 기준 재검사 | source-linked 검사와 blueprint fingerprint 유지, checks pass, 기대한 grid digest와 일치 | | 남는 한계 | `checks-passed-review-required`, `physicalDevice: not-certified` | 이 fixture의 source 정보는 합성 테스트용입니다. 실제 논문·특허를 검증한 사례가 아니며 복제한 예제 이름만 바꾼 것을 소자 재구성으로 인정하지 않습니다. PHOTO 후 PR로 차폐하는 방식과 ETCH에 마스크를 직접 지정하는 방식은 다르므로 반전 값을 무조건 재사용하지 마세요. 검사기의 자료 연결·probe·지연 처리 거부도 확인하려면 전체 파일을 실행합니다. ```powershell node dev/apps/chatgpt/tests/research-workflow.verify.mjs node dev/apps/chatgpt/tests/private-candidate-inspection.verify.mjs ``` private candidate 검사는 기존 workspace의 정확한 표시 리비전, 원래 native commands, baseline/candidate fingerprint로 메모리 안에서 후보를 재현합니다. 검사가 통과해도 live workspace가 변경되거나 계정에 저장되는 것은 아닙니다. 적용은 별도의 명시적인 workspace update 경로이며, 계정 저장과 공유도 별도입니다. workspace 참조는 접근용 값이므로 사용자에게 공개 링크처럼 노출하지 마세요. 전체 DRAM 셀 요청에는 제공되는 design 안내의 `dram-1t1c` completion 계약을 사용합니다. 일부 모듈 검사, 잘못된 anchor, 중간 단계만의 검사, 재사용된 하나의 검사가 전체 셀 완성을 대신하지 않습니다. 다른 소자에 지원되지 않는 completion profile을 만들어 넣지 마세요. 근거: `authoringTool.js`, `inspectionTool.js`, `inspectionContract.js`, `completion.js`, `research-workflow.verify.mjs`, `private-candidate-inspection.verify.mjs`.