Antigravity Agent
37 lines
2.9 KiB
Markdown
37 lines
2.9 KiB
Markdown
---
|
|
id: P-REINFORCE-AUTO-WIKI-COMM-001
|
|
category: Dev
|
|
confidence_score: 0.95
|
|
tags: [communication, code-review, feedback, constructive-feedback, psychological-safety, p-reinforce]
|
|
last_reinforced: 2026-05-01
|
|
---
|
|
|
|
# [[Effective Code Review Feedback|Effective Code Review Feedback]]
|
|
|
|
## 📌 한 줄 통찰 (The Karpathy Summary)
|
|
> "코드를 비판하되 작성자를 존중하며, 감정적 마찰을 줄이고 기술적 합의를 가속화하기 위해 구조화된 메시지(OIR)와 표준화된 라벨(Conventional Comments)을 활용하는 지능적 소통 전략."
|
|
|
|
## 📖 구조화된 지식 (Synthesized Content)
|
|
효과적인 피드백은 코드 품질 향상과 팀의 성장을 동시에 이끄는 핵심 동력입니다.
|
|
|
|
1. **건설적 피드백의 원칙**:
|
|
* **코드 중심**: 사람이 아닌 '코드'의 논리와 구조에 집중합니다. "네 코드는 틀렸다" 대신 "이 로직은 엣지 케이스에서 오류를 낼 수 있다"고 표현합니다.
|
|
* **I-Message & 질문**: "나"를 주어로 삼아 의견을 전달하고, 단정적 지시보다 "이 방법은 어떨까요?"라는 질문으로 작성자의 사고를 자극합니다.
|
|
* **OIR 룰 (Observation, Impact, Request)**: 객관적 관찰, 그것이 미치는 영향, 그리고 구체적인 개선 요청으로 피드백을 구조화합니다.
|
|
2. **Development Communication Standards (Conventional Commits & Comments**:
|
|
* `suggestion:`, `issue:`, `nit:` 등의 라벨과 `(blocking)`, `(non-blocking)` 데코레이터를 사용하여 피드백의 의도와 수정 필수 여부를 투명하게 전달합니다.
|
|
3. **심리적 안전감 (Psychological Safety)**:
|
|
* 칭찬(Praise)을 아끼지 않으며, 리뷰 과정을 '게이트키핑'이 아닌 '공동 학습'의 장으로 인식하는 문화를 구축합니다.
|
|
|
|
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
|
|
- **친절함 vs 명확성**: 감정 상함을 우려해 완곡하게 표현하다 보면 문제의 심각성이 희석될 수 있습니다. 중대한 결함은 정중하되 타협 없이 명확하게 지적하는 정책이 필요합니다.
|
|
- **운영 오버헤드**: 모든 코멘트를 정교하게 작성하는 것은 리뷰어의 시간을 많이 소모합니다. 사소한 스타일 지적은 자동화 도구에 맡기고, 인간은 복잡한 맥락이 필요한 피드백에만 정성을 들이는 '선택과 집중'이 중요합니다.
|
|
|
|
## 🔗 지식 연결 (Graph)
|
|
- Development Communication Standards (Conventional Commits & Comments: 피드백의 물리적 포맷팅.
|
|
- Non-violent Communication: 커뮤니케이션의 철학적 기반.
|
|
- [[Knowledge Management in Engineering|Knowledge Management in Engineering]]: 피드백을 통한 지식 전파.
|
|
- [[심리적 안전감 (Psychological Safety)|Psychological Safety]]: 건강한 리뷰 문화의 토대.
|
|
- OIR 룰 (Observation, Impact, Request: 피드백 작성 프레임워크.
|
|
---
|