[EP4] MoAI-ADK 핵심 기술 Deep Dive - alfred, Ralph Engine, 스킬 시스템

Domain Detection:
├── Backend Keywords: API, 서버, 인증, 데이터베이스, REST, GraphQL
├── Frontend Keywords: UI, 컴포넌트, React, Vue, Next.js, CSS
├── Security Keywords: 보안, 취약점, OWASP, 인증, 권한
├── DevOps Keywords: CI/CD, Docker, Kubernetes, 배포
└── Database Keywords: SQL, 스키마, 쿼리, 인덱스

Routing Logic:
├── 단일 도메인 감지 → Expert Agent 직접 위임
└── 복수 도메인 감지 → Full SPEC 워크플로우 (Plan → Run → Sync)

{
  "spec_id": "SPEC-AUTH-001",
  "current_phase": 2,
  "last_checkpoint": "2026-01-10T14:30:00Z",
  "phase_results": {
    "1": { "status": "completed", "spec_file": "specs/SPEC-AUTH-001.md" },
    "2": { "status": "in_progress", "coverage": 0.72 }
  },
  "git_state": {
    "branch": "feat/auth-001",
    "commits": ["abc123", "def456"]
  }
}

/moai:alfred resume SPEC-AUTH-001

LSP Client 기능:
├── 실시간 타입 오류 감지
├── 구문 오류 감지
├── 경고 수집
├── 다중 언어 서버 관리
└── 진단 결과 스트리밍

AST-grep 기능:
├── 보안 취약점 탐지
│   ├── SQL Injection 패턴
│   ├── XSS 취약점
│   └── 하드코딩된 시크릿
├── 코드 스멜 식별
│   ├── 사용되지 않는 변수
│   ├── 복잡도 초과 함수
│   └── 중복 코드
└── 자동 리팩토링
    ├── API 마이그레이션
    └── 패턴 변환

Loop Controller 동작:
├── Promise 기반 완료 조건
│   └── 모든 오류 해결 OR 최대 반복 도달
├── 설정 가능한 최대 반복 횟수 (기본: 3)
├── 상태 지속 및 재개 지원
└── 자율 수정 사이클
    ├── 오류 분석
    ├── 수정 시도
    ├── 재검증
    └── 다음 반복 또는 완료

class DiagnosisResult:
    file_path: str
    lsp_diagnostics: List[Diagnostic]
    ast_matches: List[AstMatch]
    severity_summary: Dict[str, int]
    auto_fixable: List[FixSuggestion]

Anti-Hallucination 원칙:
├── 검증된 패턴만 사용
│   └── 각 스킬은 실제 동작하는 코드 패턴 포함
├── 버전 명시
│   └── 라이브러리/프레임워크 버전 명시
├── 출처 추적
│   └── 모든 패턴에 출처 정보 포함
└── 자동 갱신
    └── Context7 MCP를 통한 최신 문서 참조

name: moai-lang-typescript
version: 5.9
category: language
effort: 3
dependencies:
  - moai-domain-frontend
triggers:
  - typescript
  - tsx
  - type-safe

// ✅ Recommended: Type inference with const assertion
const config = {
  apiUrl: 'https://api.example.com',
  timeout: 5000,
} as const;

// ❌ Avoid: Explicit any
const data: any = fetchData();

import { z } from 'zod';

const UserSchema = z.object({
  id: z.string().uuid(),
  email: z.string().email(),
  role: z.enum(['admin', 'user']),
});

type User = z.infer<typeof UserSchema>;

Context7 통합:
├── resolve-library-id: 라이브러리 식별자 해석
└── get-library-docs: 최신 문서 가져오기

사용 시나리오:
├── 스킬에 없는 최신 API 참조
├── 버전 업데이트 확인
└── 실시간 문서 검증