# Letter Hooker

> Erweitert automation-self-care um Letter Hooks, Preflight-Bootloader, Dokument-Traversierungsregeln und selbstheilende Prompt-Kontext- Anreicherung für KI-Agenten und CLIs ohne native, ereignisgetriebene JSON-Lifecycle-Hooks (wie Antigravity / Gemini CLI). Nutzen, wenn ein Agent Preflight-Regeln injizieren, vor Arbeitsbeginn Memory/Gardener durchsuchen, Verzeichnis-Dokument-Lesestrategien erzwingen (CLAUDE.md / AGENTS.md) oder Sidecar-Tasks dynamisch an Skills und Sicherheitsprotokolle routen soll.

- Skill: `ellmos-ai/letter-hooker` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add ellmos-ai/letter-hooker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/letter-hooker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/letter-hooker

---


<img src="banner.png" width="100%" alt="letter-hooker banner">

# Letter-Hooker (Prompt-Level Preflight & Governance Engine)

Der **Letter-Hooker**-Skill erweitert `automation-self-care` für KI-Agenten-Frameworks (wie **Antigravity / Gemini CLI**), die keine nativen, ereignisgetriebenen JSON-Lifecycle-Hook-Loader besitzen (z. B. `~/.claude/settings.json` oder `~/.codex/hooks.json`).

Statt sich auf passive Per-Keypress-Hooks zu verlassen, betreibt `letter-hooker` einen **aktiven Prompt-Level-Preflight-Bootloader und Letter-Hook-Injection-Loop** über geplante Tasks und Maintainer-Skripte (`agy_kontext_and_workflow_loader.py`).

---

## Kernfähigkeiten

1. **Preflight-Bootloader & Dokument-Traversierungsregeln**:
   - **Aufwärts- & Abwärtssuche**: Erzwingt strikte Anweisungen für Agenten, `AGENTS.md`, `CLAUDE.md`, `START.md`, `RULES.md` und `README.md` auf der aktuellen Arbeitsverzeichnis-Ebene zu prüfen. Fehlen sie, aufwärts traversieren, bis gefunden; dann abwärts prüfen.
   - **Memory- & Gardener-Preflight**: Pflicht-Preflight-Abfrage an `gardener` und `memoryhooker`, bevor destruktive oder komplexe Änderungen ausgeführt werden.

2. **Letter-Hooks-Katalog & Referenz-Links**:
   - Modulare `.md`-Instruktionsdateien unter `OneDrive/.SYNC/antigravity_kontext_and_workflow_loader_package/letter_hooks/`.
   - Injiziert explizite `file://`-Links direkt in den `sidecar.json`-Prompt-Text, damit Agenten bei Aufruf exakte Sicherheits- und Workflow-Protokolle lesen.

3. **Tägliche Stichwortliste & selbstheilende Prompt-Anreicherung**:
   - Pflegt eine tägliche `STICHWORTLISTE.json` aus aktiven/Standby-Tasks.
   - Analysiert Ausführungslogs (`AUTOMATIONS-MEMORY.md`) auf Fehlermuster (fehlender Kontext, fehlende Workflow-Anleitung, ungültige Pfade) und patcht Task-Prompts dynamisch.

4. **Skill- & Persona-Routing**:
   - Prüft Task-Schlüsselwörter und mappt sie auf passende `.SKILLS` (z. B. `infrastructure/condition`, `semantic-persona-routing`, `orchestrator`, `think`, `decide`).

---

## Wichtige Letter Hooks

- **`HOOK-DOC-TRAVERSAL-01`**: [bootloader_doc_traversal.md](file:///<USER_HOME>/OneDrive/.SYNC/antigravity_kontext_and_workflow_loader_package/letter_hooks/bootloader_doc_traversal.md)
- **`HOOK-GARDENER-MEMORY-01`**: [preflight_gardener_query.md](file:///<USER_HOME>/OneDrive/.SYNC/antigravity_kontext_and_workflow_loader_package/letter_hooks/preflight_gardener_query.md)
- **`HOOK-WORKFLOW-HYGIENE-01`**: [workflow_lock_and_git_hygiene.md](file:///<USER_HOME>/OneDrive/.SYNC/antigravity_kontext_and_workflow_loader_package/letter_hooks/workflow_lock_and_git_hygiene.md)
- **`HOOK-PATH-VALIDATION-01`**: [path_validation_and_authority.md](file:///<USER_HOME>/OneDrive/.SYNC/antigravity_kontext_and_workflow_loader_package/letter_hooks/path_validation_and_authority.md)

---

## Workflow-Integration

```bash
# Letter-Hooker-Wartungs-Engine ausführen
python OneDrive/.SYNC/scripts/agy_kontext_and_workflow_loader.py
```

1. **Sidecars scannen**: Alle `sidecar.json`-Prompt-Texte in `~/.gemini/config/sidecars/` lesen.
2. **Stichwortliste aktualisieren**: Fachbegriffe extrahieren und nach `.SYNC/STICHWORTLISTE.json` speichern.
3. **Letter Hooks injizieren**: Bootloader-Regeln und `file://`-Referenz-Links an Prompts anhängen.
4. **Ergebnisse loggen**: Updates in `ANTIGRAVITY-LOG.txt` und `ANTIGRAVITY-REGISTRY.md` festhalten.