Dateien, Intake & Trail

TensorPM behandelt Dateien und eingehende Signale als Eingaben für Projektkontext, nicht als separates Dokumentenarchiv.

Der wichtige Ablauf ist:

1. Dateien, E-Mails und Raw Updates gelangen in Intake.
2. Unterstützte Elemente können zusammengefasst oder bewertet werden.
3. Der Distiller macht aus relevanten Signalen prüfbare Projektupdates.
4. Angewendete Änderungen erscheinen im Trail.
5. Entscheidungen können als append-only Commitments erfasst werden.

File Explorer

Der File Explorer ist die projektbezogene Dateiansicht.

Häufige Aktionen:

• Dateien hochladen
• Ordner erstellen
• Dateien öffnen oder im System-Dateiexplorer anzeigen
• umbenennen und löschen
• Elemente per Drag and Drop verschieben
• Dateien an Action Items anhängen
• KI-Zusammenfassungen für unterstützte Dateitypen erzeugen
• Dateien für Distillation einschließen oder ignorieren

Der File Explorer unterstützt Grid- und List-View. In der List-View kannst du über Spaltenköpfe sortieren.

Projektdateien bleiben nah am Kontext, in dem Menschen und Agenten sie tatsächlich verwenden.

Projekt-Dateiroot

Ein Projekt kann einen File-Explorer-Root-Pfad haben. Wenn er gesetzt ist, nutzt der File Explorer diesen Ort als Browsing-Basis.

Nutze einen dedizierten Projektordner, wenn:

• Projektdokumente bereits in einem bekannten Ordner liegen
• TensorPM echte Arbeitsdateien referenzieren soll
• lokale Agenten im selben Dateikontext arbeiten sollen

Vermeide einen breiten Home-Ordner als Projektroot. Das erzeugt zu viel Rauschen und erhöht die Chance, dass irrelevante Dateien in Projektworkflows sichtbar werden.

KI-Verhalten für Dateien

Für unterstützte Dateitypen kann TensorPM:

• Dateizusammenfassungen erzeugen
• Dateiinhalte im KI-Chat nutzen, wenn sie angehängt sind
• bewerten, ob eine Datei projektrelevante Updates enthält
• die Datei für Distillation vormerken

Nicht unterstützte Dateien können weiterhin im File Explorer liegen, erzeugen aber nicht denselben KI-Workflow.

Dateien an Action Items anhängen

Hänge Dateien an, wenn eine Aufgabe von einem konkreten Artefakt abhängt.

Gute Beispiele:

• Requirements-Dokument an Implementierungsarbeit
• Rechnung an Budgeteintrag
• Design-Mockup an Review-Aufgabe
• Spezifikation an QA-Aufgabe

So bleibt Ausführung mit Quellenmaterial verbunden.

Intake

Intake ist die Raw-Signal-Schicht. Sie sammelt projektrelevante Eingaben, die eventuell bewertet werden müssen.

Aktuelle Intake-Quellen sind:

• Projektdateien
• verarbeitete Dokumente
• E-Mails aus konfigurierten Connectors
• Raw Project Updates

Der Header kann Intake-Aktivität anzeigen. Öffne Intake, wenn du sehen willst, was vor der Übernahme in strukturierten Projektkontext geprüft werden muss.

Preview und Hydration

Bei großen Projekten kann Intake zunächst eine Vorschau zeigen und weitere Elemente im Hintergrund laden. Dadurch blockiert die UI nicht, während TensorPM viele ausstehende Dateien oder Signale lädt.

Wenn sich Zähler kurz nach dem Öffnen ändern, warte einen Moment und aktualisiere. Der vollständige Snapshot kann noch geladen werden.

Distiller

Der Distiller ist der Review-Agent für ausstehende Signale.

Seine normale Schleife:

1. Ein ausstehendes Signal analysieren.
2. Vorgeschlagene Änderungen präsentieren.
3. Nutzer prüfen die Vorschläge.
4. Freigegebene Projektupdates über Tools anwenden.
5. Ergebnis verifizieren.
6. Signal abschließen und zum nächsten wechseln.

