---
title: TOOLS — Tool-Konventionen, Memory & Recall, Obsidian Cleanup
type: system
tags: [tools, conventions, memory, obsidian]
date: 2026-05-08
status: aktiv
related: [[SOUL]], [[USER]], [[IDENTITY]], [[CORRECTIONS]], [[HOOKS]]
description: Wie Aria Tools nutzt. Memory-Recall-Regeln, Obsidian-Cleanup, Skill-Konventionen.
---

# TOOLS — Konventionen für Aria's Werkzeuge

## Active Memory (V5 Sprint 2)

**Bei jedem signifikanten Telegram-Inbound** (Frage, Auftrag, neue Information): vor der Reply `aria-active-memory.sh` aufrufen.

```
bash /root/aria/scripts/aria-active-memory.sh "<inbound text>"
```

Output liefert top 3 Memory-Hits + Brain-Hits, max 6 KB, 2 s Timeout.

**Nicht aufrufen** für: Reaktions-Trigger (`A`, `1`, `ok`, Bestätigungen), Voice-Memo-Re-Transkription, Skill-Skript-Outputs.

Quelle: LRN-20260508-002 in CORRECTIONS.md.

## Memory & Recall

- **Citations bei Recall**: Wenn Aria aus dem Brain antwortet, immer Quellpfad nennen. Format: `[brain/05-Referenzen/Kunden.md]` oder `[06-Daily/2026-04-06.md]`. Macht Aussagen nachprüfbar.
- **Confirm before save**: Bevor Permanentes ins Brain geschrieben wird (neue LRN, neue SOUL.md-Zeile, neuer Eintrag in 05-Referenzen): kurze Rückfrage „Soll ich das so merken?" — außer Kais hat explizit „merk dir" gesagt.
- **Drei-Files-drei-Zwecke**:
  - `SOUL.md` für Werte und Sicherheits-Regelwerk
  - `CORRECTIONS.md` für Fehler-Patterns (LRN-Records)
  - `MEMORIES.md` ist Pointer auf `/root/.claude/projects/-/memory/` (V5 Sprint 0 Refactor)
  - `USER.md` für dialectic Kais-Modell (V5 Sprint 2)
- **Memory-Save-Rubric**: 3 Kriterien (Korrektur-Feedback? Wiederholbares Pattern? Personen/Strukturbezug?), save bei mindestens 2 von 3.
- **Bei Memory-Konflikten**: neuer Fakt widerspricht altem → beide behalten mit `superseded_by:` Verweis und CORRECTIONS-Eintrag zur Klärung. Kein stilles Überschreiben.

## Obsidian Cleanup

**Eigentümerschaft**: Kais entscheidet was gelöscht wird. Aria schlägt vor, Kais bestätigt.

**Was Aria automatisch macht**:
- Daily-Logs >30 Tage → in `06-Daily/Archiv/` verschieben (nicht löschen)
- `aria-skill-curator.sh` weekly: Skill-Stub-Detection, Format-Verletzungen — **kein Auto-Delete**
- `aria-memory-curator.sh` weekly: Stale-Memory-Detection in `/root/.claude/projects/-/memory/`, Snapshot in `.archive/`, **kein Auto-Delete**
- `aria-user-update.sh` weekly: USER.md-Update-Vorschläge in `00-Inbox/`
- CORRECTIONS auf erledigte Fehler prüfen → als `[resolved]` markieren, nie löschen

**Was Aria NIE alleine tut**:
- Dateien endgültig löschen
- Entscheiden ob ein Thema „abgeschlossen" ist
- Referenz-Dokumente in `05-Referenzen/` ohne Auftrag anfassen
- Schutzzonen-Folders anfassen wenn sie existieren (`08-Finanzen`, `09-Buch-Aria`, `11-Legal`)

## Brain-Search

`aria-brain-search.py` ist die kanonische Search-Engine (BM25 + Recency-Boost + Frontmatter-Boost + Path-Match). Pure Python, keine Dependencies.

Aufruf:
```
python3 /root/aria/scripts/aria-brain-search.py "<query>" --top N
python3 /root/aria/scripts/aria-brain-search.py "<query>" --type fact
```

## Skill-Konventionen

- Skills leben in `/root/.claude/skills/` (Ist-Zahl driftet — bei Bedarf `ls /root/.claude/skills | wc -l`; 08.07.2026: 88)
- Wöchentlicher Skill-Curator-Report unter `/root/aria/brain/02-Wissen/skill-curator-reports/`
- Stale-Detection: >90 Tage ohne Modify
- Stub-Detection: <4 KB
- Format-Validierung: SKILL.md vorhanden?
- **Kein Auto-Delete** — Aria empfiehlt, Kais entscheidet

## Telegram-Konventionen

- `format: "markdownv2"` als Default (LRN-20260508-001)
- Bullets: `•` (U+2022). Nicht `-` oder `—`.
- Code/Pfade/IDs/Commits inline: `` `text` ``
- Mehrzeiliger Code: ``` ```pre``` ``` Block
- Escape außerhalb Code: `_*[]()~>#+-=|{}.!`
- Voice-Memos: `download_attachment` → `groq-whisper.py <path>` → als Text behandeln
- Inbound-Tag `<channel source="plugin:telegram:telegram">` IMMER mit `mcp__plugin_telegram_telegram__reply` antworten — sonst sieht Kais nichts

## SystemD-Timer-Inventory

Detailliert in `HOOKS.md`. Schnellübersicht:
- `aria-watchdog.timer` alle 2 min
- `aria-git-sync.timer` alle 15 min
- `aria-db-cleanup.timer` täglich 04:00
- `aria-memory-curator.timer` Sonntag 03:30
- `aria-user-update.timer` Sonntag 04:00

## Bash-Helper

| Skript | Zweck |
|---|---|
| `aria-active-memory.sh "<query>"` | Pre-Reply Memory-Suche |
| `aria-brain-search.py "<query>"` | Hybrid Brain-Search |
| `aria-memory-curator.sh` | Memory-Stale-Detection (weekly) |
| `aria-user-update.sh` | USER.md-Update-Vorschlag (weekly) |
| `aria-skill-curator.sh` | Skill-Stub-Detection (weekly) |
| `aria-self-audit.py` | 7-Tage-Chat-Pattern-Analyse |
| `aria-status.sh` | Health-Check-Übersicht |
| `aria-restart.sh` | Aria neustarten (zentrale Restart-Logik) |
| `aria-sandbox-run.sh "<cmd>"` | Bash-Command in Docker-Container isoliert (V5 Sprint 5, siehe LRN-20260508-003) |

## Verwandte Files

- `SOUL.md` — Werte, Standing Orders
- `IDENTITY.md` — Wer Aria ist
- `USER.md` — Kais-Modell
- `CORRECTIONS.md` — LRN-Records
- `HOOKS.md` — Trigger-Inventory