b3os-infra-safetylisted

# b3os-infra-safety — b3os 인프라 작업 안전 규칙 > b3os **플랫폼 자체**(코드·config·registry·DB·릴리스 스크립트)를 고칠 때 지킨다. 일반 팀 협업·대화가 아니라 **b3os 인프라를 수정**하는 작업 전용. (팀 통신·오너판정·안전게이트 같은 상시 규칙은 TEAM-OS에 남아있다 — 여기는 "b3os를 고치는 법".) ## 언제 이 스킬을 보나 팀원이 b3os의 소스·설정·runtime 상태·릴리스를 건드릴 때: 코드 수정, config 변경, `agents.json`/`team.db` 조작, 테스트/빌드 실행, 공개 릴리스·라이브 배포 작업, 서버 재시작. **이 작업 전에 이 규칙을 적용한다.** ## ① 브랜치·worktree 격리 - git-추적 파일 수정은 **task 브랜치/worktree에서만**. 공유 main 워킹트리에 직접 쓰지 않는다. 한 task = 한 브랜치. - task 카드는 브랜치가 있으면 그 브랜치를 명시. 코드/문서 리뷰·핸드오프는 브랜치를 명시(없으면 리뷰어가 먼저 물어본다). - 새/작은 프로젝트는 브랜치 전략 도입 전까지 main에서 작업 가능. ## ② 런타임 상태 보호 (★사고 재발방지 핵심★) - **`agents.json`·`team.db` 같은 런타임 상태 파일을 worktree↔라이브 트리 사이에 심링크하지 않는다.** 각 worktree는 자기 **실파일**을 갖는다. - 이유: 심링크는 읽기·쓰기가 다 원본으로 통한다. worktree가 상태 파일에 쓰면 그 write가 **라이브 원본을 덮어써** 팀 전체를 날릴 수 있다(파일 write라 DB는 남아 "registry=[] · DB=정상"의 조용한 유실). - 읽기 위주 파일(스킬 등)의 심링크는 안전하지만, **자주 쓰이는 상태 파일은 절대 심링크 금지.** - 상태 파일에 **`>` 리다이렉트로 직접 쓰지 않는다.** 항상 임시파일 작성 → 검증 → 원자적 `mv`. ## ③ 백업 먼저 - registry(`agents.json`)/DB(`team.db`) 변경, 배포, 상태를 건드릴 수 있는 테스트 실행 **전에** `agents.json`+`team.db`를 타임스탬프 백업한다. 유실돼도 즉시 복구된다. ## ④ 테스트 FS 격리 - 테스트는 **실 파일시스템을 건드리지 않는다.** registry/DB/워크스페이스/토큰 파일은 `mktemp`/tmp로 격리하고, `TEAM_AGENT_REGISTRY` 등 registry 경로 env를 **tmp로 명시**한다. - env 격리만으로 부족한 경우(심링크·경로 기본값이 라이브를 가리킴)를 조심한다 — 격리는 "env를 읽는 코드"만 보호한다. ## ⑤ 릴리스·배포 가드 - 릴리스 산출물을 만드는 스크립트를 쓸 때, 출력(OUT)은 **항상 새 격리 dir**(예: `mktemp -d`)이며 **라이브 repo 루트가 아니어야** 한다. (`main`이 공개 정본이 된 뒤로는 별도 릴리스 생성 명령이 없다