diff --git a/.github/genome/Concept Genome Engine.md b/.github/knowledge-conduit/Concept.md similarity index 69% rename from .github/genome/Concept Genome Engine.md rename to .github/knowledge-conduit/Concept.md index 4b744ae..779cd83 100644 --- a/.github/genome/Concept Genome Engine.md +++ b/.github/knowledge-conduit/Concept.md @@ -1,15 +1,15 @@ -# Genome Engine – Konzept +# Knowledge Conduit – Konzept ## Ziel -Automatische Erkennung von Verbesserungen an KI-Tooling-Dateien (Skills, Agents, Prompts, Instructions) über Git-History hinweg. Die erkannten Improvements werden destilliert, bewertet und als Transfer-Vorschläge für andere Projekte bereitgestellt. +Automatische Erkennung von Verbesserungen an KI-Tooling-Dateien (Skills, Agents, Prompts, Instructions) über Git-History hinweg. Die erkannten Improvements werden destilliert, bewertet und als Transfer-Vorschläge für andere Dev+AI-Teams bereitgestellt. ```mermaid graph LR - A[Repo A
Verbesserungen] -->|Git-History| E[Extraction] + A[Team A
Verbesserungen] -->|Git-History| E[Extraction] E -->|raw improvements| D[Distillation] D -->|Insights| T[Transfer] - T -->|Patches| B[Repo B
aktualisiert] + T -->|Patches| B[Team B
aktualisiert] ``` --- @@ -18,7 +18,7 @@ graph LR ```mermaid graph TD - G[🧬 Genome
Gesamtheit aller Capabilities] --> T1[Capability: Skill] + G[� Knowledge Conduit
Kanal zwischen Dev+AI-Teams] --> T1[Capability: Skill] G --> T2[Capability: Agent] G --> T3[Capability: Prompt] G --> T4[Capability: Instructions] @@ -30,19 +30,19 @@ graph TD GV2 --> PR ``` -| Begriff | Bedeutung | -| ---------------- | -------------------------------------------------------------------------------------------- | -| **Capability** | Ein Skill, Agent, Prompt(-Verbund) oder Instructions-File inkl. aller zugehörigen Dateien | -| **Genome** | Die Gesamtheit aller Capabilities eines Projekts – das "KI-Wissen" eines Repos | -| **Improvement** | Ein Git-Commit-Delta an einer Capability – eine konkrete Verbesserung am KI-Tooling | -| **Insight** | Destilliertes, bewertetes Improvement (bereinigt, klassifiziert, gescored, übertragbar) | -| **Transfer** | Konkreter Änderungsvorschlag, um ein Insight auf ein Ziel-Genome anzuwenden | +| Begriff | Bedeutung | +| --------------- | ----------------------------------------------------------------------------------------- | +| **Capability** | Ein Skill, Agent, Prompt(-Verbund) oder Instructions-File inkl. aller zugehörigen Dateien | +| **Conduit** | Der Kanal, durch den Wissen zwischen Dev+AI-Teams fließt | +| **Improvement** | Ein Git-Commit-Delta an einer Capability – eine konkrete Verbesserung am KI-Tooling | +| **Insight** | Destilliertes, bewertetes Improvement (bereinigt, klassifiziert, gescored, übertragbar) | +| **Transfer** | Konkreter Änderungsvorschlag, um ein Insight auf ein Ziel-Repo anzuwenden | --- ## Scope -Folgende Pfade bilden das Genome: +Folgende Pfade bilden die KI-Tooling-Landschaft: - `.github/skills/**` - `.github/agents/**` @@ -135,11 +135,11 @@ Instructions-Dateien sind Einzeldateien. Der **Dateiname** ist der Capability-Sc ## Improvement-Typen -| Typ | Bedeutung | Beispiel | -| ---------------- | -------------------------------------------- | ----------------------------------------------------- | +| Typ | Bedeutung | Beispiel | +| ---------------- | --------------------------------------------- | ----------------------------------------------------- | | `content-change` | Inhalt einer Datei in der Capability geändert | `nextstep-implementation.prompt.md` optimiert | | `member-added` | Neue Datei zur Capability hinzugefügt | Neuer `nextstep-migration.prompt.md` + Router-Eintrag | -| `member-removed` | Datei aus der Capability entfernt | `nextstep-test.prompt.md` gelöscht | +| `member-removed` | Datei aus der Capability entfernt | `nextstep-test.prompt.md` gelöscht | --- @@ -149,7 +149,7 @@ Instructions-Dateien sind Einzeldateien. Der **Dateiname** ist der Capability-Sc flowchart LR subgraph "Phase 1: Extraction" direction TB - GIT[(Git-History)] --> SCRIPT[genome-extract.py] + GIT[(Git-History)] --> SCRIPT[kc-extract.py] SCRIPT --> RAW[raw-improvements.md] end subgraph "Phase 2: Distillation" @@ -160,7 +160,7 @@ flowchart LR subgraph "Phase 3: Transfer" direction TB DIST2[distilled-insights.md] --> AGENT2[KI-Agent] - ZIEL[Ziel-Genome] --> AGENT2 + ZIEL[Ziel-Repo] --> AGENT2 AGENT2 --> PATCHES[Konkrete Patches] end RAW --> RAW2 @@ -172,11 +172,11 @@ flowchart LR **Input:** Repo-Pfad + Zeitspanne (z.B. `--since "7 days ago"`) **Output:** `raw-improvements.md` -- Scannt `git log` für Änderungen im Genome-Scope +- Scannt `git log` für Änderungen im KI-Tooling-Scope - Gruppiert Diffs nach Capability (siehe Capability-Erkennung oben) - Gibt pro Capability alle Commits mit Diff, Message und Autor aus -**Tool:** `genome-extract.py` (Python) +**Tool:** `kc-extract.py` (Python) ### Phase 2: Distillation (Agent) @@ -201,25 +201,25 @@ flowchart TD - Filtert sensitive Daten (Usernames, Maschinenpfade, Tokens, projektspezifische IDs) - Specialized Improvements werden komplett entfernt -**Tool:** `genome-distill.prompt.md` +**Tool:** `kc-distill.prompt.md` ### Phase 3: Transfer (Agent) -**Input:** `distilled-insights.md` + Ziel-Genome +**Input:** `distilled-insights.md` + Ziel-Repo **Output:** `transfer-proposals.md` -- Matched Capabilities zwischen Quell- und Ziel-Genome +- Matched Capabilities zwischen Quell- und Ziel-Repo - Erstellt konkrete Änderungsvorschläge pro Capability - Formatiert als Checkliste mit Default-Auswahl: -| Kategorie | Default | Bedingung | -| ------------------ | ------- | ---------- | -| 🔴 Critical | ✅ an | immer | -| 🟡 Evolution ≥ 7 | ✅ an | Score ≥ 7 | -| 🟡 Evolution < 7 | ❌ aus | Score < 7 | -| ⚪ Specialized | — | gefiltert | +| Kategorie | Default | Bedingung | +| ---------------- | ------- | --------- | +| 🔴 Critical | ✅ an | immer | +| 🟡 Evolution ≥ 7 | ✅ an | Score ≥ 7 | +| 🟡 Evolution < 7 | ❌ aus | Score < 7 | +| ⚪ Specialized | — | gefiltert | -**Tool:** `genome-propagate.prompt.md` +**Tool:** `kc-transfer.prompt.md` --- @@ -245,22 +245,22 @@ sequenceDiagram ```mermaid graph TD - subgraph ".github/skills/genome/" + subgraph ".github/skills/knowledge-conduit/" SK[SKILL.md
Skill-Dokumentation] - EX[genome-extract.py
Phase 1 Script] + EX[kc-extract.py
Phase 1 Script] end subgraph ".github/prompts/" - OR[genome.prompt.md
Orchestrator] - DI[genome-distill.prompt.md
Phase 2] - PR[genome-propagate.prompt.md
Phase 3] + OR[knowledge-conduit.prompt.md
Orchestrator] + DI[kc-distill.prompt.md
Phase 2] + PR[kc-transfer.prompt.md
Phase 3] end - subgraph ".github/genome/output/" + subgraph ".github/knowledge-conduit/output/" RM[raw-improvements.md
generiert] DM[distilled-insights.md
generiert] PP[transfer-proposals.md
generiert] end - subgraph ".github/genome/" - CO[Concept Genome Engine.md
Dieses Konzept] + subgraph ".github/knowledge-conduit/" + CO[Concept.md
Dieses Konzept] end OR -->|"ruft auf"| EX OR -->|"delegiert an"| DI @@ -272,17 +272,17 @@ graph TD PR -->|"schreibt"| PP ``` -| # | Datei | Typ | Ort | -| --- | ---------------------------- | ------------- | -------------------------- | -| 1 | `genome-extract.py` | Python Script | `.github/skills/genome/` | -| 2 | `genome.prompt.md` | Orchestrator | `.github/prompts/` | -| 3 | `genome-distill.prompt.md` | Prompt | `.github/prompts/` | -| 4 | `genome-propagate.prompt.md` | Prompt | `.github/prompts/` | -| 5 | `SKILL.md` | Skill-Doku | `.github/skills/genome/` | -| 6 | `genome-engine.md` | Konzept | `docs/` | -| 7 | `raw-improvements.md` | Generiert | `.github/genome/output/` | -| 8 | `distilled-insights.md` | Generiert | `.github/genome/output/` | -| 9 | `transfer-proposals.md` | Generiert | `.github/genome/output/` | +| # | Datei | Typ | Ort | +| --- | ------------------------------ | ------------- | ---------------------------------- | +| 1 | `kc-extract.py` | Python Script | `.github/skills/knowledge-conduit/` | +| 2 | `knowledge-conduit.prompt.md` | Orchestrator | `.github/prompts/` | +| 3 | `kc-distill.prompt.md` | Prompt | `.github/prompts/` | +| 4 | `kc-transfer.prompt.md` | Prompt | `.github/prompts/` | +| 5 | `SKILL.md` | Skill-Doku | `.github/skills/knowledge-conduit/` | +| 6 | `Concept.md` | Konzept | `.github/knowledge-conduit/` | +| 7 | `raw-improvements.md` | Generiert | `.github/knowledge-conduit/output/` | +| 8 | `distilled-insights.md` | Generiert | `.github/knowledge-conduit/output/` | +| 9 | `transfer-proposals.md` | Generiert | `.github/knowledge-conduit/output/` | > Generierte Dateien (7–9) sind gitignored. @@ -290,7 +290,7 @@ graph TD ## Zukünftige Erweiterungen -- Multi-Repo-Registry: Zentrale Sammlung von Insights aus vielen Projekten +- Multi-Repo-Registry: Zentrale Sammlung von Insights aus vielen Dev+AI-Teams - Automatische Erkennung des Transfer-Zeitraums über Repo-Vergleich - CI-Integration: Transfer-Check bei jedem Push - Community-Sharing: Öffentliche Insights als "Capability Packages" diff --git a/.github/genome/output/.gitkeep b/.github/knowledge-conduit/output/.gitkeep similarity index 81% rename from .github/genome/output/.gitkeep rename to .github/knowledge-conduit/output/.gitkeep index 6be3263..65505a7 100644 --- a/.github/genome/output/.gitkeep +++ b/.github/knowledge-conduit/output/.gitkeep @@ -1,4 +1,4 @@ -# Genome Engine Output +# Knowledge Conduit Output Generierte Dateien (nicht committen): diff --git a/.github/prompts/genome-distill.prompt.md b/.github/prompts/kc-distill.prompt.md similarity index 91% rename from .github/prompts/genome-distill.prompt.md rename to .github/prompts/kc-distill.prompt.md index 3f1f2ef..0bd2354 100644 --- a/.github/prompts/genome-distill.prompt.md +++ b/.github/prompts/kc-distill.prompt.md @@ -1,16 +1,16 @@ --- -description: "Genome Engine Phase 2: Destilliert raw-improvements.md – klassifiziert, scored und bereinigt Improvements für Cross-Repo-Transfer." +description: "Knowledge Conduit Phase 2: Destilliert raw-improvements.md – klassifiziert, scored und bereinigt Improvements für Cross-Team-Transfer." model: Claude Opus 4.6 (copilot) tools: [read, edit] --- -# Genome Distillation +# Knowledge Conduit – Distillation Du erhältst eine Datei mit rohen Git-Improvements aus KI-Tooling-Dateien. Deine Aufgabe: **klassifizieren, scoren, bereinigen** – damit nur übertragbare Verbesserungen übrig bleiben. ## Input -Lies die Datei `.github/genome/output/raw-improvements.md`. +Lies die Datei `.github/knowledge-conduit/output/raw-improvements.md`. ## Aufgabe @@ -18,10 +18,10 @@ Für **jede Capability** und jedes Improvement darin: ### 1. Klassifizierung -| Klasse | Bedeutung | Beispiele | -| ------------------ | ---------------------------------------------- | --------------------------------------------------------------- | -| 🔴 **Critical** | Bugfixes, die andere Repos auch treffen würden | Fehlende Escapes, falsche Tool-Syntax, Security-Lücke in Prompt | -| 🟡 **Evolution** | Generelle Verbesserungen, übertragbar | Bessere Formulierung, neues Pattern, strukturelle Optimierung | +| Klasse | Bedeutung | Beispiele | +| ------------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | +| 🔴 **Critical** | Bugfixes, die andere Repos auch treffen würden | Fehlende Escapes, falsche Tool-Syntax, Security-Lücke in Prompt | +| 🟡 **Evolution** | Generelle Verbesserungen, übertragbar | Bessere Formulierung, neues Pattern, strukturelle Optimierung | | ⚪ **Specialized** | Projektspezifisch, NICHT übertragbar | Deployment auf einen konkreten Server (IP/Domain), projektspezifische DB-Seeding-Daten, App-spezifische Package-Namen ohne generelles Pattern | ### 2. Scoring (1–10) @@ -50,12 +50,14 @@ Ersetze in den Diffs: > **Specialized** = betrifft NUR dieses eine Projekt und ist nach Sanitization NICHT auf ein anderes Repo übertragbar. **Specialized (entfernen):** + - Deployment-Skripte die eine konkrete Server-IP/Domain ansprechen (SCP auf den Island-VPS) - Projekt-Renames (`krisenvorrat` → `bollwerk`) ohne inhaltliche Verbesserung - Seeding-Daten, Issue-Body-Templates für ein konkretes Feature dieses Projekts - Docker-Compose-Anpassungen für einen konkreten Server **NICHT Specialized (behalten als Evolution):** + - Technologie-Handling: Gradle-Build-Patterns, Room-Migration-Checklisten, Emulator-GPU-Workarounds - Workflow-Patterns: Ticket-Orchestrierung, Sub-Agent-Isolation, Board-Status-Automatisierung - Tooling-Bugfixes: PowerShell-Binary-Encoding umgehen, ADB-Timeout-Loops, Force-Kill-Fallbacks @@ -73,6 +75,7 @@ Ersetze in den Diffs: ### Fehler 1: `member-added` pauschal als Specialized verwerfen Neue Dateien (`member-added`) sind oft die **wertvollsten** Improvements. Ein neuer Skill, Prompt oder Agent ist nach Sanitization häufig hochgradig übertragbar. Prüfe: + - Enthält die Datei ein **allgemeines Pattern** (z.B. Checkliste, Workflow-Struktur, Fehlerklassen-Katalog)? - Ist sie nach Pfad-/Namen-Sanitization auf andere Projekte anwendbar? - → Wenn ja: **Evolution** (Score 7–9), nicht Specialized. @@ -86,6 +89,7 @@ Die raw-improvements-Datei kann **tausende Zeilen** lang sein. Skills, Scripts u ### Fehler 3: Mehrteilige Commits nicht trennen Ein einzelner Commit kann enthalten: + - 3× Specialized (Rename `krisenvorrat`→`bollwerk` in 3 Dateien) - 1× Evolution (GPU-Hardening-Pattern mit Timeout-Loop) - 1× Evolution (Hot-Reload-Action als neues Pattern) @@ -125,7 +129,7 @@ Gehe für jeden Commit wie folgt vor: ## Output-Format -Schreibe das Ergebnis in `.github/genome/output/distilled-insights.md` mit folgendem Format: +Schreibe das Ergebnis in `.github/knowledge-conduit/output/distilled-insights.md` mit folgendem Format: ````markdown # Distilled Insights diff --git a/.github/prompts/genome-propagate.prompt.md b/.github/prompts/kc-transfer.prompt.md similarity index 81% rename from .github/prompts/genome-propagate.prompt.md rename to .github/prompts/kc-transfer.prompt.md index 0b45c6e..7076bb8 100644 --- a/.github/prompts/genome-propagate.prompt.md +++ b/.github/prompts/kc-transfer.prompt.md @@ -1,17 +1,17 @@ --- -description: "Genome Engine Phase 3: Transferiert distilled Insights auf ein Ziel-Genome – erstellt konkrete Änderungsvorschläge als Checkliste." +description: "Knowledge Conduit Phase 3: Transferiert Insights auf ein Ziel-Repo – erstellt konkrete Änderungsvorschläge als Checkliste." model: Claude Opus 4.6 (copilot) tools: [read, edit, search] --- -# Genome Transfer +# Knowledge Conduit – Transfer Du erhältst destillierte Insights (klassifiziert, gescored, bereinigt) und sollst konkrete Änderungsvorschläge für das **aktuelle Repo** erstellen. ## Input -1. Lies `.github/genome/output/distilled-insights.md` (die Insights) -2. Scanne das Ziel-Genome dieses Repos: `.github/skills/`, `.github/agents/`, `.github/prompts/`, `.github/copilot-instructions.md` +1. Lies `.github/knowledge-conduit/output/distilled-insights.md` (die Insights) +2. Scanne die KI-Tooling-Dateien dieses Repos: `.github/skills/`, `.github/agents/`, `.github/prompts/`, `.github/copilot-instructions.md` ## Aufgabe @@ -19,7 +19,7 @@ Du erhältst destillierte Insights (klassifiziert, gescored, bereinigt) und soll Für jeden Insight aus `distilled-insights.md`: -- Prüfe ob eine **gleichnamige Capability** im Ziel-Genome existiert → direktes Match +- Prüfe ob eine **gleichnamige Capability** im Ziel-Repo existiert → direktes Match - Prüfe ob eine **funktional äquivalente Capability** existiert (anderer Name, gleicher Zweck) → adaptiertes Match - Kein Match → **neue Capability** (nur bei Score ≥ 8 in die Checkliste aufnehmen, aber IMMER als "neu" kennzeichnen – nie automatisch anwenden) @@ -35,7 +35,7 @@ Erstelle für jedes Match einen konkreten Änderungsvorschlag: ## Output-Format -Schreibe das Ergebnis in `.github/genome/output/transfer-proposals.md`: +Schreibe das Ergebnis in `.github/knowledge-conduit/output/transfer-proposals.md`: ````markdown # Transfer Proposals @@ -106,7 +106,7 @@ Wende dann die ausgewählten Patches an – mit folgenden Einschränkungen: ### Neue Capabilities: Bestätigung erforderlich -Bevor eine neue Capability (kein Match im Ziel-Genome) angelegt wird, **immer einzeln bestätigen lassen**: +Bevor eine neue Capability (kein Match im Ziel-Repo) angelegt wird, **immer einzeln bestätigen lassen**: > Soll ich `` als neue Capability in `.github/` anlegen? > Inhalt: diff --git a/.github/prompts/genome.prompt.md b/.github/prompts/knowledge-conduit.prompt.md similarity index 71% rename from .github/prompts/genome.prompt.md rename to .github/prompts/knowledge-conduit.prompt.md index bd2d1db..b4e0b64 100644 --- a/.github/prompts/genome.prompt.md +++ b/.github/prompts/knowledge-conduit.prompt.md @@ -1,14 +1,14 @@ --- -description: "Genome Engine – Erkennt evolutionäre Verbesserungen an Copilot-Customization-Dateien und überträgt sie auf ein Ziel-Repo." +description: "Knowledge Conduit – Erkennt Verbesserungen an KI-Tooling-Dateien und überträgt sie zwischen Dev+AI-Teams." model: Claude Opus 4.6 (copilot) tools: [read, edit, search, execute] --- -# Genome Engine +# Knowledge Conduit -> **Konzept-Dokument:** `.github/genome/Concept Genome Engine.md` · **Skill-Doku:** `.github/skills/genome/SKILL.md` +> **Konzept-Dokument:** `.github/knowledge-conduit/Concept.md` · **Skill-Doku:** `.github/skills/knowledge-conduit/SKILL.md` -Du orchestrierst die 3 Phasen der Genome Engine: **Extraction → Distillation → Propagation**. +Du orchestrierst die 3 Phasen des Knowledge Conduit: **Extraction → Distillation → Transfer**. ## Parameter ermitteln @@ -35,7 +35,7 @@ Stelle dem User zu Beginn **immer** folgende Fragen über das `vscode_askQuestio }, { "header": "targetRepo", - "question": "Ziel-Repo: Wohin sollen die Mutations übertragen werden?", + "question": "Ziel-Repo: Wohin sollen die Improvements übertragen werden?", "options": [ { "label": "Aktuelles Repo (x:\\bollwerk)", "recommended": true } ] @@ -52,7 +52,7 @@ Warte auf die Antworten, bevor du mit Phase 1 beginnst. Führe das Extraction-Script aus: ```bash -python .github/skills/genome/genome-extract.py --since "" --repo "" --output ".github/genome/output/raw-improvements.md" +python .github/skills/knowledge-conduit/kc-extract.py --since "" --repo "" --output ".github/knowledge-conduit/output/raw-improvements.md" ``` Prüfe das Ergebnis: @@ -62,14 +62,14 @@ Prüfe das Ergebnis: ## Phase 2: Distillation -Führe jetzt die Distillation durch. Folge den Anweisungen aus `.github/prompts/genome-distill.prompt.md`: +Führe jetzt die Distillation durch. Folge den Anweisungen aus `.github/prompts/kc-distill.prompt.md`: -1. Lies `.github/genome/output/raw-improvements.md` +1. Lies `.github/knowledge-conduit/output/raw-improvements.md` 2. Klassifiziere jedes Improvement (🔴 Critical / 🟡 Evolution / ⚪ Specialized) 3. Score den Übertragungswert (1–10) 4. Sanitize sensitive Daten 5. Filtere Specialized + Score < 4 -6. Schreibe `.github/genome/output/distilled-insights.md` +6. Schreibe `.github/knowledge-conduit/output/distilled-insights.md` Zeige dem User eine Zusammenfassung: @@ -83,10 +83,10 @@ Wenn 0 Critical + 0 Evolution übrig: Melde "Keine übertragbaren Insights" und > **Nur wenn Quell-Repo ≠ Ziel-Repo.** -Führe den Transfer durch. Folge den Anweisungen aus `.github/prompts/genome-propagate.prompt.md`: +Führe den Transfer durch. Folge den Anweisungen aus `.github/prompts/kc-transfer.prompt.md`: -1. Lies `.github/genome/output/distilled-insights.md` -2. Scanne das Ziel-Genome (`.github/` des Ziel-Repos) +1. Lies `.github/knowledge-conduit/output/distilled-insights.md` +2. Scanne das Ziel-Repo (`.github/` des Ziel-Repos) 3. Matche Capabilities und generiere Patches 4. Zeige die Checkliste: - `[x]` Critical (default an) @@ -104,10 +104,10 @@ Wende die ausgewählten Patches an. Zeige eine Zusammenfassung: ``` -Genome Engine abgeschlossen: +Knowledge Conduit abgeschlossen: Quell-Repo: Zeitraum: - Extrahiert: X Traits, Y Mutations + Extrahiert: X Capabilities, Y Improvements Destilliert: A Critical, B Evolution Angewendet: N Patches ``` diff --git a/.github/skills/genome/SKILL.md b/.github/skills/genome/SKILL.md deleted file mode 100644 index 8d483db..0000000 --- a/.github/skills/genome/SKILL.md +++ /dev/null @@ -1,67 +0,0 @@ -# Genome Engine - -Automatische Erkennung und Übertragung von Verbesserungen am KI-Tooling (Skills, Agents, Prompts, Instructions) zwischen Repositories. - -## Trigger-Phrasen - -`genome`, `transfer`, `improvements übertragen`, `capabilities synchronisieren`, `genome extract`, `genome transfer` - -## Konzept - -Die Genome Engine 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 -- **Genome** – Die Gesamtheit aller Capabilities eines Projekts -- **Improvement** – Ein Git-Commit-Delta an einer Capability -- **Insight** – Destilliertes, bewertetes Improvement (bereinigt, klassifiziert, gescored) -- **Transfer** – Konkreter Änderungsvorschlag für ein Ziel-Genome - -## Pipeline - -| Phase | Tool | Input → Output | -| --------------- | ---------------------------- | --------------------------------------------------- | -| 1. Extraction | `genome-extract.py` | Git-History → `raw-improvements.md` | -| 2. Distillation | `genome-distill.prompt.md` | `raw-improvements.md` → `distilled-insights.md` | -| 3. Transfer | `genome-propagate.prompt.md` | `distilled-insights.md` + Ziel-Genome → Patches | - -## Usage - -``` -/genome -``` - -Der Router-Prompt fragt nach Quell-Repo und Zeitspanne, dann orchestriert er alle 3 Phasen. - -## Dateien - -| Datei | Ort | Zweck | -| ---------------------------- | ------------------------ | --------------------------------------------- | -| `SKILL.md` | `.github/skills/genome/` | Diese Dokumentation | -| `genome-extract.py` | `.github/skills/genome/` | Phase 1: Git-Scanning + Capability-Erkennung | -| `genome.prompt.md` | `.github/prompts/` | Orchestrator (Router für alle 3 Phasen) | -| `genome-distill.prompt.md` | `.github/prompts/` | Phase 2: Klassifizierung + Scoring | -| `genome-propagate.prompt.md` | `.github/prompts/` | Phase 3: Transfer-Vorschläge für Ziel | -| `Concept Genome Engine.md` | `.github/genome/` | Vollständiges Konzept-Dokument | - -## Capability-Erkennung - -Pfade werden automatisch zu Capability-Keys aufgelöst: - -``` -.github/skills/gh-tickets/SKILL.md → skill/gh-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 -``` - -## Genome-Scope - -Folgende Pfade bilden das Genome: - -- `.github/skills/**` -- `.github/agents/**` -- `.github/prompts/**` -- `.github/copilot-instructions.md` -- `.github/*.instructions.md` diff --git a/.github/skills/knowledge-conduit/SKILL.md b/.github/skills/knowledge-conduit/SKILL.md new file mode 100644 index 0000000..d6ed7e2 --- /dev/null +++ b/.github/skills/knowledge-conduit/SKILL.md @@ -0,0 +1,67 @@ +# 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/gh-tickets/SKILL.md → skill/gh-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` diff --git a/.github/skills/genome/genome-extract.py b/.github/skills/knowledge-conduit/kc-extract.py similarity index 91% rename from .github/skills/genome/genome-extract.py rename to .github/skills/knowledge-conduit/kc-extract.py index a33a9d1..325b70d 100644 --- a/.github/skills/genome/genome-extract.py +++ b/.github/skills/knowledge-conduit/kc-extract.py @@ -1,14 +1,14 @@ #!/usr/bin/env python3 """ -Genome Engine – Phase 1: Extraction +Knowledge Conduit – Phase 1: Extraction Extrahiert Improvements aus der Git-History für KI-Tooling-Dateien. -Scannt git log für Änderungen im Genome-Scope (.github/skills, agents, prompts, instructions). +Scannt git log für Änderungen im KI-Tooling-Scope (.github/skills, agents, prompts, instructions). Gruppiert Diffs nach Capability und gibt strukturiertes Markdown aus. Usage: - python .github/skills/genome/genome-extract.py --since "7 days ago" - python .github/skills/genome/genome-extract.py --since "4 days ago" --repo /path/to/repo + python .github/skills/knowledge-conduit/kc-extract.py --since "7 days ago" + python .github/skills/knowledge-conduit/kc-extract.py --since "4 days ago" --repo /path/to/repo """ import argparse @@ -22,7 +22,7 @@ from pathlib import Path # --- Konfiguration --- -GENOME_SCOPES = [ +CONDUIT_SCOPES = [ ".github/skills/", ".github/agents/", ".github/prompts/", @@ -48,9 +48,9 @@ def run_git(*args: str, cwd: str = ".") -> str: return result.stdout -def is_in_genome_scope(filepath: str) -> bool: - """Prüft ob ein Dateipfad im Genome-Scope liegt.""" - for scope in GENOME_SCOPES: +def is_in_conduit_scope(filepath: str) -> bool: + """Prüft ob ein Dateipfad im KI-Tooling-Scope liegt.""" + for scope in CONDUIT_SCOPES: if scope.endswith("/"): if filepath.startswith(scope): return True @@ -126,7 +126,7 @@ def extract_mutations(repo_path: str, since: str) -> dict[str, list[dict]]: "--format=%H|%aI|%an|%s", f"--since={since}", "--", - *GENOME_SCOPES, + *CONDUIT_SCOPES, cwd=repo_path, ) @@ -164,7 +164,7 @@ def extract_mutations(repo_path: str, since: str) -> dict[str, list[dict]]: # Normalisieren filepath = filepath.replace("\\", "/") - if not is_in_genome_scope(filepath): + if not is_in_conduit_scope(filepath): continue trait_key = get_trait_key(filepath, repo_path) @@ -256,16 +256,16 @@ def generate_markdown(mutations: dict[str, list[dict]], repo_path: str, since: s def main(): - parser = argparse.ArgumentParser(description="Genome Engine – Extraction") + parser = argparse.ArgumentParser(description="Knowledge Conduit – Extraction") parser.add_argument("--since", default="7 days ago", help='Zeitspanne (z.B. "7 days ago")') parser.add_argument("--repo", default=".", help="Pfad zum Repository") - parser.add_argument("--output", default="", help="Output-Pfad (default: .github/genome/output/raw-improvements.md)") + parser.add_argument("--output", default="", help="Output-Pfad (default: .github/knowledge-conduit/output/raw-improvements.md)") args = parser.parse_args() repo_path = os.path.abspath(args.repo) - output_path = args.output or os.path.join(repo_path, ".github/genome/output/raw-improvements.md") + output_path = args.output or os.path.join(repo_path, ".github/knowledge-conduit/output/raw-improvements.md") - print(f"Genome Extract: Scanning commits since '{args.since}'...") + print(f"KC Extract: Scanning commits since '{args.since}'...") mutations = extract_mutations(repo_path, args.since) markdown = generate_markdown(mutations, repo_path, args.since) diff --git a/.gitignore b/.gitignore index 6aa2f2f..1f4bbde 100644 --- a/.gitignore +++ b/.gitignore @@ -38,5 +38,5 @@ memories/session/ .env -# Genome Engine generated output -.github/genome/output/*.md +# Knowledge Conduit generated output +.github/knowledge-conduit/output/*.md