Open-Source-Projekt
ayghri/i-have-adhd avatar
ayghri/i-have-adhd

i-have-adhd: Coding-Agenten zur Antwort führen statt zur Ausschweifung

Eine Fähigkeit für Ihren Programmieragenten, die verhindert, dass er die Antwort verbirgt. ADHS-freundliche Ausgabe.

46.117 Sterne2.679 ForksPythonMIT
GitHub

Auf einen Blick

Was ist das?
Ein Skill für Coding-Agenten mit 10 Regeln: Aktion zuerst, Schritte nummeriert, keine Floskeln. Installierbar für Claude Code und Codex, anpassbar über einen Fork von SKILL.md.
Für wen ist es gedacht?
i-have-adhd passt für alle, die mit Coding-Agenten arbeiten und kurze, aktionsorientierte Antworten wollen, insbesondere Nutzer mit ADHS, für die lange Begründungsketten eine Hürde sind. Wer ausführliche Analysen und Kontext schätzt, wird die Regeln als Verlust empfinden.
Darf ich es kommerziell nutzen?
Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
Wird es noch gepflegt?
Ja. Die letzten Commits kamen vor 2 Tagen.
In welcher Sprache ist es geschrieben?
Hauptsächlich Python, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

i-have-adhd stoppt das Begraben der Antwort

Das Problem kennt jeder, der viel mit Coding-Assistenten arbeitet: Die eigentliche Lösung liegt am Ende eines Absatzes, davor kommen Lob, Umschreibungen und Nebensätze. Der Skill i-have-adhd von ayghri greift genau hier an. Die Repository-Beschreibung fasst es zusammen: Ein Skill für den Coding-Agenten, der ihn daran hindert, die Antwort zu vergraben. Untertitel: ADHS-freundliche Ausgaben, keine ADHS-Diagnose nötig.

Technisch ist das Projekt klein und direkt: Ein Skill-Verzeichnis mit einer SKILL.md, die dem Agenten Verhaltensregeln für seine Antworten vorschreibt. Die Projektsprache ist als Python angegeben, die eigentliche Wirkung entfaltet der Text der Skill-Datei selbst, nicht ausführbarer Code. Die Verbreitung ist bemerkenswert für so ein schmales Werkzeug: 25279 Stars und 1595 Forks auf GitHub, dazu nur 21 offene Issues. Die Lizenz ist MIT, eine Releases-Liste existiert nicht, das README enthält keine Versionsnummern.

Vorher und Nachher: npm install jsonwebtoken@latest zuerst

Das README zeigt das Konzept an einem authentischen Beispiel. Die Vorher-Antwort beginnt mit Great question! Let me think about this, erklärt dann die Bestandteile des Auth-Flows, verweist auf die Funktion verifyToken in src/auth.ts um Zeilen 42 bis 58, erwähnt am Rande die Dependency-Versionen und endet mit Hope this helps. Die Lösung steht irgendwo im Fließtext, der Nutzer muss sie erst herausfiltern.

Die Nachher-Antwort startet mit dem Befehl npm install jsonwebtoken@latest, gefolgt von drei nummerierten Schritten: src/auth.ts öffnen, verifyToken durch den Snippet ersetzen, npm test -- auth.spec.ts ausführen. Darunter steht eine einzige nächste Aktion: die erste fehlgeschlagene Testzeile einfügen, falls etwas bricht. Der Unterschied ist nicht nur Kosmetik. Bei Arbeitsgedächtnisbelastung, Ermüdung oder einfach unter Zeitdruck entscheidet die Position der Aktion darüber, ob der Nutzer sie überhaupt erreicht. Der Skill zwingt die Antwortstruktur in genau diese Reihenfolge.

Die 10 Regeln aus skills/i-have-adhd/SKILL.md

Der vollständige Regeltext liegt in skills/i-have-adhd/SKILL.md, das README listet die 10 Regeln in Kurzform. Erstens: mit der nächsten Aktion beginnen. Zweitens: mehrstufige Aufgaben nummerieren. Drittens: mit einem konkreten nächsten Schritt enden. Viertens: Abschweifungen unterdrücken. Fünftens: den Zustand in jeder Runde wiederholen. Sechstens: konkrete Zeitschätzungen in Minuten statt Vagen wie ein bisschen. Siebtens: Erfolge sichtbar machen. Achtens: Fehler sachlich formulieren. Neuntens: Listen auf fünf Punkte begrenzen. Zehntens: kein Vorgeplänkel, keine Zusammenfassung, keine Abschlussfloskeln.

Einige dieser Regeln greifen tiefer als ein reiner Stilfilter. Das Wiederholen des Zustands in jeder Runde hilft Nutzern, die den Faden verloren haben, ohne nachfragen zu müssen. Die Beschränkung von Listen auf fünf Punkte verhindert die allzu vertrauten Zehnpunkte-Aufzählungen, die niemand zu Ende liest. Das sachliche Formulieren von Fehlern entfernt emotionale Verbrämung, die bei Fehlschlägen zusätzliche Verarbeitung kostet. Credits: lose basierend auf The Adult ADHD Tool Kit von J. Russell Ramsay und Anthony L. Rostain, angepasst darauf, wie ein LLM antworten sollte, nicht wie ein Mensch seinen Tag organisiert.

