[G1-Sync] Manual knowledge update

2026-05-01 20:45:18 +09:00
parent e56d8c7cf9
commit 13f58a24de
40 changed files with 1577 additions and 23 deletions
@@ -0,0 +1,35 @@
+---
+id: P-REINFORCE-AUTO-WIKI-DEV-003
+category: "10_Wiki/💡 Topics/Development"
+confidence_score: 0.95
+tags: [development, ci-cd, automation, quality-gate, devops, p-reinforce]
+last_reinforced: 2026-05-01
+---
+
+# [[CI-CD Pipeline]]
+
+## 📌 한 줄 통찰 (The Karpathy Summary)
+> "소프트웨어의 빌드, 테스트, 배포 전 과정을 자동화하여, 인간 리뷰어보다 먼저 결함을 찾아내는 '기계적 파수꾼'이자 배포의 신뢰성을 보장하는 핵심 인프라."
+
+## 📖 구조화된 지식 (Synthesized Content)
+CI-CD는 현대적 개발 워크플로우에서 품질과 속도를 동시에 잡는 핵심 엔진입니다.
+
+1.  **자동화된 품질 게이트 (Quality Gates)**:
+    *   **CI (Continuous Integration)**: 코드 변경 시마다 빌드와 테스트를 자동으로 수행합니다. 린터, SAST, SCA 등이 통합되어 인간 리뷰어에게 도달하기 전 기초 결함을 필터링합니다.
+    *   **CD (Continuous Delivery/Deployment)**: 검증된 코드를 스테이징이나 프로덕션 환경으로 자동 배포합니다.
+2.  **병합 차단 (Blocking Merges)**:
+    *   자동화 테스트가 실패하거나 보안 스캔에서 취약점이 발견되면 메인 브랜치로의 병합을 시스템적으로 차단하여 안전성을 확보합니다.
+3.  **인지 부하 감소**:
+    *   사소한 스타일 위반이나 오타 등은 기계가 처리하므로, 인간 리뷰어는 아키텍처와 비즈니스 로직 같은 고차원적 검토에 집중할 수 있습니다.
+
+## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
+- **파이프라인 지연의 역설**: 품질 검증을 위해 너무 많은 단계(무거운 E2E 테스트 등)를 추가하면 파이프라인 속도가 느려져 개발 피드백 루프를 저해합니다. 검증 강도와 실행 속도 사이의 정교한 밸런싱이 필수적입니다.
+- **자동화의 한계**: CI-CD는 정해진 패턴은 잘 찾지만 비즈니스적 맥락이나 설계상의 논리적 오류는 잡지 못합니다. 기계적 검증과 인간의 정성적 리뷰가 결합된 상호 보완 구조를 유지해야 합니다.
+
+## 🔗 지식 연결 (Graph)
+- [[Shift-Left Security]]: 보안 점검을 CI 단계로 앞당기는 전략.
+- [[Automated Testing]]: 파이프라인의 핵심 관문.
+- [[Pull Request Workflow]]: CI-CD가 트리거되는 지점.
+- [[DevSecOps]]: 보안이 내재화된 자동화 철학.
+- [[Infrastructure as Code (IaC)]]: 인프라 배포의 자동화 확장.
+---
@@ -0,0 +1,39 @@
+---
+id: P-REINFORCE-AUTO-WIKI-GOV-002
+category: "10_Wiki/💡 Topics/04_Governance_Reliability"
+confidence_score: 0.95
+tags: [governance, dora-metrics, engineering-metrics, performance, devops, cycle-time, p-reinforce]
+last_reinforced: 2026-05-01
+---
+
+# [[Engineering Metrics (DORA)]]
+
+## 📌 한 줄 통찰 (The Karpathy Summary)
+> "데이터에 기반하여 소프트웨어 인도 성과(Delivery Performance)를 정량화하고, 엘리트 팀의 벤치마크를 통해 개발 프로세스의 병목과 개선 방향을 제시하는 엔지니어링 표준 지표."
+
+## 📖 구조화된 지식 (Synthesized Content)
+DORA 지표는 데브옵스(DevOps) 연구를 통해 입증된 고성과 팀의 핵심 지표입니다.
+
+1.  **4대 핵심 지표**:
+    *   **Deployment Frequency (DF)**: 배포 빈도.
+    *   **Lead Time for Changes (MLT)**: 코드 커밋부터 배포까지 걸리는 시간.
+    *   **Change Failure Rate (CFR)**: 배포 후 실패율.
+    *   **Failed Service Recovery Time (MTTR)**: 장애 발생 시 복구까지 걸리는 시간.
+2.  **엘리트 성과자 (Elite Performers)의 특징**:
+    *   **PR 사이즈 제한**: 코드 변경량을 400 LOC 이하로 유지하여 인지 부하를 줄입니다.
+    *   **빠른 리뷰 응답**: 첫 리뷰 응답 시간(TTR)을 1시간 이내로, 전체 완료를 6시간 이내로 유지합니다.
+    *   **자동화 최적화**: 스타일 및 단순 검증을 자동화하여 인간 리뷰어가 아키텍처와 지식 공유에 집중하게 합니다.
+3.  **성과와 리뷰의 상관관계**:
+    *   효율적인 코드 리뷰 프로세스를 갖춘 팀은 그렇지 않은 팀보다 인도 성과가 50% 이상 높게 나타납니다.
+
+## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
+- **속도 vs 안정성**: 지표 개선을 위해 속도에만 집착하면 실패율(CFR)이 올라갈 수 있습니다. 4대 지표는 서로 견제하며 균형을 이루어야 진정한 성과 개선으로 이어집니다.
+- **데이터의 맥락**: 단순 수치만으로 팀을 평가하기보다, 지표의 변화 추이를 통해 팀의 프로세스 건전성을 진단하고 병목을 해결하는 도구로 활용해야 합니다.
+
+## 🔗 지식 연결 (Graph)
+- [[Review Performance & Flow]]: DORA 지표를 달성하기 위한 구체적 운영 전략.
+- [[Small Pull Requests (작은 PR)]]: Lead Time을 단축하는 가장 강력한 수단.
+- [[Automated Quality & Review]]: 인간의 시간을 절약하여 성과를 극대화하는 기반.
+- [[CI-CD Pipeline]]: 지표 수집과 자동화가 이루어지는 인프라.
+- [[DORA Metrics]]: 원본 개념 정의.
+---