코딩환경 재구축 통합 계획서 (v2)

6개 시스템 분석 기반 최적화된 코딩환경 구축 계획

📊 시스템 비교 요약

기존 분석 대상 (3개)

구분	everything-claude-code	shards	moai-adk
핵심 역할	Claude Code 설정/패턴	병렬 에이전트 관리	풀스택 개발 프레임워크
기술 스택	Markdown/Shell	Rust	Python
Agents	9개	6개	20개
Commands	14개	1개	10개
Skills	11개	-	49개
Hooks	6종	-	✓
Rules	8개	-	-
MCP 설정	15개	-	✓
설치 방식	수동 복사	Cargo install	`uv tool install`
워크플로우	개별 선택형	병렬 작업 특화	체계적 Pipeline

추가 분석 대상 (3개)

구분	AionUi	Archon V2	ChatDev 2.0
핵심 역할	CLI AI 도구 GUI 통합	MCP 기반 지식/태스크 관리	Zero-code 멀티에이전트
기술 스택	Electron, TypeScript	Python (FastAPI), React	Python (uv), Vue 3
에이전트	❌ 없음	❌ 없음 (MCP 도구)	가변 (YAML 정의)
MCP 지원	⚪ 설정만	✅ MCP 서버 제공	⚪ 예제만
UI/UX	✅ 데스크톱 GUI	✅ 웹 대시보드	✅ 웹 콘솔
코딩 워크플로우	❌ 없음	⚪ 태스크 기반	❌ 범용
플랫폼	Windows/macOS/Linux	Docker	Docker/로컬

🏆 기반 시스템 유지: MoAI-ADK

선정 근거 (변경 없음)

평가 항목	everything-claude-code	shards	moai-adk	AionUi	Archon V2	ChatDev 2.0
체계적 워크플로우	⚪	⚪	✅	❌	⚪	⚪
에이전트 완성도	⚪	⚪	✅	❌	❌	⚪
스킬 생태계	⚪	❌	✅	⚪	❌	❌
품질 게이트	⚪	❌	✅	❌	❌	❌
토큰 효율성	⚪	❌	✅	N/A	⚪	⚪
다국어 지원	❌	❌	✅	✅	❌	⚪

결론

MoAI-ADK가 여전히 가장 포괄적이고 체계적인 코딩 전문 시스템입니다.

추가 분석 대상들은 코딩 워크플로우(SPEC-First, DDD 등)가 없음
UI/UX 도구, 지식 관리, 범용 워크플로우 등 보조 역할로만 통합 가치 있음

🔄 통합 대상 구성요소 분석 (업데이트)

everything-claude-code에서 가져올 요소

✅ 명확히 가져올 것

구성요소	이유	우선순위
memory MCP	세션 간 영구 메모리, MoAI에 없음	🔴 높음
tmux 훅	dev server 백그라운드 유지, MoAI에 활용 가능	🟡 중간
strategic-compact	논리적 컴팩션 시점 제안, MoAI 호환	🟢 낮음

⚠️ 사용자 선택 필요 (기존)

구성요소	MoAI 상태	장점	단점	권장
Session Persistence	MoAI 자체 로그 시스템 있음	더 상세한 세션 파일 저장	중복 기능	💬 선택 필요
continuous-learning	없음	디버깅 패턴 자동 축적	검증 없이 학습 시 노이즈	💬 선택 필요
모델 티어링	MoAI는 GLM 통합 우선	3배 비용 절감	GLM과 철학 충돌	💬 선택 필요

shards에서 가져올 요소

✅ 명확히 가져올 것

구성요소	이유	우선순위
Shards CLI 도구 자체	Git Worktree 병렬 관리, MoAI worktree 스킬 보완	🔴 높음
다중 에이전트 프로필	Kiro/Claude/Gemini 등 에이전트 선택	🟡 중간

⚠️ 사용자 선택 필요

구성요소	MoAI 상태	장점	단점	권장
리뷰 에이전트 6개	MoAI에 `manager-quality` 있음	세분화된 리뷰 관점	중복	💬 선택 필요

