File-first Projektstruktur

Status: Draft · Lernzeit etwa 70 Minuten
Mission: Einen kleinen Projektordner anlegen, den Mensch und KI in einer Minute verstehen.

Was du danach kannst

Du kannst bestätigten Context, neue Eingänge, aktive Arbeit, Ausgaben und Archiv so trennen, dass ein frischer Arbeitslauf nicht raten muss. Die Struktur bleibt auf dem eigenen Rechner lesbar und kann später mit Git, Suche oder Connectoren erweitert werden.

1 · Arbeitsproblem

Informationen liegen häufig in Chatverläufen, Downloads, Drive-Dokumenten und mehreren Versionen derselben Datei. Beim nächsten Lauf ist unklar, welcher Stand gilt, was nur Rohmaterial ist und welche Ausgabe geprüft wurde.

File-first bedeutet: Der dauerhafte Arbeitsstand liegt in verständlichen, portablen Dateien. Bestehende Werkzeuge bleiben Quellen und Oberflächen.

2 · Minimaler Projektordner

mein-projekt/
├─ START-HIER.md
├─ CONTEXT.md
├─ REGELN.md
├─ QUELLEN.md
├─ ENTSCHEIDUNGEN.md
├─ ARBEITSLOG.md
├─ eingang/
├─ arbeit/
├─ ausgaben/
└─ archiv/

Element	Aufgabe
START-HIER.md	Zweck, aktueller Stand, nächster Schritt und Lesereihenfolge
CONTEXT.md	bestätigte Aussagen, Begriffe und Projektgrenzen
REGELN.md	Datenwand, Freigaben, Stop-Regeln und Definition of Done
QUELLEN.md	Originalquellen mit Owner, Pointer, Stand und Prüfdatum
ENTSCHEIDUNGEN.md	getroffene Entscheidungen mit Datum und Begründung
ARBEITSLOG.md	letzter Lauf, Ergebnis, offene Punkte und nächster Schritt
eingang/	neue, ungeprüfte Inputs
arbeit/	aktive Entwürfe und Zwischenstände
ausgaben/	prüfbare Ergebnisse
archiv/	ersetzte oder abgeschlossene Stände

3 · Drei Regeln tragen die Struktur

Regel 1 · Eine Datei hat eine klare Rolle

Bestätigte Aussagen gehören in den Context, Quellen in das Quellenledger und Laufnotizen in den Arbeitslog. Derselbe Inhalt besitzt genau eine maßgebliche Stelle.

Regel 2 · Namen beschreiben den Inhalt

angebot-draft-03.md ist verständlicher als neu-final-wirklich-final.md. Stabile Namen für dauerhafte Dateien; Datum oder Status für zeitgebundene Artefakte.

Regel 3 · Jeder Lauf endet mit Übergabe

ARBEITSLOG hält fest: Was wurde getan? Was gilt jetzt? Was bleibt offen? Was ist der nächste Schritt? Ein Chatverlauf dient nicht als Projektgedächtnis.

4 · Demonstration

Eine selbstständige Fachperson überarbeitet ihre öffentliche Website.

• Freigegebene Leistungsbeschreibungen stehen in CONTEXT.md.
• Drive-Dokumente und Website-Seiten stehen als Pointer in QUELLEN.md.
• Eine neue Sprachnotiz landet als abstrahierte Mitschrift in eingang/.
• Der Textentwurf entsteht in arbeit/.
• Die geprüfte Vorschau liegt in ausgaben/.
• Die Entscheidung zur Übernahme steht in ENTSCHEIDUNGEN.md.
• ARBEITSLOG verweist auf den nächsten Abschnitt.

Ein späterer Agent muss den Drive-Bestand nicht pauschal lesen. Er startet mit sechs kurzen Dateien und öffnet nur die benannten Quellen.

5 · Eigene Aufgabe

Nutze die Projektstruktur-Karte und den Context Starter.

1. Lege den Ordner mit C0- oder vollständig synthetischem Inhalt an.
2. Fülle jede der sechs Startdateien mit höchstens zehn Zeilen.
3. Lege einen Beispielinput in eingang/ und einen Entwurf in arbeit/ ab.
4. Aktualisiere ARBEITSLOG.
5. Starte einen frischen Chat oder Arbeitslauf und bitte um eine Zusammenfassung mit Dateiquellen.

6 · Frische-Session-Test

Der Test ist bestanden, wenn eine frische Session in unter einer Minute erkennt:

• Zweck und Grenze des Projekts;
• bestätigten Stand und Originalquellen;
• offene Entscheidung;
• nächsten Schritt;
• Daten- und Stop-Regeln.

Fehlende Aussagen werden als „nicht belegt“ markiert. Der Test verändert keine Dateien.

7 · Lernbeweis

Beleg	Mindestanforderung
Artefakt	Projektordner mit sechs Startdateien und vier Arbeitsbereichen
Erklärung	Rolle jeder Datei in eigenen Worten
Wiederholung	neuer Input wurde richtig eingeordnet
Übergabe	frische Session findet Stand und nächsten Schritt
Recovery	falsche Datei wurde erkannt und an die richtige Stelle verschoben

8 · Fehlerweg und Recovery

Fehlerbild	Recovery
Alles steht in CONTEXT	Eingänge, Entscheidungen und Logs in ihre Rollen verschieben
Zwei Dateien behaupten unterschiedliche Wahrheit	Originalquelle öffnen, Entscheidung klären, beide Pointer aktualisieren
Dateinamen werden immer länger	stabile Hauptdateien und datierte Artefakte trennen
Agent liest den ganzen Ordner	START-HIER mit Lesereihenfolge und erlaubten Pfaden schärfen
Archiv wird weiter verwendet	ersetzten Stand markieren und aktive Pointer korrigieren

9 · Ausbauleiter

1. Ordner und Markdown;
2. native Dateisuche oder ripgrep;
3. Git für Diff und Rollback;
4. lokaler Volltextindex bei echter Findelücke;
5. geteilter Store erst bei mehreren Rollen oder Remote-Zugriff;
6. RAG erst nach einem Fragenkatalog, an dem klare Suche wiederholt scheitert.

10 · Datenwand

Ein Projektordner übernimmt die Schutzklasse seines Inhalts. Sensible Bestände bleiben im zuständigen privaten Datenraum. Globale Projektregeln, Screenshots, Logs und öffentliche Repositories tragen keine Zugangsdaten oder Klientenfälle.

11 · Pflege

Zehn Minuten pro Woche oder vor einem wichtigen Run reichen für den Anfang: Quellen prüfen, Entscheidungen aktualisieren, Eingänge leeren, alte Entwürfe archivieren und den nächsten Schritt eintragen.