Dauerhafte Projektanweisungen
Was du hier lernst
3 Arbeitsbausteine
- 01AGENTS.md und Projektregeln
- 02Grenzen und Definition of Done
- 03Regeln aktuell halten
Status: Draft · Lernzeit etwa 60 Minuten
Mission: Eine kurze Projektanweisung schreiben, die Zweck, Regeln, Arbeitsweg und Definition of Done für frische Sessions erklärt.
Was du danach kannst
Du kannst dauerhafte Regeln von aktuellem Projektstand und einmaligem Auftrag trennen. Eine frische Session liest zuerst dieselbe kleine Konstitution und erhält Details über gezielte Pointer.
1 · Arbeitsproblem
Wichtige Regeln werden in jedem Chat neu erklärt oder liegen über mehrere Dokumente verteilt. Später widersprechen sich Fassungen. Lange globale Prompts laden außerdem Wissen, das für den aktuellen Job gar nicht gebraucht wird.
2 · Drei Reichweiten
| Reichweite | Inhalt | Beispiel |
|---|---|---|
| Dauerhafte Projektanweisung | Zweck, feste Regeln, Befehle, Grenzen | AGENTS.md oder CLAUDE.md |
| Aktueller Projektstand | Entscheidungen, Quellen, nächste Schritte | CONTEXT.md, ARBEITSLOG.md |
| Run-Brief | Ergebnis, ausgewählte Quellen, erlaubte Aktionen | Brief für einen einzelnen Job |
Eine Regel wird auf der höchsten nötigen Ebene genau einmal gepflegt.
3 · Gute Projektanweisung
Sie beantwortet knapp:
- Was ist dieses Projekt?
- Welche Dateien oder Quellen gelten zuerst?
- Welche Begriffe und Ordnerrollen muss man kennen?
- Welche Daten- und Sicherheitsgrenzen gelten?
- Wie wird geprüft, gebaut oder getestet?
- Welche Aktionen brauchen eine Freigabe?
- Woran ist Arbeit fertig?
Details bleiben in Referenzen. Der Pointer erklärt, wann die Referenz gelesen werden muss.
4 · Demonstration
Für einen Website-Arbeitsraum reichen etwa:
- Zweck: öffentliche Website pflegen;
- zuerst lesen: START-HIER, CONTEXT, QUELLEN;
- aktive Dateien:
arbeit/, geprüfte Ausgaben:ausgaben/; - C0-Pflichtstrecke;
- vor Änderung Plan und Preview;
- vor Publish menschliche Freigabe;
- Build-Befehl und erwarteter Erfolg;
- fertig bei grünem Check plus aktualisiertem Arbeitslog.
Aktuelle Texte oder Termine gehören nicht in die Projektanweisung.
5 · Eigene Aufgabe
Fülle die Projektanweisungs-Vorlage für deinen Übungsordner. Begrenze die Hauptdatei auf ungefähr eine Bildschirmseite.
Starte danach eine frische Session mit dem Auftrag:
Lies die Projektanweisung und die dort für den Start benannten Dateien. Fasse Zweck, Grenzen, Arbeitsweg, Prüfungen und nächsten Schritt zusammen. Verändere nichts und markiere fehlende Angaben als nicht belegt.
6 · Lernbeweis
Die Lektion ist belegt, wenn eine frische Session:
- die richtige Lesereihenfolge nutzt;
- dauerhafte Regeln und aktuellen Stand trennt;
- Freigaben und Stop-Regeln korrekt nennt;
- den gültigen Prüfweg findet;
- fehlende Fakten nicht erfindet.
7 · Fehlerweg und Recovery
| Fehlerbild | Recovery |
|---|---|
| Datei wird zum Handbuch | Spezialwissen hinter Pointer verschieben |
| aktuelle Entscheidung steht doppelt | in CONTEXT oder ENTSCHEIDUNGEN bündeln |
| Regel wird ignoriert | klaren führenden Begriff und prüfbares Kriterium einsetzen |
| Session liest falsche Quellen | Startreihenfolge und Source-of-Truth schärfen |
| veralteter Befehl blockiert | Befehl testen, Stand und Review-Datum aktualisieren |
8 · Pflege
Ändere Projektanweisungen bewusst und sichtbar. Prüfe sie nach Struktur-, Tool- oder Sicherheitsänderungen. Ein neuer Satz muss Verhalten verändern; reine Selbstverständlichkeiten erhöhen nur Context Load.
Arbeitsmittel