feat: initial marketplace (knowledge-curator + venture)

2026-06-02 14:31:42 +02:00
commit 45a4f30939
22 changed files with 1463 additions and 0 deletions
@@ -0,0 +1,78 @@
+# claude-marketplace (Inhalt) — knowledge-curator Plugin
+
+**Der Inhalt dieses Ordners ist die Wurzel deines Marketplace-Repos**
+`l.kirchner/claude-marketplace` (bereits angelegt auf
+https://gitea.luki-net.org/l.kirchner/claude-marketplace). Künftige Skills,
+Plugins und Agents kommen als weitere Unterordner + Einträge in
+`.claude-plugin/marketplace.json` dazu.
+
+## Layout
+
+```
+.claude-plugin/marketplace.json     # Marketplace-Manifest (Plugin-Liste)
+knowledge-curator/                  # Plugin #1
+├── .claude-plugin/plugin.json
+├── skills/knowledge-curator/SKILL.md
+├── agents/{kg-graph-auditor,kg-entity-deduplicator,kg-relation-miner,kg-taxonomy-architect}.md
+├── commands/{kg-curate,kg-apply}.md
+├── hooks/{hooks.json,backup-memory.sh}   # Auto-Backup bei Memory-Writes
+└── README.md                       # Architektur & Sicherheit
+push-to-gitea.sh                    # diesen Baum signiert ins Repo pushen
+install.sh                          # local | marketplace (für andere Repos)
+marketplace-entry.json              # Snippet für einen FREMDEN Marketplace
+```
+
+## Veröffentlichen (Repo ist schon da, leer)
+
+Aus diesem Ordner heraus:
+
+```
+./push-to-gitea.sh
+```
+
+Initialisiert git, setzt das Remote (SSH, Port 2222), committet (mit deiner
+lokalen Signing-Config) und pusht nach `main`. Danach in Claude Code:
+
+```
+/plugin marketplace add https://gitea.luki-net.org/l.kirchner/claude-marketplace
+/plugin install knowledge-curator@luki-net
+```
+
+Manuell geht's genauso:
+
+```
+git init -b main
+git remote add origin ssh://git@gitea.luki-net.org:2222/l.kirchner/claude-marketplace.git
+git add -A && git commit -S -m "feat: knowledge-curator plugin" && git push -u origin main
+```
+
+## Weitere Plugins später hinzufügen
+
+1. Neuen Unterordner anlegen (`<plugin>/` mit `.claude-plugin/plugin.json` +
+   `skills/`/`agents/`/`commands/`/`hooks/`).
+2. Eintrag ins `plugins`-Array von `.claude-plugin/marketplace.json`
+   (`{"name": "...", "source": "./<plugin>", "description": "..."}`).
+3. Committen, pushen. In Claude Code: `/plugin marketplace update luki-net`,
+   dann `/plugin install <plugin>@luki-net`.
+
+## Schneller Test ohne Marketplace
+
+`./install.sh local` kopiert Skill/Agents/Commands/Hooks direkt nach
+`~/.claude/`. Danach Claude Code neu starten bzw. `/reload-plugins`.
+
+## Wichtig nach der Installation
+
+- Skill-Änderungen greifen sofort; Änderungen an `agents/`, `commands/`,
+  `hooks/` brauchen `/reload-plugins` oder Neustart.
+- **Hook konfigurieren:** Der Backup-Hook braucht den Pfad zur Memory-Graph-
+  Datei. `KG_MEMORY_FILE` (oder `MEMORY_FILE_PATH`) in deiner Claude-Code-Env
+  setzen — sonst überspringt der Hook das Datei-Backup sauber (blockiert nie).
+  Optional: `KG_BACKUP_DIR` (Default `~/.claude/kg-backups`),
+  `KG_BACKUP_DEBOUNCE` (120s), `KG_BACKUP_KEEP` (20).
+- **MCP-Tool-Namen prüfen:** Agents whitelisten `mcp__memory__read_graph`,
+  `…__search_nodes`, `…__open_nodes`; der Hook matcht
+  `mcp__memory__(create|add|delete)_*`. Heißt dein Server anders, in
+  `knowledge-curator/agents/*.md`, `hooks/hooks.json` und SKILL.md anpassen.
+  Check: `claude mcp list` bzw. `/mcp`.
+
+Architektur, Sicherheit, Kosten: siehe `knowledge-curator/README.md`.