들어 있는 기능

공개 저장소에 들어 있는 기능을 묶음별로 적었습니다. Slack, LLM, Google 로그인 연동은 모두 선택이고, 없어도 보드와 문서, 결정, 승인은 그대로 동작합니다.

작업 관리

프로젝트: 열린 태스크와 임박한 마감, 참여자, 연결한 저장소를 프로젝트 카드로 봅니다.
태스크 보드: 프로젝트마다 칸반과 표 두 가지 보기를 쓰고 빠른 추가, 검색, 필터를 지원합니다.
대시보드: 마감, 상태 분포, 담당자별 작업량, 최근 활동을 한 화면에 모읍니다.
캘린더: 마감이 있는 태스크를 달력으로 봅니다.
리마인더: 한 번 또는 반복으로 알림을 예약하고 워커가 시간에 맞춰 보냅니다.
받은편지함: 나에게 온 알림을 한곳에서 확인합니다.
활동 피드: 사람과 에이전트가 한 일을 시간순으로 남깁니다.

문서와 지식

파일 우선 문서: 본문을 DB가 아니라 데이터 디렉토리의 md 파일과 git 이력으로 남깁니다.
문서 허브: 결정, 리스크, 용어집, QA, 변경 이력, 데이터 모델, 완료 기준, 온보딩을 프로젝트별로 둡니다.
위키 링크: 문서끼리 위키 링크로 잇고 어디서 참조하는지 백링크로 보여 줍니다.
지식 그래프: 문서 사이의 연결을 그래프로 봅니다.
문서 점검: 깨진 링크와 어디에도 연결되지 않은 문서를 찾아 줍니다.
검색과 질문: 전체 검색을 지원하고, 문서와 결정 본문에서 근거를 찾아 질문에 답합니다.
웹 클리퍼: 웹 페이지 내용을 요약하고 분류해 문서로 저장합니다.
보관과 이동: 휴지통에서 복원할 수 있고 가져오기와 내보내기를 지원합니다.

에이전트 협업

MCP 서버: 태스크, 문서, 레슨, 결정, 제안, 검색, 퍼블리시를 다루는 도구 23개를 제공합니다.
CLI: pnpm ws 명령으로 프로젝트, 태스크, 문서, 결정, 레슨을 API 위에서 조작합니다.
Claude Code 훅: 세션 시작 때 팀 컨텍스트를 넣고, 세션을 기록하고, 저장소에 문서 파일을 쓰려는 시도를 막습니다.
토큰과 페어링: 에이전트 토큰을 발급하고, 새 머신은 페어링 코드를 승인받아 연결합니다.
레슨: 전체, 프로젝트, 스택, 개인 범위로 규칙을 적어 두면 범위에 맞는 세션에 넣어 주고 매주 정리 제안을 만듭니다.
제안: 에이전트가 결정이나 변경을 제안으로 올리고 사람이 받아들일지 정합니다.
라이브 세션과 잠금: 지금 돌고 있는 에이전트 세션을 보여 주고, 푸시와 배포가 겹치지 않게 이름으로 잠급니다.
스킬 레지스트리: 지정한 폴더를 훑어 설치된 스킬을 목록으로 보여 줍니다.
AI 실행 경로: LLM 호출이 어느 경로로 나갔는지 기록을 보여 줍니다.

승인과 알림

승인 인박스: 에이전트와 팀원이 올린 결정을 버튼으로 승인, 거부, 추가 요청합니다.
Slack 승인 카드: Slack 연동을 켜면 같은 승인을 채널의 버튼 카드로 처리합니다.
알림 규칙: 어떤 이벤트를 어느 채널로 보낼지 프로젝트별로 정합니다.
주간 다이제스트: 프로젝트에서 한 주 동안 일어난 일을 묶어 워커가 보냅니다.

운영

