AI-CEO 프레임워크
English | 日本語 | 中文
License: MIT
GitHub stars
GitHub last commit
Claude Code로 회사 전체를 운영하세요
15개의 AI 에이전트 + 5개의 프로덕션 스킬 + 승인 파이프라인. 대부분 자동화로 운영되는 1인 기업입니다.
실제 환경(Production)에서 실행하기
AI-CEO Framework는 실제로 회사를 운영합니다. 다음은 2026년 11월 11일 기준으로 확인할 수 있는 수치들입니다:
| 지표 (Metric) | 값 (Value) | 측정 방법 (How it is measured) |
|---|
| 운영 시작일 (In production since) | 2026-02-16 (약 9개월) | 운영 레포지토리의 첫 커밋 |
| ... | | |
| 운영 비용은 Claude Code Max 플랜과 헤드리스(headless) 실행에 대한 측정 사용량으로 구성됩니다. 측정 사용량 부분은 고정적이지 않으며, 자동화를 추가함에 따라 증가했습니다. | | |
직접 운영되는 회사 자체는 17개의 에이전트와 13개의 스킬로 구성되어 있습니다. 나머지 초과분은 저희 비즈니스(출판 파이프라인, 아웃바운드 세일즈)에 특화된 것이므로 여기에는 배포되지 않았습니다.
이 README의 이전 버전에서는 "비즈니스 운영의 98%", "2025년 이후 운영 시작 (1년 이상)", 그리고 "월 약 $250"라는 주장이 있었습니다. 98%는 측정된 적이 없으며, "2025년 이후"라는 내용은 잘못되었습니다. 이 수치들은 검증 가능한 수치로 대체되었습니다.
CEO 한 명. 직원 제로명. Claude Code가 구동하는 완벽한 C-suite입니다.
내부 구성 요소 (What's Inside)
15개의 AI 에이전트 (agents/)
각 에이전트는 정의된 페르소나, 전문 지식, 워크플로우, 출력 템플릿 및 품질 검사 기능을 갖추고 있습니다.
| 에이전트 (Agent) | 역할 (Role) | 핵심 기능 (Key Capabilities) |
|---|
| CTO | 최고 기술 책임자 (Chief Technology Officer) | 스프린트 계획, 코드 리뷰, 아키텍처 결정, 핫픽스 관리 |
| ... | | |
5개의 스킬 (skills/)
에이전트가 특정 작업을 실행하기 위해 호출하는 재사용 가능한 스킬 정의입니다.
| 스킬 (Skill) | 목적 (Purpose) |
|---|
validate-hypothesis | 6단계 비즈니스 가설 검증 (원하지 않는 것을 구축하는 것 방지) |
| ... | |
오케스트레이터 (CLAUDE.md)
시스템의 두뇌입니다. 다음 기능을 수행하는 단일 CLAUDE.md 파일입니다:
- 자연어 요청을 이해하고 적절한 부서로 라우팅합니다.
- 외부 노출 액션에 대한 승인 파이프라인(approval pipeline)을 관리합니다.
- 부서 간 작업을 조정합니다.
- 새로운 이니셔티브를 위해 가설 검증 게이트(hypothesis validation gates)를 강제 적용합니다.
- 얇은 컨텍스트 발자국(context footprint, 활용률 10~15%)을 유지합니다.
Steering Files (steering/)
| 파일 | 목적 |
|---|
permissions.md | 권한 레벨(읽기 전용 / 초안 / 실행), 비용 임계값, 배포 규칙 |
policies.md | 보안, 품질, 비용 관리, 개발 프로세스, 규정 준수 정책 |
Setup Script (setup.sh)
5분 설정. 스크립트를 실행하고 몇 가지 질문에 답하면 AI-CEO Framework가 작동합니다.
아키텍처 (Architecture)
flowchart TD
CEO["CEO (당신)"]
ORC["CLAUDE.md\n(오케스트레이터)"]
...
작동 방식 (How It Works)
승인 파이프라인 (The Approval Pipeline)
모든 외부 노출 액션(이메일, 소셜 게시물, 송장, 배포 등)은 다음 과정을 거칩니다:
- 에이전트가
approval-queue.md에 초안을 작성합니다.
- CEO가
/ai-ceo:approve <id> 또는 /ai-ceo:reject <id> "reason"으로 검토합니다.
- 승인된 항목은 자동으로 실행됩니다.
이를 통해 AI가 당황스러운 이메일을 보내거나 작동하지 않는 코드를 프로덕션 환경에 배포하는 것을 방지합니다.
가설 검증 게이트 (Hypothesis Validation Gate)
새로운 제품, 광고 채널 또는 중요한 투자를 하기 전에:
- 페이즈 0: 아이디어 출처 확인 (고객 주도인지 자체 주도인지?)
- 게이트 1: 시장 존재 확인 (데이터 기반)
- 게이트 2: 고객/경쟁사 인터뷰 (3개 이상의 회사)
- 게이트 3: 인터뷰 평가 (사실 강도 점수화)
- 게이트 4: 지불 의사 확인 (LOI, 사전 주문, 서면 약속)
- 게이트 5: 최소 실행 가능 테스트 (노코드 검증)
- 결정: 진행(Go) / 중단(No-Go) / 철수(Retreat) (학습 문서 포함)
최대 2회 재시도가 가능합니다. 두 번 실패하면 철수 보고서가 생성됩니다. 이는 아무도 원하지 않는 것을 만드는 것을 방지합니다.
빠른 시작 (Quick Start) (5분)
1. 클론 및 설정
cp -r ai-ceo-framework-pack/.claude/ your-project/.claude/
cp ai-ceo-framework-pack/CLAUDE.md your-project/CLAUDE.md
...
2. 설정 질문에 답변하기
스크립트는 다음 질문들을 할 것입니다:
- 회사 이름 (Company name)
- 귀하의 이름 (CEO)
- 사업 설명 (Business description)
- 구축 중인 제품 (Products you're building)
- 기술 스택 (Tech stack)
- 외부 도구 (회계, CRM 등) (External tools)
- 우선순위를 지정할 부서 (Which departments to prioritize)
- AI 예산 (AI budget)
3. 사용 시작하기
프로젝트 디렉터리에서 Claude Code를 여세요. 자연스럽게 대화하듯이 말하면 됩니다:
> "오늘 우리의 현황은 어때?"
> "AI 자동화에 대한 블로그 게시물을 작성해 줘"
> "개발 스프린트를 진행하자"
...
또는 명시적인 명령어를 사용할 수 있습니다:
> /ai-ceo:morning -- 일일 브리핑
> /ai-ceo:status -- 빠른 현황 확인
> /ai-ceo:dev:sprint -- 개발 스프린트 실행
...
디렉터리 구조 (Directory Structure)
설정 후, 프로젝트는 다음과 같은 구조를 갖게 됩니다:
your-project/
CLAUDE.md # 오케스트레이터 (메인 두뇌)
.claude/
...
FAQ
Q: Claude Code 무료 등급에서도 작동하나요?
A: 프레임워크 자체는 모든 Claude Code 플랜에서 작동합니다. 하지만 서브 에이전트(Agent tool을 사용하는 경우)는 Claude Code Max($100/월) 또는 Anthropic API 키가 연결된 Claude Code가 필요합니다. 최적의 성능을 위해서는 Claude Code Max를 권장합니다.
Q: 이 프레임워크는 어떤 언어를 지원하나요?
A: 프레임워크 템플릿은 영어로 되어 있습니다. 모든 에이전트 정의와 명령어는 영어로 작동합니다. 설정 후에는 원하는 모든 언어로 에이전트를 사용자 지정할 수 있습니다.
Q: 제가 직접 에이전트를 추가할 수 있나요?
A: 네. 동일한 형식(프론트매터 + 페르소나 + 워크플로우 + 품질 검사)을 따라 .claude/agents/에 새로운 .md 파일을 생성하세요. 오케스트레이터가 이를 자동으로 감지합니다.
Q: 필요 없는 에이전트는 제거할 수 있나요?
A: 네. 해당 에이전트 파일을 삭제하기만 하면 됩니다. 오케스트레이터는 누락된 부서를 우아하게 처리(gracefully handles)합니다.
Q: 단순히 긴 CLAUDE.md 파일을 작성하는 것과 어떻게 다른가요?
A: 세 가지 주요 차이점이 있습니다. (1) 오케스트레이터(orchestrator)는 모든 내용을 하나의 프롬프트에 로드하는 대신 서브 에이전트(sub-agents)에게 위임함으로써 컨텍스트를 10~15% 수준으로 유지합니다. (2) 승인 파이프라인(approval pipeline)은 AI가 무단 외부 행동을 취하는 것을 방지합니다. (3) 각 에이전트는 단일하고 거대한 CLAUDE.md 파일로는 유지할 수 없는 전문화된 전문 지식, 품질 검사 및 출력 템플릿을 갖추고 있습니다.
Q: 제 데이터는 안전한가요?
A: 모든 데이터는 사용자의 로컬 .company/ 디렉터리에 보관됩니다. Claude Code의 일반적인 API 호출 경로를 통해서만 전송되며, 다른 곳으로는 어떠한 것도 전송되지 않습니다. 이 프레임워크에는 보안 정책과 권한 제어 기능이 기본적으로 포함되어 있습니다.
Q: 팀 전체(혼자 아닐 때)에도 사용할 수 있나요?
A: 이 프레임워크는 1인 기업을 위해 설계되었지만, 소규모 팀에도 작동합니다. 승인 파이프라인은 자연스럽게 단일 의사결정권자(CEO)를 지원합니다. 더 큰 팀의 경우, 승인 흐름을 사용자 지정할 필요가 있을 수 있습니다.
Q: 에이전트가 실패하면 어떻게 되나요?
A: 내장 오류 처리 기능이 있습니다. 피드백과 함께 최대 3회까지 재시도한 후, 승인 대기열(approval queue)을 통해 CEO에게 보고합니다. 오류 로그는 각 부서의 error-log.md에 기록됩니다.
배경 학습 (일본어)
이 프레임워크의 운영 기록은 일본어로 된 책으로 작성되었습니다: Claude Code로 회사를 움직이는 방법 (Zenn에서 무료 챕터 이용 가능).
전문 지원
(일본 기반 회사만 해당)
회사에 AI-CEO Framework를 설정하는 데 도움이 필요하신가요? JoinClass LLC에서 컨설팅 서비스를 제공합니다:
- 무료 30분 AI 진단 — 귀사의 비즈니스 운영을 분석하고 AI 자동화가 가장 큰 영향을 미칠 수 있는 상위 3개 영역을 식별해 드립니다.
- 맞춤 설정 — 귀사의 특정 비즈니스 요구 사항에 맞춰 프레임워크를 구성합니다.
- 지속적인 지원 — AI 운영 최적화를 위한 월간 자문 서비스를 제공합니다.
무료 진단 예약하기 →
이전 / 이후
| Without AI-CEO | With AI-CEO |
|---|
| 설정 (Setup) | 모든 것이 담긴 거대한 CLAUDE.md 파일 하나 | 15개의 전문 에이전트 + 얇은 오케스트레이터(orchestrator) |
| ... | | |
이것이 실제로 무엇인가
이것은 단순한 프롬프트 모음집이 아닙니다. 인공지능(AI)으로 회사를 운영하기 위한 프로덕션 등급의 운영 체제입니다. 모든 에이전트, 모든 워크플로우, 모든 품질 검사는 2026년 2월부터 매일 사용하면서 다듬어졌습니다. 가설 검증(hypothesis validation) 기능이 가장 의존하는 부분입니다: 2026년 8월에는 회사를 세 개의 사업으로 축소하고 다섯 가지 제품을 폐쇄하기로 결정하는 데 이 부분이 포함되었습니다.
이것은 Claude Code를 사용하여 전체 회사를 운영하며 얻은 정수입니다. 실패했던 경험, 수정된 부분들, 그리고 살아남은 프레임워크들이 담겨 있습니다.
별(Star) 히스토리
Star History Chart
기여 (Contributing)
기여는 언제나 환영합니다! 버그 보고서, 기능 요청, 또는 풀 리퀘스트(pull request) 등 모든 입력은 소중하게 여겨집니다.
- 이슈 (Issues): 버그를 발견했거나 아이디어가 있나요? 이슈 열기.
- 풀 리퀘스트 (Pull Requests): 레포지토리를 포크(fork)하고, 변경 사항을 만들고, PR을 제출하세요. 변경 사항은 초점을 맞추고 명확한 설명을 포함해 주십시오.
- 토론 (Discussions): 이슈로 분류하기 애매한 질문이나 아이디어가 있나요? 토론 시작.
라이선스 (License)
MIT 라이선스. 자세한 내용은 [LICENSE]를 참조하세요.
Claude Code로 구축되었습니다. 프로덕션 환경에서 테스트되었습니다. 여러분의 사용을 위해 준비되었습니다.