Lesson #1477

ID

1477

Author

ai

Agent

agent-claude

Reviewed

✓ Yes

Source authority

75 / 100

Source

Neue Tools + Konventionen seit 2026-05-12 — Multi-Python via uv, MCP-Server, 12 Workers, Swarm-CLI, Trajectory-Bank, .agents/-Konzept. Aktuell laufende Sessions sollten das wissen.

Source issue

—

Created at

2026-05-12T12:38:46.949657+00:00

Valid until

—

Deprecated at

—

Supersedes

—

Obsidian path

/root/.claude/projects/-nvmetank1-projects/memory/reference_stack_update_2026_05_12.md

Obsidian hash

86db7f64a854f91596af827fd2869da7

Tags

claude-memory,reference

Content

**Aktualisierungs-Datum: 2026-05-12** — diese Tools/Konventionen wurden in der orchestrator-improvement-Wave neu eingeführt. Alle Sessions (auch laufende) sollten sie kennen.

## Neue CLI-Tools auf Host (`/usr/local/bin/`)

| Tool | Zweck |
|---|---|
| `claude-context-pack <task> --repo X --limit N` | Memories + Gitea-Issues + git-log als Markdown-Block |
| `memory-sync-to-rag [file...]` | Sync `memory/*.md` → rag-stack Lessons (idempotent) |
| `claude-store-success-pattern <repo> <issue> [merge\|deploy\|test]` | Capture success-pattern nach Erfolg |
| `claude-agent-state {set,get,del,list,dump} <ns> <key>` | Shared k/v store (rag.db `agent_state`) |
| `claude-log-attempt {log,rate,stats} <agent> <task_class> <outcome>` | Self-learning: log + read success-rate |
| `claude-test-env [--version X.Y] <project>` | Multi-Python pytest (3.10-3.14 via uv) |
| `claude-swarm {run,status,collect} ...` | Fan-out N agents + consensus (majority/best/first-pass) |
| `claude-trajectory {log,show,similar,stats}` | Reasoning-Bank (sequences von tool-calls) |
| `claude-memory-mcp` | MCP-Server (8 tools: context_pack, memory_search, agent_state_*, log_attempt, store_success_pattern) — registered host-wide |
| `claude-delegation-logger` | PreToolUse-Hook: loggt direkte Edits auf /nvmetank1/projects/ |
| `claude-memory-write-hook` | PostToolUse-Hook: auto-sync memory/*.md → rag-stack |
| `orchestrator-snapshot` | Host-data → JSON (containers/services/ollama/disk) every 60s |
| `orchestrator-backup` | Daily backup (rag.db + memory + bugtest-stack) |
| `orchestrator-worker [name\|--all\|--list]` | 12 background workers (audit, testgaps, security_scan, drift_check, etc.) |
| `orchestrator-worker-summary` | Surfaces danger/warning findings — wird in jedem SessionStart angezeigt |

## Neue UI-Routes auf `orchestrator.joelduss.xyz/governance/`

| Route | Inhalt |
|---|---|
| `/bugs`, `/tests`, `/activity` | Bug-Tracker + Test-Coverage + Live-Activity-Feed |
| `/resources`, `/workflows`, `/dataflows`, `/claude`, `/nodes`, `/catalog`, `/ollama`, `/missions`, `/services` | Nerve-inspirierte Übersichten |
| `/workers` | Background-Worker Dashboard mit Status pro Worker |
| `/backlog` | Feature-Backlog |

Plus Standalones: `bug.joelduss.xyz` + `test.joelduss.xyz` (read-only public).

## Neue MCP-Tools (in jedem Claude-Code-Session via `mcp__memory__*`)

- `mcp__memory__context_pack(task, repo, limit)`
- `mcp__memory__memory_search(query, limit)`
- `mcp__memory__memory_sync_one(path)`
- `mcp__memory__agent_state_get/set/list(namespace, key, ...)`
- `mcp__memory__log_attempt(agent, task_class, outcome, ...)`
- `mcp__memory__store_success_pattern(repo, issue, outcome)`

## Neue Konventionen

1. **AGENTS.md ist single-source** pro Projekt — CLAUDE.md + GEMINI.md sind Symlinks.
2. **Multi-Python via uv** — `claude-test-env <project>` für jedes pytest-Run (statt direkt `python -m pytest`).
3. **Per-Projekt `.agents/`** in rag-stack/glug/yoga/bugtest-stack: codex-CLI-config + 11 skills (8 ruflo + 3 unsere).
4. **claude-Handler-Headless** über `claude --print` (OAuth) — kein API-Key nötig.
5. **Auto-Inject context-pack** in jedem n8n-dispatch (fetch_issue_context fügt's hinzu).
6. **Pattern-store nach Erfolg** — handler-common.sh ruft `store_success_pattern` auto.

## Systemd-Timers laufen autonom

- `orchestrator-snapshot.timer` — 60s
- `orchestrator-worker-all.timer` — 15min
- `orchestrator-backup.timer` — daily 03:00
- `agent-dispatch.service` — always-on (port 8810, ersetzt glug-webhook.service)

## Auto-Memory-Hook

Jeder `Write` an `~/.claude/projects/.../memory/*.md` triggert via PostToolUse-Hook
`memory-sync-to-rag` — sofort sichtbar im Memory-Bus für andere Sessions.

## Was passiert per Default in jeder SessionStart

`claude-automation-session` chain läuft:
1. `rag-session-bootstrap` (RAG knowledge bootstrap aus rag-stack:8801)
2. `secondbrain-hook`
3. `claude-automation-detector --pending-only`
4. `qa-status-check`
5. `glug-capabilities-bootstrap`
6. **`orchestrator-worker-summary`** ← NEU 2026-05-12: zeigt danger/warning findings aus den 12 workers

## Issues für offene Items

`https://git.joelduss.xyz/ubuadmin/rag-stack/issues` — 13 open (rest closed/done):
- #100 EPIC Orchestrator-Improvement Wave 2026-05-12
- #103-#107, #109, #110 — dispatched, agents arbeiten dran
- #94-#99 — auto-detected automation-candidates
- #100 — EPIC

## Wenn du das hier liest und es ist DEINE erste Session des Tages

`claude-context-pack "what's new in the stack" --limit 5` zeigt dir die letzten Updates.