AI Control Tower 운영 허브

AI 도구, 스킬, 에이전트, 문서 워크플로우를 실제 프로젝트에 적용하기 전에 검증하는 개인 작업 공간이다. 루트의 CLAUDE.md는 에이전트 실행 지침이고, 이 README는 사람이 저장소를 빠르게 탐색하기 위한 인덱스다.

폴더 구조

경로	역할
.claude/	Claude Code용 로컬 스킬, 참조 문서, 실행 스크립트. skills-lock.json과 함께 설치된 스킬 버전을 추적한다.
.obsidian/	Obsidian으로 이 저장소를 열 때 쓰는 로컬 vault 설정. 새 로컬 상태 파일은 .gitignore 대상이다.
.omc/	OMC/mission-control 계열의 세션, 체크포인트, 프로젝트 상태 파일. 지속 문서의 원본이 아니라 도구 상태에 가깝다.
agent/	재사용 가능한 에이전트 정의. 현재 atlas.md가 저장소 맥락 파악용 에이전트 역할을 한다.
decisions/	의사결정 기록과 Agent Arena 결과. 날짜 기반 파일명으로 남긴다.
outputs/	필요할 때 생성되는 임시 산출물 위치. 장기 원본으로 보지 않고 비어 있으면 제거한다.
presentations/	발표용 HTML 슬라이드와 발표 스크립트. assets/에는 발표 보조 자산을 둔다.
problem-finding/	반복되는 불편을 실행 가능한 문제 후보로 바꾸는 기록 공간.
project/	ai-control-tower 자체 운영 문서. 로드맵, 인벤토리, 배포 동기화, 운영 절차로 나눈다.
projects/	프로젝트별 에이전트 팀, 프로필, 메모리, 워크플로우를 관리한다.
reports/	일일 보고서나 목표 기반 결과 보고서.
requirements/	기능이나 실험의 요구사항 문서.
research/	학습, 리서치, TIL, 도메인 모델, 콘텐츠 digest 자료.
reviews/	설계나 문서에 대한 리뷰 결과.
scripts/	YouTube, 프레젠테이션, 저장소 메타데이터 작업용 유틸리티 스크립트.
shared/	여러 프로젝트 팀이 공유하는 에이전트 역할, 규칙, 템플릿, 스킬을 둔다.
sync/	팀 채널 요약, 주간 싱크 등 외부 정보 동기화 기록.
templates/	발표와 플래너 같은 재사용 템플릿.

주요 문서

파일	내용
CLAUDE.md	저장소 목적, 기본 디렉터리 설명, 발표 제작 규칙, 알려진 이슈.
project/README.md	project/ 하위 운영 문서의 분류 기준.
project/runbooks/folder-cleanup-criteria.md	폴더 유지, 통합, 아카이브, 삭제 기준.
projects/README.md	프로젝트별 에이전트 팀 구조와 shared 자산 사용 규칙.
problem-finding/README.md	문제 발견 기록 방식과 평가 기준.
shared/README.md	공통 규칙, 템플릿, 스킬의 역할과 승격 규칙.
skills-lock.json	.claude/skills/에 들어온 스킬의 source와 hash lock.

도구와 스킬

Claude Code 스킬

.claude/skills/ 아래에는 Claude Code에서 직접 호출할 수 있는 스킬들이 있다.

스킬	용도
compound	작업 중 검증된 인사이트를 구조화된 지식 베이스로 축적한다.
content-digest	YouTube, X/Twitter, 웹페이지, PDF를 quiz-first 방식으로 정리한다.
fetch-tweet	X/Twitter URL에서 트윗 원문과 작성자, 인게이지먼트 데이터를 가져온다.
history-insight	Claude Code 세션 히스토리를 추출하고 요약한다.
my-context-sync	Slack, Notion 등 여러 소스의 컨텍스트를 한 문서로 모은다.
session-analyzer	과거 Claude Code 세션이 스킬 명세대로 실행됐는지 후행 분석한다.
session-wrap	세션 종료 시 변경사항, 학습, 후속 작업을 정리한다.
team-assemble	복잡한 작업을 전문가 역할로 나누고 팀 단위 실행 흐름을 설계한다.