env 금고: 프로젝트와 환경별 env 값을 AES-256-GCM으로 보관하고, 사람이 승인하면 .env, AWS SSM, Vercel, GitHub Actions에 반영합니다.
백업: Postgres 덤프와 데이터 디렉토리를 묶어 저장하고 최근 14개만 남깁니다.
복원 리허설: 백업을 임시 DB에 복원해 일곱 가지를 점검하고, 분기마다 하라고 알립니다.
상태 점검: /api/health 가 DB와 워커 상태를 알려 주고, 실패하면 점검 스크립트가 서비스를 다시 띄웁니다.
한 줄 설치: 새 머신에서 스크립트 한 줄로 페어링, 토큰, 훅 설치까지 마칩니다.
HTML 퍼블리시: HTML 페이지를 올려 초대한 사람만 보는 주소로 공유합니다.
로그: 운영 로그는 한 줄 JSON이고 모든 API 응답에 요청 id가 붙습니다.
권한: 읽기, 쓰기, 관리 세 역할로 나누고 요청 빈도 제한이 기본으로 켜져 있습니다.

배포 방식

로컬·사내 서버: Postgres는 docker compose로 띄우고 앱은 빌드한 뒤 실행합니다.
홈서버: macOS에서 명령 하나로 웹, 워커, 백업, 상태 점검을 launchd 서비스로 설치하고 Tailscale로 HTTPS를 엽니다.
AWS EC2: Ubuntu에서 Postgres는 compose로, 앱은 systemd 서비스로 상시 실행합니다.

승인 루프

방향이 갈리는 결정이 나오면 에이전트가 Slack으로 승인과 거부 버튼이 달린 카드를 보냅니다. 에이전트는 답을 확인한 뒤에 다음 작업으로 넘어갑니다. 자리를 비워도 결정은 사람이 내립니다.

세션 컨텍스트 주입

세션을 시작할 때는 훅이 팀에서 얻은 교훈과 확정한 결정, 프로젝트 상태를 에이전트에게 넣어 줍니다. 지난 작업에서 배운 것이 다음 세션으로 이어집니다.

에이전트가 접근하는
세 가지 길

에이전트는 MCP 서버, CLI, Claude Code 훅 세 경로로 보드와 문서, 결정, 승인에 접근합니다. CLI와 API, MCP가 서로 어긋나지 않는지는 테스트가 확인합니다. 자동화 테스트는 1,500개가 넘습니다.

일하는 약속도 도구로 옮겼습니다. 문서는 문서 API로만 저장하고, 저장소에 문서 파일을 따로 만들려고 하면 훅이 막습니다. 리뷰에서 찾은 문제는 보드에 자동으로 올라갑니다.

공개 저장소 동기화

작업용 저장소에서 공개 저장소로 옮길 때 쓰는 동기화 도구도 직접 만들었습니다. 공개하면 안 되는 내부 정보를 지우는 단계와, 다른 환경에서도 돌아가도록 해 둔 부분이 되돌아가지 않았는지 보는 검사가 들어 있습니다.

쓴 기술

웹: Next.js, TypeScript
데이터: Prisma, PostgreSQL
연동: Slack API(승인 카드, 알림), NextAuth
에이전트: MCP 서버, CLI, Claude Code 훅

사람과 AI 에이전트가
같이 쓰는 작업 공간, TeamSpace

한곳에 두는 것

들어 있는 기능

작업 관리

문서와 지식

에이전트 협업

승인과 알림

운영

배포 방식

승인 루프

세션 컨텍스트 주입

에이전트가 접근하는
세 가지 길

공개 저장소 동기화

쓴 기술

비슷한 서비스를 만들고 싶다면

한곳에 두는 것

들어 있는 기능

작업 관리

문서와 지식

에이전트 협업

승인과 알림

운영

배포 방식

승인 루프

세션 컨텍스트 주입

에이전트가 접근하는세 가지 길

공개 저장소 동기화

쓴 기술

비슷한 서비스를 만들고 싶다면

에이전트가 접근하는
세 가지 길