저장소 경계와 문서 작업

2026-09-09 사용자 결정, 앱 이슈 #1463, 적용 대상 앱 릴리스 v0.17.7. 문서 저장소는 dekerd/Barbelic-docs다. "앱 검사가 읽는 문서는 앱에 남긴다"는 이전 제안은 채택하지 않았다. 모든 문서·정책 원문을 이 저장소로 옮기고 앱의 문서 의존 검사를 실제 동작 검사로 바꾼다.

소유자	내용
dekerd/Barbelic	앱·공통 백엔드·SQL/마이그레이션·실행 정책 구현·빌드/배포 설정·앱 자산·고정 QA1 버전 호출
dekerd/Barbelic-QA1	기존 앱 Full CI 테스트·fixture·helper·검사 전용 실행기와 테스트 설정. 앱의 제품 코드를 검증하는 비공개 저장소
dekerd/Barbelic-QA2	제품 약속 기반 독립 검증 시스템(계획·실행기·시나리오·판정·보고). 앱이 qa2.lock.json으로 고정 호출하는 승격 CI 필수 검사(2026-09-15 #1604). QA1 코드·fixture에 의존하지 않는다
dekerd/Barbelic-docs	관리자 프론트엔드와 모든 설명·명세·계약·정책 JSON/CSV·로드맵·업데이트·장애 보고·운영 절차·에이전트 지침·README·약관 원문
dekerd/Barbelic-landing	랜딩 화면 코드·이미지·전용 의존성/테스트·CI·배포 실행 설정
dekerd/Barbelic-preview	디자인 세션용 라이브 프리뷰 도구(워크트리·포트 풀·staging 연결·기기 틀). 앱 소스를 읽지 않으며 앱 release 큐·앱 CI 와 무관. 절차는 디자인 세션 프리뷰 (2026-09-15 Barbelic-preview #2)

2026-09-14 사용자 결정 앱 #1591·QA1 #1: 기존 앱 Full CI용 테스트 전체를 Barbelic-QA1로 이관한다. QA1의 suite/ 아래에 기존 앱 상대경로를 보존하고, 앱의 qa1.lock.json에 고정한 QA1 커밋과 suite tree를 확인해 검사 실행에 필요한 파일을 준비한다. 준비된 파일은 Git 추적 대상에서 제외하며 테스트의 원본 수정은 QA1에서 한다. 앱 제품 파일이나 사용자의 수정 파일을 덮어쓰지 않는다. QA2는 독립 검증의 소유권과 판정을 유지하며 이번 이관에 합치지 않는다. 구체적 운영 및 이관·검증·반영 상태는 QA1 안내를 따른다.

2026-09-15 사용자 지시 앱 #1604: QA2를 GitHub Full CI의 필수 검사 job으로 추가해 release→staging·staging→main 승격 PR에 적용한다. QA1 lane은 유지한다. 앱은 qa2.lock.json으로 QA2 커밋을 고정하고 읽기 전용 deploy key로 읽는다. 운영 방법은 QA2 승격 게이트를 따른다.

2026-09-09 후속 사용자 결정: 랜딩 수정마다 앱 full CI가 실행되는 결합을 없애기 위해 사용자가 만든 Barbelic-landing으로 기존 랜딩 구현을 직접 반입한다. 기존 앱의 /landing 공개 이슈 #1473은 삭제하고, 랜딩을 앱 v0.17.7 release 큐에 넣는 계획을 폐기한다. 앱의 v0.18.0 도메인 이전 #1474는 유지한다. 이번 초기 반입은 사용자 요청에 따라 새 랜딩 저장소 main으로 직접 반영하며, 이후 랜딩 변경은 해당 저장소의 PR·전용 CI와 독립 배포를 따른다. 앱 checkout·앱 의존성·DB가 랜딩 빌드나 검사의 선행 조건이 되지 않는다. 실행·현재 연결 상태는 랜딩 안내에 기록한다.

같은 날 추가 요청 #1477: 앱에 남은 홍보 랜딩 구현·자산·설정·테스트·중복 문서와 분류 참조를 v0.17.7에서 제거한다. 2026-09-10 통합 PR #1484의 release merge e56604cb와 staging PR #1488의 213aaeb7로 반영됐으며, main·Production 완료는 이 기록에서 확정하지 않는다. 랜딩 원본은 독립 코드 저장소와 이 문서 저장소에 유지한다. 제거 PR은 실제 앱 저장소 변경이므로 앱 릴리스 검증을 따르며, 이후 랜딩 단독 변경의 독립 CI 원칙은 그대로다. 병합 자동화의 landing-* 명령·파일은 홍보 사이트와 무관하다. 도메인·PWA 이전은 #1474의 범위다.

2026-09-14 최신 사용자 예외: 앱 최상위 AGENTS.md에 설계·작업 원칙 원문과 필독 지시를 둔다. 모든 Barbelic 작업 세션은 착수·재개 전에 이 앱 지침을 반드시 읽는다. 원칙 본문은 이 저장소의 설계·작업 원칙 및 최상위 AGENTS.md와 동일하게 유지한다. 기존의 앱 AGENTS 링크 한 줄·수정 금지 지시는 이 예외로 대체하며, 다른 문서의 소유권은 그대로 이 저장소에 둔다. 문서 원문이나 안내 링크를 강제하는 앱 CI는 추가하지 않는다.

앱 설치·빌드·테스트에는 문서 저장소 checkout이나 네트워크 접근이 필요하지 않다. 관리자도 앱 checkout·submodule·앱 내부 소스에 의존하지 않는다. 공통 백엔드와 마이그레이션은 앱 저장소 한 곳이 소유하고, 관리자와 앱은 배포된 서버 계약을 사용한다. DB와 사용자 데이터를 이관하는 작업은 아니다.

앱 CI에서 Markdown 문구·표·경로·해시·보고서 존재·문서 생성 결과를 통과 조건으로 삼지 않는다. 수치와 제품 정책은 버전 있는 코드·SQL·독립 테스트 예제로 검증하며 수치·정밀도·기존 식별자·계산 결과를 보존한다. 검증 대상 함수의 결과를 그대로 예상값으로 재사용하지 않는다. 과거 마이그레이션에 기록된 출처 경로와 정책 식별자는 이관을 위해 다시 쓰지 않는다.

약관 원문은 이 저장소의 public/legal/terms-vN.html, privacy-vN.html에서 작성해 문서 사이트의 /legal/ 주소에 게시한다. 앱은 버전별 주소·식별자와 동의 처리 코드에 더해, 2026-09-15 사용자 결정 #1643(앱 v0.19.3)부터 같은 원문의 사본을 자체 public/legal/·public/account/에 두고 앱 origin에서 직접 제공한다(문서 사이트로의 rewrite·개발 서버 프록시 없음). 사본은 이 저장소의 게시본과 바이트 단위로 같아야 하며, 동의 기록이 가리키는 기준은 앱 사본이다. 앱 검사 scripts/check-legal-documents.mjs가 식별자·버전·뷰어 마커·약관/처리방침 쌍·게시본 불변·레지스트리 경로의 파일 존재를 확인한다. 이미 게시한 버전은 수정·삭제·이름 변경할 수 없으며, 새 문구는 새 버전으로 낸다. 문서 CI의 약관 검사는 이 저장소의 Git 이력과 메타데이터만 확인한다.

모든 작업자는 착수 시 이 저장소의 최신 상태와 공통 규칙, 해당 작업의 정책·설계·절차를 읽는다. 코드와 문서의 적용 버전 차이를 확인하고, 구현으로 계약·운영 방식이 바뀌면 같은 저장소에서 문서를 갱신한다. 코드/문서 PR·커밋을 서로 연결하고 적용 릴리스를 적는다. 진행·버그·업데이트 기록을 남기기 위해 앱에 추가 커밋을 만들지 않는다.

문서만 수정하면 문서 검사·게시로 끝난다. 문서 게시가 실행 정책을 바꾸거나 앱 CI를 자동 실행하지 않는다. Codex·Claude 등 작업자의 전역·워크스페이스 지침은 앱 최상위 AGENTS.md의 필독과 이 저장소의 상세 지침 참조를 명시한다. 실행 중 세션의 자동 재로딩을 가정하지 않는다. 다른 세션에 대한 메시지 전파는 사용자의 명시적인 중단 지시를 따른다.

앱 release→staging→main 절차와 데이터 보호는 유지한다. 이전 문서의 docs/admin 결합 빌드·앱 main 문서 직행은 이관 전 기록이며, 독립 문서·관리자 검증/게시 기준은 문서·관리자 운영을 따른다. 코드 이관·원격 연결·실제 배포 완료는 별도 상태로 기록한다.