공개 소스 작업 지침

문서와 설명

문서는 자연스럽고 친절한 한국어로 작성합니다. 처음 사용하는 사람이 다음 행동을 쉽게 찾을 수 있도록 안내합니다.

• 한 문단에는 하나의 주제를 담습니다. 주제가 바뀌면 빈 줄을 넣습니다.
• 제목, 본문, 목록, 표, 코드 블록 사이에는 빈 줄을 둡니다.
• 절차는 번호 목록으로 작성합니다. 한 단계에는 하나의 행동을 담습니다.
• 명사와 전문 용어를 길게 나열하지 않습니다. 필요한 용어는 처음 나올 때 설명합니다.
• 강조는 핵심 조건과 화면의 메뉴 이름에 사용합니다. 같은 주의사항을 반복하지 않습니다.
• 과거 보고서의 날짜, 수치, 원문 커밋과 미검증 범위를 보존합니다.
• 작업 결과는 원인 → 해결 방법 → 제안사항 순서로 보고합니다.

소스와 데이터

Tower 화면은 tower/, API와 모든 OS의 에이전트는 agent-go/에서 관리합니다. 변경한 파일을 검토한 뒤 한국어 커밋 메시지로 커밋하고 원격에 푸시합니다.

직원 정보, 키, 운영 DB·로그·백업, 등록용 ZIP은 커밋하지 않습니다. 공개 전에 tools/verify-public-tree.py를 실행합니다.

판정과 재검사

LLM의 1차 판정, 사람의 최종 판정, 직원 조치의 재검증은 서로 구분합니다. 실패하거나 건너뛴 검사를 해결 완료로 처리하지 않습니다.

발췌와 추가 문맥은 Tower의 sample_context_chars 정책을 공통으로 사용합니다.

에이전트 빌드와 릴리즈

모든 에이전트 빌드에 승인된 브랜드 아이콘을 포함합니다. Windows에서는 실제 실행 파일·설치기·제거기의 PE 아이콘을 검사합니다. macOS와 Linux에서는 해당 패키지의 아이콘 리소스를 검사합니다. 누락되거나 잘못된 아이콘이 있으면 빌드를 중단합니다.

설치기나 아이콘을 변경하면 해당 OS에서 설치, 바로가기, 트레이, 창을 직접 확인합니다. 파일의 정적 검사만으로 실제 OS 확인을 완료했다고 보고하지 않습니다.

버전이 올라가면 이 공개 저장소의 Releases에도 다음 항목을 게시합니다.

• Windows 설치 EXE
• 지원 OS·CPU별 실행 파일과 OCR 전체 ZIP
• VERSION과 최종 파일의 SHA256SUMS
• 한국어 변경 내역과 검증 범위

특정 회사의 기본 서버 주소나 등록 키가 든 사내용 파일을 복사하지 않습니다. 공개 소스를 검사한 뒤 새 버전과 태그로 빌드합니다. 이미 공개한 바이너리나 태그는 덮어쓰지 않습니다.

게시 후에는 로그인 없이 파일을 내려받아 최종 바이트를 대조합니다.

릴리즈 설명은 다운로드 → 설치 방법 → 변경 내용 → 검증 범위 순서로 작성합니다. 긴 체크섬 목록은 본문에 붙이지 않고 SHA256SUMS 다운로드로 연결합니다. 빌드 소스 커밋도 링크로 남깁니다. 사용자가 설명 수정을 요청하면 본문만 수정하고, 태그·첨부파일·체크섬은 유지합니다. 빌드·게시 스크립트의 기존 릴리즈 변경 거부는 그대로 유지합니다.

성능 목표

일반 PC 한 대에서 에이전트 1,000대를 운영하는 것은 아직 검증하지 않은 목표입니다. 실제 시험의 장비, 기간, 혼합 부하와 저장량을 명시하고 목표와 구분해 보고합니다.

브랜치 이름

사용자는 2026-10-12에 브랜치 이름의 codex/ 접두사를 제거하도록 요청했습니다. 앞으로도 이 접두사를 사용하지 않습니다. 작업 내용을 나타내는 이름을 사용합니다. 다른 사람의 브랜치나 커밋을 덮어쓰지 않습니다.

원문: 공개 소스 b915c42. 문서 갱신일 2026-10-12.