# Knowledge Conduit

Automatische Erkennung und Übertragung von Verbesserungen am KI-Tooling (Skills, Agents, Prompts, Instructions) zwischen Dev+AI-Teams.

## Trigger-Phrasen

`knowledge conduit`, `conduit`, `transfer`, `improvements übertragen`, `capabilities synchronisieren`, `kc extract`, `kc transfer`

## Konzept

Der Knowledge Conduit erkennt Verbesserungen an KI-Konfigurationsdateien über Git-History, destilliert sie in übertragbare "Insights" und schlägt konkrete Patches für andere Repos vor.

**Begriffe:**

- **Capability** – Ein Skill, Agent, Prompt(-Verbund) oder Instructions-File
- **Conduit** – Der Kanal, durch den Wissen zwischen Dev+AI-Teams fließt
- **Improvement** – Ein Git-Commit-Delta an einer Capability
- **Insight** – Destilliertes, bewertetes Improvement (bereinigt, klassifiziert, gescored)
- **Transfer** – Konkreter Änderungsvorschlag für ein Ziel-Repo

## Pipeline

| Phase           | Tool                    | Input → Output                                  |
| --------------- | ----------------------- | ----------------------------------------------- |
| 1. Extraction   | `kc-extract.py`         | Git-History → `raw-improvements.md`             |
| 2. Distillation | `kc-distill.prompt.md`  | `raw-improvements.md` → `distilled-insights.md` |
| 3. Transfer     | `kc-transfer.prompt.md` | `distilled-insights.md` + Ziel-Repo → Patches   |

## Usage

```
/knowledge-conduit
```

Der Router-Prompt fragt nach Quell-Repo und Zeitspanne, dann orchestriert er alle 3 Phasen.

## Dateien

| Datei                         | Ort                                 | Zweck                                        |
| ----------------------------- | ----------------------------------- | -------------------------------------------- |
| `SKILL.md`                    | `.github/skills/knowledge-conduit/` | Diese Dokumentation                          |
| `kc-extract.py`               | `.github/skills/knowledge-conduit/` | Phase 1: Git-Scanning + Capability-Erkennung |
| `knowledge-conduit.prompt.md` | `.github/prompts/`                  | Orchestrator (Router für alle 3 Phasen)      |
| `kc-distill.prompt.md`        | `.github/prompts/`                  | Phase 2: Klassifizierung + Scoring           |
| `kc-transfer.prompt.md`       | `.github/prompts/`                  | Phase 3: Transfer-Vorschläge für Ziel        |
| `Concept.md`                  | `.github/knowledge-conduit/`        | Vollständiges Konzept-Dokument               |

## Capability-Erkennung

Pfade werden automatisch zu Capability-Keys aufgelöst:

```
.github/skills/forgejo-tickets/SKILL.md      → skill/forgejo-tickets
.github/agents/code-reviewer.agent.md   → agent/code-reviewer
.github/prompts/nextstep.prompt.md       → prompt/nextstep  (inkl. Sub-Prompts)
.github/copilot-instructions.md          → instructions/copilot-instructions
```

## Scope

Folgende Pfade bilden die KI-Tooling-Landschaft:

- `.github/skills/**`
- `.github/agents/**`
- `.github/prompts/**`
- `.github/copilot-instructions.md`
- `.github/*.instructions.md`