Show GN: Dual-Brain — Codex/Claude Code에 ‘좌뇌·우뇌식 디베이트 워크플로우’를 붙이는 스킬

안녕하세요. 최근 Codex나 Claude Code를 실무에 쓰면서, LLM이 복잡한 코드를 짤 때 쉽게 과부하에 걸리거나 과거 결정을 번복하는 문제를 줄이기 위해 오픈소스로 개발 중인 확장 스킬 프로토콜 Dual-Brain을 소개합니다.

Dual-Brain은 AI에게 “PM / 개발자 / QA” 같은 직책을 나눠주는 방식보다, 문제를 바라보는 사고 기능을 분리하는 쪽에 가깝습니다.

하나의 에이전트가 바로 답을 내지 않고, 우뇌 역할의 맥락 심문과 좌뇌 역할의 논리 검증을 순서대로 거친 뒤 orchestrator가 최종 결과를 합성하도록 강제합니다.

1. 기존 에이전트 단독 실행의 3가지 실패 모드

터미널에서 LLM에게 한 번에 복잡한 아키텍처 설계나 리팩토링을 맡기면 보통 다음 문제를 자주 만납니다.

• 문면 그대로 받아들이는 함정
  모호한 요건을 그대로 수용했다가, 엉뚱한 코드를 자신 있게 빌드합니다.
• 디테일의 지옥
  미시적인 코드 문법과 엣지 케이스에 매몰되어, 더 단순하고 좋은 아키텍처적 경로를 놓칩니다.
• 기억상실 루프
  세션이 끝나면 이전 맥락이 사라져, 지난주에 이미 결정한 아키텍처 방향을 다음 세션에서 다시 번복합니다.

2. 해결책: 두 개의 사고 기능

Dual-Brain을 로드하면 메인 에이전트는 orchestrator 역할을 맡고, 바로 답하지 않습니다. 대신 정해진 순서로 두 개의 내부 검토 단계를 실행합니다.

• 우뇌, Right Brain: 맥락 / 패턴 / 심문
  사용자의 요구사항을 바로 구현하지 않고 먼저 의심합니다. “이 요구사항의 맹점은 무엇인가?”, “과거 결정과 충돌하지 않는가?”, “용어가 모호하지 않은가?”를 따집니다.
• 좌뇌, Left Brain: 논리 / 검증 / 코드
  우뇌가 만든 문제 정의를 실제 코드베이스, 공식 문서, 프로젝트 메모리와 대조합니다. 환각 API, 낡은 가정, 구현 불가능한 설계를 걸러내고 실행 가능한 형태로 다듬습니다.

최종적으로 orchestrator가 두 결과를 합성해 코드 변경, 문서화, 메모리 업데이트까지 이어갑니다.

3. 기억 등급제 시스템

스킬은 프로젝트 루트의 .dual-brain/MEMORY.md에 장기 기억을 저장합니다.

그런데 프로젝트가 커질수록 오래전 결정과 지난주의 활성 제약 조건이 같은 무게로 섞이는 문제가 생길 수 있습니다. 이를 해결하기 위해 memory를 flat document가 아니라 tiered memory로 다룹니다.

• Hot Memory
• Warm Memory
• Cold Memory
• Archived Decisions

Hot Memory는 현재 작업에 강하게 영향을 주는 활성 결정과 제약입니다.

Warm Memory는 관련 작업에서만 읽는 유용한 맥락입니다.

Cold Memory와 Archived Decisions는 기본으로 모두 읽지 않고, 키워드 검색이나 충돌 검증이 필요할 때만 조회합니다.

refs는 단순히 읽었다고 증가하지 않고, 실제 질문 / 검증 / 합성 / 구현에 영향을 줬을 때만 증가합니다.

오래되었거나 중복된 기억은 자동 압축하고, 모순되거나 폐기된 결정은 Archived로 보냅니다.

민감정보, 토큰, 키, 개인정보는 저장하거나 요약하지 않고 제거/비저장 대상으로 처리합니다.

중요한 점은 memory가 진실의 원천은 아니라는 것입니다. Dual-Brain에서 memory는 advisory context이고, 현재 코드와 공식 문서가 stale memory보다 우선합니다.

4. 벤치마크

repo에는 Codex 기준으로 single-agent 방식과 Dual-Brain 방식을 비교하는 작은 benchmark harness가 포함되어 있습니다.

Dual-Brain은 빠른 방식이 아닙니다. 오히려 앞단에서 더 많이 생각하게 만들어, 사람이 나중에 다시 고치고 설명하는 루프를 줄이는 쪽을 목표로 합니다.

5. 설치

SkillsGate를 쓰면 Codex CLI와 Claude Code 환경에 skill을 설치하고 관리할 수 있습니다.

npx skillsgate add sleeplesshan/dual-brain -g  
수동 설치도 가능합니다.  
 - Codex  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.codex/skills/dual-brain  
 - Claude Code  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.claude/skills/dual-brain  
설치 후에는 평소처럼 자연어로 호출하면 됩니다.  
  
6. 언제 쓰면 좋은가  
Dual-Brain은 단순 수정에는 과합니다. 변수명 변경, 한 줄 버그 수정, 명확한 boilerplate에는 굳이 쓸 필요가 없습니다.  
대신 다음 상황에 잘 맞습니다.  
- 요구사항이 모호한 리팩토링  
- 아키텍처 결정  
- 낯선 API나 SDK 통합  
- 과거 결정과 충돌할 수 있는 변경  
- hallucinated API가 실제 장애로 이어질 수 있는 작업  
- “내가 지금 맞는 질문을 하고 있는지도 모르겠다” 싶은 작업  
  
오픈소스(MIT 라이선스)로 전체 SKILL.md와 benchmark harness를 공개해두었습니다.  
 LLM orchestration, prompt engineering, agent memory 설계에 관심 있는 분들의 피드백을 받고 싶습니다.