오픈소스 · 텔레그램 방 = 지휘소 · 실행은 내 PC에서

텔레그램 방이 곧
AI 작업팀의 지휘소가 된다

사람은 평소처럼 방에서 말한다. LeaderBot이 요청을 작업 제안으로 정리하고, 방장이 승인하면 CodexBot·ClaudeBot이 작업 PC의 프로젝트 폴더에서 실행하고, AuditBot이 작업자와 다른 엔진으로 결과를 독립 검증한다. 요청 → 제안 → 승인 → 실행 → 보고 → 검증까지 한 방 안에서.

필요한 것 — Windows PC 1대, Node.js, Supabase·Telegram·Vercel 계정(무료 플랜), Claude Code·Codex 구독. 별도 앱 설치 없음.

LeaderBot 제안·승인·라우팅 CodexBot 실행 ClaudeBot 실행 AuditBot 독립 검증
📁 프로젝트 A · 텔레그램봇 4 · 사람 2
@leader 이번 주 작업 내역 정리해서 보고서 파일로 만들어줘
작업 제안: 주간 보고서(hwp) 작성 → ClaudeBot 배정LeaderBot
승인수정반려
완료. 보고서 파일 첨부. 감사로 넘깁니다.ClaudeBot · 4분
검증 통과 — 수치 3건 원본 대조 일치.AuditBot (Codex)
완료 승인보완 요청

Problem

AI에게 일을 시키는 화면이
또 하나 늘어나면 안 됩니다

대시보드를 새로 배우고, 봇마다 창을 따로 열고, 누가 무엇을 승인했는지 채팅 로그를 뒤지는 방식으로는 팀이 굴러가지 않습니다. 그리고 AI가 만든 것을 AI 자신이 "다 됐다"고 하면 끝나는 구조는 믿을 수 없습니다.

🪟

화면이 하나 더

이미 쓰는 텔레그램을 두고 별도 앱을 깔아야 한다. 사람도 봇도 흩어진다.

🤷

누가 승인했나

채팅에서 "해도 돼"가 곧 실행이 되면, 중복 실행·잘못된 폴더·무한 봇 대화가 생긴다.

🪞

자기 검증

만든 AI가 스스로 "완료"라고 보고한다. 다른 눈이 없다.

How it works

작업 한 건의 여정 —
요청에서 검증까지 한 방 안에서

텔레그램은 대화 화면이고, 공식 작업 상태의 기준은 중앙 DB(Supabase)입니다. 그래서 중복 메시지·중복 승인·봇 간 무한 대화·엉뚱한 폴더 실행이 막힙니다.

방에서 말한다

@leader에게 평소처럼 요청. 질문은 바로 답하고, 실제 변경·실행이 필요한 말만 작업 제안으로 정리한다.

방장이 승인한다

협업 운영센터(Mini App)에서 승인·수정·반려. 파일을 안 바꾸는 조회성 작업은 승인 없이 자동 시작.

PC에서 실행, 다른 AI가 검증

local-gateway가 허용된 폴더에서만 Claude Code·Codex·Gemini 웹을 돌리고, AuditBot이 작업자와 다른 엔진으로 결과를 검증한다. 방에는 사람이 알아야 할 것만.

HuAI 작업 흐름도 — 요청·제안·승인·실행·보고·검증 순서와 인계·승격 경로
작업 흐름도 — 방장 승인 게이트, 실행 엔진 3종 인계(한도 걸리면 다음 엔진, 최대 3회), 웹 산출물은 프리뷰 → 승인 후 프로덕션 승격.

Architecture

사람은 텔레그램만 쓰고,
실행은 작업 PC에서만 일어난다

공개되는 것은 협업 운영센터와 결과물뿐입니다. 코드·파일 작업은 작업 PC의 local-gateway가 방마다 하나씩, 허용된 프로젝트 폴더 안에서만 합니다.

HuAI 관계도 — 사람·텔레그램, 작업 PC(bot-service·local-gateway·실행 엔진 3종·디스크), 클라우드(Supabase·Vercel)
관계도 — 사람·텔레그램 / 작업 PC / 클라우드 세 열. 실선은 실행 경로, 점선은 폴링·발신.
구성 요소역할어디서
텔레그램 프로젝트방사람이 지시하고 결과·운영센터 링크를 받는 대화 UI. 주제(topic)마다 작업이 따로 흐른다.사람
LeaderBot요청 정리, 작업 제안, 승인 흐름, 역할 라우팅. 다중 AI 협의 요청도 하나의 작업으로 묶는다.봇
CodexBot · ClaudeBot실제 코드·파일 작업 실행과 결과 보고. 한 엔진이 한도에 걸리면 다른 엔진이 이어받는다(최대 3회).봇 → 작업 PC
AuditBot보안·DB 변경·배포·구현 완료·문서처럼 검증할 가치가 있는 결과물만, 작업자와 다른 엔진으로 독립 검증. 사람이 직접 감사 요청도 가능.봇
bot-service텔레그램 수신(polling, 공개 URL 불필요) · 권한 확인 · 중복 처리 · 발신. 6시간마다 방 전체 백업.작업 PC
local-gateway방마다 1개. 허용된 프로젝트 폴더와 어댑터만 실행. 웹 산출물은 Vercel 프리뷰까지 올린다.작업 PC
Supabaserooms · tasks · events · artifacts · verifications · outbox · 보고 전문 · 보관 장부 — 공식 작업 기록의 기준.클라우드
협업 운영센터 (Vercel Mini App)작업·산출물·보고 전문을 보고 승인·수정·반려, 완료 승인·보완 요청을 결정하는 화면.클라우드

Design principles

승인은 사람이, 검증은 다른 AI가, 기록은 DB가

✅

승인 게이트

파일을 만들거나 바꾸는 작업은 방장이 승인해야 시작된다. 애매하면 "필수 승인" 쪽으로. 자동 허용도 같은 권한 검사를 통과해야 실행된다.

🔁

자기 검증 금지

감사는 작업자와 다른 엔진이 맡는다. 셋 중 둘이 막혀 같은 엔진으로 감사하게 되면, 독립성이 낮다는 사실을 방에 밝힌다.

📂

폴더 격리

방마다 게이트웨이가 따로다. 한 프로젝트의 실행이 다른 프로젝트 폴더를 열 수 없다.

🧾

DB가 진실, 방은 화면

텔레그램은 지난 대화를 돌려주지 않는다. 원본 대화·보고 전문·검증 이력은 Supabase에, 방 기억은 일자별 위키로 남긴다. /trace로 언제든 추적.

Get started

방 하나, 봇 넷, PC 한 대

새 프로젝트는 텔레그램 비공개 그룹을 만들고 봇 4개를 초대한 뒤 폴더를 연결하면 끝. 같은 봇을 여러 방에서 재사용하되 방장·참여자·폴더·실행 범위는 방마다 분리됩니다. 설치는 30~50분.