Understand before you build. A minimal, framework-agnostic architecture for personal AI agent systems.Verstehen, bevor du baust. Eine minimale, Framework-unabhängige Architektur für persönliche KI-Agent-Systeme.
New to agent systems? Start with the free Agent Literacy Course — no code required.Neu bei Agent-Systemen? Starte mit dem kostenlosen Agent Literacy Kurs — kein Code erforderlich.
146 skills. 72 plugins. 26 slash commands. Most starter kits give you tools. This one gives you understanding — the architecture of a real agent system that's been running in production since early 2026.146 Skills. 72 Plugins. 26 Slash-Befehle. Die meisten Starter-Kits geben dir Werkzeuge. Dieses hier gibt dir Verständnis — die Architektur eines echten Agent-Systems, das seit Anfang 2026 produktiv läuft.
Built by an engineer who runs this system daily — including the mistakes. See FAILURES.md.Entwickelt von einem Ingenieur, der dieses System täglich nutzt — einschließlich der Fehler. Siehe FAILURES.md.
SOUL.md — Who is this agent? Name, personality, language, hard boundaries.SOUL.md — Wer ist dieser Agent? Name, Persönlichkeit, Sprache, klare Grenzen.
AGENTS.md — How does it act? Skill routing, delegation rules, feedback loops.AGENTS.md — Wie handelt er? Skill-Routing, Delegationsregeln, Feedbackschleifen.
memory/ — What does it remember? Daily notes, long-term context, learned rules.memory/ — Woran erinnert es sich? Tägliche Notizen, Langzeitkontext, gelernte Regeln.
skills/ — What can it do? Reusable instruction files the agent follows on demand.skills/ — Was kann es tun? Wiederverwendbare Anweisungsdateien, denen der Agent bei Bedarf folgt.
| This KitDieses Kit | wshobson/agents | Decipherist | |
|---|---|---|---|
| PhilosophyPhilosophie | Understand firstZuerst verstehen | Plugin catalogPlugin-Katalog | Project scaffoldProjektgerüst |
| FilesDateien | ~15 markdown~15 Markdown | 300+ | 50+ |
| DependenciesAbhängigkeiten | NoneKeine | NoneKeine | NoneKeine |
| Multi-Agent | ✅ Exchange | ❌ | ❌ |
| Provider lock-inAnbieter-Bindung | NoneKeine | Claude Code | Claude Code |
| Skills includedEnthaltene Skills | 3 examples3 Beispiele | 146+ | 10+ |
| Failure docsFehler-Doku | ✅ Real storiesEchte Geschichten | ❌ | ❌ |
One agent can't do everything well. A research agent needs time and context. A coding agent needs speed and precision. An always-on agent handles cron jobs while you sleep. Splitting responsibilities makes each agent better — and the Exchange pattern lets them collaborate without a framework.Ein Agent allein kann nicht alles gut machen. Ein Recherche-Agent braucht Zeit und Kontext. Ein Programmier-Agent braucht Geschwindigkeit und Präzision. Ein Always-on-Agent erledigt Cron-Jobs, während du schläfst. Die Aufteilung der Verantwortlichkeiten macht jeden Agent besser – und das Exchange-Muster lässt sie ohne ein Framework zusammenarbeiten.
Two agents share a Git repo. They communicate via markdown files — signals, questions, responses. Asynchronous, auditable, version-controlled.Zwei Agents teilen sich ein Git-Repository. Sie kommunizieren über Markdown-Dateien – Signale, Fragen, Antworten. Asynchron, prüfbar, versioniert.
🔬 Research + Review:Recherche + Prüfung: Agent A researches, Agent B reviews and challenges findingsAgent A recherchiert, Agent B prüft und hinterfragt die Ergebnisse
🌙 Day + Night:Tag + Nacht: Cron agent works overnight, interactive agent picks up results in the morningEin Cron-Agent arbeitet über Nacht, der interaktive Agent greift die Ergebnisse am Morgen auf
🔍 Build + Audit:Entwickeln + Prüfen: One agent writes code, another runs quality checksEin Agent schreibt Code, ein anderer führt Qualitätsprüfungen durch
See a real exchange session →Eine echte Exchange-Sitzung ansehen → · Deep dive →Mehr dazu →
The architecture is the starting point. These pages cover the questions that come next.Die Architektur ist der Ausgangspunkt. Diese Seiten behandeln die Fragen, die als Nächstes kommen.
Claude Code is a tool. An agent system is a teammate. Persistence, hooks, skills, and why it matters.Claude Code ist ein Werkzeug. Ein Agent-System ist ein Teamkollege. Persistenz, Hooks, Skills und warum das wichtig ist.
Read →Lesen →When to delegate, when not to. The 2×2 matrix, five patterns, the trust ladder.Wann man delegieren sollte und wann nicht. Die 2×2-Matrix, fünf Muster, die Vertrauensleiter.
Read →Lesen →Where agents run. Hardware, platforms, costs, local vs cloud models, sovereign AI.Wo Agents laufen. Hardware, Plattformen, Kosten, lokale vs. Cloud-Modelle, souveräne KI.
Read →Lesen →Multi-agent collaboration via Git. 4 use cases, limitations, 5-minute setup.Multi-Agent-Kollaboration über Git. 4 Anwendungsfälle, Einschränkungen, 5-Minuten-Einrichtung.
Read →Lesen →30 min. Read the files. The architecture is the lesson.30 Min. Lies die Dateien. Die Architektur ist die Lektion.
30 min. Clone, personalize, connect to any LLM platform.30 Min. Klonen, personalisieren, mit jeder LLM-Plattform verbinden.
2 hours. Follow the Agent Literacy Course with this as companion.2 Stunden. Folge dem Agent Literacy Kurs mit diesem Kit als Begleiter.
Nav buttons disappeared. Closing tags were silently removed. Lesson: Always verify HTML balance after batch operations.Navigations-Buttons verschwanden. Schließende Tags wurden lautlos entfernt. Lektion: Überprüfe nach Stapelverarbeitungen immer die HTML-Balance.
Confident and wrong. The citation looked correct. It wasn't. Lesson: Always verify citations independently.Selbstbewusst und falsch. Das Zitat sah korrekt aus. War es aber nicht. Lektion: Überprüfe Zitate immer unabhängig.
3 weeks of automated tasks. Monthly bill: 3× the budget. Nobody noticed because cron jobs run silently. Lesson: Set spending limits BEFORE you automate.3 Wochen automatisierte Aufgaben. Monatsrechnung: 3x das Budget. Niemand hat es bemerkt, weil Cron-Jobs im Hintergrund laufen. Lektion: Setze Ausgabenlimits, BEVOR du automatisierst.