AionUi에서 가져올 요소 (신규 추가)

⚠️ 사용자 선택 필요

구성요소	MoAI 상태	장점	단점	권장
WebUI 원격 접속	없음	모바일에서 Claude Code 제어 가능	별도 앱 실행 필요	💬 선택 필요
멀티세션 관리	없음	여러 프로젝트 병렬 작업 GUI	Electron 앱 의존	💬 선택 필요
오피스 스킬 (docx/xlsx/pptx)	없음	문서 자동화 필요 시 유용	코딩과 무관	💬 선택 필요

❌ 가져오지 않을 것

구성요소	이유
AionUi 전체 시스템	코딩 워크플로우/에이전트 체계 없음, 기반 시스템 부적합
소셜 미디어 리크루터 스킬	코딩환경과 무관

Archon V2에서 가져올 요소 (신규 추가)

✅ 명확히 가져올 것

구성요소	이유	우선순위
MCP 서버 연결	Claude Code에 외부 문서/지식베이스 직접 제공	🔴 높음
웹 크롤러	프레임워크 문서 자동 수집 및 인덱싱	🟡 중간
RAG 검색 엔진	벡터 검색 + 리랭킹으로 정밀 정보 검색	🟡 중간

⚠️ 사용자 선택 필요

구성요소	MoAI 상태	장점	단점	권장
태스크 관리	MoAI SPEC 시스템 있음	별도 UI로 태스크 관리	SPEC과 중복, 동기화 필요	💬 선택 필요
Archon 워크플로우 (CLAUDE-ARCHON.md)	MoAI DDD/SPEC 워크플로우 있음	지식 기반 개발 프로세스	MoAI 워크플로우와 충돌 가능	💬 선택 필요

❌ 가져오지 않을 것

구성요소	이유
에이전트 시스템	MoAI 20개 에이전트가 상위호환
Serena MCP 의존	특정 도구 의존성, 범용성 떨어짐

ChatDev 2.0에서 가져올 요소 (신규 추가)

⚠️ 사용자 선택 필요

구성요소	MoAI 상태	장점	단점	권장
딥 리서치 워크플로우	없음	연구 자동화, 문헌 분석	별도 시스템 운영 필요	💬 선택 필요
데이터 시각화 워크플로우	없음	데이터 분석 및 차트 자동 생성	코딩과 직접 연관 적음	💬 선택 필요
Visual Workflow 디자이너	없음	Zero-code 멀티에이전트 설계	코딩 전문 워크플로우 아님	💬 선택 필요

❌ 가져오지 않을 것

구성요소	이유
소프트웨어 개발 워크플로우	MoAI SPEC-First DDD가 상위호환
기반 시스템	코딩 특화 워크플로우 없음, 범용 플랫폼
3D 생성/교육 영상	코딩환경과 무관

🎯 통합 아키텍처 제안 (업데이트)

통합 코딩환경/
├── .claude/                         # MoAI-ADK 기반 (핵심)
│   ├── agents/moai/                 # 20개 MoAI 에이전트
│   ├── commands/moai/               # 10개 MoAI 명령어
│   ├── skills/                      # 49개 MoAI 스킬
│   └── hooks/                       # MoAI 훅 + ECC tmux 훅
│
├── .moai/                           # MoAI 런타임
│   ├── config/                      # 설정
│   ├── specs/                       # SPEC 문서
│   └── ...
│
├── .shards/                         # Shards 런타임 (병렬 작업)
│   └── config.toml                  # 에이전트 프로필
│
├── mcp-configs/                     # MCP 서버 설정
│   ├── memory.json                  # ECC 세션 간 메모리
│   └── archon.json                  # Archon 지식베이스 연결 (신규)
│
└── 외부 시스템 (선택적 연동)
    ├── Archon V2                    # Docker로 별도 운영
    │   └── http://localhost:8051    # MCP 서버 엔드포인트
    ├── AionUi                       # 독립 실행 (선택)
    │   └── WebUI 모드               # 원격 접속용
    └── ChatDev 2.0                  # 독립 실행 (선택)
        └── 딥 리서치/시각화         # 특수 작업용

