---
title: "Hansbridge AI Hub 전환 설계서"
category: "playbook"
document_type: "roadmap"
source_status: "generated"
knowledge_group: "01_rules"
priority: "High"
purpose: "달록KB 이후 FactoPin 및 차기 프로젝트에서 중앙 AI 운영 허브 구조로 전환하기 위한 미래 작업 가이드. 달록KB v1은 복사 대상이 아니라 발전 기준점."
read_when: ["문서이전·KnowledgeBase","컨텍스트복구","운영규칙·프롬프트작성"]
updated: "2026-06-04"
source_of_truth: "https://dallog-tools.hansbridge.co.kr/"
---

# Hansbridge AI Hub 전환 설계서

## 0. 이 문서의 목적

이 문서는 즉시 실행할 작업 지시서가 아니다.

달록(PaceLog) 종료 이후 FactoPin 또는 신규 프로젝트 재개 시점에, 사용자와 AI Agent가 참고할 **미래 전환 가이드**이다.

달록KB 구축 과정에서 만들어진 AI 협업 시스템을 프로젝트 단위 구조에서 한스브릿지 전체 운영 구조로 확장하기 위한 기준 문서이다.

---

## 1. 현재 상태 (달록KB v1)

달록 프로젝트에서는 다음 구조를 구축했다.

**서비스 레포** — `D:\dallog\dallog_git\`
- 달록 서비스 개발 / 기능 구현 / 버그 수정 / 서비스 코드 관리

**운영 레포** — `D:\hansbridge-tools\dallog-tools\`
- 달록KB 관리 / AI 컨텍스트 복구 / 프롬프트 생성기 / 문서 관리

이 구조는 성공적으로 동작했다.

검증
- Claude.ai 컨텍스트 복구 성공
- GPT/Claude/Code/Codex 공유 가능 구조 확보
- Notion 의존 제거
- Source of Truth 자체 보유

---

## 2. 발견된 개선점

달록에서는 개발 중간에 KB 시스템이 탄생했기 때문에 `dallog` + `dallog-tools` 형태가 되었다.

하지만 FactoPin 이후 모든 프로젝트마다 `project-A` + `project-A-tools`를 계속 만드는 것은 장기적으로 비효율 가능성이 있다.

따라서 다음 단계에서는 **중앙 운영 허브**를 검토한다.

---

## 3. 목표 구조 후보 — Hansbridge AI Hub

예상 구조

```
hansbridge-ai-hub/
├── knowledge/
│   ├── dallog/
│   ├── factopin/
│   └── future-projects/
├── prompts/
│   ├── claude-code/
│   ├── codex/
│   └── general-llm/
├── playbooks/
│   ├── ai-collaboration-blueprint
│   ├── git-migration-guide
│   └── project-start-guide
└── tools/
```

역할: 한스브릿지 전체 AI 운영센터.

---

## 4. 프로젝트별 역할 구조

**각 서비스 레포** (예: `factopin/`)
- 실제 서비스 코드 / 기능 개발 / 배포 / DB / API

**Hansbridge AI Hub**
- 기록 / 작업보고 / 핸드오프 / 운영 규칙 / AI 기억 복구 / 프롬프트 관리

---

## 5. FactoPin 시작 시 검토할 작업

FactoPin 재개 시
1. GitHub 레포 생성
2. 기존 ZIP/Cloudflare 기반 작업물을 Git 관리 환경으로 이전
3. Claude Code / Codex workspace 연결
4. CLAUDE.md 작성
5. AI Agent 역할 정의
6. Hansbridge AI Hub 구축 여부 결정
7. FactoPin KB 생성

---

## 6. 미래 담당 AI Agent에게 전달할 프롬프트

아래 내용을 먼저 읽고 작업하라.

### AI Agent 초기 지시

현재 당신은 Hansbridge 신규 프로젝트 운영 구조 설계를 담당한다. 먼저 아래 전제를 이해한다.

과거 달록(PaceLog) 프로젝트에서는 AI 협업 개발 / Git 전환 / Claude Code 운영 / Knowledge Base 구축 / LLM Context Recovery 시스템을 구축했다. 그 결과물이 달록KB이다.

참고: https://dallog-tools.hansbridge.co.kr/

먼저
1. AI 협업 청사진
2. 달록KB 관리설명서
3. Hansbridge AI Hub 전환 설계서

를 읽고 현재 프로젝트에 맞는 구조를 제안하라.

**주의 — 달록 구조를 그대로 복사하지 말 것.** 달록은 최초 구축 사례이고, 현재 프로젝트는 개선된 2세대 구조를 설계하는 것이 목적이다.

필요하다면 레포 구조 변경 / KB 구조 변경 / AI Agent 업무분장 변경을 사용자에게 제안할 수 있다.

단, 기존 달록에서 검증된 원칙은 유지한다.
- Source of Truth 유지
- AI 컨텍스트 복구 가능성
- 작업 기록 보존
- 역할 분리

---

## 7. 최종 원칙

달록KB는 완성형이 아니라 **첫 번째 성공 사례**이다.

FactoPin 이후 시스템은 달록을 복사하는 것이 아니라, 달록에서 배운 내용을 기반으로 발전시킨다.

새로운 프로젝트 담당 AI가 더 좋은 구조를 제안할 경우, 그 시점의 구조가 새로운 Hansbridge 표준이 될 수 있다.

---

## 8. 달록KB v1 과도기 운영 참고사항

달록 프로젝트는 Hansbridge AI Hub 탄생 **이전의 최초 레퍼런스 프로젝트**이다. 따라서 일부 운영 규칙은 달록 전용 보완책이다.

대표 — **문서명 timestamp 강제 규칙** (`YYYYMMDD_HHMMSS_문서명.md`)

발생 이유
- 서비스 레포(`dallog_git`)와 KB 관리 레포(`dallog-tools`)가 분리되어 있다.
- 작업 기록 생성 시점과 KB 반영 시점이 달라질 수 있다(작업보고·핸드오프가 일정 기간 쌓인 뒤 일괄 등록될 수 있음).
- 따라서 **파일명 timestamp로 원래 발생 순서를 복원**할 수 있어야 한다. 업로드 시간이 아니라 문서명 timestamp가 기록 순서의 기준이다.

향후 Hansbridge AI Hub 적용 프로젝트에서는 더 발전된 기록 관리 체계를 적용할 수 있으며, 그 시점의 최신 Hub 운영 규칙을 우선한다.

**기록 파이프라인 (달록 v1)** — Hub 구축 이전 달록 프로젝트에서는 **본레포 `docs/kb-pending` → 툴레포 KB 편입** 방식으로 운영한다. 본레포CC는 KB 반영 예정 문서를 `D:\dallog\dallog_git\docs\kb-pending\` 에 `YYYYMMDD_HHMMSS_문서명.md`로 저장하고, 툴레포CC가 문서명 timestamp 순서로 편입한다. Hub 구축 후에는 이 수동 파이프라인이 자동 파이프라인으로 대체될 수 있다.

> **즉 달록 방식은 복사 대상이 아니라 발전 기준점이다.**

---

*본 문서는 달록KB v1 이후의 한스브릿지 중앙 AI 운영 허브 전환을 위한 미래 설계 기준이다. FactoPin·신규 프로젝트 시작 시 「START_HERE → AI 협업 청사진 → 본 문서」 순서로 읽는다.*