AI 네이티브 기술 기업을 위한 오픈소스 운영체제. 버전: 3.0 · 클론하고, 커스터마이징하고, 아이디어부터 글로벌 규모까지 회사를 운영하세요.
Company OS는 프롬프트 저장소, 코드 템플릿, 또는 사업 계획서가 아닙니다. 이는 AI 네이티브 기업이 어떻게 운영되는지에 대한 **중앙 진실 공급원(central source of truth)**입니다: 조직 구조, 엔지니어링 문화, 제품 개발, 연구, 운영, AI 에이전트 인력, 오케스트레이션, 메모리, 표준, 템플릿, 플레이북, 그리고 도메인별 스타터 키트.
이는 산업에 구애받지 않으며(industry-agnostic) 모듈식입니다. 특정 비즈니스를 가정하는 것이 없습니다. 모든 부서는 동일한 구조를 따르는 자체 포함형 미니어처 운영 매뉴얼이므로, 시스템은 예측 가능하고, 확장 가능하며, 반복적입니다.
규모: AI C-suite · 20개 전체 부서 · 107개 AI 에이전트 · 16개 스타터 키트 · 모든 폴더는 자체 README.md를 통해 셀프 인덱싱됩니다.
.
그리고 그것은 작동합니다. 런타임(runtime)이 실제로 해당 에이전트들을 오케스트레이션합니다 — 아래를 확인하세요.
저장소는 정확히 반으로 나뉘어 있습니다. 어느 쪽에 있는지 알면 커스터마이징은 명확해집니다:
handbook/ — 인간이 읽는 부분 |
ai/ — AI가 작동하는 부분 |
|
|---|---|
포함 내용 | 회사 정체성, 거버넌스, 20개 부서 매뉴얼, 워크플로우, 표준, 플레이북, 템플릿, 가이드 | 107개 에이전트 사양(임원 C-suite + 20개 사업부), 오케스트레이션 커널, 메모리 시스템
당신이 편집하는 것 | 회사 운영 방식을 설명하는 것 | 어떤 에이전트가 존재하고 작업이 어떻게 라우팅되는지 변경하는 것 |
대상 독자 | 창업자, 직원, 신규 입사자 | 에이전트 인력
그리고 두 번째 부분을 실행하는 세 번째 요소: runtime/.
런타임은 ai/agents/에 있는 에이전트 사양을 읽고 이를 오케스트레이션합니다. 요청에 필요한 에이전트를 선택하고, 그 에이전트들의 임시 인스턴스만 생성하며, 독립적인 작업을 병렬로 실행하고, 검토한 다음, 결과를 합성합니다. 의존성도 없고, 시도하는 데 API 키가 필요하지 않습니다:
`python -m companyos run
CEO Agent
|-- Planner
| `-- Task Decomposer
...
107개의 스펙은 **정의(definitions)**입니다. 즉, 템플릿이죠. 실행 시에는 필요한 소수의 에이전트만 인스턴스화하고 작업이 끝나면 종료하며, 절대로 107개 에이전트가 동시에 실행되지는 않습니다. 자세한 내용은 ai/orchestration/runtime.md를 참고하세요.
Company OS는 완성된 상태로 배포됩니다. 이 시스템을 당신만의 것으로 만드는 것은 주로 필요하지 않은 것을 삭제하고 당신의 정체성을 채워 넣는 과정입니다. 다음 순서대로 진행하세요:
1. 회사화하기 (Make it your company) (약 30분) — 이 다섯 개의 파일을 수정하세요. 이곳이 당신의 정체성이 정의되는 유일한 장소이며, 다른 모든 것은 이곳을 참조합니다.
mission · vision · principles · structure · roles
2. 스타터 키트 선택하기 (Pick a starter kit) (약 10분) — 회사 유형에 맞는 키트를 선택하세요. 이 키트는 어떤 부서를 먼저 활성화해야 하는지 알려주고 도메인 표준을 추가해 줍니다. 나머지 키트는 삭제하세요.
3. 필요한 부서만 남기기 (Keep only the departments you need) (약 30분) — 첫날부터 스무 개 부서가 모두 필요하지는 않습니다. 일반적인 초기 단계 소프트웨어 회사는 product, engineering, design, post-launch, strategy를 운영합니다.
하나를 제거하려면: handbook/departments/<이름>/와 ai/agents/<이름>/을 삭제하고, 인덱스에서 해당 행을 제거하며, scripts/check-structure.py의 DEPARTMENT_NAMES에서 이를 제거한 다음, 아래 검사를 실행하세요.
하나를 추가하려면: python scripts/scaffold.py department <이름>
4. 에이전트 선택하기 (Choose your agents) (약 20분) — ai/agents/README.md 파일을 열고 실제로 실행할 에이전트만 남기고 나머지는 삭제하세요. 하나를 추가하려면: python scripts/scaffold.py agent <부서> <에이전트-이름>
5. 규칙 조정하기 (Tune the rules) (지속적) — 품질 게이트(quality gates), 의사 결정 프레임워크, 그리고 각 부서의 standards.md를 원하는 엄격도에 맞게 조정하세요.
| 파일 | 가이드라인 |
|---|
| ✏️ 항상 | handbook/company/* , ai/agents/* |
| ⚙️ 자주 | department standards.md , metrics.md , quality-gates.md , governance/* |
| 📖 읽기, 편집 금지 | handbook/guides/* |
| 🔒 건드리지 마세요 | handbook/templates/* , STRUCTURE.md , scripts/* , .github/* |
python scripts/check-links.py # 모든 내부 링크가 해결되는지 확인
python scripts/check-structure.py # 부서 + 에이전트 사양이 준수되었는지 확인
python scripts/check-conventions.py # 폴더별 README, 플레이스홀더 텍스트 없음
...
위 네 가지 스크립트는 푸시 및 PR 시 CI에서 모두 실행됩니다. 만약 부서를 삭제했다면, check-links.py가 해당 부서를 참조하는 모든 링크를 알려줍니다.
👉 부서나 에이전트를 수동으로 추가하는 방법 등 자세한 내용은: CUSTOMIZE.md.
company-os/
│
├── handbook/ ◀── 당신이 읽는 모든 것 ─────────────────────────
...
- 사용자 정의 방법 · 폴더 구조
- 여기서 시작하기 · 메타 및 규칙
- handbook/ — 읽기 측면
- ai/ — 기계 측면
- 창업자 여정 — 아이디어 → 검증 → 구축 → 출시 → 판매 → 투자 유치 → 확장
- 스타터 키트 · 자동화
- 디자인 철학 · 기여하기 · 라이선스
처음 창업하는 분이신가요? Company-Building Guide를 읽어보세요. 회사 구축 및 관리에 필요한 기술과 전체 단계를 담고 있습니다.이것을 당신의 회사로 만들 건가요? CUSTOMIZE.md를 따르세요.OS를 도입할 건가요? company identity → governance → the kernel + memory 순서로 진행하세요.특정 종류의 회사를 구축하고 싶으신가요? 스타터 키트를 선택하세요.
모든 디렉토리에는 해당 내용을 색인화한 자체 README.md 파일이 있습니다. 이 페이지는 최상위 레벨 인덱스이며, 전체 상세 내용은 원하는 영역의 인덱스를 따라가세요.
| 파일 | 목적 |
|---|
| CUSTOMIZE.md | 이 리포지토리를 자신만의 것으로 만드는 방법 |
| ... | |
| 전체 색인: handbook/README.md | |
| Area | 포함 내용 |
|---|
| company/ | 미션 · 비전 · 원칙 · 구조 · 역할 |
| ... | |
| Full index: handbook/departments/README.md | |
| Department | 소유 범위 |
|---|
| engineering/ | 유지보수 가능하고, 테스트되었으며, 안전한 소프트웨어; 표준, 검토, 배포 |
| ... | |
| Full index: ai/README.md | |
| Area | 포함 내용 |
|---|
| agents/ | 107개 에이전트 스펙 레지스트리 + 표준 11개 섹션 스펙 |
| ... | |
| 혼동하지 마세요: | |
ai/ | |
| (AI 인력) | |
| 과 handbook/departments/ai-engineering/ (AI 제품 구축의 학문). | |
회사가 거치는 전 과정의 경로와 각 단계별 정확한 문서를 제공합니다. Company-Building Guide는 이 전체 과정을 서술합니다.
| Phase | 이동할 곳 |
|---|
| 0 · Brainstorm | 아이디어 구상 · 플레이북 |
| 1 · Validate the idea | 아이디어 검증 · 제품 발견 · 플레이북 |
| 2 · Assess & rank | 기술 성숙도 (TRL) · 기회 점수화 · 시장 분석 |
| 3 · Business model | 비즈니스 모델 및 가격 책정 · 단위 경제학 (unit economics) |
| 4 · Build | SDLC · MVP 플레이북 · 엔지니어링 · 디자인 |
| 5 · Launch | 출시 플레이북 · 릴리스 관리 |
| 6 · Sell | 판매 방법 · 구매자 심리 · 어디서 판매할지 · GTM (Go-To-Market) |
| 7 · Raise | 피칭 · 투자자 찾기 · 자금 조달 플레이북 |
| 8 · Operate & scale | 운영 리듬 · OKR · 지속적 개선 |
핵심 Company OS를 상속받고 도메인별 차이점(delta)을 추가한 사전 구성된 회사 유형들입니다. — starter-kits/ 참고.
ai-startup · saas · developer-tools · enterprise-b2b · marketplace · consumer-app · robotics · drone · embedded · iot · research-lab · fintech · healthtech · climate-tech · gaming · edtech
| Script | 목적 |
|---|
| scripts/scaffold.py | 템플릿을 사용하여 새로운 부서 또는 에이전트의 골격(scaffold) 생성 |
| ... | |
| 세 가지 검사기(checkers)는 푸시 및 PR 발생 시 CI에서 실행됩니다 (.github/, 여기에는 이슈/PR 템플릿, 행동 강령, 보안 정책, 지원, 자금 조달, 그리고 오래된 이슈 처리 봇도 포함되어 있습니다). | |
두 개의 명확한 영역— 핸드북(handbook)/은 사람을 위해, ai/는 에이전트 워크포스(agent workforce)를 위해. 경계가 명확하기 때문에 커스터마이징이 자명합니다.모듈식이며 산업에 구애받지 않음 (Modular & industry-agnostic)— SaaS, AI, 로보틱스, 임베디드, IoT, 하드웨어, 드론, 헬스케어, 핀테크(fintech), 기후 기술(climate tech), 연구소, 개발자 도구, 소비자용, 엔터프라이즈 등 다양한 분야를 지원합니다.모든 곳에서 동일한 구조— 모든 부서는 표준 구조를 사용하고; 모든 에이전트는 표준 사양을 사용합니다. 예측 가능성은 시스템의 확장성을 높여줍니다.가정보다 증거 기반 · 제1원칙(first principles) · 장기적 가치— handbook/company/principles.md를 참조하세요.프로덕션 준비 완료, 절대 플레이스홀더 아님 (Production-ready, never placeholder)— 모든 문서는 실제로 사용되도록 작성되었습니다.
부서를 추가하려면 handbook/templates/department-template/을 복사하여 내용을 채우세요. 에이전트를 추가하려면 ai/agents/agent-template.md를 복사하세요. PR(Pull Request)을 열기 전에 python scripts/check-links.py와 python scripts/check-structure.py를 실행하세요. 전체 규칙은 CONTRIBUTING.md를 참조하세요.
이 저장소의 시초가 된 원래 단일 파일 운영 매뉴얼은 위 구조로 분해되었습니다. 그 전체 텍스트는 git 히스토리(분해 전 README.md)에 보존되어 있습니다.
Company OS는 MIT 라이선스로 배포되며, 클론하고, 커스터마이징하고, 상업적으로 사용하는 것이 자유롭습니다.