Portiert vom PC-Skill (F:\Coding Stuff\projekt-start): 4 Phasen mit hartem
Plan-Riegel, Savepoints, AGENTS.md/SAVEPOINT.md/.aiexclude-Ritual und
Kontext-Waechter. Zed-Verweise durch Hermes Desktop ersetzt (Modellwaehler
"Box / Coder (bauen)" / "Box / Planer (denken)", Planer-Kontexthinweis),
.aiexclude-Regel in die AGENTS.md-Vorlage gehoben, Verweis auf den
Werkstatt-Weg fuer Box/Lucy-Wartung ergaenzt. deploy.sh installiert ihn
nach ~/.hermes/skills/projekt-start.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 10:56:33 +02:00
2 changed files with 376 additions and 0 deletions
description: "Startet und begleitet ein Coding-Projekt RICHTIG: erst verstehen, dann planen (mit hartem Freigabe-Gate), dann Gerüst, dann Code, dann Beweis — mit Sicherungspunkten (Savepoints) und Wahl des passenden Box-Modells je Aufgabe. Pflegt die drei Projektdateien AGENTS.md, SAVEPOINT.md und .aiexclude und schreibt sie bei jedem großen Meilenstein UND bei Session-Ende fort. Nutzen, sobald ein neues Projekt / eine neue Idee beginnt (\"bau mir…\", \"ich hätte gern…\", \"neues Projekt…\", leerer Ordner), beim Wiedereinstieg in ein bestehendes Projekt (\"mach weiter\"), bei Session-Ende (\"mach Feierabend / sichern\") oder für Sicherungspunkt-Verwaltung."
version: 1.0.0
author: MC2 (Ablösung 13.07.2026 — portiert vom PC-Skill F:\Coding Stuff\projekt-start, Zed-Verweise durch Hermes Desktop ersetzt)
**Zurückrollen** (wenn der User sagt „zurück zum letzten Sicherungspunkt / das war Mist"):
- Erst die vorhandenen Savepoints auflisten (`git log --oneline`), den passenden zeigen.
- Dann sicher zurück (z. B. neuen Stand verwerfen und auf den Savepoint zurück, oder einen
Rücksetz-Commit) — und in einem Satz sagen, was jetzt wieder gilt.
- Nie unwiederbringlich löschen ohne Rückfrage.
**Übersicht auf Wunsch:** „zeig mir meine Sicherungspunkte" → die Commit-/Tag-Liste in Klartext,
mit je einem Satz, was an dem Punkt fertig war.
---
## Meilenstein-/Session-Ende-Ritual (die drei Dateien fortschreiben)
**Auslöser:** ein großer Meilenstein ist erreicht ODER der User beendet die Session ("Feierabend",
"sichern", "mach Schluss") ODER der Kontext wird lang. Dann IMMER, in dieser Reihenfolge:
1.**`SAVEPOINT.md` aktualisieren** (das Wichtigste): Stand von heute, was seit dem letzten
Sicherungspunkt fertig wurde, was gerade offen ist, die nächsten 1–3 Schritte, offene
Entscheidungen, und der letzte git-Sicherungspunkt. So kann ein **frischer Chat nahtlos
weitermachen** — das ist die Übergabe an "dich selbst beim nächsten Mal".
2.**`AGENTS.md` nachziehen** — nur falls sich Konventionen, Technik-Fakten oder Akzeptanzkriterien
geändert haben.
3.**`.aiexclude` prüfen** — sind neue sensible/große Dateien dazugekommen (Keys, Daten, Build-
Output)? Dann eintragen.
4.**Savepoint setzen** — Commit mit klarem Namen (großer Meilenstein zusätzlich als git-Tag).
5.**Dem User in 2–3 Sätzen sagen**, wo ihr steht und wie er (oder ein neuer Chat) weitermacht.
**Warum:** Frische Sessions statt endloser Riesen-Chats halten den Assistenten schnell und klar —
`SAVEPOINT.md` ist die Brücke, damit trotzdem nichts verloren geht.
---
## Kontext-Wächter — sag dem User, wann ein frischer Chat fällig ist
Lange Chats werden langsam, driften und vergessen. Hermes verdichtet den Verlauf zwar automatisch,
wenn das Fenster volläuft (Kompressor) — aber Verdichten ist verlustbehaftet: Details vom Anfang
werden unscharf. Ein frischer Chat mit `SAVEPOINT.md` ist IMMER besser als weiterwursteln.
**Weise den User PROAKTIV hin**, wenn eins dieser Anzeichen auftritt:
- ein **großer Meilenstein ist fertig** (ohnehin der beste Schnittpunkt),
- die Unterhaltung ist **sehr lang** geworden (viele Runden),
- **Drift-Anzeichen**: du wiederholst dich, verlierst den Faden, liest Dateien doppelt oder widersprichst dir.
Dann klar ansagen, z. B.:
> *„Wir sind jetzt lang unterwegs — guter Moment für einen frischen Chat. Ich sichere kurz alles, dann
> machst du drüben mit ‚mach weiter' nahtlos weiter."*
…und **zuerst das Session-Ende-Ritual** fahren (SAVEPOINT.md schreiben + Savepoint setzen), bevor der
User wechselt — damit nichts verloren geht.
**Ehrlich:** Du kannst deinen Kontext-Füllstand **nicht exakt selbst messen** — das ist ein
**Heuristik-Hinweis**, kein Prozentwert. Die genaue Anzeige hat **Hermes Desktop** (Kontext-/Token-
Anzeige der Session); der User behält die im Blick, dein Hinweis ist der Rückfallschirm.
---
## Vorlage: `AGENTS.md` (fülle die {…} projektbezogen)
```markdown
# {Projektname}
{Ein Satz: was dieses Projekt ist und für wen.}
## Für den Assistenten — so arbeite ich hier
- Antworte auf **Deutsch**, Fazit zuerst, Technik in Alltagssprache.
- **Plan vor Code** bei allem Größeren: erst Vorgehen zeigen, auf OK warten.
- **Kleine Schritte**, eine Sache zur Zeit. Nichts Ungefragtes ausführen.
- **Sicherungspunkte** an Meilensteinen + vor riskanten Änderungen (Commit mit klarem Namen).
- **Beweisen statt behaupten** — am Ende live testen, nicht "sollte gehen".
- Frag nach, bevor du etwas löschst oder überschreibst.
- **Lies keine Dateien/Ordner, die in `.aiexclude` stehen** (Secrets, große Daten, Build-Output).
## Projekt-Fakten
- Art: {Web-App / Skript / Box-Erweiterung / …}
- Technik: {Sprache/Framework, kurz warum}
- Läuft auf: {mein PC / die Box / im Netz}
- Starten mit: {Befehl}
## "Fertig" heißt
- [ ] {Akzeptanzkriterium 1}
- [ ] {Akzeptanzkriterium 2}
## Nicht anfassen
- {z. B. Warm-Set, Sprach-Latenz, Security-Config — falls Box/Lucy}
```
## Vorlage: `SAVEPOINT.md`
```markdown
# Savepoint — {Projektname}
_Stand: {Datum}. Diese Datei ist die Übergabe an den nächsten Chat — lies sie zuerst._
## Wo wir stehen
{1–3 Sätze: aktueller Zustand in Alltagssprache.}
## Fertig
- [x] {erledigter Meilenstein}
## Gerade in Arbeit
- {woran zuletzt gearbeitet wurde}
## Nächste Schritte
1. {nächster Schritt}
2. {…}
## Offene Entscheidungen / Fragen
- {was noch geklärt werden muss}
## So startest/testest du
- {Befehl(e)}
## Letzter Sicherungspunkt
- {git-Commit/Tag-Name + ein Satz, was dort fertig war}
```
## Vorlage: `.aiexclude` (gitignore-Syntax — was die KI NICHT lesen soll)
```
# Geheimnisse
.env
.env.*
*.key
*.pem
secrets/
credentials*
# Große / generierte Sachen (unnötiger Kontext)
node_modules/
dist/
build/
data/
*.sqlite
*.log
```
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Auftragsbuch