📋 사용자 선택 필요 항목 (업데이트)

기존 선택 항목

1️⃣ 세션 메모리 방식

옵션	설명
A. MoAI 로그 시스템만	`.moai/logs/`에 30일 보관, 문서 관리와 분리
B. ECC Session Persistence 추가	`~/.claude/sessions/`에 별도 저장, 7일간 탐색

2️⃣ 자동 학습 (Continuous Learning)

옵션	설명
A. 사용 안 함	MoAI 스킬만 사용, 노이즈 방지
B. ECC 방식 도입	세션 종료 시 패턴 자동 추출, 사용자 확인 후 저장

3️⃣ 모델 티어링 전략

옵션	설명
A. MoAI GLM 통합 우선	z.ai GLM 사용, 70% 비용 절감
B. ECC 모델 티어링	Haiku(문서)/Sonnet(코딩)/Opus(설계) 분리
C. 혼합	GLM 기본 + 복잡한 작업만 Opus

4️⃣ Shards 리뷰 에이전트 통합

옵션	설명
A. MoAI `manager-quality`만	통합된 품질 검증
B. Shards 리뷰 에이전트 추가	6개 세분화된 관점 (code-simplifier, silent-failure-hunter 등)

신규 선택 항목

5️⃣ AionUi 통합 범위

옵션	설명
A. 사용 안 함	CLI만 사용, GUI 불필요
B. WebUI 원격 접속만	모바일에서 Claude Code 제어용
C. 멀티세션 GUI 활용	여러 프로젝트 병렬 작업 시 GUI 활용
D. 오피스 스킬 포함	문서 자동화(docx/xlsx/pptx) 필요 시

💬 선택해주세요: Claude Code 작업에 GUI 인터페이스가 필요하신가요? 모바일 원격 접속이나 멀티세션 관리가 유용하시겠습니까?

6️⃣ Archon V2 통합 범위

옵션	설명
A. MCP 서버만 연결	Claude Code에 지식베이스 직접 제공 (권장)
B. 웹 크롤러 + RAG 활용	프레임워크 문서 자동 수집 및 검색
C. 태스크 관리 병행	Archon 태스크 + MoAI SPEC 병행 (동기화 필요)
D. 사용 안 함	MoAI 자체 시스템만 활용

💬 선택해주세요: 외부 문서(프레임워크 공식 문서 등)를 Claude Code에서 직접 검색하고 싶으신가요? Archon MCP 서버 연동을 원하시는지 확인이 필요합니다.

7️⃣ ChatDev 2.0 통합 범위

옵션	설명
A. 사용 안 함	MoAI 워크플로우만으로 충분 (권장)
B. 딥 리서치만	`deep_research_v1.yaml` 연구 자동화 활용
C. 데이터 시각화만	분석 작업에 ChatDev 활용
D. 독립 운영	코딩환경과 별도로 특수 작업용 유지

💬 선택해주세요: 딥 리서치나 데이터 시각화 같은 특수 작업이 자주 필요하신가요? ChatDev 2.0을 별도 도구로 유지할지 결정이 필요합니다.

📝 통합 실행 로드맵 (업데이트)

Phase 1: 기반 설정 (MoAI-ADK)

# 1. MoAI-ADK 설치
uv tool install moai-adk

# 2. 프로젝트 초기화
moai init .

# 3. 기본 설정 확인
moai update --check

Phase 2: Shards CLI 통합

# 1. Shards 설치
cd shards
cargo install --path .

# 2. 에이전트 프로필 설정 (~/.shards/config.toml)

Phase 3: 선택적 ECC 요소 통합

memory MCP → .claude/settings.json에 추가
tmux 훅 (선택 시) → .claude/hooks/에 추가
Session Persistence (선택 시) → 훅 스크립트 추가

Phase 4: Archon V2 통합 (신규, 선택 시)

# 1. Archon Docker 실행
cd Archon-V2-Alpha
docker-compose up -d

# 2. MCP 설정에 Archon 추가
# .claude/settings.json에 archon MCP 서버 추가

# 3. 지식베이스 구성
# http://localhost:3737에서 문서 크롤링/업로드