Dadurch bleiben Projektupdates kontrolliert, statt jede erkannte Änderung still zu schreiben.

Für Distillation einschließen oder ignorieren

Nutze Ignore for distillation für Dateien, die im Ordner bleiben sollen, aber keine Projektupdates beeinflussen sollen.

Nutze Include for distillation, wenn eine Datei wieder relevant wird.

Typische Dateien zum Ignorieren:

• doppelte Exporte
• alte Screenshots
• Referenzmaterial ohne Projektzustand
• temporäre Dateien
• Rohassets ohne Entscheidungen oder Anforderungen

Trail Updates

Trail -> Updates zeigt verarbeitete Änderungen und Historie.

Trail macht Änderungen nachvollziehbar, wenn Kontext durch Dateien, KI oder Agenten aktualisiert wurde.

Nutze diese Ansicht für Fragen wie:

• Was hat sich geändert?
• Welches Feld hat sich geändert?
• Welche Quelle hat die Änderung ausgelöst?
• Kam die Änderung durch Distillation oder eine andere KI-/Tool-Aktion?
• Gibt es verarbeitete Signale mit Follow-up?

Trail ist besonders nützlich, wenn ein Projekt über Dateien, E-Mails, KI-Chat oder Agentenaktionen verändert wird und nicht nur durch manuelle Bearbeitung.

Trail Decisions

Trail -> Decisions speichert First-Class Commitments.

Entscheidungsdatensätze enthalten:

• Entscheidungstext
• Quelle der Entscheidung
• Akteur
• Entscheidungszeitpunkt
• Status
• Begründung
• Links zu Action Items, Risiken oder Meilensteinen
• Supersession-Kette, wenn sich eine Entscheidung ändert

Schreibe alte Entscheidungen nicht um, um Änderungen zu verstecken. Supersede oder withdraw sie, damit die Audit-Historie nützlich bleibt.

Wann du eine Entscheidung erfassen solltest

Erfasse eine Entscheidung, wenn sie Projektverhalten verändert.

Gute Kandidaten:

• Scope-Einschluss oder -Ausschluss
• Termin-Commitment
• Budgetgrenze
• Architektur-Richtung
• Vendor-Auswahl
• Risikoakzeptanz
• Stakeholder-Abstimmung
• Prioritätsregel

Chat-Nachrichten reichen für dauerhafte Commitments nicht aus. Lege Entscheidungen im Trail ab, damit Menschen und Agenten sie später finden.

Routine für Dateien und Trail

1. Quellen hochladen oder verbinden.
2. Dateien an konkrete Action Items anhängen, wenn sie Ausführungsnachweis sind.
3. Für große Referenzdokumente Zusammenfassungen erzeugen.
4. Rauschende Dateien ignorieren.
5. Pending Intake mit dem Distiller verarbeiten.
6. Trail Updates nach Änderungen prüfen.
7. Entscheidungen getrennt von allgemeinen Kontextupdates erfassen.

Fehlerbehebung

Wenn eine Datei nicht erscheint:

• prüfe den Projekt-Dateiroot
• aktualisiere den File Explorer
• prüfe, ob die Datei außerhalb des gewählten Roots liegt
• prüfe lokale Ordnerberechtigungen

Wenn Distillation eine Datei nicht aufgreift:

• prüfe, ob der Dateityp für KI-Verarbeitung unterstützt wird
• prüfe, ob die Datei ignoriert wurde
• erzeuge bei großen Dateien zuerst eine Zusammenfassung
• öffne Intake und prüfe, ob das Signal pending ist

Nächste Schritte

• Projektstruktur verstehen: Projektstruktur
• Arbeitsartefakte anhängen: Action Items
• Connectors und MCP-Clients konfigurieren: Agenten-Integrationen
• Datei- oder KI-Probleme lösen: Fehlerbehebung