WORKFLOW

Vault-Workflow

Zentrale Anleitung, was du als Nutzer in welcher Situation tust. Der Rest (Strukturierung, Validation, Verlinkung, Commits) macht Claude Code.

Detail-Workflow nur fuer die Manual-Pipeline: WORKFLOW.

Routinen im Ueberblick

1. Manual-Section verarbeiten
2. Neues Teil eintragen
3. Neue Anleitung erstellen
4. Reparatur durchfuehren und dokumentieren
5. Wartung durchfuehren
6. Chat-Recherche anstossen und integrieren

---

1. Manual-Section verarbeiten

PDF einer neuen Section liegt in 01_manual/original/:

1. Im Chat sagen: „Neue PDF <name>.pdf in original/, bitte verarbeiten.”
2. Claude Code OCR-iert, extrahiert Seitenrenderings, sucht Tabellen, uebersetzt nach Pilot-Stil, legt 01_manual/de_uebersetzt/<NX>_<name>.md an.
3. Falls Diagramme zu croppen sind: Page-Renderings unter 01_manual/diagramme/raw/<name>/. Du croppst manuell, finaler Name {bild-id}_{kurz}.jpg nach 01_manual/diagramme/.

Detail: WORKFLOW.

2. Neues Teil eintragen

Drei Wege:

a) Aus Chat-Recherche (haeufig):

• Anfrage A in ki_briefings kopieren, Bauteil eintragen
• Im Chat-Interface stellen, Antwort als Markdown-Block holen
• Block in neue Datei 02_teile/einzelteile/<bauteil>.md einkippen
• Im Chat zu Claude Code: „Integriere neue Recherche zu , verlinke, aktualisiere Master-Katalog.”

b) Direkt waehrend einer Reparatur (kurz):

• Aus Template teil eine Datei kopieren
• Frontmatter komplett ausfuellen, Bezugsquelle als Stand-Datum
• Im Chat: „Trag das Teil in den Master-Katalog ein.”

c) Aus dem Manual (selten direkt):

• Wenn beim Uebersetzen einer Section neue Teilenummern auftauchen, Claude Code legt automatisch die Detail-Datei an und verlinkt vom Manual-Kapitel.

Ergebnis in jedem Fall: Detail-Datei in 02_teile/einzelteile/, Eintrag in katalog_master und in der passenden Kategorie-Sicht (katalog_motor, katalog_antrieb, katalog_boot).

3. Neue Anleitung erstellen

1. Aus Template anleitung eine Datei in 06_anleitungen/<kategorie>/<titel>.md anlegen.
2. Frontmatter ausfuellen (betroffene_bauteile als Wikilinks auf Detail-Dateien aus 02_teile/einzelteile/).
3. Bei Bedarf Chat-Recherche Anfrage B aus ki_briefings stellen.
4. Im Chat zu Claude Code: „Trag die neue Anleitung in den Anleitungs-Index ein.”

4. Reparatur durchfuehren und dokumentieren

Vor der Reparatur:

• Anleitung in 06_anleitungen/<kategorie>/ lesen, fehlende Schritte vorher klaeren (Anfrage B im Chat)
• Teile bestellen (Bezugsquellen aus [[02_teile/einzelteile/]]), Verbau-Log spaeter aktualisieren
• Werkzeug und Dichtmittel pruefen

Waehrend / nach der Reparatur:

• Fotos sammeln in 03_reparaturen/photos/ mit Datumspraefix
• Im Chat: „Neue Reparatur am , dokumentiere.”
• Claude Code legt 03_reparaturen/archiv/YYYY-MM_<bauteil>_<kurz>.md an, verlinkt zur Anleitung und zu den verbauten Teilen
• Reparatur-Logbuch in der Anleitung wird mit Datum/Wer/Besonderheit erweitert
• Verbau-Log in der Teil-Detail-Datei wird mit der konkret verbauten OEM-Nummer und Bezugsquelle aktualisiert
• log zeigt den neuen Eintrag in der Chronologie
• Anleitungs-Status ggf. von entwurf auf verifiziert_am_objekt

5. Wartung durchfuehren

1. Checkliste in 04_wartung/checklisten/ waehlen (saisonal oder Stunden-basiert).
2. Punkte abhaken, Auffaelligkeiten notieren.
3. Im Chat: „Wartung am erledigt, Stand h.”
4. Claude Code aktualisiert betriebsstunden:
   • neuer Eintrag in der Logbuch-Tabelle
   • Bezugspunkte (zaehlstand_letzter_wechsel) aktualisieren
   • Naechster Wechsel-Stand berechnen
5. Falls Anomalien aufgetreten sind: Eintrag in offene_fragen oder neuer Reparatur-Plan in 03_reparaturen/geplant/.

6. Chat-Recherche anstossen und integrieren

1. Passende Vorlage aus ki_briefings kopieren (Anfrage A bis D).
2. Stammdaten-Block voranstellen, konkrete Daten einfuegen.
3. In Chat-Interface stellen.
4. Antwort-Block in den Vault kopieren (Ziel-Datei je Anfragentyp: siehe recherche_eingang).
5. Im Chat zu Claude Code: „Integriere die neue Recherche zu , validiere Format, verlinke, aktualisiere Index.”
6. Falls Antwort lueckig: Claude Code traegt die offenen Punkte in offene_fragen ein, du entscheidest ueber neue Anfrage.

Wichtige Grundregeln

• Bei Unklarheit nicht raten — Eintrag in offene_fragen und Chat-Recherche anstossen.
• Quellen sind Pflicht — Manual + Seite / URL + Abrufdatum / Forum-Thread.
• Eintraege werden nicht geloescht — obsolet markieren statt entfernen.
• Sicherheitskritisches — bei DANGER/WARNING/CAUTION Originaltext zitieren, bei Zweifeln Fachwerkstatt.

Bezug zu projekt_vision.md

Diese Datei ist die operative Anleitung. Die strategische Ebene (Rolle, Arbeitsteilung, Nicht-Ziele) steht in projekt_vision. Bei Konflikt gewinnt projekt_vision.