Phase 5: AionUi 설정 (신규, 선택 시)

# 1. AionUi 설치 (GitHub Releases에서 다운로드)

# 2. WebUI 모드 실행 (원격 접속 필요 시)
AionUi --webui --remote

# 3. Claude Code 연동 확인

Phase 6: 검증

# MoAI 설치 확인
moai --version

# Shards 설치 확인
shards --version

# MoAI 초기화
moai init . && ls .moai/

# Shards 동작
shards create test --agent claude && shards destroy test

# Archon MCP 연결 (선택 시)
curl http://localhost:8051/health

⚠️ 주의사항 (업데이트)

항목	설명
MCP 개수 제한	프로젝트당 10개 미만 권장 (컨텍스트 70% 축소 방지)
Rust 환경	Shards 사용 시 Rust 컴파일 환경 필요
GLM API 키	MoAI 사용 시 z.ai GLM API 키 필요 (선택)
훅 충돌	ECC 훅과 MoAI 훅 병합 시 실행 순서 확인 필요
Docker 리소스	Archon V2 사용 시 Docker 메모리 2GB+ 권장
포트 충돌	Archon(3737, 8051, 8181), ChatDev(5173, 6400) 포트 확인

검증 계획

자동 검증

항목	명령어
MoAI 설치 확인	`moai --version`
Shards 설치 확인	`shards --version`
MoAI 초기화	`moai init . && ls .moai/`
Shards 동작	`shards create test --agent claude && shards destroy test`
Archon MCP (선택)	`curl http://localhost:8051/health`

수동 검증

/moai:1-plan "테스트" 명령어로 SPEC 생성 확인
Shards로 병렬 분기 생성 후 각 분기에서 독립 작업 확인
MoAI TRUST 5 품질 게이트 통과 여부 확인
(선택) Archon에서 문서 크롤링 후 Claude Code에서 RAG 검색 테스트
(선택) AionUi WebUI 모드에서 원격 접속 테스트

작성일: 2026-01-24 (v2 업데이트)

sqwda22/CODING_ENV_INTEGRATION_PLAN.md

코딩환경 재구축 통합 계획서 (v2)

📊 시스템 비교 요약

기존 분석 대상 (3개)

추가 분석 대상 (3개)

🏆 기반 시스템 유지: MoAI-ADK

선정 근거 (변경 없음)

결론

🔄 통합 대상 구성요소 분석 (업데이트)

everything-claude-code에서 가져올 요소

✅ 명확히 가져올 것

⚠️ 사용자 선택 필요 (기존)

shards에서 가져올 요소

✅ 명확히 가져올 것

⚠️ 사용자 선택 필요

AionUi에서 가져올 요소 (신규 추가)

⚠️ 사용자 선택 필요

❌ 가져오지 않을 것

Archon V2에서 가져올 요소 (신규 추가)

✅ 명확히 가져올 것

⚠️ 사용자 선택 필요

❌ 가져오지 않을 것

ChatDev 2.0에서 가져올 요소 (신규 추가)

⚠️ 사용자 선택 필요

❌ 가져오지 않을 것

🎯 통합 아키텍처 제안 (업데이트)

📋 사용자 선택 필요 항목 (업데이트)

기존 선택 항목

1️⃣ 세션 메모리 방식

2️⃣ 자동 학습 (Continuous Learning)

3️⃣ 모델 티어링 전략

4️⃣ Shards 리뷰 에이전트 통합

신규 선택 항목

5️⃣ AionUi 통합 범위

6️⃣ Archon V2 통합 범위

7️⃣ ChatDev 2.0 통합 범위

📝 통합 실행 로드맵 (업데이트)

Phase 1: 기반 설정 (MoAI-ADK)

Phase 2: Shards CLI 통합

Phase 3: 선택적 ECC 요소 통합

Phase 4: Archon V2 통합 (신규, 선택 시)

Phase 5: AionUi 설정 (신규, 선택 시)

Phase 6: 검증

⚠️ 주의사항 (업데이트)

검증 계획

자동 검증

수동 검증