본문으로 건너뛰기

AI Workflow 개요

multi-saas-kit은 AI 에이전트(Claude Code, Codex, Gemini)와의 협업을 위한 자동화 시스템을 내장하고 있습니다.

핵심 가치​

가치설명
일관된 품질보안 검사, 테스트 확인, 문서 정합성이 코드 수정 시 자동 실행
컨텍스트 보존세션 요약, handoff, tmux 연동으로 작업 연속성 보장
멀티 LLM 합의Claude 단독이 아닌 4개 LLM(OpenCode, Kilo, Codex, Gemini)의 교차 검증
프로젝트 격리서브 프로젝트별 독립 실행 + 공통 기능 공유

3계층 아키텍처 (.ai-core v2.1.0)​

┌─────────────────────────────────────────────────┐
│  Adapter Layer                                   │
│  .claude/  .codex/  .gemini/                     │
│  hooks, commands, skills, settings.json          │
├─────────────────────────────────────────────────┤
│  Core Layer                   ← .ai-core/        │
│  config, scripts, validation, multi-llm, tmux    │
├─────────────────────────────────────────────────┤
│  Data Layer                   ← .ai-core/data/   │
│  context, reports, cache, venv, backups          │
└─────────────────────────────────────────────────┘
계층위치Git역할
Adapter.claude/YesClaude Code 전용 인터페이스 (hooks, commands, skills)
Core.ai-core/Yes에이전트 공통 로직 (config, scripts, validation, multi-llm)
Data.ai-core/data/No런타임 데이터 (세션, 리포트, 캐시)
왜 3계층인가?

에이전트(Claude, Codex, Gemini)는 각자 다른 이벤트 시스템을 가집니다. 공통 로직을 .ai-core/에 집중하면, 새 에이전트 추가 시 어댑터만 작성하면 됩니다.

주요 기능 한눈에​

자동 실행 (Hooks)​

코드를 수정하면 자동으로:

  • SQL Injection, XSS, 시크릿 노출 패턴 검사
  • 테스트 파일 존재 여부 확인
  • 문서 정합성 검사
  • 위험 파일(Core, .env, migrations) 변경 시 자동 백업

세션 관리​

  • /quit 시 handoff 자동 저장
  • /-session-resume으로 이전 세션 이어가기
  • 증분 요약으로 컨텍스트 보존 (2차 원본)

Multi-LLM​

  • /-chorus: 4개 LLM 병렬 합주 (Agent 세션 기반)
  • /-consensus: 심층 합의 (PASS/ISSUE 판정)
  • 자동 토론: 의사결정 프롬프트에 외부 LLM 의견 자동 수집

tmux 대시보드​

3줄 상태바 + pane-border에 실시간 표시:

  • 세션 ID, 작업 요약, LLM 상태
  • Handoff 상태, 프롬프트 주입 현황
  • CPU/MEM 사용률

버전​

현재: v2.1.0 (2026-04-11)