Files
2nd/10_Wiki/Topics_Blog/Frontend-Team-Collaboration-and-Governance.md
T

30 lines
2.6 KiB
Markdown

---
id: FE-TEAM-COLLAB-001
category: "10_Wiki/💡 Topics/AI"
confidence_score: 1.0
tags: [frontend, team-collaboration, governance, code-reviews, documentation, standard-operating-procedures]
last_reinforced: 2026-04-26
---
# Frontend Team Collaboration and Governance (프런트엔드 팀 협업 및 거버넌스)
## 📌 한 줄 통찰 (The Karpathy Summary)
> "코드의 품질은 개발자의 재능이 아니라 팀이 합의한 '시스템(규칙)'에서 나오며, 명확한 협업 프로토콜을 통해 지식의 파편화를 방지하고 제품의 일관성을 수호하라" — 대규모 조직에서 프런트엔드 개발의 예측 가능성과 효율성을 보장하는 거버넌스 체계.
## 📖 구조화된 지식 (Synthesized Content)
- **추출된 패턴:** "Standardized Workflow and Collective Responsibility" — PR 템플릿, 코드 리뷰 가이드라인, 자동화된 린팅/포맷팅 규칙을 통해 개인의 편차를 줄이고 팀 전체의 역량을 상향 평준화하는 패턴.
- **협업 핵심 요소:**
- **Code Governance:** ESLint, Prettier 설정을 통한 코드 스타일 강제. Husky를 활용한 Git Hooks 자동화.
- **Review Protocol:** 의미 있는 커밋 메시지 규칙(Conventional Commits), PR 단위의 작업 정의, 건설적인 코드 리뷰 문화.
- **Documentation Strategy:** 기술 설계 문서(RFC), Storybook을 활용한 컴포넌트 시각적 문서화, Wiki 기반의 도메인 지식 공유.
- **Standard Operating Procedures (SOP):** 버그 리포팅, 배포 승인 프로세스, 온보딩 가이드 등 반복적인 업무의 표준화.
- **의의:** 개발 속도의 병목을 제거하고 코드의 기술 부채 누적을 방지하며, 팀원 변경 시에도 프로젝트의 연속성을 유지함.
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- **과거 데이터와의 충돌:** 과거에는 개인의 코딩 스타일을 존중했으나, 현대 정책은 '팀 스타일 최우선 정책'으로 전환됨. 또한 문서화를 개발의 '부수적인 일'이 아닌 '개발의 일부 정책'으로 간주하여 병행 작업을 강제함.
- **정책 변화:** Antigravity 프로젝트는 모든 PR에 대해 최소 2인 이상의 승인(Approval)을 필수 정책으로 하며, 매 분기마다 기술 부채를 전담 처리하는 'Gardening Week' 정책을 시행함.
## 🔗 지식 연결 (Graph)
- [[Git-Branching-Strategies-and-Workflows|Git-Branching-Strategies-and-Workflows]], Pull-Request-Workflow, [[Clean-Code-Principles|Clean-Code-Principles]], Technical-Debt-Management
- **Raw Source:** 00_Raw/Frontend Team Collaboration.md