공개 문서
LAB README
아래는 learn/lab/README.md 와 동일한 원문입니다. Markdown과 HTML 변환 결과를 각각 복사할 수 있습니다.
공개 문서 원문 (Markdown)
# Learning Hub Source Pack
2019 iMac LAB에서 진행한 Cursor/MultiAgentSystem Phase 10–26 기록(`multi-agent-system/runs/`)을 **SaaS-Engine Learning Hub**로 가져갈 수 있도록 정리한 Markdown Source Pack이다.
> **Hub 학습 본문 SSOT** (바이브코더·초급 개발자 · 기술 용어 적극): [`../docs/learn/`](../docs/learn/)
> 본 Pack = **LAB historical provenance** (run-001~017). 본문 대체가 아니라 `source-map.json` 링크용.
## 목적
- run-001 ~ run-017 Phase 이력을 학습·재사용 가능한 형태로 요약
- 주제별(topic) 재분류로 Hub 온보딩·타임라인 구성 지원
- 원본 provenance를 `source-map.json`으로 추적
## 작업 경로 (2020)
`<local-path>/server/Desktop/MultiAgentSystem`
## 파일 구성
| 파일 | 용도 |
|---|---|
| [README.md](README.md) | 본 안내 (시작점) |
| [phase-index.md](phase-index.md) | Phase 10→26 순서 요약 목록 |
| [topic-map.md](topic-map.md) | 학습 주제별 재분류 (7 topics) |
| [source-map.json](source-map.json) | 정리 항목 ↔ 원본 파일 상대경로 매핑 |
| [import-readiness-report.md](import-readiness-report.md) | Hub import 전 준비 상태·민감정보·누락·다음 작업 |
## 권장 읽기 순서
1. README.md (본 문서)
2. phase-index.md — 전체 Phase 타임라인 파악
3. topic-map.md — 학습 목적별 탐색
4. source-map.json — 원본 artifact 추적 (import 스크립트 입력)
5. import-readiness-report.md — import GO/NO-GO 판단
## 원본 보존 원칙
- **원본 위치:** `multi-agent-system/runs/` (run-001 ~ run-017)
- 본 Pack은 **읽기 전용 요약본**이며, 원본 run 폴더를 삭제·이동·덮어쓰지 않는다.
- 2019 경로(`<local-path>/2019imac/...`)는 원본 보고서에 그대로 남아 있으며, 본 Pack 문맥만 2020 경로로 정규화한다.
## 다음 import 대상
- **SaaS-Engine Learning Hub** — Contract 06 (`learning-hub-source`) 필드에 맞춰 `source_type`, `markdown_path`, `reusable_tags` 등록
- 본 MultiAgentSystem 저장소 및 SaaS-Engine 저장소는 **Phase 27에서 직접 수정하지 않음**
- live Slack/Hermes/Hub API 호출 없이 문서 import만 수행
## Pack 메타
| 항목 | 값 |
|---|---|
| pack_id | `mas-cursor-phase10-26` |
| pack_version | `1.0.0` |
| run 범위 | run-001 ~ run-017 (Phase 10 ~ 26) |
| 생성 Phase | Phase 27 |
## Git 추적
- **현재**: repo 루트 `.gitignore` → `multi-agent-system/learning-hub-sources/` **미추적** (Phase 67 hold)
- **구조 문서**: [`STRUCTURE-DESIGN.md`](../STRUCTURE-DESIGN.md) · Hub import Phase에서 `git add -f` 또는 ignore 해제 후 추적 가능
- **starter template sync**: 제외 ([`run-089`](../runs/run-089-template-sync-lab-reinit/))
공개 문서 변환 코드 (HTML)
<h1>Learning Hub Source Pack</h1>
<p>2019 iMac LAB에서 진행한 Cursor/MultiAgentSystem Phase 10–26 기록(<code>multi-agent-system/runs/</code>)을 <strong>SaaS-Engine Learning Hub</strong>로 가져갈 수 있도록 정리한 Markdown Source Pack이다.</p>
<blockquote>
<p><strong>Hub 학습 본문 SSOT</strong> (바이브코더·초급 개발자 · 기술 용어 적극): <a href="../docs/learn/"><code>../docs/learn/</code></a><br>본 Pack = <strong>LAB historical provenance</strong> (run-001~017). 본문 대체가 아니라 <code>source-map.json</code> 링크용.</p>
</blockquote>
<h2>목적</h2>
<ul>
<li>run-001 ~ run-017 Phase 이력을 학습·재사용 가능한 형태로 요약</li>
<li>주제별(topic) 재분류로 Hub 온보딩·타임라인 구성 지원</li>
<li>원본 provenance를 <code>source-map.json</code>으로 추적</li>
</ul>
<h2>작업 경로 (2020)</h2>
<p><code><local-path>/server/Desktop/MultiAgentSystem</code></p>
<h2>파일 구성</h2>
<table>
<thead>
<tr>
<th>파일</th>
<th>용도</th>
</tr>
</thead>
<tbody><tr>
<td><a href="README.md">README.md</a></td>
<td>본 안내 (시작점)</td>
</tr>
<tr>
<td><a href="phase-index.md">phase-index.md</a></td>
<td>Phase 10→26 순서 요약 목록</td>
</tr>
<tr>
<td><a href="topic-map.md">topic-map.md</a></td>
<td>학습 주제별 재분류 (7 topics)</td>
</tr>
<tr>
<td><a href="source-map.json">source-map.json</a></td>
<td>정리 항목 ↔ 원본 파일 상대경로 매핑</td>
</tr>
<tr>
<td><a href="import-readiness-report.md">import-readiness-report.md</a></td>
<td>Hub import 전 준비 상태·민감정보·누락·다음 작업</td>
</tr>
</tbody></table>
<h2>권장 읽기 순서</h2>
<ol>
<li>README.md (본 문서)</li>
<li>phase-index.md — 전체 Phase 타임라인 파악</li>
<li>topic-map.md — 학습 목적별 탐색</li>
<li>source-map.json — 원본 artifact 추적 (import 스크립트 입력)</li>
<li>import-readiness-report.md — import GO/NO-GO 판단</li>
</ol>
<h2>원본 보존 원칙</h2>
<ul>
<li><strong>원본 위치:</strong> <code>multi-agent-system/runs/</code> (run-001 ~ run-017)</li>
<li>본 Pack은 <strong>읽기 전용 요약본</strong>이며, 원본 run 폴더를 삭제·이동·덮어쓰지 않는다.</li>
<li>2019 경로(<code><local-path>/2019imac/...</code>)는 원본 보고서에 그대로 남아 있으며, 본 Pack 문맥만 2020 경로로 정규화한다.</li>
</ul>
<h2>다음 import 대상</h2>
<ul>
<li><strong>SaaS-Engine Learning Hub</strong> — Contract 06 (<code>learning-hub-source</code>) 필드에 맞춰 <code>source_type</code>, <code>markdown_path</code>, <code>reusable_tags</code> 등록</li>
<li>본 MultiAgentSystem 저장소 및 SaaS-Engine 저장소는 <strong>Phase 27에서 직접 수정하지 않음</strong></li>
<li>live Slack/Hermes/Hub API 호출 없이 문서 import만 수행</li>
</ul>
<h2>Pack 메타</h2>
<table>
<thead>
<tr>
<th>항목</th>
<th>값</th>
</tr>
</thead>
<tbody><tr>
<td>pack_id</td>
<td><code>mas-cursor-phase10-26</code></td>
</tr>
<tr>
<td>pack_version</td>
<td><code>1.0.0</code></td>
</tr>
<tr>
<td>run 범위</td>
<td>run-001 ~ run-017 (Phase 10 ~ 26)</td>
</tr>
<tr>
<td>생성 Phase</td>
<td>Phase 27</td>
</tr>
</tbody></table>
<h2>Git 추적</h2>
<ul>
<li><strong>현재</strong>: repo 루트 <code>.gitignore</code> → <code>multi-agent-system/learning-hub-sources/</code> <strong>미추적</strong> (Phase 67 hold)</li>
<li><strong>구조 문서</strong>: <a href="../STRUCTURE-DESIGN.md"><code>STRUCTURE-DESIGN.md</code></a> · Hub import Phase에서 <code>git add -f</code> 또는 ignore 해제 후 추적 가능</li>
<li><strong>starter template sync</strong>: 제외 (<a href="../runs/run-089-template-sync-lab-reinit/"><code>run-089</code></a>)</li>
</ul>