# OpenAI Codex를 활용한 하네스 엔지니어링 실습 요약 > **원본 영상:** [ZeroCho TV - OpenAI Codex로 하는 하네스 엔지니어링 실습 요약본!!](http://www.youtube.com/watch?v=MpeuOAmctAg) > **발표자:** ZeroCho > **핵심 주제:** OpenAI Codex와 오픈소스 하네스 플러그인(Superpowers, gstack 등)을 활용해 실전 데스크톱 앱(ManicTime 대체재)을 구축하며 배우는 **하네스 엔지니어링(Harness Engineering) 실습 가이드** [00:00:15] --- ## 1. 프로젝트 개요 & 개발 환경 설정 ### 1) 구축 대상 앱 [00:00:39] - **ManicTime 대체 데스크톱 앱:** 유료 시간 관리 서비스인 ManicTime 대신, 사용자 작업 시간(생산적/비생산적/중립)을 자동으로 추적·기록하는 앱 구축 [00:00:47]. - **기술 스택:** Rust, Tauri, React 기반 데스크톱 앱 (Windows 우선 제작 후 macOS 확장 고려) [00:00:31], [00:04:17], [00:08:59]. ### 2) OpenAI Codex 데스크톱 설정 [00:01:38] - **모델 선택:** GPT 5.5 사용 [00:01:52]. - **추론 수준 (Intelligence / Effort Level):** 중간 (Medium) 설정 (속도와 IQ의 균형) [00:02:00]. - **속도 설정 (Fast Mode):** 토큰 소모량 2배 증가하나 속도 1.5배 상승 [00:02:39]. 토큰 한도가 넉넉하여 Fast Mode 켜는 것을 추천 [00:02:52]. - **권한 관리 (Permissions):** '기본 권한' ➔ 답답할 경우 '자동 검토(Auto-review)' 권한 적용 [00:03:32]. (위험한 작업 외에는 자동 승인) [00:03:41] --- ## 2. 하네스 엔지니어링(Harness Engineering) 실습 가이드 ### 1) 하네스 엔지니어링의 본질 [00:04:53] - **어원 및 개념:** 강다리가 제멋대로 튀어나가지 못하게 통제하는 '하네스(구속구)'처럼, **AI 에이전트가 우회하거나 제멋대로 코딩하지 못하도록 제약·가이드 구조를 씌우는 기술** [00:05:01]. - **핵심 철학:** 프로젝트와 요구사항에 따라 **하네스를 유연하게 탈부착/커스터마이징**해야 함 [00:05:44], [00:06:41]. AI 모델(GPT 6 등)이 발전할수록 하네스 의존도를 점차 줄여가는 방향으로 설계 [00:06:24]. ### 2) 핵심 하네스 도구 활용 [00:05:28] #### ① Superpowers (기본 추천 플러그인) [00:05:52] - **Brainstorming 스킬:** 조잡한 프롬프트를 AI 기획자와의 대화를 통해 정교한 사양(Specification)으로 구체화 [00:06:07], [00:07:48]. - **Writing Plans (플랜 모드):** 기획 문서 작성 후 개발 팀장 관점에서 구체적인 구현 계획 작성 [00:11:17]. - **TDD & 코드 리뷰:** 구현 시 테스트 주도 개발을 강제하고, 서브 에이전트 간 코드 리뷰/검증 수행 [00:09:30], [00:12:12]. - **Git Worktrees:** 병렬 작업을 수행하는 서브 에이전트 간 코드 충돌 방지 [00:12:48]. #### ② Compound Engineering (컴파운드 엔지니어링) 연동 [00:15:34] - Superpowers 리뷰 프로세스 직후 **실수 및 피드백 내역을 `docs` 폴더에 축적**하는 컴파운드 단계를 수동으로 추가 [00:17:09], [00:17:53]. - 동일한 오류나 퇴짜 사유가 다음 플랜/실행 단계에서 반복되지 않도록 자가 개선 루프 형성 [00:18:02]. #### ③ gstack (보안 및 역할극) [00:13:04] - **CSO (Chief Security Officer) 스킬:** 개발자가 놓치기 쉬운 보안 체크리스트 항목을 자동 점검 [00:13:39], [00:20:43]. --- ## 3. 단계별 실전 개발 워크플로우 ``` [1. 브레인스토밍/기획] ➔ [2. 구현 계획 수립] ➔ [3. 서브 에이전트 병렬 개발] ➔ [4. TDD/리뷰/컴파운드] ➔ [5. 보안 점검(CSO)] ➔ [6. 워크트리 정리] ``` 1. **기획 구체화 (Brainstorming) [00:07:05]:** - 모호한 초기 지시사항에 대해 AI가 역으로 질문을 던져 브라우저 탭별 구분, 데이터 저장 방식 등 세부 기획 수립 [00:07:22]. 2. **구현 계획 및 명세서 확인 [00:10:12]:** - 작성된 명세서(Single Source of Truth)를 개발자가 직접 검토 [00:10:35]. 코드를 직접 읽기보다 **기획 명세서의 정확성을 검증하는 것이 하네스 시대의 개발자 역할** [00:10:43]. 3. **서브 에이전트(Sub-agents) 기반 병렬 작업 [00:14:04]:** - 메인 에이전트(GPT 5.5)가 하위 에이전트(GPT 5.5 또는 5.4 mini)를 생성하고 상세 프롬프트를 전달하여 작업 분담 [00:14:13]. - **Tip:** 메인 에이전트가 서브 에이전트에 내리는 프롬프트 양식을 관찰하면 고품질 프롬프트 작성 법을 학습할 수 있음 [00:16:22]. 4. **컨텍스트 자동 압축 대응 [00:19:43]:** - 토큰 한도 임계 시 발생할 수 있는 환각/손실을 대비하여 **체크리스트 기반 파일 상태 관리** 적용 [00:20:08]. 5. **CSO 보안 점검 실행 [00:20:43]:** - gstack의 CSO 스킬로 보안 체크리스트를 실행해 취약점 보완 [00:21:46]. 6. **워크트리(Git Worktree) 병합 및 정리 [00:24:05]:** - 병렬 작업 완료 후 임시 워크트리 폴더를 최종 정리하여 프로젝트 완성 [00:24:13]. --- ## 4. 하네스 엔지니어링 실습 주요 교훈 (Takeaways) - **코드보다 스펙(기획 문서)을 믿어라 [00:10:43]:** AI가 코드를 계속 수정하므로, 개발자는 코드를 일일이 읽기보다 기획 명세서(스펙)의 완전성을 검증하는 데 집중해야 함 [00:10:35]. - **보안 검사에는 토큰을 아끼지 말 것 [00:23:09]:** 단순 버그 수정보다 DB 삭제, 보안 노출 등 시스템 사고 예방을 위한 CSO 체크리스트 검증에 충분한 토큰 투자 필요 [00:23:14]. - **프로젝트별 하네스 최적화 [00:25:06]:** 남이 만든 하네스나 Superpowers 프레임워크에 프로젝트를 맞추지 말고, 개발/영상제작/단순 수정 등 목적에 맞게 필요한 스킬만 선택·변형하여 활용 [00:25:15].