Comad World 사용법 가이드

각 모듈의 핵심 기능, 실행 명령, 예상 출력을 스크린샷과 함께 단계별로 정리합니다. 상단 탭 또는 아래 카드에서 관심 있는 모듈을 선택하세요. 영문 번역은 순차적으로 추가됩니다.

처음 오신 분이라면 스케줄러 설치 → Brain (지식 그래프) 순서를 추천합니다. 모든 모듈은 독립적으로도 동작합니다.

0. 공통

스케줄러 Scheduler

macOS LaunchAgents · Linux cron · Windows Task Scheduler. schedule-install.sh 한 번으로 OS 자동 감지.

1. 지식 그래프

Brain 지식 그래프 · GraphRAG

크롤링 → 엔티티 추출 → Neo4j → 20+ MCP 도구. GraphRAG 벤치마크 recall 93%, latency 13.8s.

2. 수집

Ear 뉴스 큐레이터

Discord 기사 자동 아카이브 · 3단 관련성 분류 · 일일 digest HTML · 필독 기사 자동 /search 피드.

3. 예측

Eye 시뮬레이션 엔진

텍스트 → 온톨로지 → 10 분석 렌즈 → 전파 시뮬레이션 → 예측 보고서. Next.js UI + 7 MCP 도구.

4. 자기진화

Search 레퍼런스 파이프라인

GitHub · npm · PyPI · arXiv 병렬 탐색 · 오프토픽 게이트 · sandbox 검증 · 채택 이력 추적.

5. 창작

Photo AI 사진 보정

이미지 분석 → 보정 계획 → Photoshop MCP 비파괴 편집. MAE 가드, 배치 모드.

6. 기억

Sleep 메모리 정리

Claude Code 프로젝트별 auto memory 전수 스캔 · 중복 감지 · 통합 · MCP 서버로 조회.

7. 오케스트레이션

Voice 워크플로우 하네스

CLAUDE.md 트리거 6개. "상황 검토해봐" 한마디로 코드베이스 진단 → 개선 카드 제시.

8. 브라우저

Browse 헤드리스 브라우저 · 토큰 최적화

Playwright Chromium 래퍼 + @ref 기반 상호작용. find·batch·세션 영속화로 로그인 플로우를 1 round-trip으로 압축.

자매 레포 Sister Repos

코마드월드는 위 8개 핵심 모듈 외에 extensions(자가진화·QA·병렬 외주 가드) 와 studio(이미지·영상·슬라이드 등 산출물 생성) 두 자매 레포가 함께 한 시스템을 이룹니다. 각 가이드는 별도 페이지에 정리되어 있습니다.

9. 확장 (가드)

Extensions 조용한 가드 · 9 hooks + 5 skills

T6 자가진화 (fix:/feat: 자동 학습) · Approval-Gated Destruction · Proof-Driven QA (.qa-evidence + .second-opinion) · Codex 병렬 외주(parallel) + 5종 통합 게이트.

10. 산출물 스튜디오

Studio 시각/미디어 생성 · 5 skills

Codex /imagen 7-mode 이미지 · HTML→Playwright→ffmpeg 영상(BGM/SFX 번들) · pptxgenjs 슬라이드 · 4-패턴 인포그래픽 · iOS/Android/macOS/Browser 프레임 목업.

업그레이드 Upgrading

이미 설치했다면 comad 한 명령으로 main + 6개 모듈 + deps + agents를 한 번에 업데이트합니다. Dirty tree abort · 자동 스냅샷 · 롤백 지원.

# Any directory (symlinked to ~/.local/bin/comad by install.sh)
comad status              # VERSION + module SHAs (dirty flagged)
comad upgrade --dry-run   # preview changes
comad upgrade             # pull + deps + agents + auto-backup
comad backups             # list snapshots
comad rollback <ts>       # restore a prior snapshot

# Or via Makefile from the repo root
make test                 # full suite (brain + eye)
make clean                # dry-run: preview 300MB+ of caches & logs
make clean-apply          # actually delete them
make clean-deep           # also nuke node_modules / .venv (~3.6 GB)
make validate-config      # comad.config.yaml + presets vs JSON Schema

루트 VERSION (semver) + comad.lock (6개 모듈 branch+SHA 고정)으로 package-lock.json처럼 조합을 재현 가능. 기존 설치 사용자는 한 번 git pull origin main && ./install.sh 하면 comad 명령이 생깁니다. 세부: README § Upgrading.

📄 Config 계약 — ADR 0002: comad.config.yaml의 JSON Schema(schema/comad.config.schema.json)를 기준으로 필수·선택 섹션, 타입, URL 패턴, Neo4j URI 등 자동 검증. 오타나 잘못된 타입은 CI의 config-schema-validation 잡이 2초 안에 잡아냅니다. make validate-config로 로컬에서도 실행.

📐 저장소 전략 — ADR 0011 (Accepted, 2026-04-14): 단일 mono-repo. 모든 모듈 파일이 umbrella git의 일급 트래킹 대상이고, git clone comad-world && ./install.sh 한 번으로 전체 시스템이 재현됩니다. ADR 0001의 "umbrella + 6 nested .git" 분리 전략은 superseded — nested git 6개는 archive로 보존(7일 rollback 가능). Structure Guard CI는 그대로 유지되어 루트 중복 파일·빌드 산출물 트래킹·VERSION 형식 오류를 PR마다 자동 검증합니다.

📂 경로 무관 — 어느 폴더, 어느 이름으로 클론해도 동작합니다. scripts/comad가 자기 심링크를 따라 repo root를 찾고, scripts/render-templates.sh가 {{COMAD_ROOT}} 플레이스홀더를 install/upgrade 시점에 절대경로로 치환합니다. ~/Desktop/내-에이전트, /opt/comad 어디든 OK.