EP13. 올바른 Cocrates Harness 활용
🌐 함께 진화하는 피드백 루프와 오픈소스 정신
Cocrates를 설치하고 실습을 마쳤으며, 그 저변을 흐르는 견고한 구조적 원리까지 모두 살펴봤습니다.
그렇다면 이제 모든 학습이 끝난 것일까요? 아닙니다. 진짜 여정은 지금부터 시작입니다. 구조를 이해하는 것이 자동차의 엔진 메커니즘을 공부한 단계라면, 지금부터는 도로 위에서 직접 핸들을 잡고 주행 감각을 익혀야 할 때이기 때문입니다.
Cocrates Harness 프레임워크의 대미를 장식할 이번 에피소드에서는 사용자와 도구가 어떻게 상호작용하며 함께 진화해 나가는지, 그리고 이 프레임워크가 지닌 확장성의 본질을 이야기합니다.
1. 사용자가 진화해야 한다: Harnessing Ignorance
이 시리즈가 관통하는 핵심은 간단합니다. AI가 생성한 산출물을 검토 없이 덜컥 수령하는 블랙박스식 습관을 파괴하는 것입니다. 검토의 본질은 질문을 통해 이해하고, 주도적으로 판단하며, 명시적으로 승인하는 프로세스에 있습니다.
- 대화에 익숙해지기: Cocrates는 정답을 곧바로 대령하지 않고 쉼 없이 질문을 던집니다. "그냥 답만 주면 안 되나?"라는 답답함이 드는 것은 자연스럽습니다. 하지만 이 질문들은 주도권을 유저에게 돌려주기 위한 파트너의 손짓입니다.
- 질문의 내면화: 시간이 흐르면 에이전트가 외부에서 던지던 소크라테스식 질문이 사용자 자신의 내면적인 사고방식으로 자리 잡기 시작합니다. "이 결정의 트레이드오프는 무엇인가?", "내가 놓치고 있는 제약 조건은 없는가?" 이 질문을 스스로 지필 수 있을 때, 사용자는 AI 시대에 대체되지 않는 단단한 기획자이자 개발자로 진화합니다.
- 검토와 승인의 습관화: PR(Pull Request)을 리뷰할 때는 코드 한 줄 한 줄 매서운 눈으로 보면서, AI가 준 결과물은 왜 그대로 복사·붙여넣기 하나요? AI의 산출물도 결국 검토 대상입니다. "결과물이 요청과 일치하는가?", "타인에게 이 구조를 설명할 수 있는가?"라는 질문에 자신 있게 '예'라고 답할 수 있어야 합니다.
2. Cocrates Harness를 진화시켜야 한다
Cocrates는 공장에서 찍어내어 변경할 수 없는 닫힌 제품이 아닌, 언제든 뜯어고칠 수 있는 열린 설계도입니다.
🛠️ 고정되지 않은 Skills의 확장
기본 제공 스킬은 시작일 뿐입니다. 본인의 반복적인 업무 패턴에 맞게 새로운 스킬을 추가하거나 확장할 수 있습니다.
- 주간 보고서 작성이 잦다면
weekly-report-authoring - 프로젝트 제안서 작성이 많다면
proposal-authoring - 그 외 팀 온보딩이나 배포 검증용 맞춤형 스킬 등
지난 편에서 다룬 generating-skill-creation을 통해 "~~를 생성하는 스킬을 만들어줘"라고 요청하는 것만으로도 나만의 재사용 가능한 스킬 아키텍처를 설계할 수 있습니다.
✍️ 내 입맛에 맞춘 커스텀 프로세스
~/.config/opencode/skills/ 경로에 저장된 SKILL.md 파일들은 단순한 마크다운 문서이기에 누구나 읽고 수정할 수 있습니다.
- "검토 단계가 너무 촘촘해 피로하다" → 단계 축소 및 단순화
- "내 실무 스타일과 맞지 않는다" → 단계별 워크플로우 재구성
🔄 함께 자라는 닫힌 피드백 루프
사용자가 정교하게 검토할수록 에이전트는 더 밀도 높은 결과물을 내놓고, 훌륭한 결과물은 다시 사용자의 안목을 성장시킵니다. 사용자의 참여도와 성능은 완벽하게 정비례합니다.
사용 경험 → 에이전트/스킬 개선 → 더 나은 경험 → 사용자 성장
자전거를 처음 배울 때 달아두는 보조바퀴처럼, Cocrates는 초기 구조화의 페이스메이커 역할을 수행하다가 사용자가 완전히 균형을 잡는 순간 더 깊고 거대한 비즈니스 도전 과제를 제시하는 동반자가 됩니다.
🌐 어디서나 살아 숨 쉬는 '오픈소스 철학'
Cocrates의 모든 소스코드와 프롬프트, 아키텍처 문서는 투명하게 공개되어 있습니다.
이 투명성은 단순한 소스코드 공유를 넘어 플랫폼의 독립성을 의미합니다. Cocrates의 소크라테스식 대화 철학과 Snowflake 워크플로우 구조는 특정 IDE나 플러그인에 종속되지 않습니다.
Claude Code, Cursor, Codex, Antigravity 등 AI 에이전트를 구동할 수 있는 환경이라면 그 어디든 이 설계도를 이식하여 당신만의 하네스를 빌드할 수 있습니다. 제공되는 툴을 그대로 쓰는 것을 넘어, 그 정신을 흡수해 자신만의 커스텀 하네스를 구축하는 것이 가장 바람직한 진화 방향입니다.
🎯 지속적 개선의 원칙
Cocrates의 아키텍처 세계관을 지탱하는 단 하나의 절대 헌법을 다시금 되새겨봅니다.
"The unexamined code is not worth generating."
(검토되지 않은 코드는 생성할 가치가 없다)
이 준엄한 원칙은 에이전트가 뱉어내는 산출물뿐만 아니라, Cocrates Harness 프레임워크 자체(프롬프트, 스킬, 워크플로우)에도 예외 없이 적용됩니다. 한 번에 완벽한 스킬을 만들려는 욕심보다는, 끊임없이 사용하고 검토하며 작은 개선을 굴려 나가는 끈기가 핵심입니다.
🎬 다음 편 예고
지금까지 총 13편의 에피소드를 통해 AI 에이전트의 주권을 잡고 동반 성장하는 구조적 방법론을 쉼 없이 달려왔습니다. 원칙을 이해했고, 도구를 쥐었으며, 진화의 도화선을 당겼습니다.
이제 이 긴 여정을 매듭지을 마지막 한 걸음이 남았습니다.
다음 편은 기술 설명서가 아닌, 가슴에 새길 이정표입니다. 우리가 AI를 다루는 방식의 기준이자 약속이 될 "Cocrates Harness 사용자 선언문 — 끊임없는 성장을 멈추지 않는다"와 함께 찾아오겠습니다!
이 시리즈는 Cocrates Harness 프레임워크를 소개합니다. Cocrates는 소크라테스식 대화로 사용자가 주도권을 잡고 성장하도록 설계된 에이전트 하네스입니다.