[Repository] main 보호 규칙·필수 CI·보안 자동화 구성 #27

완료 기록

2026-07-23에 실제 저장소 설정과 Wiki를 기준으로 완료했습니다.

적용 완료

• main 변경은 Pull Request로만 허용
• 승인 1명 이상과 review conversation 해결 필수
• Test and build required status check와 최신 main 반영 필수
• 오래된 승인 자동 해제
• Admin 포함 보호 규칙 적용
• Force push와 main 삭제 금지
• Linear history와 Squash Merge만 허용
• 병합된 작업 branch 자동 삭제
• GitHub Actions 기본 권한은 read-only, workflow의 PR 승인 권한 없음 확인
• Secret scanning, Push protection, Dependabot security update 활성화
• 적용 규칙과 긴급 복구 절차를 GitHub 협업 가이드에 기록

권한과 CODEOWNERS 판단

현재 조직 구성원 8명은 조직 설정에서 이 저장소의 Admin 권한을 상속받습니다. 개별 사용자를 임의로 강등하면 조직의 다른 저장소 협업까지 영향을 줄 수 있으므로 이 이슈에서는 권한을 변경하지 않았습니다. 대신 enforce_admins=true로 Admin도 직접 push와 검증 없는 병합을 할 수 없게 했습니다.

현재 Server 실작업자는 두 명이고 파일 소유권과 상호 PR review 규칙이 Wiki에 정해져 있어 CODEOWNERS 필수 승인은 적용하지 않았습니다. 인원이 늘거나 reviewer 누락이 반복될 때 도입합니다.

완료 조건

• 일반 개발자와 Admin 모두 보호된 main에 직접 push할 수 없습니다.
• 실패한 CI, 승인 없음, 미해결 conversation이 있는 PR은 병합할 수 없습니다.
• 비상 변경 절차와 원상복구 기준이 Wiki에 기록됐습니다.
• 실제 Secret이나 개인정보를 문서와 설정에 추가하지 않았습니다.

관계

• 연결: [Architecture] 저장소 경계·모듈·API·이벤트 계약 ADR 작성 #23, [EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP #2
• Parent: [EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP #2