[Harness Engineering] 실제 사례 비교

OpenAI(인간 코드 0줄로 100만 줄 프로덕션 구축), Anthropic(장기 실행 에이전트의 세션 간 기억 문제 해결), Stripe(주당 1,000+ PR을 기존 품질 기준으로 운영)는 서로 다른 질문에서 출발했지만, 환경 중심 설계, 점진적 작업, 기계적 강제, 피드백 채널 제공이라는 동일한 원칙에 수렴했다. 조직의 맥락에 따라 세 모델을 선택적으로 조합하는 것이 가장 효과적이다.

[Harness Engineering] 실패 패턴과 안티패턴

하네스 엔지니어링의 다섯 가지 주요 안티패턴은 천 페이지 매뉴얼(과도한 규칙), 과도한 제어 흐름(절차 정의), 도구 과다 제공, 실패를 모델 탓으로 돌리기, 하네스 오버엔지니어링이다. 공통 해결 원칙은 에이전트가 실수할 때마다 그 실수를 구조적으로 불가능하게 만드는 해결책을 코드로 반영하는 것이며, 하네스는 완성되는 것이 아니라 실패를 연료로 진화하는 것이다.

[Harness Engineering] 피드백 루프

피드백 루프는 에이전트가 코드 작성 결과를 직접 확인하고 자율적으로 수정하는 순환 구조를 만드는 하네스의 네 번째 기둥이다. Puppeteer 기반 E2E 테스트로 사용자 관점 검증, 관찰 가능성 스택으로 로그·메트릭 직접 쿼리, 단계별 CI 파이프라인으로 모든 피드백을 통합한다. 에이전트에게 “눈과 귀”를 제공함으로써 코드 수준이 아닌 실행 수준의 품질을 보장한다.

[Harness Engineering] 아키텍처 제약

아키텍처 제약은 컨텍스트 엔지니어링이 ‘안내’하는 것을 ‘강제’로 전환하는 하네스의 두 번째 기둥이다. 의존성 방향 테스트, 순환 의존성 감지, 커스텀 린터 규칙, pre-commit 훅, 데이터 경계 파싱 강제를 통해 에이전트의 판단과 무관하게 규칙이 지켜지는 구조를 만든다. 핵심 철학은 불변 규칙은 기계적으로 강제하되 구현 방식은 자유롭게 두는 것이다.

[Harness Engineering] 컨텍스트 엔지니어링

컨텍스트 엔지니어링은 AI 에이전트가 올바른 결과물을 만들기 위해 필요한 정보를 구조화하고 제공하는 기술이다. 구체적인 규칙 파일(AGENTS.md), 계층적 구조, JSON 기반 기능 목록, 파일시스템 기반 진행 로그, 초기화 스크립트를 통해 에이전트에게 추측이 아닌 읽기를 시킨다. 핵심 원칙은 저장소가 단일 진실 소스가 되어야 한다는 것이다.

[Harness Engineering] 하네스 엔지니어링이란 무엇인가

하네스 엔지니어링은 AI 에이전트가 대규모로 안정적인 결과물을 만들 수 있도록 환경, 제약, 피드백 루프를 설계하는 분야다. 프롬프트가 부탁이라면 하네스는 강제이며, OpenAI·Anthropic·Stripe가 독립적으로 같은 결론에 도달했다. 핵심은 컨텍스트 엔지니어링, 아키텍처 제약, 엔트로피 관리의 세 기둥이다.

Supabase 완전 정복 시리즈 15편 — 실전: AI 챗봇 서비스 (RAG + 스트리밍 + 문서 업로드)

Supabase pgvector + OpenAI + Vercel AI SDK로 RAG 기반 AI 챗봇 서비스를 Next.js App Router에서 처음부터 끝까지 구축. 문서 청킹·임베딩·벡터 검색·스트리밍 응답·대화 히스토리·RLS 보안까지 완전 구현.

Supabase 완전 정복 시리즈 8편 — AI & 벡터 검색: pgvector로 시맨틱 검색과 RAG 구현하기

Supabase pgvector로 벡터 임베딩 저장, HNSW 인덱스, 코사인 유사도 검색, RAG(검색 증강 생성) 파이프라인을 구현하는 완벽 가이드. OpenAI Embeddings, 하이브리드 검색(FTS+벡터), 자동 임베딩 갱신까지 Next.js TypeScript 코드로 다룹니다.

Supabase 완전 정복 시리즈 7편 — Edge Functions: Deno 기반 서버리스 함수 완벽 가이드

Supabase Edge Functions로 Deno 기반 서버리스 함수를 구현하는 완벽 가이드. Stripe 웹훅, OpenAI 프록시, 이메일 발송, Database Webhook 등 실전 패턴과 Next.js App Router 연동 방법을 TypeScript 코드로 상세히 다룹니다.

LibreChat Docker 설치 가이드: 멀티 AI ChatGPT 클론

LibreChat는 모든 주요 AI 제공자를 하나의 인터페이스에서 사용할 수 있는 오픈소스 ChatGPT 클론입니다. OpenAI, Anthropic, Google, Ollama 등을 연결하고 대화 중 자유롭게 전환할 수 있습니다. AI 에이전트, MCP, 코드 인터프리터, Artifacts, 멀티 유저, OAuth 등 엔터프라이즈급 기능을 제공합니다.

LocalAI Docker 설치 가이드: 로컬 OpenAI 호환 API 서버

LocalAI는 OpenAI API 호환 로컬 추론 서버입니다. 텍스트 생성, 이미지 생성, 음성 인식/합성, 임베딩을 모두 지원하며, 기존 OpenAI SDK/앱을 코드 변경 없이 사용할 수 있습니다. GPU 없이도 CPU만으로 실행 가능하며, llama.cpp, Stable Diffusion, Whisper 등 다양한 백엔드를 지원합니다.

Karakeep Docker 설치 가이드: AI 기반 북마크 관리의 새로운 패러다임

Karakeep(구 Hoarder)은 AI 기반 자동 태깅과 전체 텍스트 검색을 지원하는 셀프호스팅 북마크 앱입니다. 링크, 노트, 이미지, PDF, 동영상을 저장하고 OpenAI 또는 로컬 Ollama로 AI 기능을 사용할 수 있습니다. Meilisearch 기반의 빠른 검색, 전체 페이지 아카이브, 크로스 플랫폼 앱을 제공합니다.