markfulton/ai-employees

Open source AI Employees. 8 scheduled business roles, 60 routines, on Claude Code and 10 other harnesses. They drive your browser the way you do and improve every run. You own the files.

📚 빠른 개요

ai‑employees 는 소규모 기업의 정규직 직원처럼 작동하는 즉시 실행 가능한 AI 에이전트 세트를 제공합니다. 각 '직원'은 다음을 정의하는 일반 텍스트 파일 폴더입니다:

역할 (예: GTM 엔지니어, SEO, 웹 개발, 소셜 미디어, 광고 관리자, 영업, 고객 만족도, 참모장).
7~8개의 반복 루틴 일정 (아침 브리핑, 초안 작성, 데이터 수집 등).
가드레일: 사용자의 명시적인 클릭 없이 에이전트가 비가역적인 작업을 수행하지 못하도록 방지합니다.

이 저장소는 키트(폴더 구조 및 샘플 프롬프트)와 작은 Node 기반 설치 프로그램(npx ai-employees hire …)을 제공합니다. 설치 후, 직원은 이미 사용 중인 AI 코딩 어시스턴트(Claude Code 또는 호환되는 12개 에이전트)에서 실행되어, 사용자처럼 브라우저와 PC를 조작하고 간결한 아침 브리핑을 전달합니다.

🛠️ 작동 방식

설치 – 웹 기반 'Agent Ops Club' 마법사를 통하거나, 수동으로 npx ai-employees hire <role> --to <folder>를 실행합니다.
에이전트 실행 – 선택한 AI 에이전트가 INSTALL‑PROMPT.md를 읽고, 웹사이트에서 정보를 수집하며, 대시보드를 구축하고, PC에 직원 일정을 등록합니다.
정기 루틴 – SCHEDULE.md에 나열된 시간에 에이전트가 루틴을 실행합니다(예: SEO 기사 생성, 소셜 게시물 초안 작성, 광고 성과 확인). 결과는 일반 텍스트 파일로 저장되며, 게시, 전송, 지출 단계는 수동 승인을 위해 보류됩니다.
아침 브리핑 – 매일 직원은 수행한 작업, 주의가 필요한 사항, 장애 요인을 요약한 짧은 Markdown 요약을 게시합니다.
반복적 개선 – 후속 실행 시 에이전트는 이전에 다룬 페이지나 데이터를 재평가하고 자신의 지침을 자동으로 업데이트합니다.

모든 로직은 로컬에서 실행됩니다. 외부 호출은 로그인된 AI 모델(Claude Pro/Max 등)에 대한 액세스뿐입니다. 자격 증명은 저장되지 않으며, 백그라운드 서비스도 설치되지 않습니다. 업그레이드(npx ai‑employees upgrade)는 사용자 지정 편집 내용을 덮어쓰지 않고 새 키트 파일을 병합합니다.

🚀 제공되는 것

직원	핵심 결과물	정기 루틴 수
GTM 엔지니어	런칭 포지셔닝, 아웃바운드 초안, 보도 자료 형식, 주간 스코어보드	8
SEO/AEO	키워드 조사, 일일 기사 초안, 게시, 인덱싱, 순위 검토	8
웹 개발	사이트 상태 점검, 오류 분류, 작은 코드 변경, 종속성 검토	8
소셜 미디어	각 플랫폼별 게시물 초안, 거부 창, 답글 초안	7
광고 관리자	계정 읽기, 크리에이티브 세트, 예산 변경 목록(승인 필요)	7
영업	잠재 고객 스캔, 첫 접촉 초안, 후속 조치 시퀀스	7
고객 만족도	받은 편지함 스캔, 우선순위별 답글, 이탈 경고	8
참모장	다른 직원의 로그 읽기, 정체된 작업 표면화, 다음 3가지 조치 제안	7

60개의 모든 루틴은 employees/ 디렉토리에 상세 문서와 출력 예시와 함께 기록되어 있습니다.

💰 비용

에이전트 자체는 무료(MIT 라이선스)입니다. 실행 시 기존 Claude 구독 사용량만 소비됩니다(GTM 엔지니어의 일일 작업 시 Claude Max 시트의 약 6%). 추가 API 키나 유료 서비스는 필요하지 않습니다.

🤝 커뮤니티 및 지원

Agent Ops Club – 무료 멤버십을 통해 워크스루, 라이브 세션, 프리미엄 소프트웨어 라이브러리에 액세스할 수 있습니다.
GitHub – 이슈, 토론, 새로운 루틴 아이디어를 위한 CONTRIBUTING 가이드.
가드레일 및 보안 – 상세 문서(GUARDRAILS.md, SECURITY.md)에서 에이전트가 할 수 있는 작업과 할 수 없는 작업을 설명합니다.

📦 시작하기 (한 줄 명령)

npx ai-employees hire gtm-engineer --to ./my‑gtm‑engineer
# 그 후, Claude Code(또는 지원되는 에이전트)에서 다음을 입력:
"Install the GTM Engineer from this folder."

설치 프로그램이 키트를 복사하고, 자체 테스트를 실행하며, 새 에이전트 세션에 붙여넣을 정확한 프롬프트를 알려줍니다.

📝 요약

ai‑employees 는 기존 AI 대규모 언어 모델 어시스턴트를 사용하여 자신의 PC에서 자율적이고 일정 기반의 AI '직원'을 실행할 수 있는 진정한 오픈 소스 프로젝트입니다. 실용적인 비즈니스 자동화에 중점을 두고 있으며, 강력한 안전 가드레일과 명확하고 낮은 진입 장벽의 설치 경로를 갖추고 있습니다.