Pu11en/sysmap

Systeme durch eine gespeicherte, klickbare Karte planen und erklären. Ideal für kollaboratives Design, die Fortsetzung einer Planungskonversation, Systemerklärungen oder die Vorbereitung eines abgestimmten Plans für die Implementierung. Halte Designfragen im Chat.

Was ist sysmap?

Dieses Skill ermöglicht es, komplexe Systeme visuell zu planen und zu erklären, indem eine interaktive Karte erstellt wird, die das Systemverhalten darstellt, während die Diskussion im Chat geführt wird. Es ist besonders nützlich für die kollaborative Systemarchitektur, das Wiederaufsetzen von Planungsgesprächen, das Erläutern von Systemdesigns oder die Vorbereitung eines abgestimmten Plans für die Implementierung. Das Skill unterstützt eine strukturierte Planung, bei der jede Systemkomponente („Teil“) präzise definiert wird: mit einer Aufgabe, Ein- und Ausgaben, Regeln und Belegen. Es wird ein zentrales Quellformat (`.plan.json`) verwendet, das autoritativ ist und nicht überschrieben wird; generierte Zeichnungen sind lediglich ableitbare Visualisierungen. Die Planung bleibt strikt auf das Entwerfen beschränkt und erteilt keine Implementierungsfreigabe – die Verantwortung für die Umsetzung liegt separat. Es fördert evidenzbasierte Entscheidungen, trennt gesicherte Fakten von Vorschlägen und unbekannten Aspekten und stellt sicher, dass jede Änderung am Plan durch Tests (z. B. Struktur- und Navigationsprüfungen) validiert wird, bevor eine Fertigstellung gemeldet wird. Das Skill ist primär für die Nutzung in KI-Agenten wie Claude Code konzipiert, erfordert aber Browserzugriff für die visuelle Inspektion der Karte.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pu11en/sysmap/tree/HEAD

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Durch eine Systemkarte planen

Erstelle ein gemeinsames Verständnis, bevor du zeichnest oder baust. Die Karte zeigt das Systemverhalten; der Chat enthält die Diskussion. Planung erteilt niemals die Erlaubnis, das Produkt zu implementieren.

Lies den Planungsleitfaden, bevor du mit der Planung beginnst oder sie fortsetzt. Er definiert das Quellformat, Teiledatensätze, Navigation und Prüfungen. Informationen zur Helfer-Einrichtung und zu Befehlen findest du in der README.

Mit Belegen beginnen

Setze die eine gespeicherte .plan.json-Quelle der Konversation fort. Lies ihr Ziel, Entscheidungen, offene Fragen und die aktuelle Planungsposition. Untersuche relevante Projektevidenz, bevor du das bestehende Verhalten beschreibst. Lade nur den aktuellen Teil und seine Nachbarn, wenn die Quelle groß ist.

Wähle für eine neue Konversation einen eindeutigen, beschreibenden Quellennamen. Überschreibe niemals den Plan einer anderen Konversation. Die Quellenplan ist maßgeblich; generierte Zeichnungen und Manifeste sind keine bearbeitbaren Pläne.

Trenne überprüfte Fakten, abgestimmte Pläne, Unbekanntes und nicht akzeptierte Vorschläge. Zitiere Belege. Leite niemals eine frühere Entscheidung aus einem vagen Label ab oder erfinde Fakten, um eine Lücke zu schließen.

Bedeutung vor dem Zeichnen definieren

Halte für jeden Teil seine eine Aufgabe, Eingabe, Arbeit, Ergebnis, Regeln, nächsten Empfänger, Grenze und Belege fest. Verwende die im Leitfaden definierten Feldnamen.

Halte Speicherung von Aktionen getrennt. Unterscheide einen Wartezustand von der Arbeit. Verbinde jedes Ergebnis mit der erwarteten Eingabe des nächsten Teils. Gehe ein konkretes Beispiel durch die verbundenen Teile hindurch.

Verwende kurze Bezeichnungen und benannte Pfeile. Unterseiten erklären ihren übergeordneten Teil. Verbinde sie über explizite detail-Ziele, niemals über passende Namen oder vermutete Links. Halte Toolauswahlen, Designfragen und Kommentare zu entfernten Funktionen aus dem Graphen heraus.

Zusammenarbeiten und vorankommen

Beantworte zuerst die aktuelle Frage. Lies getroffene Entscheidungen, bevor du eine weitere Frage stellst. Klar formulierte Änderungswünsche aktualisieren die Quelle, während nicht betroffene Entscheidungen erhalten bleiben. Zustimmung akzeptiert nur den tatsächlich gezeigten Vorschlag.

Bewege dich nach der Klärung eines Punktes auf das nächste sinnvolle ungelöste Teil zu. Erkläre seinen Zweck, schlage einen fundierten Ansatz vor und stelle dann eine konkrete Wahl, wenn sie das Design ändert. Verwandle die Planung nicht in ein Interview und höre nicht bei „gespeichert“ auf.

Kennzeichne geringfügige Standardeinstellungen als Vorschläge. Entscheide nicht stillschweigend über Berechtigung, Privatsphäre, Kosten oder faktische Belege. Löse Verwirrung, bevor du fortfährst. Wenn keine wesentlichen Entscheidungen mehr anstehen, fasse die Bereitschaft zusammen und biete eine Überprüfung oder eine separat autorisierte Implementierung an.

Vor der Fertigmeldung prüfen

Erstelle nach einer Planänderung die Karte und überprüfe die betroffenen Verbindungen und die Bedeutung der Unterseiten. Wenn Browserzugriff verfügbar ist, überprüfe auch die Zeichnung und Navigation. Melde nicht verfügbare Prüfungen ehrlich.

Helfer-Tests prüfen die Struktur und die generierte Ausgabe, nicht die Systemwahrheit, echte Browser-Interaktionen oder die Kompatibilität mit jedem Agenten-Framework.

Verwandte Skills