Cockpit으로AI Coding Tools 허브로

공개 문서

learn/canonical/knot/README.md

아래는 learn/canonical/knot/README.md 와 동일한 원문입니다. Markdown과 HTML 변환 결과를 각각 복사할 수 있습니다.

공개 문서 원문 (Markdown)

# knot — Harness integration tools

Upstream: [netwaif/knot](https://github.com/netwaif/knot) — 벤더중립 평문 마크다운 지식 vault.

MultiAgentSystem 하네스(`tasks/`)와 **분리**되어 있으며, 장기 지식·교차링크 wiki를 담당한다.

**SkoolChef LLM Wiki (WORKSPACE 실무 vault):** `WORKSPACE_CLEAN/CLAUDE/PROJECTS/SKOOLCHEF-LLM-WIKI/` — SkoolChef ingest·Obsidian. **MAS LAB vault**는 이 `knot-wiki/`만 (`KNOT_WIKI`). 강의 raw → 각 vault `raw/inbox/` → ingest.

## LAB vault 경로 (정본)

| 항목 | 경로 |
|------|------|
| **KNOT_WIKI** | `MultiAgentSystem/knot-wiki/` (repo 루트, `.gitignore`) |
| **scaffold** | `tools/knot/scaffold/` (빈 템플릿 — `schema/raw/wiki/ops` 구조) |
| **도구** | `tools/knot/` |

## Canonical vault layout (Phase 5b+)

| 용도 | 경로 |
|------|------|
| schema 정본 | `knot-wiki/schema/schema.md` |
| index / log | `knot-wiki/schema/index.md`, `schema/log.md` |
| inbox / archive / quarantine | `raw/inbox/`, `raw/archive/`, `raw/quarantine/` |
| wiki (3문서) | `wiki/llm-wiki.md`, `knot-wiki.md`, `harness-multiagent.md` |
| prompts / scripts | `ops/prompts/`, `ops/scripts/` |
| lint / drain | `ops/scripts/lint.py`, `ops/scripts/drain.sh` |

## Quick start

```bash
cd ~/Desktop/MultiAgentSystem
source tools/knot/env.example
bash tools/knot/run-knot.sh validate

# raw/inbox/에 md 넣고:
bash tools/knot/run-knot.sh ingest
bash tools/knot/run-knot.sh query '관련 지식 요약'
```

신규 설치(빈 vault):

```bash
bash tools/knot/install-knot-wiki.sh    # → knot-wiki/
source tools/knot/env.example
```

## Obsidian (선택)

1. Obsidian → **Open folder as vault**
2. 폴더: `<local-path>/server/Desktop/MultiAgentSystem/knot-wiki`
3. Graph view로 `[[링크]]` 그래프 확인

상세: `knot-wiki/schema/OBSIDIAN.md`

## drain (inbox 일괄 ingest, 선택)

```bash
source tools/knot/env.example
bash tools/knot/run-knot.sh drain
```

macOS 무인 실행: `knot-wiki/ops/scripts/launchd.plist.template` — `__RUNNER__`는 `claude` 권장 (`run-knot.sh` 기본과 동일).

## Learn · OpenClaw 동기화 체크리스트

knot 도구·문서를 바꾼 뒤:

```bash
cd ~/Desktop/MultiAgentSystem
bash tools/knot/sync-knot-canonical-to-learn.sh   # → multi-agent-system/docs/learn/canonical/knot/
bash tools/sync-mas-learn-to-openclaw.sh          # → WORKSPACE OpenClaw content + bundled learn
```

OpenClaw 허브 TS(`multi-agent-learn-config.ts`)를 수동 수정했다면 learn md와 함께 커밋.

## Layout

| Path | Role |
|------|------|
| `knot-wiki/` | **운용 vault** (`schema/` · `raw/` · `wiki/` · `ops/`) |
| `scaffold/` | Upstream knot scaffold (tracked in MAS repo) |
| `install-knot-wiki.sh` | Copy scaffold → knot-wiki + git init |
| `run-knot.sh` | ingest / query / lint / drain / validate |
| `env.example` | `KNOT_WIKI` + `KNOT_RUNNER` |

## Harness bridge

See [`docs/KNOT-HARNESS-INTEGRATION.md`](../../docs/KNOT-HARNESS-INTEGRATION.md) · **운영 SOP:** [`docs/KNOT-WIKI-OPS-SOP.md`](../../docs/KNOT-WIKI-OPS-SOP.md).

공개 문서 변환 코드 (HTML)

<h1>knot — Harness integration tools</h1>
<p>Upstream: <a href="https://github.com/netwaif/knot">netwaif/knot</a> — 벤더중립 평문 마크다운 지식 vault.</p>
<p>MultiAgentSystem 하네스(<code>tasks/</code>)와 <strong>분리</strong>되어 있으며, 장기 지식·교차링크 wiki를 담당한다.</p>
<p><strong>SkoolChef LLM Wiki (WORKSPACE 실무 vault):</strong> <code>WORKSPACE_CLEAN/CLAUDE/PROJECTS/SKOOLCHEF-LLM-WIKI/</code> — SkoolChef ingest·Obsidian. <strong>MAS LAB vault</strong>는 이 <code>knot-wiki/</code>만 (<code>KNOT_WIKI</code>). 강의 raw → 각 vault <code>raw/inbox/</code> → ingest.</p>
<h2>LAB vault 경로 (정본)</h2>
<table>
<thead>
<tr>
<th>항목</th>
<th>경로</th>
</tr>
</thead>
<tbody><tr>
<td><strong>KNOT_WIKI</strong></td>
<td><code>MultiAgentSystem/knot-wiki/</code> (repo 루트, <code>.gitignore</code>)</td>
</tr>
<tr>
<td><strong>scaffold</strong></td>
<td><code>tools/knot/scaffold/</code> (빈 템플릿 — <code>schema/raw/wiki/ops</code> 구조)</td>
</tr>
<tr>
<td><strong>도구</strong></td>
<td><code>tools/knot/</code></td>
</tr>
</tbody></table>
<h2>Canonical vault layout (Phase 5b+)</h2>
<table>
<thead>
<tr>
<th>용도</th>
<th>경로</th>
</tr>
</thead>
<tbody><tr>
<td>schema 정본</td>
<td><code>knot-wiki/schema/schema.md</code></td>
</tr>
<tr>
<td>index / log</td>
<td><code>knot-wiki/schema/index.md</code>, <code>schema/log.md</code></td>
</tr>
<tr>
<td>inbox / archive / quarantine</td>
<td><code>raw/inbox/</code>, <code>raw/archive/</code>, <code>raw/quarantine/</code></td>
</tr>
<tr>
<td>wiki (3문서)</td>
<td><code>wiki/llm-wiki.md</code>, <code>knot-wiki.md</code>, <code>harness-multiagent.md</code></td>
</tr>
<tr>
<td>prompts / scripts</td>
<td><code>ops/prompts/</code>, <code>ops/scripts/</code></td>
</tr>
<tr>
<td>lint / drain</td>
<td><code>ops/scripts/lint.py</code>, <code>ops/scripts/drain.sh</code></td>
</tr>
</tbody></table>
<h2>Quick start</h2>
<pre><code class="language-bash">cd ~/Desktop/MultiAgentSystem
source tools/knot/env.example
bash tools/knot/run-knot.sh validate

# raw/inbox/에 md 넣고:
bash tools/knot/run-knot.sh ingest
bash tools/knot/run-knot.sh query &#39;관련 지식 요약&#39;
</code></pre>
<p>신규 설치(빈 vault):</p>
<pre><code class="language-bash">bash tools/knot/install-knot-wiki.sh    # → knot-wiki/
source tools/knot/env.example
</code></pre>
<h2>Obsidian (선택)</h2>
<ol>
<li>Obsidian → <strong>Open folder as vault</strong></li>
<li>폴더: <code>&lt;local-path&gt;/server/Desktop/MultiAgentSystem/knot-wiki</code></li>
<li>Graph view로 <code>[[링크]]</code> 그래프 확인</li>
</ol>
<p>상세: <code>knot-wiki/schema/OBSIDIAN.md</code></p>
<h2>drain (inbox 일괄 ingest, 선택)</h2>
<pre><code class="language-bash">source tools/knot/env.example
bash tools/knot/run-knot.sh drain
</code></pre>
<p>macOS 무인 실행: <code>knot-wiki/ops/scripts/launchd.plist.template</code> — <code>__RUNNER__</code>는 <code>claude</code> 권장 (<code>run-knot.sh</code> 기본과 동일).</p>
<h2>Learn · OpenClaw 동기화 체크리스트</h2>
<p>knot 도구·문서를 바꾼 뒤:</p>
<pre><code class="language-bash">cd ~/Desktop/MultiAgentSystem
bash tools/knot/sync-knot-canonical-to-learn.sh   # → multi-agent-system/docs/learn/canonical/knot/
bash tools/sync-mas-learn-to-openclaw.sh          # → WORKSPACE OpenClaw content + bundled learn
</code></pre>
<p>OpenClaw 허브 TS(<code>multi-agent-learn-config.ts</code>)를 수동 수정했다면 learn md와 함께 커밋.</p>
<h2>Layout</h2>
<table>
<thead>
<tr>
<th>Path</th>
<th>Role</th>
</tr>
</thead>
<tbody><tr>
<td><code>knot-wiki/</code></td>
<td><strong>운용 vault</strong> (<code>schema/</code> · <code>raw/</code> · <code>wiki/</code> · <code>ops/</code>)</td>
</tr>
<tr>
<td><code>scaffold/</code></td>
<td>Upstream knot scaffold (tracked in MAS repo)</td>
</tr>
<tr>
<td><code>install-knot-wiki.sh</code></td>
<td>Copy scaffold → knot-wiki + git init</td>
</tr>
<tr>
<td><code>run-knot.sh</code></td>
<td>ingest / query / lint / drain / validate</td>
</tr>
<tr>
<td><code>env.example</code></td>
<td><code>KNOT_WIKI</code> + <code>KNOT_RUNNER</code></td>
</tr>
</tbody></table>
<h2>Harness bridge</h2>
<p>See <a href="../../docs/KNOT-HARNESS-INTEGRATION.md"><code>docs/KNOT-HARNESS-INTEGRATION.md</code></a> · <strong>운영 SOP:</strong> <a href="../../docs/KNOT-WIKI-OPS-SOP.md"><code>docs/KNOT-WIKI-OPS-SOP.md</code></a>.</p>