TECH NOTES
기술노트
현장에서 검증된 개발 지식을 기록합니다.
1918171615141312111098
AI
코딩 에이전트 하네스 설계 — 같은 모델로 결과가 달라지는 이유
에이전트 성능은 모델만으로 결정되지 않는다. 도구 설계, 컨텍스트 구성, 검증 루프, 실패 복구 같은 하네스(harness) 요소가 결과를 좌우한다. 직접 만들 때의 설계 원칙과 흔한 실패를 정리한다.
Tools
Git 훅(hooks) — 커밋·푸시 순간에 끼어드는 자동화
Git 훅은 커밋·푸시 순간에 내 스크립트를 끼워 넣는 확장 지점입니다. pre-commit·commit-msg·pre-push의 동작, 종료 코드 규칙, 훅이 공유되지 않는 함정과 해결법까지 정리했습니다.
Backend
Swagger/OpenAPI 3.1 API 문서 자동화
OpenAPI 3.1 스펙을 활용하여 API 문서를 자동 생성하고 Swagger UI로 인터랙티브 문서를 제공하는 방법을 소개합니다.
Infra
GitHub Actions Self-Hosted Runner 구축과 보안
GitHub Actions Self-Hosted Runner를 직접 구축하고, 보안 강화 설정과 자동 스케일링을 구현하는 실전 가이드를 제공합니다.
Database
PostgreSQL Trigger와 Function으로 자동화 로직 구현
PostgreSQL의 Trigger와 PL/pgSQL Function을 활용하여 감사 로그, 자동 계산, 데이터 검증 등 비즈니스 로직을 데이터베이스 레벨에서 자동화합니다.
Infra
Ansible 플레이북 실전 — 서버 100대 동시 설정
Ansible 플레이북을 사용하여 대규모 서버 환경을 효율적으로 관리하는 방법을 실전 예제와 함께 소개합니다. 인벤토리, 롤, 핸들러 등 핵심 개념을 다룹니다.
Frontend
Playwright 1.40 — API 테스트와 컴포넌트 테스트
Playwright 1.40 — API 테스트와 컴포넌트 테스트 — 실무에서 바로 적용할 수 있는 가이드입니다.
Infra
Ansible 서버 자동화 — 플레이북으로 100대 서버 한 번에
Ansible 서버 자동화 — 플레이북으로 100대 서버 한 번에 — 실무에서 바로 적용할 수 있는 가이드입니다.
Infra
ArgoCD GitOps 배포 자동화 — Kubernetes 선언적 배포
ArgoCD GitOps 배포 자동화 — Kubernetes 선언적 배포 — 실무에서 바로 적용할 수 있는 가이드입니다.
AI
AI 코드 리뷰 자동화 — GitHub Actions + GPT 연동
AI 코드 리뷰 자동화 — GitHub Actions + GPT 연동 — 실무에서 바로 적용할 수 있는 가이드입니다.
Infra
Shell Script 자동화 — 서버 관리를 10배 효율적으로
Shell Script 자동화 — 서버 관리를 10배 효율적으로 — 실무에서 바로 적용할 수 있는 가이드입니다.
Frontend
Playwright E2E 테스트 시작하기 — Cypress 대안의 강력한 도구
Playwright E2E 테스트 시작하기 — Cypress 대안의 강력한 도구 — 실무에서 바로 적용할 수 있는 가이드입니다.