grzadr/agent-skills

Skill „Blueprint erstellen“

Wenn du aufgefordert wirst, ein Lernprojekt zu entwerfen oder zu initialisieren, erstelle eine strukturierte ROADMAP.md-Datei im Wurzelverzeichnis des Arbeitsbereichs. Schreibe KEINEN Anwendungs- oder Implementierungscode.

Grundlegende Designprinzipien

1. Mikro-Sprints (dopamingetriebenes Tempo): Jeder Schritt muss in 15 bis 30 Minuten fokussiertem Codieren abschließbar sein. Wenn eine Funktion länger dauert, teile sie in Unterschritte auf.
2. Vertikale Slices statt horizontaler Schichten: Erstelle niemals eine Stufe wie „Schreibe alle Datenmodelle“ gefolgt von „Schreibe alle Datenbankabfragen“. Stattdessen sollte Stufe 1, Schritt 1.1 eine einzelne Eingabe nehmen und sofort eine sichtbare, testbare Ausgabe erzeugen.
3. Sprachagnostik: Formuliere Spezifikationen basierend auf beobachtbarem Verhalten (Eingaben, Ausgaben, Zustandsänderungen, Exit-Codes, Rückgabewerte oder API-Antworten) anstatt auf sprachspezifischem Boilerplate.

Protokoll

1. Minimalen Kontext klären (nur falls fehlend)

Falls der Benutzer nicht angegeben hat:

• Zielprojekt (z. B. ToDo-App, BitTorrent-Client, Key-Value-Store, HTTP-Server)
• Zielsprache / Laufzeit (z. B. Go, Rust, Python, TypeScript, C, Zig)
• Schnittstellentyp (z. B. CLI, HTTP-API, TUI, Bibliothek)

Stelle höchstens 2 kurze Fragen, um diese Punkte festzulegen, bevor du ROADMAP.md generierst.

2. ROADMAP.md generieren

Erstelle ROADMAP.md mit der folgenden Struktur:

• Projektübersicht: Eine 2-Sätze-Zusammenfassung dessen, was gebaut wird, und der zentralen Sprachkonzepte, die der Lernende üben wird (z. B. Speicherverwaltung, Nebenläufigkeit, Structs/Interfaces, asynchrone E/A, Fehlerbehandlung).
• Fortschrittsanzeige:
  • Aktueller Stufen- & Schrittzeiger (z. B. Aktiver Schritt: Stufe 1 - Schritt 1.1)
  • Statuslegende: [ ] Gesperrt/Ausstehend, [~] In Bearbeitung, [x] Bestanden
• Stufen (insgesamt 4 bis 6 Stufen):
  • Stufe 1: Der Herzschlag (Walking Skeleton): Das einfachste mögliche Ende-zu-Ende-Kommando oder die einfachste Funktion zum Laufen bringen.
  • Stufe 2: Kernzustand & Happy Path: Primäre Datenstrukturen und Kernoperationen im Speicher implementieren.
  • Stufe 3: Persistenz / E/A & Randfälle: Zustand speichern, komplexe Eingaben parsen und elegante Fehlerbehandlung.
  • Stufe 4: Fortgeschrittene Sprachfunktionen: Nebenläufigkeit, Streaming, Middleware oder Leistungsoptimierung einführen.
• Schritte (2 bis 4 Schritte pro Stufe): Für jeden Schritt füge hinzu:
  • Ziel: Ein Satz, der beschreibt, was der Benutzer bauen wird.
  • Sprachkonzepte geübt: 2 bis 3 spezifische Sprachfunktionen, die für diesen Schritt benötigt werden.
  • Spezifikation & Abnahmekriterien: Konkrete, Blackbox-testbare Verhaltensweisen (exakte Funktionssignaturen, CLI-Argumente, erwartetes stdout/stderr oder HTTP-Status/Nutzdaten), die craft-gatekeeper zum Schreiben automatisierter Tests verwenden wird.

Leitplanken

• Generiere NIEMALS Quellcodedateien oder Lösungsausschnitte, wenn dieses Skill ausgeführt wird.
• Beende deine Antwort, indem du den Benutzer auf Stufe 1, Schritt 1.1 verweist und vorschlägst, /craft-bootstrap (zum Einrichten des leeren Projektgerüsts) oder /craft-gatekeeper (zum Generieren des ersten fehlschlagenden Tests) auszuführen.