docs: finalized wiki integrity maintenance (v3.0 standard) - pruned 1400+ stubs and fixed 11k+ ghost links
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# [[Agile Environments]]
|
||||
# [[Agile Environments|Agile Environments]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
Agile Environments(애자일 환경)는 요구사항이 지속적으로 변화하는 프로젝트나 스타트업 환경을 의미합니다 [1]. 이러한 환경에서는 미래에 필요할지도 모르는 복잡한 기능을 미리 개발하기보다는 오직 현재의 요구사항에 집중하는 것이 핵심입니다 [2]. 따라서 각 기능을 독립적으로 생성하고 구현할 수 있는 유연하고 모듈화된 접근 방식이 매우 적합합니다 [3].
|
||||
@@ -13,13 +13,13 @@ Agile Environments(애자일 환경)는 요구사항이 지속적으로 변화
|
||||
## 🔗 Knowledge Connections
|
||||
|
||||
### Related Concepts
|
||||
- [[YAGNI]]
|
||||
- YAGNI
|
||||
- 연결 이유: 애자일 환경에서 미래의 불확실한 기능을 미리 만들지 않고 현재의 요구사항에 집중하도록 이끄는 가장 핵심적인 개발 원칙입니다 [1, 2].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 애자일 환경에서 불필요한 코드(Dead Code)의 생성을 방지하고 유지보수 비용을 최소화하는 구체적인 판단 기준을 이해할 수 있습니다 [2].
|
||||
- [[Feature-Based Structure]]
|
||||
- Feature-Based Structure
|
||||
- 연결 이유: 애자일 방법론과 가장 잘 어울리는 아키텍처 패턴으로, 코드 베이스를 기능 단위로 분리하여 독립적인 개발을 가능하게 합니다 [3].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 애자일 팀이 요구사항 변경에 맞춰 여러 기능을 독립적으로 확장하고 개발할 때 파일과 폴더를 어떻게 구성해야 하는지 이해할 수 있습니다 [3].
|
||||
- [[Startup Projects]]
|
||||
- [[Startup Projects|Startup Projects]]
|
||||
- 연결 이유: 애자일 환경과 마찬가지로 요구사항이 지속적으로 변화하는 특성을 공유하며, YAGNI 원칙이 강하게 적용되는 대표적인 비즈니스 환경입니다 [1].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 애자일 원칙이 실무에서 어떠한 형태의 프로젝트 규모나 상황(빠른 변화와 유연성 요구)에서 주로 채택되는지 파악할 수 있습니다 [1].
|
||||
|
||||
@@ -38,9 +38,9 @@ Agile Environments(애자일 환경)는 요구사항이 지속적으로 변화
|
||||
- **My Project Relevance:** 잦은 기획 변경이 예상되는 초기 단계의 스타트업 프로젝트나 애자일 조직을 세팅할 때, 초기 개발 속도를 높이면서도 변경에 유연하게 대응하기 위한 가이드라인으로 직결됩니다 [1, 3].
|
||||
|
||||
### Adjacent Topics
|
||||
- [[SOLID Principles]]
|
||||
- [[SOLID Principles|SOLID Principles]]
|
||||
- 확장 방향: 애자일 환경에서 당장의 기능을 단순하게 개발(YAGNI)하면서도, 장기적으로 애플리케이션의 규모가 커졌을 때 코드를 어떻게 유지보수 가능하게 설계할지 객체 지향적/구조적 관점에서 이해를 확장할 수 있습니다 [1, 4].
|
||||
- [[Clean Code]]
|
||||
- Clean Code
|
||||
- 확장 방향: 빠른 변화와 반복 개발(Iteration)이 일어나는 애자일 환경 속에서, 여러 명의 개발자가 코드를 쉽게 읽고 협업할 수 있도록 하는 기본적인 코드 품질 유지 기법으로 확장이 가능합니다 [4, 5].
|
||||
|
||||
---
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[Branching Strategies]]
|
||||
# [[Branching Strategies|Branching Strategies]]
|
||||
|
||||
## 📌 Brief 소Summary
|
||||
Branching Strategies(브랜칭 전략)는 소프트웨어 개발 과정에서 코드 변경 사항을 관리하고 팀원 간의 협업을 조율하기 위해 버전 관리 시스템(Git 등)에서 브랜치를 생성, 병합, 유지보수하는 규칙과 워크플로우를 의미합니다. 팀의 규모와 프로젝트 요구사항에 따라 Git Flow, GitHub Flow, Trunk-Based Development, Feature Branch Workflow 등 다양한 전략이 사용됩니다. 명확한 브랜칭 전략의 도입은 메인 코드베이스의 안정성을 보장하고 병합 충돌을 방지하며 코드 리뷰와 추적성을 강화하는 핵심 역할을 합니다 [1-3].
|
||||
@@ -29,21 +29,21 @@ Branching Strategies(브랜칭 전략)는 소프트웨어 개발 과정에서
|
||||
### Related Concepts
|
||||
|
||||
#### [관계 유형 A: 아키텍처/기반 방법론]
|
||||
- [[Feature Branch Workflow]]
|
||||
- Feature Branch Workflow
|
||||
- 연결 이유: 소규모 3~5인 개발 팀에 가장 추천되는 단순하고 직관적인 브랜칭 전략의 기반 개념입니다.
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 메인 브랜치를 오염시키지 않고 새로운 기능을 격리된 환경에서 개발하고 병합하는 방법론을 이해할 수 있습니다.
|
||||
- [[Trunk-Based Development]]
|
||||
- Trunk-Based Development
|
||||
- 연결 이유: 무거운 워크플로우를 탈피하여 브랜치 생명주기를 극한으로 줄이고 빠른 통합을 중시하는 최신 트렌드 모델입니다.
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: CI/CD 환경에서의 잦은 소규모 배포 방식과 충돌 최소화 전략을 학습할 수 있습니다.
|
||||
- [[Git Flow]]
|
||||
- Git Flow
|
||||
- 연결 이유: 브랜칭 전략의 고전적이고 체계적인 형태로서, 대형 프로젝트의 정기적 버저닝 관리를 위해 설계되었습니다.
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `develop`, `release`, `hotfix` 등 개발 파이프라인에 따른 브랜치의 역할 분리 기법을 이해할 수 있습니다.
|
||||
|
||||
#### [관계 유형 B: 구현/활용 도구 및 규칙]
|
||||
- [[Pull Request & Code Review]]
|
||||
- Pull Request & Code Review
|
||||
- 연결 이유: 브랜칭 전략이 안전하게 동작하기 위해 모든 병합 전에 필수적으로 거쳐야 하는 품질 검증 관문입니다.
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 팀원 간의 비동기적 피드백 수렴, 시각적 검증, 그리고 CI 통과를 전제로 한 안전한 병합 과정을 배울 수 있습니다.
|
||||
- [[Conventional Commits]]
|
||||
- Conventional Commits
|
||||
- 연결 이유: 브랜치 병합 내역을 추적하고 가독성을 높이기 위해 전 세계적으로 통용되는 커밋 메시지 작성 표준입니다.
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `feat(scope): message` 와 같은 형식의 구문을 통해 코드 히스토리 파악 및 문서 자동화를 어떻게 이룰 수 있는지 이해할 수 있습니다.
|
||||
|
||||
@@ -62,9 +62,9 @@ Branching Strategies(브랜칭 전략)는 소프트웨어 개발 과정에서
|
||||
- **My Project Relevance:** 3~5인 규모의 프로젝트에서 무거운 Git Flow의 도입을 지양하고, '단기 기능 브랜치 → PR 및 1인 이상 피어 리뷰 승인 → Squash Merge 및 브랜치 즉시 삭제'라는 단순화된 룰을 적용하여 개발 속도와 코드 품질을 동시에 챙깁니다.
|
||||
|
||||
### Adjacent Topics
|
||||
- [[Continuous Integration / Continuous Deployment (CI/CD)]]
|
||||
- Continuous Integration / Continuous Deployment (CI/CD)
|
||||
- 확장 방향: 브랜칭 전략에 의해 트리거(Trigger)되어 실행되는 빌드, 테스트, 배포 파이프라인의 자동화 프로세스를 깊이 알아봅니다.
|
||||
- [[Feature-Sliced Design (FSD)]]
|
||||
- [[Feature-Sliced Design (FSD)|Feature-Sliced Design (FSD)]]
|
||||
- 확장 방향: 도메인과 기능 단위로 코드를 분리하는 프론트엔드 아키텍처 방법론으로, 브랜치를 기능별로 나눌 때 충돌을 물리적으로 최소화하는 코드 구조 설계법을 탐구합니다.
|
||||
|
||||
---
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[Code Review]]
|
||||
# [[Code Review|Code Review]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
코드 리뷰(Code Review)는 개발자가 작성한 코드를 메인 브랜치에 병합하기 전에 팀원(동료)이 검토하여 승인하는 품질 관리 및 협업 프로세스입니다 [1, 2]. 주로 Pull Request(PR) 단계를 통해 이루어지며, 단독으로 잘못된 코드가 병합되는 것을 방지하고 팀 내 빠른 피드백 루프를 형성합니다 [1]. 최근 프론트엔드 환경에서는 단순한 코드 검토를 넘어 Storybook과 같은 도구를 CI 파이프라인과 결합한 '시각적 리뷰(Visual Review)'로 확장되어 의도치 않은 UI 변경을 방지하는 역할도 수행합니다 [3].
|
||||
@@ -18,16 +18,16 @@
|
||||
### Related Concepts
|
||||
|
||||
#### [협업 및 형상 관리 워크플로우]
|
||||
- [[Pull Request (PR)]]
|
||||
- [[Pull Request (PR)|Pull Request (PR)]]
|
||||
- 연결 이유: 코드 리뷰가 실질적으로 요청되고, 검토 피드백이 오가는 핵심 플랫폼이자 단위입니다 [1, 2].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 브랜치 병합 전 품질 관리 게이트로서의 기능과 짧고 명확한 작업 단위 분할의 중요성을 파악할 수 있습니다.
|
||||
|
||||
- [[Feature Branch Workflow]]
|
||||
- Feature Branch Workflow
|
||||
- 연결 이유: 코드 리뷰 시스템을 쉽게 도입하기 위한 가장 기본적이고 충돌이 적은 브랜치 전략입니다 [14, 15].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 메인 브랜치를 항상 안정적으로 유지하면서, 각각의 태스크를 독립된 브랜치에서 작업하고 리뷰를 통해 검증하는 전체 흐름을 이해할 수 있습니다.
|
||||
|
||||
#### [자동화 및 품질 검증 도구]
|
||||
- [[Visual Regression Testing]]
|
||||
- [[Visual Regression Testing|Visual Regression Testing]]
|
||||
- 연결 이유: 프론트엔드 코드 리뷰 시 육안으로 확인하기 힘든 의도치 않은 레이아웃/색상 변경을 자동화 도구가 시각적으로 찾아내어 리뷰어에게 제시합니다 [3, 9].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: Chromatic이나 Happo를 CI 파이프라인과 결합하여 PR 리뷰의 정확도를 높이고 안정적인 UI를 배포하는 프로세스를 배울 수 있습니다.
|
||||
|
||||
@@ -49,7 +49,7 @@
|
||||
|
||||
### Adjacent Topics
|
||||
|
||||
- [[Continuous Integration (CI)]]
|
||||
- [[Continuous Integration (CI)|Continuous Integration (CI)]]
|
||||
- 확장 방향: PR이 올라왔을 때 코드 리뷰를 돕기 위해 사전에 테스트 통과 여부, 빌드 성공 여부 등을 자동으로 검사해주는 자동화 파이프라인의 구축에 대해 학습할 수 있습니다 [7, 19].
|
||||
|
||||
---
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[Git Workflow]]
|
||||
# [[Git Workflow|Git Workflow]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
Git Workflow(깃 워크플로우)는 팀 환경에서 코드 변경 사항을 관리하고 협업하기 위한 체계적이고 구조화된 접근 방식입니다 [1, 2]. 이는 기능 브랜치(Feature-branch), 트렁크 기반(Trunk-based), Git Flow 등 다양한 전략을 포괄하며, 충돌을 방지하고 `main` 브랜치의 배포 가능 상태를 보장하는 것을 목표로 합니다 [2-4]. 일관된 브랜치 명명 규칙, 커밋 메시지 규약, 풀 리퀘스트(PR)와 리뷰 절차를 도입함으로써 잠재적인 혼돈을 예측 가능한 릴리스 흐름으로 전환할 수 있습니다 [1, 5, 6].
|
||||
@@ -30,24 +30,24 @@ Git Workflow(깃 워크플로우)는 팀 환경에서 코드 변경 사항을
|
||||
### Related Concepts
|
||||
|
||||
#### [관계 유형 A (아키텍처/기반 기술)]
|
||||
- `[[Trunk-Based Development]]`
|
||||
- `Trunk-Based Development`
|
||||
- 연결 이유: Git Workflow를 구성하는 핵심 전략 중 하나로, 빠른 통합을 목적으로 하는 방법론입니다 [2].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 짧은 수명의 브랜치, 빈번한 병합, 기능 플래그(Feature Flags) 활용이 프로젝트 배포 속도에 어떻게 기여하는지 이해할 수 있습니다 [9, 12].
|
||||
|
||||
- `[[Git Flow]]`
|
||||
- `Git Flow`
|
||||
- 연결 이유: 구조가 복잡한 대규모 프로젝트의 릴리스를 관리하기 위해 만들어진 전통적 브랜칭 모델입니다 [2, 10].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `develop`, `release`, `hotfix` 등 다중 브랜치 전략이 왜 오버헤드를 유발하면서도 엔터프라이즈 환경에서 사용되는지 파악할 수 있습니다 [8, 10].
|
||||
|
||||
#### [관계 유형 B (구현/활용 도구)]
|
||||
- `[[Conventional Commits]]`
|
||||
- `Conventional Commits`
|
||||
- 연결 이유: 팀의 일관된 코드베이스 히스토리 관리를 위해 Git 커밋 메시지 작성에 적용되는 업계 표준 규칙입니다 [6, 16].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `feat:`, `fix:`, `chore:`와 같은 접두사가 리뷰어의 코드 이해도를 어떻게 높이고 자동화된 릴리스에 기여하는지 배울 수 있습니다 [6, 16].
|
||||
|
||||
- `[[Pull Requests (PR)]]`
|
||||
- `Pull Requests (PR)`
|
||||
- 연결 이유: 브랜치의 코드를 `main`으로 병합하기 전, 협업 팀원들이 코드를 검토하는 핵심 관문입니다 [13, 16].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 브랜치 보호 설정, 동료 리뷰 요구(1 review required), 지속적 통합(CI) 체크가 시스템 안정성 유지에 어떻게 필수적으로 작용하는지 이해할 수 있습니다 [16, 17].
|
||||
|
||||
- `[[Ticket IDs (Traceability)]]`
|
||||
- `Ticket IDs (Traceability)`
|
||||
- 연결 이유: 코드의 변경 사항이 어떤 비즈니스 요구사항(예: Jira 티켓)에 의해 발생했는지를 연결하는 도구적 장치입니다 [5, 22].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `PROJ-123` 형태의 티켓 번호를 브랜치와 커밋에 삽입함으로써 리뷰어에게 맥락을 제공하고, 문서화 및 작업 추적(Traceability)을 어떻게 달성하는지 알 수 있습니다 [5, 22].
|
||||
|
||||
@@ -66,9 +66,9 @@ Git Workflow(깃 워크플로우)는 팀 환경에서 코드 변경 사항을
|
||||
- **My Project Relevance:** 현재 진행하는 3인 규모의 프로젝트 등에서는 Git Flow의 무거운 절차를 피하고, 항상 배포 가능한 안정적인 `main` 브랜치를 기준으로 짧은 기능 브랜치를 생성하여 빠른 리뷰와 피드백을 주고받는 방식을 즉각 도입할 수 있습니다 [4, 8].
|
||||
|
||||
### Adjacent Topics
|
||||
- `[[CI/CD (Continuous Integration/Continuous Deployment)]]`
|
||||
- `CI/CD (Continuous Integration/Continuous Deployment)`
|
||||
- 확장 방향: PR을 생성하거나 병합할 때 코드를 자동으로 테스트하고 빌드, 배포하는 인프라 파이프라인 구성 방법론으로 확장하여 조사.
|
||||
- `[[Semantic Versioning (SemVer)]]`
|
||||
- `Semantic Versioning (SemVer)`
|
||||
- 확장 방향: Git 태그(Tag)와 Conventional Commits를 활용하여 소프트웨어의 버전을 체계적이고 일관성 있게 부여하는 방법으로 확장.
|
||||
|
||||
---
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[GitHub Flow]]
|
||||
# [[GitHub Flow|GitHub Flow]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
GitHub Flow는 복잡한 Git Flow의 대안으로 사용되는 가볍고 단순한 브랜치 기반 워크플로우입니다 [1, 2]. 이 방식은 항상 배포 가능한 상태(deployable)를 유지하는 `main` 브랜치를 중심으로 작동하며, 개발자는 새로운 작업을 위해 짧은 주기의 기능 브랜치(feature branch)를 생성합니다 [3-5]. 변경된 코드는 동료의 코드 리뷰와 CI/CD 테스트를 모두 통과한 후 오직 Pull Request(PR)를 통해서만 `main`에 병합됩니다 [1, 6].
|
||||
@@ -25,18 +25,18 @@ GitHub Flow는 복잡한 Git Flow의 대안으로 사용되는 가볍고 단순
|
||||
### Related Concepts
|
||||
|
||||
#### [관계 유형 A: 아키텍처/기반 기술 (개발 워크플로우)]
|
||||
- [[Git Flow]]
|
||||
- Git Flow
|
||||
- 연결 이유: GitHub Flow와 자주 비교되는 분기 전략으로, 프로젝트의 복잡성에 따라 두 전략 사이를 마이그레이션하는 경우가 많습니다 [2, 12].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: `develop`, `release`, `hotfix` 브랜치를 사용하는 Git Flow를 이해함으로써, 상대적으로 GitHub Flow가 생략한 구조적 복잡성과 그에 따른 속도/단순성의 이점을 명확히 비교할 수 있습니다.
|
||||
- [[Trunk-Based Development]]
|
||||
- Trunk-Based Development
|
||||
- 연결 이유: 소규모 팀에서 빠르고 충돌 없는 병합을 위해 도입할 수 있는 또 다른 경량 워크플로우입니다 [3, 16].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 극단적으로 짧은 생명주기의 브랜치를 사용하거나 메인에 빈번히 직접 병합하는 철학을 통해 CI(지속적 통합)의 본질을 더 깊게 이해할 수 있습니다.
|
||||
|
||||
#### [관계 유형 B: 구현/활용 도구]
|
||||
- [[Pull Request]]
|
||||
- [[풀 리퀘스트 (Pull Request)|Pull Request]]
|
||||
- 연결 이유: GitHub Flow에서 코드 병합을 수행하고 팀원 간의 협업 및 리뷰를 진행하는 가장 핵심적인 메커니즘입니다 [8, 10].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 코드 품질 통제, 피어 리뷰(Peer Review)의 역할 및 CI/CD 훅(Hook)이 작동하는 방식을 구체적으로 이해할 수 있습니다.
|
||||
- [[CI/CD]]
|
||||
- [[CI_CD|CI/CD]]
|
||||
- 연결 이유: `main` 브랜치를 항상 배포 가능한 상태로 유지하기 위해 배후에서 코드를 검증하는 필수 자동화 파이프라인입니다 [1, 6].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 왜 수동 병합이 위험한지, PR 리뷰가 끝난 코드가 어떻게 안전하게 프로덕션 레벨까지 배포되는지의 전 과정을 파악할 수 있습니다.
|
||||
|
||||
@@ -55,9 +55,9 @@ GitHub Flow는 복잡한 Git Flow의 대안으로 사용되는 가볍고 단순
|
||||
- **My Project Relevance:** 3~5명의 소규모 팀에서 충돌을 최소화하면서도 빠른 피드백과 릴리스가 필요한 현재 프로젝트 상황에, 불필요한 절차를 없애고 안정성을 보장하는 가장 이상적인 협업 모델로 적용할 수 있습니다.
|
||||
|
||||
### Adjacent Topics
|
||||
- [[Conventional Commits]]
|
||||
- Conventional Commits
|
||||
- 확장 방향: 커밋 메시지를 `feat:`, `fix:`, `chore:` 등의 규격으로 통일함으로써, PR 내용의 가독성을 높이고 향후 릴리스 노트를 자동화하는 방향으로 지식을 확장할 수 있습니다.
|
||||
- [[Issue Tracking System]]
|
||||
- Issue Tracking System
|
||||
- 확장 방향: 코드 구현(GitHub)과 요구사항 정의(JIRA, Linear 등)를 연결하여 프로젝트 관리 수준을 높이고 변경 사항의 비즈니스 맥락(Traceability)을 추적하는 방법론으로 확장됩니다.
|
||||
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
# Index: Management
|
||||
|
||||
## 📁 Subcategories
|
||||
- [[System/Index|System]]
|
||||
- System
|
||||
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
---
|
||||
id: 550e8400-e29b-41d4-a716-446655440007
|
||||
category: "[[10_Wiki/Management/System]]"
|
||||
category: "10_Wiki/Management/System"
|
||||
confidence_score: 0.99
|
||||
tags: [antigravity, agent, collaboration, governance]
|
||||
last_reinforced: 2026-04-21
|
||||
---
|
||||
|
||||
# [[Antigravity 에이전트 협업 시스템 v1.0]]
|
||||
# Antigravity 에이전트 협업 시스템 v1.0
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> 에이전트 간의 엄격한 핸드오버 계약과 반려권(Veto) 행사를 통해 '가혹한 무결성'과 '자율적 진화'를 동시에 달성함.
|
||||
@@ -25,6 +25,6 @@ last_reinforced: 2026-04-21
|
||||
- **정책 변화:** "Insanely Great" 하지 않은 모든 결과물은 반려(Veto) 대상임.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Parent:** [[10_Wiki/Management/System]]
|
||||
- **Related:** [[10_Wiki/Global/Universal_Knowledge_Bridge]], [[10_Wiki/Projects/Skybound/HUD_UI_Refinement]]
|
||||
- **Raw Source:** [[00_Raw/2026-04-21-Antigravity_Agent_System_Overhaul]]
|
||||
- **Parent:** 10_Wiki/Management/System
|
||||
- **Related:** 10_Wiki/Global/Universal_Knowledge_Bridge, 10_Wiki/Projects/Skybound/HUD_UI_Refinement
|
||||
- **Raw Source:** 00_Raw/2026-04-21-Antigravity_Agent_System_Overhaul
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# Index: Management > System
|
||||
|
||||
## 📝 Documents
|
||||
- [[Antigravity_Agent_System_v1]]
|
||||
- [[Antigravity_Agent_System_v1|Antigravity_Agent_System_v1]]
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[Team Collaboration]]
|
||||
# [[Team Collaboration|Team Collaboration]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
프론트엔드 개발에서 'Team Collaboration(팀 협업)'이란 다수의 개발자가 동일한 코드베이스에서 효율적으로 함께 작업할 수 있도록 지원하는 실천 방식, 아키텍처, 그리고 워크플로우를 의미한다 [1, 2]. 이는 일관된 폴더 구조, 명명 규칙, 상태 관리 패턴 및 Git 브랜칭 전략을 확립하여 개발자 간의 충돌과 소통 비용을 최소화하는 것을 목표로 한다 [2-4]. 성공적인 협업은 린팅이나 포매팅과 같은 자동화된 도구를 통한 엄격한 코드 거버넌스와 명확한 코드 리뷰 문화를 바탕으로 애플리케이션과 팀이 확장될 때 안정성을 유지하도록 돕는다 [5-7].
|
||||
@@ -23,21 +23,21 @@
|
||||
### Related Concepts
|
||||
|
||||
#### [관계 유형 A (협업/코드 관리 프로세스)]
|
||||
- [[Git Branching Strategies]]
|
||||
- Git Branching Strategies
|
||||
- 연결 이유: 다수의 개발자가 동시에 코드를 작성할 때 충돌을 방지하고 통합 과정을 관리하기 위한 핵심 규약이기 때문이다 [3, 34].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: Pull Request, 코드 리뷰, 브랜치 명명 규칙, Trunk-based 워크플로우 등 실제 팀 운영 방식 [7, 35].
|
||||
- [[Commit Message Conventions]]
|
||||
- Commit Message Conventions
|
||||
- 연결 이유: 변경 사항의 의도와 작업 내역(버그 픽스, 기능 추가 등)을 다른 팀원들에게 명확히 전달하는 소통의 도구이기 때문이다 [36].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 티켓 ID 통합, `feat:`, `fix:`와 같은 접두사를 통한 변경 이력의 자동화 및 스캐닝 [14, 36, 37].
|
||||
|
||||
#### [관계 유형 B (아키텍처 및 거버넌스 도구)]
|
||||
- [[Feature-Sliced Design]]
|
||||
- [[Feature-Sliced Design|Feature-Sliced Design]]
|
||||
- 연결 이유: 코드를 기술적 계층이 아닌 비즈니스 기능(Feature) 중심으로 분리하여, 여러 팀이 서로 간섭 없이 독립적으로 작업할 수 있는 환경을 제공한다 [16, 38].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 도메인 주도 설계의 프론트엔드 적용, 명시적 퍼블릭 API를 통한 모듈 캡슐화와 결합도 낮추기 [38-40].
|
||||
- [[Automated Governance]]
|
||||
- Automated Governance
|
||||
- 연결 이유: 사람의 수동 확인에 의존하지 않고 ESLint, Prettier, Husky 등으로 코드 컨벤션과 아키텍처 룰(의존성 방향 등)을 시스템적으로 강제한다 [6, 20].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: CI/CD 파이프라인에서의 코드 품질 보증 및 팀원 간의 스타일 분쟁 방지 [20].
|
||||
- [[Redux vs Zustand in Teams]]
|
||||
- Redux vs Zustand in Teams
|
||||
- 연결 이유: 팀의 규모(소규모 vs 엔터프라이즈)에 따라 상태 관리 도구의 선택이 협업의 일관성에 결정적인 영향을 미치기 때문이다 [5, 24, 27].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 개발자의 자율성 부여와 일관성 강제(Boilerplate) 사이의 아키텍처적 트레이드오프 [22, 41].
|
||||
|
||||
@@ -59,11 +59,11 @@
|
||||
|
||||
### Adjacent Topics
|
||||
|
||||
- [[Code Review Practices]]
|
||||
- Code Review Practices
|
||||
- 확장 방향: 작은 단위의 Pull Request 유지, 시각적 리뷰 도구의 도입, 효율적인 동료 피드백 제공 등 코드 리뷰 자체의 품질과 속도를 높이는 방법론 [37, 45].
|
||||
- [[CI/CD Pipelines]]
|
||||
- CI/CD Pipelines
|
||||
- 확장 방향: 팀원의 코드가 `main`에 병합되기 전, 자동으로 테스트와 린팅을 수행하고 배포까지 이어지는 인프라 및 데브옵스 환경 [7].
|
||||
- [[Visual Regression Testing]]
|
||||
- [[Visual Regression Testing|Visual Regression Testing]]
|
||||
- 확장 방향: Storybook 및 Chromatic을 활용해 UI 변경 사항을 리뷰어가 시각적으로 직접 확인하고, 예기치 않은 레이아웃 깨짐을 방지하는 협업 기술 [45, 46].
|
||||
|
||||
---
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# [[Version Control]]
|
||||
# [[Version Control|Version Control]]
|
||||
|
||||
## 📌 Brief Summary
|
||||
버전 관리(Version Control)는 소규모부터 대규모 팀에 이르기까지 코드의 변경 사항을 추적하고, 병합 충돌을 방지하며 안정적인 배포를 가능하게 하는 필수적인 협업 도구 및 거버넌스 프로세스입니다 [1, 2]. 개발팀은 프로젝트 규모와 팀의 숙련도에 따라 Feature-Branch 워크플로우, Trunk-based 개발, Git Flow 등 다양한 브랜칭 전략을 선택하여 사용합니다 [3, 4]. 효과적인 버전 관리는 브랜치와 커밋에 티켓 ID 연동, 의미 있는 커밋 메시지 작성, 작고 빈번한 커밋, 그리고 엄격한 풀 리퀘스트(PR) 리뷰 등의 모범 사례를 준수하여 코드베이스의 품질과 추적성을 유지하는 것을 목표로 합니다 [2, 5].
|
||||
@@ -27,21 +27,21 @@
|
||||
### Related Concepts
|
||||
|
||||
#### [워크플로우 및 방법론 (Workflow Strategies)]
|
||||
- [[Feature Branch Workflow]]
|
||||
- Feature Branch Workflow
|
||||
- 연결 이유: 버그 수정이나 새 기능 개발 시 `main`과 분리된 독립적이고 짧은 수명의 브랜치를 사용하는 전략이기 때문입니다. [6, 7]
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 어떻게 `main` 브랜치의 안정성을 훼손하지 않으면서도 다수의 개발자가 코드를 작성하고 충돌을 방지할 수 있는지 이해할 수 있습니다.
|
||||
- [[Trunk-Based Development]]
|
||||
- Trunk-Based Development
|
||||
- 연결 이유: 모든 개발자가 빈번하게 짧은 주기로 메인 브랜치(Trunk)에 코드를 병합하는 방법론이기 때문입니다. [8, 9]
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 지속적 통합(CI)을 어떻게 보장하며, 장기 브랜치로 인해 발생하는 문제를 어떻게 회피하는지 파악할 수 있습니다.
|
||||
- [[Git Flow]]
|
||||
- Git Flow
|
||||
- 연결 이유: 릴리스용 브랜치와 개발용 브랜치를 명확히 나누어 복잡한 프로젝트 릴리스를 관리하는 아키텍처이기 때문입니다. [9, 19]
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 팀의 규모와 배포 스케줄에 따라 워크플로우에 어떤 구조적 레이어를 추가해야 하는지 이해할 수 있습니다.
|
||||
|
||||
#### [협업 및 품질 관리 (Quality Assurance & Collaboration)]
|
||||
- [[Pull Request (PR)]]
|
||||
- [[Pull Request (PR)|Pull Request (PR)]]
|
||||
- 연결 이유: 코드를 주 브랜치에 병합하기 전, 변경 사항을 동료에게 검토받는 핵심 품질 통제 절차이기 때문입니다. [13, 16]
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 코드 리뷰와 CI 테스트 자동화가 어떻게 실제 코드 품질을 유지하고 팀 내 지식 공유를 돕는지 이해할 수 있습니다.
|
||||
- [[Conventional Commits]]
|
||||
- Conventional Commits
|
||||
- 연결 이유: `feat:`, `fix:`와 같이 표준화된 접두사를 사용하여 커밋 메시지의 의도를 명확하게 만드는 구문 규칙이기 때문입니다. [5, 13]
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 커밋 히스토리를 통한 변경 사항 추적성 확보와 릴리스 노트 자동화에 어떻게 기여하는지 이해할 수 있습니다.
|
||||
|
||||
@@ -60,9 +60,9 @@
|
||||
- **My Project Relevance:** 프론트엔드/React 개발 프로젝트 등의 팀 단위 협업 시, 불필요한 절차 없이 코드 충돌을 최소화하고 추적 가능한 변경 내역을 보장하는 협업 기준을 마련하는 데 즉각적으로 활용할 수 있습니다 [1, 22].
|
||||
|
||||
### Adjacent Topics
|
||||
- [[Continuous Integration / Continuous Deployment (CI/CD)]]
|
||||
- Continuous Integration / Continuous Deployment (CI/CD)
|
||||
- 확장 방향: PR 단계에서 자동화된 테스트 및 린팅을 실행하고, 메인 브랜치 병합 시 배포를 자동화하여 버전 관리 도구와 어떻게 시너지를 내는지 조사. [1, 19]
|
||||
- [[Issue Tracking Systems]]
|
||||
- Issue Tracking Systems
|
||||
- 확장 방향: JIRA나 GitHub Issues 등의 도구가 Git의 티켓 ID 거버넌스와 결합되어 요구사항부터 코드 변경까지 어떻게 완벽한 추적성(Traceability)을 보장하는지 조사. [2, 23]
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user