| { |
| "meta": { |
| "stand": "2026-03-22", |
| "version": "1.0.0" |
| }, |
| "hero": { |
| "title": "Samuels AI-Werkstatt", |
| "subtitle": "4 Harnesses. 1 Workflow. Datengetrieben.", |
| "stats": [ |
| { "label": "Harnesses", "value": "4" }, |
| { "label": "Sessions", "value": "100+" }, |
| { "label": "Stunden", "value": "50+" }, |
| { "label": "Stand", "value": "2026-03-22" } |
| ] |
| }, |
| "style_fit": { |
| "kicker": "Welches Tool passt?", |
| "heading": "Style-Fit Matrix", |
| "description": "Welches Harness trifft deinen Arbeitsstil am besten — fuer jeden Task-Typ bewertet.", |
| "task_types": [ |
| "Greenfield Architektur", |
| "Feature iterieren", |
| "Bugfix isoliert", |
| "Refactor gross", |
| "Docs schreiben", |
| "Codebase erkunden", |
| "Parallele Agenten", |
| "Interaktiv chatten", |
| "Terminal-nah" |
| ], |
| "harnesses": ["Claude Code", "Hermes", "OpenCode", "Codex CLI"], |
| "matrix": [ |
| ["PERFEKT", "GUT", "OKAY", "MITTEL"], |
| ["PERFEKT", "GUT", "GUT", "OKAY"], |
| ["GUT", "GUT", "PERFEKT", "OKAY"], |
| ["PERFEKT", "GUT", "GUT", "MITTEL"], |
| ["GUT", "PERFEKT", "OKAY", "SCHLECHT"], |
| ["PERFEKT", "GUT", "GUT", "MITTEL"], |
| ["PERFEKT", "MITTEL", "GUT", "SCHLECHT"], |
| ["PERFEKT", "GUT", "OKAY", "MITTEL"], |
| ["GUT", "MITTEL", "MITTEL", "PERFEKT"] |
| ], |
| "recommendations": [ |
| { |
| "harness": "Claude Code", |
| "for": "Architektur, grosse Refactors, Agenten-Workflows", |
| "color": "teal" |
| }, |
| { |
| "harness": "Hermes", |
| "for": "Dokumentation, Research, Analyse", |
| "color": "gold" |
| }, |
| { |
| "harness": "OpenCode", |
| "for": "Isolierte Bugs, saubere Feature-Implementierungen", |
| "color": "green" |
| }, |
| { |
| "harness": "Codex CLI", |
| "for": "Terminal-Scripts, Batch-Ops, Shell-Automation", |
| "color": "amber" |
| } |
| ] |
| }, |
| "harnesses": [ |
| { |
| "id": "claude-code", |
| "name": "Claude Code", |
| "tagline": "Vollstaendiges Agentic Coding Environment", |
| "status": "aktiv", |
| "color": "teal", |
| "data_complete": true, |
| "stats": [ |
| { "label": "Sessions", "value": "100+" }, |
| { "label": "Avg. Session", "value": "~45 min" }, |
| { "label": "Modell", "value": "claude-opus-4-6" } |
| ], |
| "strengths": [ |
| "Tiefste Codebase-Integration via LSP und Git", |
| "Subagent-Orchestrierung fuer parallele Arbeit", |
| "Sidecar-NG Kontext-Injektion", |
| "MCP-Server Support", |
| "Direkter Bash/File-Zugriff" |
| ], |
| "weaknesses": [ |
| "Hoechste Kosten pro Session", |
| "Opinionated Workflow (Claude-first)", |
| "Kein nativer Web-Browser" |
| ], |
| "architecture_link": "diagrams/architecture-claude-code.html", |
| "router_keywords": ["architektur", "system", "design", "plan", "komplex", "verstehen", "codebase", "neue idee", "greenfield", "orchestr", "analyse"], |
| "router_reason": "Dein Architekt-Modus — Plan Mode erzwingt Denken vor Code. Teuer aber richtig wenn du verstehen willst WAS passiert.", |
| "router_wave": "Wave 1 — Scout", |
| "tutorial": { |
| "quickStart": [ |
| "Starte mit: `claude` oder `claude --plan` für Architektur-Modus", |
| "Erste Commands: `/status`, `git status`, `Lies BACKLOG.md`", |
| "Plan Mode aktivieren für grosse Entscheidungen", |
| "Subagents für parallele Recherche: `run_in_background: true`", |
| "Ergebnis als Tasksheet exportieren für nächstes Harness" |
| ], |
| "adhsPatterns": { |
| "bodyDoubling": "Du bist mein virtueller Co-Worker. Ich rede mit dir während ich hacke — nicht weil ich Hilfe brauche, sondern weil Präsenz mich fokussiert. Sprich, auch wenn ich nicht direkt frage.", |
| "dopaminTrigger": "Schnelle Wins: Cliffhanger setzen, Teilergebnisse zeigen, Checkpoint-Messages ('Session bisher: 3 Features, 2 Tests grün').", |
| "antiParalysis": "Wenn ich feststecke: Nicht philosophieren, sondern 'Was ist die kleinste nächste Action?' stellen. Mikro-Schritte, nicht Grossvision.", |
| "sessionRhythm": "Max 45min pro Session. Dann /compact oder neue Session. Hyperfocus ≠ Produktivität — nach 1h ohne Test → Quality Drop." |
| }, |
| "wellenmodus": { |
| "role": "Scout & Orchestrator", |
| "entry": "Wenn Task Architektur, Planung, oder grosses Refactor braucht", |
| "exit": "Tasksheet für Hermes/Codex wenn Code gebaut werden soll" |
| }, |
| "handoff": { |
| "toHermes": "Konkretes Feature mit Scope-Statement, nicht Plan", |
| "toOpenCode": "Isolierter Bugfix mit Fehlermeldung + Expected vs Actual", |
| "toCodex": "Refactor-Task mit Before/After-Beschreibung" |
| }, |
| "architektur": { |
| "annotations": [ |
| { "component": "CLAUDE.md", "description": "Globale + per-project Verhaltensregeln. Priorität: project > global." }, |
| { "component": "settings.json", "description": "Modell, Permissions, Env-Variablen. settings.local.json überschreibt." }, |
| { "component": "Hooks (5 Points)", "description": "SessionStart, UserPromptSubmit, PreToolUse (blockiert!), PostToolUse, Stop" }, |
| { "component": "Subagents", "description": "Parallele Tasks via Task-Tool. Cost: ~$0.25/M (Haiku). vs $15/M (Opus)." }, |
| { "component": "MCP-Server", "description": "Externe Tools: Filesystem, GitHub, Memory. Nicht für Long-Running." } |
| ] |
| }, |
| "config": { |
| "settingsKeys": [ |
| { "key": "model", "type": "string", "default": "claude-opus-4-6", "description": "Default-Modell für Sessions" }, |
| { "key": "permissions.allow", "type": "array", "default": "['Edit', 'Write', 'Glob', 'Grep', 'Agent', 'Bash(git*)']", "description": "Erlaubte Tools" }, |
| { "key": "permissions.deny", "type": "array", "default": "['Bash(rm*)', 'Bash(apt*)', 'Bash(dd*)']", "description": "Verbotene Tools ( safety_gates.py)" }, |
| { "key": "env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS", "type": "boolean", "default": "1", "description": "Aktiviert Subagent-Orchestrierung" }, |
| { "key": "hooks.PreToolUse", "type": "array", "description": "Blocking-Hooks vor Tool-Ausführung" }, |
| { "key": "hooks.UserPromptSubmit", "type": "array", "description": "Context-Injection vor LLM-Call (Sidecar-NG nutzt dies)" } |
| ], |
| "hooks": [ |
| { "name": "SessionStart", "description": "Session-Init. Nicht blockierend. Gut für Auto-Context.", "canBlock": false }, |
| { "name": "UserPromptSubmit", "description": "Vor LLM-Call. Kann additionalContext injizieren (Sidecar-NG).", "canBlock": false }, |
| { "name": "PreToolUse", "description": "Vor Tool-Ausführung. BLOCKIERT Tool wenn Handler blockiert. Nutzung: safety_gates.py.", "canBlock": true }, |
| { "name": "PostToolUse", "description": "Nach Tool-Ausführung. Für Logging, Async-Review.", "canBlock": false }, |
| { "name": "Stop", "description": "Session-Ende. Cleanup, Final-Report.", "canBlock": false } |
| ] |
| }, |
| "faq": [ |
| { "q": "Session friert ein", "a": "ctrl+c → neu starten. Prüfe ~/claude/.claude/logs/ für Fehler." }, |
| { "q": "Subagent antwortet nicht", "a": "60s timeout in CLAUDE.md. Prüfe seinen Output oder spawnne neuen." }, |
| { "q": "Sidecar-Injection funktioniert nicht", "a": "Prüfe hook_inject.py läuft, additionalContext wird in PreToolUse nicht unterdrückt." }, |
| { "q": "Context zu voll", "a": "/compact eingeben oder neue Session starten. Long-Context = Quality-Drop." }, |
| { "q": "Hook führt nichts aus", "a": "Prüfe: 1) Hook-Pfad existiert, 2) Datei ausführbar, 3) Interpreter-Pfad in Shebang." } |
| ] |
| }, |
| "powerUser": { |
| "level2": { |
| "title": "Config Mastery", |
| "configHierarchy": [ |
| { "file": "~/.claude/settings.json", "role": "Basis-Config: Modell, Permissions, Hooks. Wird versioniert." }, |
| { "file": "~/.claude/settings.local.json", "role": "Lokale Overrides — NICHT ins Git. Für Bash(*) und sensitive Permissions." }, |
| { "file": "~/.claude/CLAUDE.md", "role": "Globale Verhaltensregeln. Akkumulieren mit Projekt-CLAUDE.md — nicht überschreiben." }, |
| { "file": "<project>/CLAUDE.md", "role": "Projektspezifische Regeln. Höchste Priorität. Definiert Scope, Test-Strategie, Verbote." } |
| ], |
| "bashPermissions": [ |
| { "pattern": "Bash(git*)", "meaning": "Alle git-Befehle erlaubt" }, |
| { "pattern": "Bash(python3 /home/*)", "meaning": "python3 nur mit absolutem Pfad" }, |
| { "pattern": "Bash(*)", "meaning": "ALLES erlaubt — nur in settings.local.json, nie in settings.json" }, |
| { "pattern": "Bash(gh api*)", "meaning": "GitHub CLI API-Calls" }, |
| { "pattern": "Bash(npm*)", "meaning": "Alle npm-Befehle" } |
| ], |
| "attentionBudget": [ |
| { "rule": ">50 Regeln = Compliance-Drop", "detail": "Ab ~50 CLAUDE.md-Regeln sinkt die Regel-Einhaltung messbar. Weniger, schärfer ist besser." }, |
| { "rule": "Weniger > Mehr", "detail": "Weniger Regeln, scharf formuliert > viele Regeln, weich formuliert. Jede Regel konkurriert um Kontext." }, |
| { "rule": "CLAUDE.md ≠ Config-File", "detail": "Kein JSON, kein YAML — Aufmerksamkeitsbudget. Was nicht gelesen wird, wirkt nicht." }, |
| { "rule": "Projekt > Global", "detail": "project/CLAUDE.md überschreibt ~/.claude/CLAUDE.md bei Konflikten. Nutze das gezielt." } |
| ] |
| }, |
| "level3": { |
| "title": "Subagent & Cost Mastery", |
| "costTable": [ |
| { "action": "Kurze Analyse", "cost": "<$0.05", "tip": "Unter 2min — kein Subagent nötig" }, |
| { "action": "Codebase-Analyse (vollständig)", "cost": "~$0.20-0.50", "tip": "Sonnet-Subagent statt Opus direkt" }, |
| { "action": "Subagent-Wave (3 Agents)", "cost": "~$0.10-0.30", "tip": "Haiku für Background-Tasks: ~$0.25/1M" }, |
| { "action": "Session ohne Fokus (>1h)", "cost": "$1-3+", "tip": "ABBRECHEN — /compact oder neue Session" }, |
| { "action": "Opus direkt", "cost": "~$15/1M Tokens", "tip": "Nur für Architektur — nie für Recherche" }, |
| { "action": "Sonnet-Subagent", "cost": "~$3/1M Tokens", "tip": "5x günstiger als Opus — für Recherche + Code" } |
| ], |
| "subagentPatterns": [ |
| { "pattern": "run_in_background: true — IMMER", "description": "Hauptsession muss responsive bleiben. Kein Blocking. Pflicht bei run_in_background: true." }, |
| { "pattern": "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1", "description": "Aktiviert typisierte Subagents mit Frontmatter-Model-Override. 21 aktive Agent-Typen parallel ausführbar." }, |
| { "pattern": "Max 2-3 parallele Sessions", "description": "Mehr als 3 parallele Claude Code Sessions = Context-Chaos + doppelte Kosten. Hard Limit." }, |
| { "pattern": "Sonnet für Recherche, Opus für Architektur", "description": "Nie Opus für Websuche oder File-Lesen. Sonnet-Subagent reicht, spart 80% der Kosten." }, |
| { "pattern": "Lesen vor Spawn", "description": "Erst relevante Dateien selbst lesen. Subagent soll nicht Dinge herausfinden die schon bekannt sind." }, |
| { "pattern": "1 fehlgeschlagener Ansatz → STOPP", "description": "Nicht automatisch Ansatz 2 probieren. Samuel fragen. Zweiter autonomer Versuch löst Problem selten." } |
| ] |
| }, |
| "level4": { |
| "title": "Extension System", |
| "extensionTypes": [ |
| { "type": "Agent", "path": "~/.claude/agents/my-agent.md", "description": "Frontmatter mit name/model/tools/subagent_type + System-Prompt. Erbt alle aktiven Hooks." }, |
| { "type": "Skill", "path": "~/.claude/skills/my-skill/SKILL.md", "description": "Via /my-skill getriggert. Kontext-Injektion, kein Tool. Sidecar-NG nutzt Skills über Knowledge-Base-Paths." }, |
| { "type": "Command", "path": "~/.claude/commands/my-cmd.md", "description": "Via /my-cmd aufgerufen. Setzt Datei-Inhalt als System-Prompt. Verhält sich wie Slash-Command." }, |
| { "type": "Hook", "path": "~/.claude/hooks/my-hook.py", "description": "Bekommt JSON via stdin (tool, input, session_id). Exit 0 = erlaubt, non-zero = geblockt (nur PreToolUse)." }, |
| { "type": "Statusline", "path": "~/.claude/statusline.sh", "description": "Liest JSON von stdin (Context%, Token-Usage, Git-Branch, Hooks). ANSI-formatierte Ausgabe. Editierbar ohne Neustart." } |
| ], |
| "hookDeepDive": [ |
| { "name": "PreToolUse", "blocking": true, "knownBug": false, "detail": "Einzigartig: blockt Tool-Ausführung physisch. Kein anderer Harness hat das. Hook entscheidet ob Tool läuft.", "workaround": null }, |
| { "name": "UserPromptSubmit", "blocking": false, "knownBug": false, "detail": "additionalContext-Injection vor LLM-Call. Sidecar-NG nutzt diesen Hook für Prompt-Klassifikation.", "workaround": null }, |
| { "name": "SessionStart", "blocking": false, "knownBug": true, "detail": "Bug #13650: additionalContext wird verworfen. Hook läuft, aber Injection landet nicht beim LLM.", "workaround": "Injection über UserPromptSubmit statt SessionStart" }, |
| { "name": "Hook-Inheritance", "blocking": false, "knownBug": false, "detail": "Subagents erben ALLE Hooks — kein differenziertes Gate pro Agent möglich. Known Limitation.", "workaround": "Matcher in PreToolUse einschränken, z.B. nur auf Agent-Tool" }, |
| { "name": "Hook-Restart Required", "blocking": false, "knownBug": false, "detail": "Hook-Änderungen in settings.json erfordern Session-Neustart. Kein Hot-Reload.", "workaround": "Hook-Script selbst kann ohne Neustart editiert werden — nur settings.json-Änderungen erfordern Neustart" } |
| ], |
| "activeHooks": [ |
| { "name": "enforce-background-agents.py", "hook": "PreToolUse → Agent", "function": "Blockt Agent-Calls ohne run_in_background: true. Hält Hauptsession responsive." }, |
| { "name": "coach-before.sh", "hook": "SessionStart", "function": "Rotiert Playbook-Regeln, Streak-Counter, tägliche Fokus-Injection." }, |
| { "name": "event_logger.py", "hook": "alle Events", "function": "JSON-Telemetrie aller Tool-Calls. Datei: ~/.claude/events/YYYY-MM-DD.jsonl" }, |
| { "name": "gsd-context-monitor.js", "hook": "PostToolUse", "function": "Context-Window-Überwachung. Warnt bei >80% Auslastung." }, |
| { "name": "hook_inject.py (Sidecar-NG)", "hook": "UserPromptSubmit", "function": "Keyword-First → LLM-Fallback Klassifikation. Injiziert additionalContext für aktiven Mode/Skill." } |
| ] |
| } |
| } |
| }, |
| { |
| "id": "hermes", |
| "name": "Hermes", |
| "tagline": "Billig & Anpassungsfähig — das Arbeitspferd", |
| "status": "aktiv", |
| "color": "gold", |
| "data_complete": true, |
| "stats": [ |
| { "label": "Sessions", "value": "40+" }, |
| { "label": "Avg. Session", "value": "~20 min" }, |
| { "label": "Modell", "value": "MiniMax-M2.5" } |
| ], |
| "strengths": [ |
| "MiniMax ~150x billiger als Opus — fuer Routineaufgaben", |
| "10 Provider, 200+ Modelle via OpenRouter", |
| "Beste Feedback-Annahme — Korrekturen werden direkt akzeptiert", |
| "48 eingebaute Tools (Web, Browser, Vision, SmartHome)", |
| "Git Worktrees fuer parallele, isolierte Tasks" |
| ], |
| "weaknesses": [ |
| "Scope-Drift: Baut standardmaessig in ~/.hermes/ wenn cwd nicht gesetzt", |
| "Langsamer Start: 10-15s Stille vor erster Response — normal, nicht abbrechen", |
| "Output-Qualitaet mittel: funktional aber nicht elegant", |
| "Kein CLAUDE.md-Aequivalent: SOUL.md aktuell leer", |
| "Kein PreToolUse-Blocking: keine programmatische Verhaltenssteuerung" |
| ], |
| "architecture_link": "diagrams/architecture-hermes.html", |
| "router_keywords": ["build", "implement", "feature", "frontend", "backend", "api", "günstig", "iterati", "docs", "dokumentation", "research", "schreib"], |
| "router_reason": "50x günstiger als Opus. Self-Improvement ersetzt deine Meta-Arbeit. Wenn du weißt WAS du willst — bau es hier.", |
| "router_wave": "Wave 2 — Build", |
| "tutorial": { |
| "quickStart": [ |
| "IMMER zuerst: `cd ~/Projekte/Projekt` — Hermes baut sonst in ~/.hermes/", |
| "Starte: `hermes chat` (15s Stille am Anfang = normal, nicht abbrechen)", |
| "Modell waehlen: `hermes chat -m minimax/minimax-text-01` fuer guenstige Runs", |
| "Verzeichnis-Check: 'Bestätige in welchem Verzeichnis du arbeitest'", |
| "Tasksheet einfuegen — Scope, Output-Pfad, Constraints klar", |
| "Feedback geben — konkret und praezise. Hermes akzeptiert Korrekturen direkt.", |
| "Feature by Feature iterieren, Summary fuer Handoff an Codex" |
| ], |
| "adhsPatterns": { |
| "bodyDoubling": "Pair-Programming-Feeling. CLI oder Telegram — offen lassen, nicht killen. Ich rede waehrend du zuloeschst.", |
| "dopaminTrigger": "Iteratives Feedback gibt immediate gratification. Kleine Korrektur, sofort sichtbarer Erfolg. Nicht alles auf einmal.", |
| "antiParalysis": "Feature by Feature. Kleine Schritte die ich abschliessen kann. Scope-Drift ist teurer als tiny Tasks.", |
| "sessionRhythm": "15s Stille am Anfang ist normal. Geduld. Iterationen sind billig — nich neu starten wenn etwas falsch ist." |
| }, |
| "wellenmodus": { |
| "role": "Output-Bauer (Wave 2)", |
| "entry": "Wenn Claude Code einen Plan hat und Tasksheet existiert", |
| "exit": "Summary an Codex fuer Polishing oder fertig wenn keine Qualitaetsanspruch" |
| }, |
| "handoff": { |
| "toOpenCode": "Reality-Check mit frischem Blick — was hat Hermes gebaut das suboptimal ist?", |
| "toCodex": "Summary: Geaenderte Dateien, implementierte Features, offene TODOs. Codex Polishing machen lassen." |
| }, |
| "architektur": { |
| "annotations": [ |
| { "component": "config.yaml", "description": "Haupt-Config (YAML). 284 Zeilen — alle Einstellungen." }, |
| { "component": "SOUL.md", "description": "Agent-Personality, freier Text. Aktuell leer — Potenzial ungenutzt." }, |
| { "component": "10 Provider", "description": "MiniMax, OpenRouter (200+ Modelle), Anthropic, OpenAI, Gemini, Custom Endpoints." }, |
| { "component": "48 Tools", "description": "Web, Terminal, Vision, Browser, SmartHome — ohne MCP-Server." }, |
| { "component": "Git Worktrees", "description": "Parallele isolierte Agents auf demselben Repo. Merge danach manuell." } |
| ] |
| }, |
| "config": { |
| "settingsKeys": [ |
| { "key": "default_model", "type": "string", "default": "MiniMax-M2.5", "description": "Default-Modell" }, |
| { "key": "default_provider", "type": "string", "default": "minimax", "description": "Default-Provider" }, |
| { "key": "agent.reasoning_effort", "type": "string", "default": "medium", "description": "low | medium | high — mehr Tokens bei high" }, |
| { "key": "terminal.backend", "type": "string", "default": "local", "description": "local | docker | ssh | modal — wo Code ausgefuehrt wird" }, |
| { "key": "terminal.cwd", "type": "string", "default": ".", "description": "Working Directory — ~/.hermes wenn nicht gesetzt" }, |
| { "key": "memory.enabled", "type": "boolean", "default": "true", "description": "Cross-Session Memory via Honcho AI" }, |
| { "key": "compression.enabled", "type": "boolean", "default": "true", "description": "Context-Kompression fuer lange Sessions" } |
| ], |
| "hooks": [ |
| { "name": "gateway:startup", "description": "Beim Gateway-Start. Logging, Init.", "canBlock": false }, |
| { "name": "session:start", "description": "Bei neuer Session. Worktree-Setup.", "canBlock": false }, |
| { "name": "agent:start", "description": "Vor erstem Agent-Turn.", "canBlock": false }, |
| { "name": "session:reset", "description": "Bei Session-Reset. Cleanup.", "canBlock": false } |
| ] |
| }, |
| "faq": [ |
| { "q": "Session startet nicht", "a": "15s warten. Dann Enter druecken. Das ist normal — nicht abbrechen und neu starten." }, |
| { "q": "Baut am falschen Ort", "a": "IMMER zuerst cd in Projektordner. Tasksheet muss Output-Pfad enthalten." }, |
| { "q": "Output-Qualitaet mittel", "a": "Normal. Hermes ist funktional, nicht elegant. Polishing by Codex." }, |
| { "q": "Keine Verhaltensregeln", "a": "SOUL.md ist leer. Fuer strukturierte Regeln: SOUL.md befuellen (kommt noch)." }, |
| { "q": "Workflow mit Claude Code", "a": "Plan Mode in CC → Tasksheet schreiben → hermes chat → Summary → Codex Polishing." } |
| ] |
| } |
| }, |
| { |
| "id": "opencode", |
| "name": "OpenCode", |
| "tagline": "Schlankes Agentic Coding Tool", |
| "status": "aktiv", |
| "color": "green", |
| "data_complete": true, |
| "stats": [ |
| { "label": "Sessions", "value": "50+" }, |
| { "label": "Avg. Session", "value": "~15 min" }, |
| { "label": "Modell", "value": "MiniMax / Claude Sonnet" } |
| ], |
| "strengths": [ |
| "Multi-Provider: Anthropic, OpenAI, MiniMax ohne Lock-in", |
| "One-Shot Mode für schnelle Pipelines", |
| "Parallele Instanzen ohne Konflikte", |
| "MCP native Support ohne JSON-Editierung", |
| "Headless Server für API-Integration" |
| ], |
| "weaknesses": [ |
| "Fragt NICHT nach — unvollständiges Briefing führt zu falschem Output", |
| "Scope-Drift ohne explizites Scope-Statement", |
| "Kein Session-Gedächtnis zwischen opencode run-Aufrufen", |
| "Feedback-Reparatur schwach — Korrekturen werden bestätigt aber nicht integriert", |
| "Keine Subagent-Orchestrierung" |
| ], |
| "architecture_link": "diagrams/architecture-opencode.html", |
| "router_keywords": ["bugfix", "bug", "fix", "fehler", "debug", "isoliert", "schnell", "provider", "lsp"], |
| "router_reason": "LSP Pre-fetch liefert Kontext bevor du fragst. Für isolierte Bugs ohne den Overhead von Claude Code.", |
| "router_wave": "Wave 2 — Build (Alternative)", |
| "tutorial": { |
| "quickStart": [ |
| "Starte mit: `opencode` (TUI) oder `opencode run \"prompt\"` (one-shot)", |
| "Im Projektordner starten: `cd ~/Projekte/MeinProjekt`", |
| "Erstes: `Lies ARCHITECTURE.md` — Was hat Claude Code geplant?", |
| "Scope explizit machen: Output-Pfad + Umfang in einem Satz", |
| "Bauen oder Reality-Check — one-shot für Drafts, TUI für komplexe Tasks", |
| "Ergebnis dokumentieren — was wurde gebaut, was weggelassen, warum" |
| ], |
| "adhsPatterns": { |
| "bodyDoubling": "TUI-Session fühlt sich wie Pair-Programming an. Offen lassen, nicht wegdiskutieren. Ich rede während du baust.", |
| "dopaminTrigger": "Schneller Output in <30s. One-shot für immediate gratification — Draft wegwerfen ist billig, nicht frustrierend.", |
| "antiParalysis": "Kurzes Briefing, schneller Re-Run. Billig = Experimentieren erlaubt. Lieber 2min laenger briefen als zweiten Run.", |
| "sessionRhythm": "One-shots statt Marathon. Max 3 Runs pro Task, dann reflektieren. Nicht in Loop verlieren." |
| }, |
| "wellenmodus": { |
| "role": "Reality-Check & Schnell-Builder", |
| "entry": "Wenn Claude Code einen Plan hat und du schnelle Validierung brauchst", |
| "exit": "Ergebnis an Hermes für Implementierung oder Bestätigung dass Plan stimmt" |
| }, |
| "handoff": { |
| "toHermes": "Dateistruktur + validierten Plan. Kontext immer mitgeben.", |
| "toCodex": "Refactor-Task mit Before/After-Beschreibung. Sandbox macht sicheres Bulk-Edit." |
| }, |
| "architektur": { |
| "annotations": [ |
| { "component": "opencode run", "description": "One-shot Execution ohne TUI. Für Pipelines und schnelle Drafts." }, |
| { "component": "opencode serve", "description": "Headless HTTP-Server für API-Integration." }, |
| { "component": "Multi-Provider", "description": "anthropic, openai, minimax. MiniMax ~150x billiger als Opus." }, |
| { "component": "Plugins (TS)", "description": "TypeScript Hooks für Context-Injection. experimental.chat.system.transform." }, |
| { "component": "MCP-Server", "description": "Native CLI-Verwaltung: opencode mcp add/remove/list." } |
| ] |
| }, |
| "config": { |
| "settingsKeys": [ |
| { "key": "provider", "type": "object", "description": "API-Keys für Provider (anthropic, openai, minimax)" }, |
| { "key": "model.default", "type": "string", "default": "anthropic/claude-sonnet-4-5", "description": "Default-Modell" }, |
| { "key": "model.fast", "type": "string", "default": "anthropic/claude-haiku-4-5", "description": "Schnelles Modell für einfache Tasks" }, |
| { "key": "permission", "type": "string", "default": "ask", "description": "ask | auto-edit | allow — für headless: allow" }, |
| { "key": "mcp", "type": "object", "description": "MCP-Server Config (filesystem, github, etc.)" }, |
| { "key": "experimental.chat.system.transform", "type": "string", "description": "Plugin-Path für Context-Injection" } |
| ], |
| "hooks": [ |
| { "name": "system.transform", "description": "TypeScript-Hook für System-Prompt Modifikation. Injiziert CLAUDE.md-ähnliche Regeln.", "canBlock": false }, |
| { "name": "postResponse", "description": "Nach Response — für Syntax-Check, Narration-Dispatch.", "canBlock": false }, |
| { "name": "onError", "description": "Bei Error — Error-Pattern-Analyse und Kontext-Return.", "canBlock": false } |
| ] |
| }, |
| "faq": [ |
| { "q": "Session blockiert", "a": "ctrl+c zum Beenden. Bei headless: permission: allow in opencode.json setzen." }, |
| { "q": "Baut das Falsche", "a": "Re-Run mit explizitem Scope. Nicht 'nochmal' sagen — genau beschreiben was ANDERS." }, |
| { "q": "Kein Gedächtnis", "a": "Kontext immer mitgeben. Nichts voraussetzen. Jeder run startet blank." }, |
| { "q": "Plugin funktioniert nicht", "a": "experimental.chat.system.transform in opencode.json prüfen. Pfad muss stimmen." }, |
| { "q": "Dashboard statt Website", "a": "Immer explizit: 'Admin-Dashboard, nicht Landing Page. Keine Hero-Section.'" } |
| ] |
| } |
| }, |
| { |
| "id": "codex-cli", |
| "name": "Codex CLI", |
| "tagline": "Verify-, Review- und Polishing-Harness fuer den letzten Meter", |
| "status": "aktiv", |
| "color": "amber", |
| "data_complete": true, |
| "stats": [ |
| { "label": "Sessions", "value": "40+" }, |
| { "label": "Avg. Session", "value": "~20 min" }, |
| { "label": "Modell", "value": "gpt-5.4" } |
| ], |
| "strengths": [ |
| "Saubere Scope-Begrenzung durch Sandbox + Approval-Policy", |
| "Starker Review-Workflow mit `codex review`", |
| "Rigorose Rueckfragen vor riskanten Implementierungen", |
| "Terminal-nahe Edits, Refactors und Batch-Operationen", |
| "Runbooks fuer Planning, Build, Inspect und Review" |
| ], |
| "weaknesses": [ |
| "Langsamer Start wenn das Repo erst gelesen werden muss", |
| "Kein Hook-System wie bei Claude Code", |
| "Wenig Selbstkritik — Review und Tests weiter selbst einfordern", |
| "Nicht der beste ROI fuer offene Exploration oder Research", |
| "OpenAI-locked, kein Multi-Provider-Setup" |
| ], |
| "architecture_link": "diagrams/architecture-codex-cli.html", |
| "router_keywords": ["test", "tests", "verif", "review", "polish", "polieren", "refactor", "rename", "bulk", "migrat", "sandbox", "batch", "aufräum", "cleanup", "quality", "stabil", "ship"], |
| "router_reason": "Codex ist dein Finish-Harness: Sandbox und Approval halten den Scope eng, Rueckfragen reduzieren Fehlannahmen und `codex review` macht den letzten Qualitaetscheck.", |
| "router_wave": "Wave 3 — Verify" |
| , |
| "tutorial": { |
| "quickStart": [ |
| "Starte interaktiv mit `codex` direkt im Projektordner wenn der Task noch Rueckfragen braucht", |
| "Nutze `codex exec \"PROMPT\"` fuer klare Einzelaufgaben wie Type Hints, Refactors oder Tests", |
| "Setze fuer sichere Alltagsarbeit `-s workspace-write -a on-request` oder den Shortcut `--full-auto`", |
| "Verwende `codex review` vor jedem Ship-Kandidaten als Pflichtschritt, nicht als Bonus", |
| "Wenn ein guter Zwischenstand existiert: `codex resume --last` fortsetzen oder `codex fork --last` fuer riskante Varianten" |
| ], |
| "adhsPatterns": { |
| "bodyDoubling": "Codex ist weniger conversational als Claude Code, aber stark wenn der Auftrag klar gerahmt ist. Nutze ihn als ruhigen Co-Worker fuer den Finish-Pass: ein Ziel, ein Scope, ein sauberer Abschluss.", |
| "dopaminTrigger": "Sichtbare Mini-Wins funktionieren gut: erst `codex review`, dann ein enger Fix, dann direkt Tests oder Smoke-Checks. Kurze, abgeschlossene Schleifen halten Momentum ohne Scope-Explosion.", |
| "antiParalysis": "Wenn du festhaengst, nicht 'mach es besser' sagen. Gib Codex ein enges Paket: Datei, Ziel, Definition of Done und was explizit out of scope ist.", |
| "sessionRhythm": "Codex nicht als Marathon-Session benutzen. Erst Planung oder Build woanders, dann 15 bis 25 Minuten Finish-Phase: Review, Polishing, Verifikation, Handoff." |
| }, |
| "wellenmodus": { |
| "role": "Verifier & Finisher", |
| "entry": "Wenn ein Feature bereits gebaut ist und jetzt Review, Polishing, Tests oder Scope-sichere Refactors anstehen", |
| "exit": "Ship-Entscheidung mit Findings, offenen Punkten und konkreter Empfehlung an Samuel" |
| }, |
| "handoff": { |
| "toHermes": "Wenn waehrend des Polishings klar wird dass neue Funktionalitaet fehlt oder ein groesserer Umbau noetig ist.", |
| "toOpenCode": "Wenn ein isolierter Build-Task schneller als one-shot oder in parallelen kleinen Runs gebaut werden kann.", |
| "toSamuel": "Review-Ergebnis, behobene Punkte, verbleibende Risiken und eine klare Ship-Empfehlung: JA oder NEIN." |
| }, |
| "architektur": { |
| "annotations": [ |
| { "component": "config.toml", "description": "Zentrale Steuerung fuer Modell, Reasoning, Trust-Level und Modell-Migrationen." }, |
| { "component": "Runbooks", "description": "Vier Session-Typen strukturieren die Arbeit: build, planning, review und inspect." }, |
| { "component": "Sandbox Mode", "description": "Bestimmt die Umgebung: read-only, workspace-write oder danger-full-access." }, |
| { "component": "Approval Policy", "description": "Legt fest wann Rueckfragen kommen: untrusted, on-request, on-failure oder never." }, |
| { "component": "codex review", "description": "Eingebauter Review-Modus fuer uncommitted Changes, Branch-Diffs oder einzelne Commits." } |
| ] |
| }, |
| "config": { |
| "settingsHeading": "Config / CLI Keys", |
| "hooksHeading": "Runbooks", |
| "settingsKeys": [ |
| { "key": "model", "type": "string", "default": "gpt-5.4", "description": "Standardmodell fuer interaktive Sessions und exec-Runs" }, |
| { "key": "model_reasoning_effort", "type": "string", "default": "medium", "description": "Reasoning-Tiefe: low, medium, high oder xhigh" }, |
| { "key": "projects.<path>.trust_level", "type": "string", "default": "trusted", "description": "Projektbezogene Vertrauenseinstufung fuer Rechte und Verhalten" }, |
| { "key": "notice.model_migrations", "type": "table", "description": "Leitet veraltete Modellnamen auf aktuelle Modelle um" }, |
| { "key": "sandbox_mode", "type": "flag", "default": "workspace-write", "description": "Praktisch via CLI-Flag gesetzt: read-only, workspace-write oder danger-full-access" }, |
| { "key": "approval_policy", "type": "flag", "default": "on-request", "description": "Praktisch via CLI-Flag gesetzt: untrusted, on-request, on-failure oder never" } |
| ], |
| "hooks": [ |
| { "name": "planning.md", "description": "Runbook fuer unscharfe Ziele und Architekturarbeit. Erst artefaktfaehig machen, dann bauen.", "canBlock": false }, |
| { "name": "build.md", "description": "Runbook fuer klar umrissene Implementierung mit stabilem Outcome.", "canBlock": false }, |
| { "name": "inspect.md", "description": "Read-only Exploration zum Verstehen einer Codebase ohne Edits.", "canBlock": false }, |
| { "name": "review.md", "description": "Qualitaets- und Regressionsfokus fuer Review-Paesse vor dem Ship.", "canBlock": false } |
| ] |
| }, |
| "faq": [ |
| { "q": "Warum stellt Codex so viele Rueckfragen?", "a": "Weil es Fehlannahmen vor dem Edit reduziert. Gerade bei Review-, Refactor- und Finish-Aufgaben spart das Re-Work." }, |
| { "q": "Wann nutze ich `codex review`?", "a": "Immer vor einem Ship-Kandidaten und immer dann, wenn Codex selbst etwas veraendert hat. Review ist Pflichtschritt, nicht optional." }, |
| { "q": "Welcher Sandbox-Modus ist alltagstauglich?", "a": "Meist `workspace-write` mit `on-request`. Fuer Analyse `read-only`, fuer riskante Vollautonomie nur in bekannten, stabilen Situationen mehr." }, |
| { "q": "Wofuer ist Codex die falsche Wahl?", "a": "Offene Exploration, Research und grobe Produktentscheidungen. Dafuer erst Claude Code oder Hermes nutzen und Codex spaeter fuer Finish und Verify einsetzen." }, |
| { "q": "Was wenn waehrend des Polishings neuer Scope auftaucht?", "a": "Nicht heimlich mitbauen. Findings dokumentieren und den Task zur passenden Build- oder Plan-Phase zurueckgeben." } |
| ] |
| } |
| } |
| ], |
| "architecture_diagrams": [ |
| { |
| "name": "Claude Code", |
| "link": "diagrams/architecture-claude-code.html", |
| "description": "Hub-and-Spoke Architektur mit Sidecar-NG Integration" |
| }, |
| { |
| "name": "Hermes", |
| "link": "diagrams/architecture-hermes.html", |
| "description": "Multi-Provider Gateway mit SOUL.md und Personality-System" |
| }, |
| { |
| "name": "Codex CLI", |
| "link": "diagrams/architecture-codex-cli.html", |
| "description": "Terminal-native Pipeline mit Sandbox-Execution" |
| }, |
| { |
| "name": "OpenCode", |
| "link": "diagrams/architecture-opencode.html", |
| "description": "Modulares Open-Source Coding Agent Framework" |
| } |
| ], |
| "laws": [ |
| { |
| "number": 1, |
| "title": "Kontext ist alles", |
| "text": "Ohne sauberen Kontext liefert jedes Modell Mittelwert-Output. CLAUDE.md, Sidecar und Skill-Injektion sind keine Extras — sie sind der Job.", |
| "beweis": "Sessions ohne Sidecar produzieren messbar mehr Korrekturen", |
| "color": "teal" |
| }, |
| { |
| "number": 2, |
| "title": "Verifikation vor Commit", |
| "text": "Code Review allein zaehlt nicht. Tests laufen oder es ist nicht fertig.", |
| "beweis": "Jeder 'fast fertig'-Commit ohne Tests hat Folge-Fixes erzeugt", |
| "color": "green" |
| }, |
| { |
| "number": 3, |
| "title": "Atomare Commits", |
| "text": "Eine logische Aenderung pro Commit. Was nicht in einen Satz passt, gehoert in zwei Commits.", |
| "beweis": "Grosse Commits blockieren Rollbacks und verwischen Kausalitaet", |
| "color": "gold" |
| }, |
| { |
| "number": 4, |
| "title": "Fragen ist schneller als Irren", |
| "text": "Wenn der Agent unsicher ist, fragt er. Eine Rueckfrage kostet 10 Sekunden. Falsches Abbiegen kostet 10 Minuten.", |
| "beweis": "Sidecar Intent-First-Regel reduziert Out-of-Scope-Aenderungen", |
| "color": "teal" |
| }, |
| { |
| "number": 5, |
| "title": "Parallelitaet beats Sequenz", |
| "text": "Unabhaengige Tasks werden gleichzeitig ausgefuehrt. Subagents sind die Einheit, nicht Prompts.", |
| "beweis": "Parallele Subagent-Runs reduzieren Gesamtzeit um ~60%", |
| "color": "amber" |
| }, |
| { |
| "number": 6, |
| "title": "Scope-Disziplin", |
| "text": "Was nicht explizit beauftragt ist, wird nicht gemacht. Keine spontanen Refactors, keine Erweiterungen.", |
| "beweis": "Scope-Creep ist die haeufigste Ursache fuer lange Review-Zyklen", |
| "color": "red" |
| }, |
| { |
| "number": 7, |
| "title": "Exploration Budget", |
| "text": "Ein fehlgeschlagener Ansatz, dann Stop und fragen. Nicht automatisch Ansatz 2 probieren.", |
| "beweis": "Zweiter autonomer Ansatz loest das Problem selten, kostet aber immer Context", |
| "color": "amber" |
| }, |
| { |
| "number": 8, |
| "title": "Stabilisierung vor Neubau", |
| "text": "Bugs werden als Patches geloest, nicht als Rewrites. Backlog schlaegt Goldplating.", |
| "beweis": "Rewrites ohne Testbaseline reproducieren 40% der alten Bugs", |
| "color": "gold" |
| }, |
| { |
| "number": 9, |
| "title": "Deutsche Kommunikation, englische Commits", |
| "text": "Conventional Commits auf Englisch. Alles andere in der Sprache des Kontexts.", |
| "beweis": "Konsistenz in Commit-History erleichtert Changelog-Generierung", |
| "color": "muted" |
| }, |
| { |
| "number": 10, |
| "title": "Evidence vor Bauchgefuehl", |
| "text": "Kein Feature, keine Entscheidung ohne Datenbasis. Evals, Logs, Tests — nicht Intuition.", |
| "beweis": "Sidecar-NG Accuracy-Messungen zeigten kontra-intuitive Ergebnisse mehrfach", |
| "color": "teal" |
| } |
| ], |
| "anti_patterns": [ |
| { |
| "name": "Ambiguous Target", |
| "description": "Task starten ohne zu klaeren welches Projekt, welche Komponente, welches Konzept gemeint ist.", |
| "folge": "30 Minuten Arbeit in die falsche Richtung", |
| "severity": "hoch" |
| }, |
| { |
| "name": "Blind Agent Trust", |
| "description": "Subagent-Output nicht verifizieren und direkt als erledigt markieren.", |
| "folge": "Stille Regressionen, die erst Tage spaeter auffallen", |
| "severity": "kritisch" |
| }, |
| { |
| "name": "Big Bang Commit", |
| "description": "Alles in einem Commit, weil 'gehoert zusammen'.", |
| "folge": "Unkontrollierbarer Rollback, verlorene Kausalitaet", |
| "severity": "hoch" |
| }, |
| { |
| "name": "Config-Halluzination", |
| "description": "Keys in Konfigurationsdateien schreiben die dort nicht existieren.", |
| "folge": "Stille Fehler oder Runtime-Crashes", |
| "severity": "hoch" |
| }, |
| { |
| "name": "Scope Creep", |
| "description": "Waehrend X implementieren auch Y und Z refactoren weil man gerade dabei ist.", |
| "folge": "Review-Aufwand verdoppelt, Rollback unmoeglich", |
| "severity": "mittel" |
| }, |
| { |
| "name": "Guessing without Asking", |
| "description": "Bei Unklarheit raten statt eine Rueckfrage zu stellen.", |
| "folge": "Meistens falsche Richtung, immer Zeitverlust", |
| "severity": "hoch" |
| }, |
| { |
| "name": "Retry Loop ohne Diagnose", |
| "description": "Nach fehlgeschlagenem Test denselben Ansatz nochmal versuchen.", |
| "folge": "Exponentiell steigende Context-Kosten, gleiche Fehler", |
| "severity": "mittel" |
| }, |
| { |
| "name": "Commit ohne Tests", |
| "description": "Commit-Vorschlag ohne eigene Verifikation dass Tests gruen sind.", |
| "folge": "Samuel gibt Freigabe auf der Basis falscher Annahmen", |
| "severity": "kritisch" |
| } |
| ], |
| "wave_mode": { |
| "kicker": "So arbeite ich", |
| "heading": "Wellenmodus", |
| "description": "Jede produktive Session folgt dem gleichen Muster: Scout, Build, Verify — mit klaren Convergence-Checkpoints.", |
| "phases": [ |
| { |
| "id": "scout", |
| "name": "Scout", |
| "description": "Kontext aufbauen. Ziel klaeren. Ambiguitaeten eliminieren bevor Code geschrieben wird.", |
| "steps": ["git status pruefen", "Relevante Dateien lesen", "Ziel mit Samuel abgleichen", "Teilaufgaben identifizieren"], |
| "color": "teal" |
| }, |
| { |
| "id": "build", |
| "name": "Build", |
| "description": "Parallele Subagents fuer unabhaengige Tasks. Atomare Aenderungen. Scope-Disziplin.", |
| "steps": ["Subagents spawnen fuer parallele Arbeit", "Jede Aenderung atomar halten", "Scope nicht erweitern", "Fehler sofort eskalieren"], |
| "color": "gold" |
| }, |
| { |
| "id": "verify", |
| "name": "Verify", |
| "description": "Tests ausfuehren. Output verifizieren. Commit erst nach gruenem Signal.", |
| "steps": ["pytest / smoke-tests laufen", "Agent-Output selbst pruefen", "Commit-Gate: Samuel entscheidet", "Ergebnis dokumentieren"], |
| "color": "green" |
| } |
| ], |
| "checkpoints": [ |
| "Nach Scout: Ziel ist schriftlich klar", |
| "Nach Build: Tests existieren fuer jede Aenderung", |
| "Nach Verify: Samuels Commit-Freigabe" |
| ] |
| }, |
| "costs": { |
| "kicker": "Was kostet was", |
| "heading": "Kostenvergleich", |
| "harnesses": [ |
| { |
| "name": "Claude Code", |
| "model": "claude-opus-4-6", |
| "cost_per_session": "~$0.80-3.00", |
| "cost_relative": 100, |
| "billing": "Token-basiert", |
| "notes": "Hoechste Qualitaet, hoechste Kosten. Subagents multiplizieren." |
| }, |
| { |
| "name": "Hermes", |
| "model": "TBD", |
| "cost_per_session": "TBD", |
| "cost_relative": 0, |
| "billing": "TBD", |
| "notes": "Daten nach Bootcamp verfuegbar" |
| }, |
| { |
| "name": "OpenCode", |
| "model": "Konfigurierbar", |
| "cost_per_session": "Modell-abhaengig", |
| "cost_relative": 60, |
| "billing": "Token-basiert via Provider", |
| "notes": "Open-Source, Kosten haengen vom konfigurierten Modell ab" |
| }, |
| { |
| "name": "Codex CLI", |
| "model": "gpt-5.4", |
| "cost_per_session": "~$0.20-0.60", |
| "cost_relative": 25, |
| "billing": "Token-basiert (OpenAI)", |
| "notes": "Mittelpreisig, aber stark fuer Review, Polishing und verifizierte Terminal-Tasks" |
| } |
| ] |
| } |
| } |
|
|
