SEMO (Semicolon Orchestrate)

AI Agent Orchestration Framework v3.0

빠른 시작

# CLI 설치
npm install -g @team-semicolon/semo-cli

# 프로젝트에 SEMO 설치
semo init

# 버전 확인
semo -v

주요 명령어

# 설치
semo init                  # SEMO 설치 (프로젝트 유형 자동 감지)
semo onboarding            # 글로벌 설정 (~/.claude/) 초기 구성
semo -v                    # 버전 및 업데이트 확인

# DB 동기화
semo context sync          # Core DB → .claude/memory/ 동기화
semo context push          # decisions.md → Core DB 저장
semo doctor                # 환경 진단 (DB 연결, 설치 상태)

# 봇 관리
semo bots status           # 봇 상태 조회
semo bots sync             # 봇 메타데이터 + 스킬 → DB 동기화
semo sessions sync         # OpenClaw 세션 데이터 동기화

3-Layer Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Business Layer (biz)                      │
│  discovery │ design │ management │ poc                       │
│  아이템발굴  │  UX설계  │  스프린트관리  │  PoC               │
├─────────────────────────────────────────────────────────────┤
│                   Engineering Layer (eng)                    │
│  nextjs │ spring │ ms │ infra                                │
│  프론트엔드 │ 백엔드  │ MSA │ 인프라                           │
├─────────────────────────────────────────────────────────────┤
│                   Operations Layer (ops)                     │
│  qa │ monitor │ improve                                      │
│  테스트 │ 모니터링 │ 개선제안                                  │
└─────────────────────────────────────────────────────────────┘

레이어	역할	패키지
biz	사업 (기획, 설계, 관리)	discovery, design, management, poc
eng	개발 (구현, 배포)	nextjs, spring, ms, infra
ops	운영 (테스트, 모니터링)	qa, monitor, improve

패키지 구조

Standard (필수)

모든 프로젝트에 기본 설치됩니다.

패키지	설명
semo-core	원칙, 오케스트레이터, 공통 커맨드

Extensions (선택)

Business Layer

패키지	설명	설치
biz/discovery	아이템 발굴, 시장 조사, Epic/Task	semo add biz/discovery
biz/design	컨셉 설계, 목업, UX	semo add biz/design
biz/management	일정/인력/스프린트 관리	semo add biz/management
biz/poc	빠른 PoC, 패스트트랙	semo add biz/poc

Engineering Layer

패키지	설명	자동 감지	설치
eng/nextjs	Next.js 프론트엔드	next.config.*	semo add eng/nextjs
eng/spring	Spring Boot 백엔드	pom.xml	semo add eng/spring
eng/ms	마이크로서비스	-	semo add eng/ms
eng/infra	인프라/배포	Dockerfile	semo add eng/infra

Operations Layer

패키지	설명	설치
ops/qa	테스트/품질 관리	semo add ops/qa
ops/monitor	서비스 현황 모니터링	semo add ops/monitor
ops/improve	개선 제안	semo add ops/improve

Meta

패키지	설명	설치
meta	SEMO 프레임워크 자체 개발	semo add meta

설치 후 구조

# 글로벌 (semo onboarding)
~/.claude/
├── settings.json              # SessionStart/Stop 훅 + MCP 서버 설정
├── memory/                    # Core DB → 자동 동기화 컨텍스트
├── skills/                    # DB → 자동 동기화 (skill_definitions)
├── commands/                  # DB → 자동 동기화 (command_definitions)
└── agents/                    # DB → 자동 동기화 (agent_definitions)

# 프로젝트 (semo init)
your-project/
├── .claude/
│   ├── CLAUDE.md              # 프로젝트 설정 + semo 안내
│   └── settings.json          # 프로젝트별 MCP 설정 (선택)
│
└── semo-system/               # White Box (이 레포 전용)
    ├── bot-workspaces/        # 봇별 워크스페이스 (hooks, skills, memory)
    └── sync-agent/            # 봇 워크스페이스 Git 동기화

레포지토리 구조

semo/
├── semo-core/                 # 핵심 원칙, 오케스트레이터
├── packages/
│   ├── cli/                   # @team-semicolon/semo-cli
│   ├── mcp-server/            # @team-semicolon/semo-mcp
│   ├── biz/                   # Business Layer
│   ├── eng/                   # Engineering Layer
│   ├── ops/                   # Operations Layer
│   └── meta/                  # Meta 패키지
└── docs/                      # 문서

MCP 서버

SEMO는 다음 MCP 서버를 자동으로 등록합니다:

서버	설명
semo-integrations	GitHub, Slack, Supabase 연동
context7	라이브러리 문서 조회
sequential-thinking	순차적 사고 지원

환경변수

export GITHUB_TOKEN="your-token"
export SLACK_BOT_TOKEN="your-token"
export SUPABASE_URL="your-url"
export SUPABASE_KEY="your-key"

모드 시스템

모드	용도	특성
mvp	PoC, 프로토타입	속도 우선, 컨벤션 최소화
prod	실서비스 (기본값)	품질 우선, 풀 컨벤션

관련 패키지

패키지	npm	설명
@team-semicolon/semo-cli		CLI 도구
@team-semicolon/semo-mcp		MCP 서버

라이선스

MIT