lucaszb-orla/lucas-setup

Lucas Setup

Bereite die Grundlage eines Projekts vor, ohne stillschweigend Produkt, Stack oder Architektur zu wählen. Wende die enthaltenen Vorlagen an und passe nur das an, was der tatsächliche Kontext rechtfertigt.

Ablauf

1. Untersuche das Zielverzeichnis, Anweisungsdateien, Manifeste und den Git‑Status.
2. Bestimme anhand der Anfrage und der vorhandenen Dateien, ob es sich um ein Web‑, Apple‑ oder plattformübergreifendes Projekt handelt.
3. Falls die Wahl der Plattform oder des Stacks das Ergebnis wesentlich verändert und nicht ermittelt werden kann, stelle vor dem Erstellen von Code eine kurze Frage.
4. Wende die Basisdateien an:
   • In einem neuen Verzeichnis oder ohne widersprüchliche Dateien führe aus: python3 <skill-dir>/scripts/apply_setup.py --target <verzeichnis> --platform <web|apple|both>.
   • Bei einem Projekt mit AGENTS.md, CLAUDE.md oder PROJECT_CONTEXT.md nicht überschreiben. Lese beide, fasse kompatible Regeln zusammen und weise auf echte Konflikte hin.
5. Fülle PROJECT_CONTEXT.md mit beobachteten Fakten. Lasse keine Beispiele stehen, die wie Entscheidungen wirken.
6. Erstelle oder passe das Projekt nur an, wenn die Anfrage Scaffolding oder Implementierung umfasst.
7. Richte Conductor nur ein, wenn es angefordert wird oder wenn das Projekt für Conductor vorbereitet werden soll.
8. Validiere Dateien, Befehle, Git und die Abwesenheit von Geheimnissen.

Assets anwenden

Verwende scripts/apply_setup.py für eine deterministische Kopie ohne Überschreiben. Das Skript:

• erstellt das Zielverzeichnis bei Bedarf;
• kopiert AGENTS.md, CLAUDE.md und PROJECT_CONTEXT.md;
• kopiert nur die Richtlinien der gewählten Plattform;
• lehnt jede vorhandene Datei mit abweichendem Inhalt ab;
• akzeptiert --dry-run;
• akzeptiert --conductor für eine einzelne Plattform.

Für ein Apple‑Projekt:

python3 <skill-dir>/scripts/apply_setup.py \
  --target /pfad/zum/projekt \
  --platform apple \
  --conductor

Für ein Web‑Projekt:

python3 <skill-dir>/scripts/apply_setup.py \
  --target /pfad/zum/projekt \
  --platform web \
  --conductor

Nach dem Kopieren bearbeite PROJECT_CONTEXT.md mit apply_patch.

Projektentscheidungen

• Wähle kein Framework, keine Datenbank, keine Architektur, keine Bundle‑ID, kein Deployment‑Target und keinen Anbieter ohne Beleg in der Anfrage oder im Repository.
• Bevorzuge den bereits verwendeten Stack und Paketmanager.
• Gib bei einem wirklich leeren Projekt eine kurze, produktbasierte Empfehlung ab, trenne aber die Empfehlung von der bestätigten Entscheidung.
• Füge keine Abhängigkeiten oder Dienste nur hinzu, um eine Vorlage zu vervollständigen.
• Ändere generierte Dateien nicht, wenn eine deklarative Quelle vorhanden ist.

Zwingende Präferenzen

• Verwende keinen langen Gedankenstrich in der Benutzeroberfläche, in der Dokumentation, in Kommentaren oder in exportierten Inhalten.
• Füge dem Onboarding keine dekorativen Ränder hinzu.
• Wenn im Onboarding ein Hauptbild vorhanden ist, behalte es als einziges materielles Highlight.
• Bewahre Benutzeränderungen und halte den Umfang chirurgisch präzise.
• Mache kleine, atomare Commits, nachdem relevante Fortschritte validiert wurden.
• Aktualisiere das Projektspeichergedächtnis, sobald eine dauerhafte Entscheidung oder ein Knackpunkt auftritt.

Conductor

Bevor die Konfiguration erstellt wird, untersuche die tatsächlichen Befehle für Setup, Ausführung und Tests.

• Verwende .conductor/settings.toml für gemeinsame Konfiguration.
• Verwende .conductor/settings.local.toml für lokale Repository‑Präferenzen.
• Verwende CONDUCTOR_PORT bei konfigurierbaren Servern.
• Markiere die Ausführung als nicht parallel, wenn Datenbank, Port oder lokaler Dienst nicht isoliert werden können.
• Erstelle keinen verschachtelten Worktree innerhalb eines Conductor‑Workspaces.
• Behandle die TOMLs in assets/conductor/ als Ausgangspunkte, niemals als Fakten des Projekts.

Git und GitHub

• Initialisiere Git und erstelle ein entferntes Repository nur, wenn die Anfrage diese Aktionen erlaubt.
• Validiere vor dem ersten Commit den Diff und suche nach Geheimnissen.
• Verwende den Standard-Branch main, sofern keine bestehende Konvention abweicht.
• Benenne einen aktiven Branch nicht ohne explizite Aufforderung um.
• Veröffentliche ein Projekt nicht als öffentlich, wenn die Sichtbarkeit nicht klar ist.

Überprüfung

Stelle Folgendes sicher:

• AGENTS.md, CLAUDE.md und PROJECT_CONTEXT.md existieren und sind konsistent;
• es wurden nur die Richtlinien der zutreffenden Plattform hinzugefügt;
• der Kontext enthält keine Beispiele, die als Entscheidungen behandelt werden;
• die Conductor‑Konfigurationen verwenden echte Befehle;
• relevante enge Tests oder Befehle bestehen;
• Git enthält keine Geheimnisse, Artefakte oder Änderungen außerhalb des Umfangs.

Teile am Ende mit, was erstellt wurde, was ausgefüllt werden muss und welche Validierung noch nicht durchgeführt wurde.