에이전트와 프로젝트 팀

도구	위치	용도
Atlas agent	agent/atlas.md	저장소 구조, 관련 파일, 검증 경로를 짧은 실행 브리프로 정리한다.
Project Team skill	shared/skills/project-team/SKILL.md	프로젝트별 팀 프로필과 shared 규칙을 조합해 작업을 운영한다.
Project profiles	projects/<project>/	프로젝트별 에이전트 팀, 운영 메모리, 워크플로우를 보관한다.
Shared agents	shared/agents/README.md	여러 프로젝트 팀이 공통으로 참조하는 에이전트 역할 목록.
Shared rules	shared/rules/	작업 스타일, git, 검증, 언어, 메모리 승격 같은 반복 규칙을 보관한다.
Shared templates	shared/templates/	AGENTS.md, CLAUDE.md, 아키텍처/보안/신뢰성 문서 템플릿.

스크립트

루트에 별도 package.json이나 Python 의존성 매니페스트는 없다. 필요한 런타임은 스크립트별로 준비해서 실행한다.

스크립트	사용처
scripts/extract_metadata.sh	python -m yt_dlp로 YouTube 제목, 채널, 업로드일, 길이, 영상 ID를 추출한다.
scripts/extract_transcript.sh	YouTube 자막을 JSON3 형식으로 output_dir/source/에 저장한다.
scripts/download_video.sh	YouTube 영상을 720p 이하 mp4로 output_dir/source/에 저장한다.
scripts/capture_frames.py	영상과 JSON3 자막을 받아 프레임 이미지와 segments.json을 만든다. ffmpeg가 필요하다.
scripts/generate_output.py	segments.json을 slides.md와 slides.html로 변환한다.
scripts/gen_html.py	기존 YouTube digest 데이터를 특정 HTML 문서로 변환하는 하드코딩된 레거시 스크립트다.
scripts/hub_deploy_mattermost.py	Hub front/server 감시 브랜치의 새 커밋을 Mattermost 배포 알림으로 보낸다.
scripts/pptx_to_html.py	PPTX를 레이아웃 보존 HTML로 변환한다. python-pptx가 필요하다.
scripts/update_repos.sh	GitHub CLI로 kingkingburger/* 저장소 description과 topics를 일괄 업데이트한다.

자주 쓰는 흐름

YouTube 슬라이드 추출

scripts/extract_metadata.sh "<YouTube URL>"
scripts/extract_transcript.sh "<YouTube URL>" "<output_dir>"
scripts/download_video.sh "<YouTube URL>" "<output_dir>"
python scripts/capture_frames.py "<video.mp4>" "<subtitle.json3>" "<output_dir>" --min-interval 3
python scripts/generate_output.py "<output_dir>" --title "<title>" --url "<url>" --channel "<channel>" --date "<date>" --duration "<duration>"

결과는 보통 <output_dir>/images/, <output_dir>/segments.json, <output_dir>/slides.md, <output_dir>/slides.html로 나뉜다.

발표 HTML 작성

templates/slide-deck.html을 기반으로 presentations/에 날짜 기반 HTML 파일을 만든다. 발표 원고가 필요하면 같은 날짜와 제목으로 *-speaker-script.md 또는 *-script.md를 둔다.

프로젝트 팀 작업

프로젝트별 맥락은 projects/<project>/에서 관리한다. 여러 프로젝트에 반복되는 에이전트 규칙, 템플릿, 스킬만 shared/로 올리고, 대상 저장소에 남길 내용은 해당 프로젝트의 AGENTS.md나 docs에 맞게 별도로 승격한다.

기록 규칙

• 날짜가 중요한 문서는 YYYY-MM-DD-주제.md 형식을 우선 사용한다.
• README나 history 항목은 나중에 읽는 사람이 맥락을 이해하도록 짧은 배경과 구체적 변경만 남긴다.
• 터미널 조사 과정, 일회성 디버깅 로그, 도구의 임시 상태는 장기 문서에 그대로 옮기지 않는다.
• 새로 생성되는 대용량 미디어, 빌드 산출물, 로컬 도구 상태는 .gitignore에 맞춰 저장소 원본과 분리한다.