개발 키트 소개

Multi-SaaS Kit의 **Foundation(개발 키트)**는 프레임워크에 구애받지 않는 AI 협업 개발 방법론입니다.

📝 초안 (Draft)

이 문서는 검토 중입니다. 내용이 변경될 수 있습니다.

개요

Foundation은 Laravel, Next.js, Spring, Go 등 어떤 기술 스택에서도 활용 가능한 개발 프로세스와 도구 모음입니다.

┌─────────────────────────────────────────────────────────────────┐
│                    🔧 Foundation (개발 키트)                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│  ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐    │
│  │  AI 워크플로우   │ │   폴더 구조     │ │   운영 시스템    │    │
│  │                 │ │                 │ │                  │    │
│  │ • Claude 자동화  │ │ • 표준 디렉토리  │ │ • Docker 컨테이너│    │
│  │ • Multi-LLM     │ │ • 문서 체계     │ │ • Makefile 자동화│    │
│  │ • Hooks/Cmds    │ │ • 분리 원칙     │ │ • 배포 관리      │    │
│  └─────────────────┘ └─────────────────┘ └─────────────────┘    │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘

핵심 구성 요소

1. AI 워크플로우

Claude Code를 중심으로 한 AI 협업 개발 시스템입니다.

구성 요소	설명
Hooks	자동 검증 (보안, 품질, 컨벤션)
Commands	슬래시 명령어 (/code-review, /security-scan)
Skills	재사용 가능한 작업 템플릿
Agents	특화된 하위 에이전트
Multi-LLM	여러 LLM 활용한 검증

→ AI 워크플로우 상세

2. 폴더 구조 설계

일관된 프로젝트 구조와 문서화 체계입니다.

원칙	설명
소스/데이터 분리	개발 소스와 런타임 데이터 완전 분리
문서 체계	계층화된 문서 구조 (CLAUDE.md, README.md)
프로젝트 독립	각 프로젝트가 모든 설정을 자체 보유

3. 운영 시스템

Docker와 Makefile 기반의 자동화된 운영 환경입니다.

도구	역할
Docker	컨테이너화된 개발/운영 환경
Makefile	단일 진입점 명령어 시스템
릴리즈 관리	스냅샷 기반 배포

→ 인프라 운영 상세

대상 독자

독자	Foundation 활용 방식
Laravel 개발자	Platform과 함께 사용
Next.js/React 개발자	Foundation만 활용, 설계 참고하여 자체 구현
Spring/Java 개발자	Foundation만 활용, 설계 참고하여 자체 구현
기타 스택 개발자	방법론과 자동화 시스템 활용

다음 단계

• 설치 가이드 - Foundation 설치
• 시스템 요구사항 - 필요 환경
• AI 워크플로우 - AI 협업 시스템
• 인프라 운영 - Makefile/Docker