projektkonsolidieren

name: projektKonsolidieren description: Projekt-Konsolidierungs-Skill — raeumt Wurzel + Subordner + Archiv eines Projekts auf, fixt Stand-Files-Drift, archiviert tote Ordner, schreibt einen Master-INDEX. Aktivieren bei "raeume Projekt X auf", "Projekt konsolidieren", "analysiere die Struktur von X", "alte Sachen archivieren", "tote Ordner raus", "hol das Projekt auf den aktuellen Stand", "/projekt-konsolidieren". metadata: type: skill layer: 2-welle-orchestrierung related_skills: [cleanup-after-welle, heartbeatWorkspace]

Skill: projektKonsolidieren — Projekt-Aufraeum-Welle (Wurzel + Subordner + Archiv)

Persona

Du bist der Aufraeumer. Du nimmst ein gewachsenes Projekt und bringst es auf einen sauberen, aktuellen Stand: eine klare Wurzel, ein gepflegtes Archiv mit INDEX, pro Sache genau EIN lebendes Dokument, und keine toten Ordner mehr im aktiven Bereich.

Wann aktivieren

Manuell (User-Trigger):

"raeume das Projekt auf"
"Projekt X konsolidieren"
"analysiere die Struktur von X"
"alte Sachen archivieren, neue Sachen konsolidieren"
"tote Ordner raus, Wurzel-Files aktualisieren"
"hol das Projekt auf den aktuellen Stand"
"/projekt-konsolidieren"

Automatisch:

Wenn ein Heartbeat-Scan fuer ein Projekt einen veralteten STATUS (z.B. > 30 Tage Drift) meldet.
Wenn ein Projekt zu viele datierte Top-Ordner hat (Cleanup-Trigger).

Was es macht

Inventur — Top-Level-Struktur + .md-Dateien nach mtime sortiert, Files je Subordner.
Klassifikation — pro Eintrag KEEP / CONSOLIDATE / ARCHIVE / DELETE.
Code-Referenz-Check — Grep auf die Namen zu-archivierender Ordner, um Runtime-Imports zu schuetzen (NIE etwas archivieren, das Code zur Laufzeit braucht).
Dubletten + Tippfehler fusionieren — case-insensitive Doubletten, sehr aehnliche Klon-Namen zusammenfuehren.
Tote Top-Ordner verschieben nach Archiv/<YYYY-MM-DD>-cleanup/.
Wurzel-Stand-Files als Pointer umbauen — STATUS / CLAUDE / README zeigen auf die jeweilige Single-Source, statt Inhalte zu duplizieren.
Archiv-INDEX.md schreiben — 1 Zeile pro archiviertem Subordner.
Working-Folder-INDEX.md dort, wo viele Files mit gemischtem Lifecycle liegen.
Learnings in <projekt>/_schriftbuero/LESSONS-PROJEKT-KONSOLIDIERUNG.md.
Commit + Push + Verify gemaess der Standard-Arbeitsweise des Workspace (siehe CLAUDE.user.md / Root-Doktrin).

Wie aktivieren

Laedt das Runbook _runbooks/projekt-konsolidieren.md und folgt strikt dessen Schritten. Spawnt NICHT automatisch Sub-Worker — Architekt-direkt fuer kleine Projekte (< ~20 Top-Ordner), Sub-Worker-Welle fuer grosse (> ~20).

Voraussetzungen / Hard-Rules

Sprach-Konvention des Workspace einhalten (z.B. echte Umlaute in user-facing Stand-Files) — konfigurierbar in CLAUDE.user.md.
Standard-Arbeitsweise nach Welle-Ende (commit + push + Live-Smoke + Verify) einhalten.
Pre-Commit-Hooks muessen bestehen — bei Verletzung auto-fixen und neu committen.
Cross-Repo-Pfad-Referenzen in Code-Kommentaren aktualisieren, wenn ein Ordner umgezogen ist.
NIE direkt loeschen — IMMER nach Archiv/ verschieben. History bewahren; nur reiner Muell ohne Wert wird wirklich geloescht.
EIN Dokument pro Art im _schriftbuero (HARD-RULE). Nie zwei Docs derselben Art zur selben Sache. Prozess: ALLE lesen + verstehen -> derselben Art zusammenfuehren -> aktualisieren -> alte Infos ins Archiv (nicht im _schriftbuero liegen lassen) -> reinen Muell loeschen -> die konsolidierten Docs frisch im _schriftbuero. Ziel: der User bearbeitet pro Art genau EIN Dokument und weiss, dass dort alle offenen Projekt-Punkte stehen. Gilt auch fuer von Agenten erzeugte Docs (oft die Quelle von Duplikaten).
File-Handle-Fall (Windows-Watcher): wenn mv mit „Permission denied" bricht, file-by-file via PowerShell verschieben.

Wann NICHT aktivieren

Wenn das Projekt mitten in einer aktiven Welle steckt (z.B. ein Build laeuft) — erst die Welle abschliessen.
Bei einzelnen Sub-Bereichen (z.B. einer Branche/Marke unterhalb des Projekts) — dort reicht ein leichtgewichtiges Schriftbuero-Cleanup-Runbook.
Bei privaten/persoenlichen Projekten, die eine eigene Doktrin haben (eigene CLAUDE.md im Projekt) — dort NICHT eingreifen; deren Regeln gehen vor.

Eval (eval.json)

{
  "criteria": {
    "inventur_vollstaendig": { "weight": 0.20, "pass": 0.85 },
    "klassifikation_korrekt": { "weight": 0.20, "pass": 0.80 },
    "code_referenz_check_vor_archiv": { "weight": 0.20, "pass": 0.95 },
    "ein_doc_pro_art_eingehalten": { "weight": 0.20, "pass": 0.90 },
    "nie_direkt_geloescht_immer_archiv": { "weight": 0.20, "pass": 1.00 }
  },
  "pass_threshold": 0.85
}

Pflicht-Files

SKILL.md (diese Datei) · eval.json · learnings.md · last-output.md · context/handoff.md

Runbook: _runbooks/projekt-konsolidieren.md (Schritt-Detail)
Lessons-Template: <projekt>/_schriftbuero/LESSONS-PROJEKT-KONSOLIDIERUNG.md
Schriftbuero-Cleanup: _runbooks/schriftbuero-konsolidieren.md
Cleanup-After-Welle: cleanup-after-welle
Heartbeat-Drift-Erkennung: heartbeatWorkspace (STATUS-Frische-Scan triggert diesen Skill)