Aufgefallen bei der Frage, wo man ein Werkbank-Token anlegt. Drei Befunde an
derselben Stelle:
1. DIE SUPERVISOR-RECHTE FEHLTEN IM FORMULAR
TokenManager::KNOWN_SCOPES kennt supervisor:read, :manage und :report seit
2.6.0 - die Ankreuzliste bot sie nie an. Ein Werkbank-Token liess sich
ueber die Oberflaeche also gar nicht so ausstellen, wie die Anleitung es
verlangt: dc_findings, dc_finding_summary und dc_metrics im MCP-Adapter
waeren mit "unauthorized" gescheitert, und der Grund waere nirgends zu
sehen gewesen.
2. "ALLE RECHTE" WAR DIE VORGABE
Wer ein Agenten-Token anlegte und den Haken uebersah, gab damit alles
heraus - Releases veroeffentlichen und Tokens ausstellen inbegriffen. Die
gefaehrlichste Auswahl gehoert nicht in die Vorgabe. Vorangekreuzt ist
jetzt "Bugtracker verwalten", also der dokumentierte Normalfall; der
Vollzugriff traegt eine Warnung und muss ausdruecklich gewaehlt werden.
3. DIE ANSICHT HIESS "MASTER-TOKEN ERSTELLEN"
Deshalb fand niemand das Werkbank-Token: Es entsteht an genau dieser
Stelle, nur mit anderem Identitaetstyp. Der Name der Ansicht versprach
etwas anderes, als sie kann - und widersprach der eigenen Regel "kein
Master-Token an einen Agenten". Heisst jetzt "Token erstellen", mit einem
Hinweiskasten fuer den Agentenfall.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
VORLAGE ZERLEGT
docs/AGENT_PROMPT_TEMPLATE.md war ein Block von 300 Zeilen, den jedes Projekt
vollstaendig einkopierte - auch die, in denen der MCP-Adapter laeuft und die
Werkzeuge ihre Beschreibung selbst mitbringen. Jetzt vier Bausteine:
A Grundhaltung, gilt immer. Vier Regeln, kurz.
B Mit MCP-Adapter: die Reihenfolge, die in keiner Werkzeugbeschreibung
steht - erst nachsehen, dann uebernehmen, dann arbeiten.
C Ohne MCP: der REST-Weg, vollstaendig. Nur wo kein Adapter laeuft.
D Auf der Test-VM.
Ein Projekt mit Adapter traegt damit eine halbe Seite statt zweihundert Zeilen,
die das Modell nie liest und die auseinanderlaufen, sobald sich die
Schnittstelle aendert. Loest #75 (vormals C4).
NEU: docs/AGENTEN_ANBINDEN.md
Was einmalig je Projekt zu tun ist - fuer den Menschen, nicht fuer den Agenten:
Werkbank-Token, Adapter, welche Bausteine, Roadmap-Uebernahme, Test-VM. Dazu
zwei Abschnitte, die sonst gefehlt haetten:
- Was NICHT an die anderen Projekte geht: Testinstanz und tests/e2e gehoeren
zum Deploymentcenter und werden nicht je Projekt nachgebaut. Uebernehmen
laesst sich die Haltung dahinter - Befund bekommt Item UND Testfall,
bekannte Befunde blockieren nicht, fehlende Voraussetzung heisst
uebersprungen und nicht rot.
- Vier Pruefragen an den Agenten nach der Einrichtung. Antwortet er auf
"was steht als Naechstes an" mit dem Inhalt einer Markdown-Datei, fehlt
Baustein A oder der Adapter laeuft nicht.
WEBUI
Die Spaltenkoepfe der Bereichsuebersicht waren Zeichen ohne Erklaerung - wer
die Legende nicht gelesen hat, und das ist der Normalfall, riet was 🧊 heisst.
Jetzt title= samt Fragezeichen-Zeiger und gepunkteter Linie, damit ueberhaupt
erkennbar ist, dass da etwas zu holen ist. Auch Rang, Item, Ziel, Wer und Doku
in der Vorhabenliste, und der Fortschritt mit dem Hinweis, warum
Zurueckgestelltes und Verworfenes nicht in den Nenner zaehlt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
