| name | module-howto |
| disable-model-invocation | true |
| description | Bedienungsanleitung für das imp-assistant-Repo — Handlung im Moment: Content-/Outreach-Scout starten, distill-Review fahren und mergen, Metriken/Konstruktions-Review ansehen, neuen Skill anlegen. Nur explizit per /module-howto aufrufen. Referenz-Doku steht im README, nicht hier. |
How-to — imp-assistant bedienen
Rezepte für die vier häufigsten Handgriffe. Architektur, Lern-Loops und
Boundary-Regel stehen im README — hier nichts doppeln.
Volle Übersicht aller Skills → lies memory/state/skills-overview.md
(generiert, eine Quelle für README und dieses How-to).
1. Scout manuell starten
Im Repo (Claude Code) sagen: „Content-Scout starten" (content-scout) oder
„Outreach-Scout starten" (outreach-scout). Der Scout lädt Rules + IDs
selbst, schreibt Treffer nach Notion/Attio und loggt Events nach
memory/logs/<key>/run-<ID>.jsonl.
Vorher prüfen, wenn der letzte Lauf länger her ist: Sind in Notion
genug Quellen auf „Aktiv"? (Scout-Quellen-DB, Paul setzt manuell.)
2. distill-Review fahren + mergen
Je Eigentümer (Memory-Key), sobald Events aufgelaufen sind:
bash scripts/distill.sh voice-linkedin # oder: voice-core, voice-email,
# outreach-brief, linkedin-ghostwriter,
# content-scout, outreach-scout
Der Output ist ein Diff-Vorschlag gegen memory/rules/<key>.md —
es wird nie automatisch geschrieben. Merge:
- Diff lesen; bei Kanal-Skills den Routing-Hinweis beachten
(universelle Muster →
voice-core.md statt Kanal-Datei).
- Tragfähige Regeln von Hand in die Rules-Datei übernehmen.
- Committen:
<key>: Regeln aus Distill <Datum> übernommen
Optional --llm ans Script anhängen — formuliert die Regel-Entwürfe vor.
3. Metriken / Konstruktions-Review ansehen
bash scripts/metrics.sh
metrics/correction.csv — Korrekturrate je Schreib-Skill (sinkend = Rules wirken)
metrics/acceptance.csv — Scout-Outcomes (positiv / verworfen)
metrics/linkedin-construction.csv — Engagement je Hook-Typ. Vorher den
Spiegel auffrischen: in Claude Code sagen „aktualisiere den
LinkedIn-Performance-Spiegel" (holt Kalender-Zahlen via Notion-MCP nach
metrics/linkedin-performance.json).
Konstruktions-Erkenntnisse aus dem Review von Hand nach
memory/rules/linkedin-ghostwriter.md committen — bewusst kein Auto-Distill.
4. Neuen Skill anlegen
- Ordner flach:
.claude/skills/<klasse>-<name>/SKILL.md —
Präfix agent- (macht einen Job, invocable), voice- (Ton,
disable-model-invocation: true), module- (Baustein, Flag je nach Zweck).
- Description: Keywords in die ersten ~250 Zeichen.
- Soll er lernen? Memory-Block nach Contract
(
.claude/skills/_shared/memory-contract.md): Familie wählen,
Memory-Key in die Contract-Tabelle, Capture-Ziel nach Routing-Regel,
memory/rules/<key>.md leer anlegen (Kopf wie bei den bestehenden).
bash scripts/gen-overview.sh — Übersicht und README aktualisieren sich.
- Committen:
<skill-name>: angelegt — <Zweck>