Installation über claude plugin marketplace add ayghri/i-have-adhd

Der Weg ins README selbst ist schon ein Test des Konzepts: Copy and paste in die CLI-Eingabe, und der Agent holt sich die Installationsanleitung aus der AGENTS.md des Repositories. Wer es manuell macht, findet Details in INSTALL.md. Für Claude Code lautet die Kette: claude plugin marketplace add ayghri/i-have-adhd, dann claude plugin install i-have-adhd@i-have-adhd. Ein lokaler Klon ist nicht nötig, Claude Code zieht und aktualisiert das Repository selbst. Nach der Installation genügt der Aufruf /i-have-adhd.

Für Dauernutzung gibt es einen Schalter: touch ~/.claude/.i-have-adhd-always aktiviert den Stil für jede Sitzung. Für Codex lauten die Befehle codex plugin marketplace add ayghri/i-have-adhd --ref main und codex plugin add i-have-adhd@i-have-adhd, der explizite Aufruf läuft über $i-have-adhd, alternativ greift der Stil implizit, wenn Codex eine passende Aufgabe erkennt. Anleitungen für andere Agenten stehen in INSTALL.md, das Projekt ist also nicht auf die beiden ersten Ziele beschränkt.

Fork und Tausch: claude plugin uninstall i-have-adhd vor dem Eigenversion

Wer Regeln ändern will, forkt das Repository und editiert skills/i-have-adhd/SKILL.md. Der Austausch erfordert eine bestimmte Reihenfolge, weil Fork und Upstream denselben Namen tragen. Erst claude plugin uninstall i-have-adhd, dann claude plugin marketplace remove i-have-adhd, danach claude plugin marketplace add <your-username>/i-have-adhd und claude plugin install i-have-adhd@i-have-adhd. Anschließend startet man Claude Code neu und ruft /i-have-adhd erneut auf.

Diese Tuning-Möglichkeit ist der eigentliche Wert hinter dem einfachen Konzept. Nicht jede Regel passt in jede Umgebung: In einem Onboarding-Kontext können Zusammenfassungen am Ende sinnvoll sein, die Regel 10 sie verbietet. Wer mit externen Kunden arbeitet, mag Floskeln durchaus wollen. Weil der komplette Stil in einer einzigen Markdown-Datei steckt, ist der Anpassungsaufwand minimal, und die Versionskontrolle des eigenen Forks dokumentiert jede Abweichung vom Upstream. Damit ist das Werkzeug weniger ein festes Produkt als eine veränderliche Konfiguration der Agentenpersönlichkeit.

Grenzen: keine Messwerte, keine Releases, Wirkung per Prompt

Das README dokumentiert keine Benchmarks und keine Produktionsmesswerte, die behauptete Wirkung beruht auf dem Konzept und dem Vorher-Nachher-Beispiel, nicht auf erhobenen Daten. Auch eine Releases-Liste existiert nicht, wer eine bestimmte Version pinnen will, findet keine Tags. Die Wirkung hängt zudem vom jeweiligen Agenten ab: Ein Skill setzt Regeln per Kontext durch, nicht per erzwungener Ausgabemaske, also bleibt beobachtbar, ob der eigene Agent die Regeln in jeder Sitzung befolgt.

Die Alternative wäre, dem eigenen Agenten ähnliche Regeln direkt in eine eigene Systemanweisung zu schreiben, etwa in eine eigene CLAUDE.md. Der Unterschied: i-have-adhd liefert einen ausgearbeiteten, community-erprobten Regelsatz mit Installations- und Tauschwerkzeug, während ein Eigenbau in der eigenen Datei mehr Kontrolle über Formulierung und Reihenfolge gibt, aber die Ausarbeitung übernimmt niemand anderes. Wer den Regelsatz zuerst unverändert nutzen will, installiert ihn über den marketplace add-Weg und beobachtet einige Sessions, bevor er forked.

Redaktionelles Fazit

i-have-adhd passt für alle, die mit Coding-Agenten arbeiten und kurze, aktionsorientierte Antworten wollen, insbesondere Nutzer mit ADHS, für die lange Begründungsketten eine Hürde sind. Wer ausführliche Analysen und Kontext schätzt, wird die Regeln als Verlust empfinden. Vor dem Dauerbetrieb lohnt es sich, SKILL.md zu lesen und zu entscheiden, welche der 10 Regeln im eigenen Workflow passen, denn das Werkzeug ist genau auf dieses Tuning ausgelegt.

Offizielle Quellen

  1. Official README
  2. Project repository
Community-Notizen

Community-Notizen