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 add <package>         # Extension 패키지 추가
semo add biz               # Business 레이어 전체 설치
semo add eng               # Engineering 레이어 전체 설치
semo add ops               # Operations 레이어 전체 설치
semo list                  # 사용 가능한 패키지 목록
semo status                # 설치 상태 확인
semo update                # 최신 버전으로 업데이트
semo -v                    # 버전 및 업데이트 확인

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                                      │
│  테스트 │ 모니터링 │ 개선제안                                  │
└─────────────────────────────────────────────────────────────┘

패키지 구조

Standard (필수)

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

Extensions (선택)

Business Layer

Engineering Layer

Operations Layer

Meta

설치 후 구조

your-project/
├── .claude/
│   ├── CLAUDE.md              # 프로젝트 설정
│   ├── settings.json          # MCP 서버 설정
│   ├── memory/                # Context Mesh
│   ├── agents/                # 에이전트 링크
│   ├── skills/                # 스킬 링크
│   └── commands/SEMO/         # SEMO 커맨드
│
└── semo-system/               # White Box
    ├── semo-core/
    ├── semo-skills/
    └── {extensions}/

레포지토리 구조

semo/
├── semo-core/                 # 핵심 원칙, 오케스트레이터
├── semo-skills/               # 통합 스킬 (13개)
├── 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 서버를 자동으로 등록합니다:

환경변수

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

모드 시스템

관련 패키지

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

라이선스

MIT