Skip to content

kiranmusze/micro-pe-operator-log

Repository files navigation

🏗️ Micro-PE Operator Log

Ein KI-Agent, der dein Unternehmen vom ersten Tag an verkaufbar dokumentiert.

Telegram → Claude API → Notion — automatisch kategorisiert, strukturiert, dataroom-ready.


Das Problem

Die meisten Gründer und Unternehmer dokumentieren ihre Entscheidungen nicht. Wenn sie verkaufen wollen, fehlt die Nachvollziehbarkeit — der größte Wertkiller beim Exit.

Die Lösung

Ein Telegram-Bot, der jede Nachricht von dir automatisch:

  • kategorisiert (Entscheidung, Meilenstein, Learning, Problem, ...)
  • einem Bereich zuordnet (Deals, Portfolio, System, ...)
  • die Sichtbarkeit einschätzt (Privat, Intern, LinkedIn-tauglich, Käufer-relevant)
  • in deine Notion-Datenbank schreibt — sauber, durchsuchbar, exportierbar

Du tippst. Der Agent strukturiert. Dein Dataroom baut sich selbst.


Architektur

Du (Telegram)
  │
  ▼
Telegram Bot (Python)
  │
  ▼
Claude API (Sonnet)
  ├── Titel extrahieren
  ├── Typ klassifizieren
  ├── Bereich zuordnen
  ├── Sichtbarkeit einschätzen
  └── Kontext erkennen
  │
  ▼
Notion API
  └── Neuer Eintrag in Activity Log DB

Features

Automatische Kategorisierung

Schreib eine Nachricht wie einem Kollegen — Claude erkennt automatisch alle Felder:

Heute entschieden: Wir wechseln von Lieferant A zu B.
Grund: 15% bessere Konditionen, gleiche Qualität.

Typ: Entscheidung · Bereich: PORTFOLIO · Sichtbarkeit: Käufer-relevant · Status: Erledigt

Explizite Feldangaben

Du kannst jedes Feld manuell überschreiben, direkt in der Nachricht:

Gespräch mit Investor über Beteiligung. Typ: Meeting, Bereich: DEALS

→ Typ und Bereich fix gesetzt, Rest automatisch klassifiziert. Erkennungsmuster: Feldname: Wert oder Feldname = Wert

Einträge nachträglich bearbeiten (/bearbeiten)

  1. Bot zeigt die letzten 10 Einträge als Inline-Buttons
  2. Feld auswählen: Typ, Bereich, Sichtbarkeit, Status, Zyklus, Kontext
  3. Neuen Wert per Button oder Freitext eingeben
  4. Option "Neu klassifizieren" — neuen Text eingeben, Claude kategorisiert alles neu

Kontext-Feld

Zusätzlicher Kontext wird separat vom Originaltext gespeichert:

Neue Produktlinie getestet. Kontext: nach dem Feedback vom Kundenevent letzte Woche

→ Beschreibung enthält den Originaltext, Kontext-Feld den Zusatzkontext.

Befehle

Befehl Funktion
/start Willkommensnachricht + Hilfe
/status Prüft Telegram, Claude API und Notion-Verbindung
/bearbeiten Startet Edit-Flow (letzte 10 Einträge)
/abbrechen Bricht laufenden Edit-Flow ab

Notion-Datenbank

Erstelle eine Notion-Datenbank mit diesen Feldern:

Feld Typ Optionen
Titel Title
Datum Date
Typ Select Entscheidung · Meilenstein · Reflexion · Learning · Problem · Idee · Agent-Event · Meeting
Bereich Select ME · DEALS · PORTFOLIO · SYSTEM · WISSEN
Beschreibung Rich Text
Kontext Rich Text
Sichtbarkeit Select 🔒 Privat · 👥 Intern · 📢 LinkedIn-tauglich · 🔑 Käufer-relevant
LinkedIn-Post Checkbox
Zyklus Select Zyklus 1 · Zyklus 2 · Zyklus 3 · Übergreifend
Status Select Offen · Erledigt · Beobachten

Tipp: Die Select-Optionen werden beim ersten Eintrag automatisch erstellt. Du musst sie nicht vorher manuell anlegen.

Empfohlene Views

View Filter
📅 Tagebuch Gallery, nach Datum absteigend
✅ Entscheidungen Typ = Entscheidung
📢 LinkedIn-Pipeline Sichtbarkeit = LinkedIn-tauglich + LinkedIn-Post = unchecked
🔑 Käufer-relevant Sichtbarkeit = Käufer-relevant
🤖 Agent-Events Typ = Agent-Event
📆 Kalender Kalender-View nach Datum

Schnellstart

1. Voraussetzungen

2. Installation

git clone https://github.com/kiranmusze/micro-pe-operator-log.git
cd micro-pe-operator-log
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env

3. .env konfigurieren

TELEGRAM_BOT_TOKEN=dein-telegram-token
ANTHROPIC_API_KEY=dein-anthropic-key
NOTION_TOKEN=dein-notion-integration-token
NOTION_DATABASE_ID=deine-datenbank-id
TELEGRAM_ALLOWED_USERS=deine-telegram-user-id

Sicherheit: TELEGRAM_ALLOWED_USERS stellt sicher, dass nur du den Bot nutzen kannst. Finde deine User-ID via @userinfobot auf Telegram.

4. Notion vorbereiten

  1. Neue Datenbank erstellen (Felder siehe oben)
  2. Notion Integration unter notion.so/my-integrations anlegen
  3. Integration zur Datenbank einladen: Share → Integration auswählen

5. Starten

python bot.py

6. Testen

Schick dem Bot in Telegram /status — er prüft alle drei Verbindungen (Telegram, Claude API, Notion).

Dann eine Testnachricht:

Heute entschieden, Lieferant A durch B zu ersetzen.
Grund: 15% bessere Konditionen, gleiche Qualität.

Warum dieses System funktioniert

  1. Null Reibung — Du tippst in Telegram wie du einem Kollegen schreibst
  2. Sofortige Struktur — Claude versteht Kontext und kategorisiert zuverlässig
  3. Override wenn nötig — Explizite Feldangaben überschreiben die Automatik
  4. Nachträglich editierbar/bearbeiten für schnelle Korrekturen
  5. Dataroom ab Tag 1 — Jeder Eintrag ist durchsuchbar, filterbar, exportierbar
  6. LinkedIn-Pipeline — Filter auf "LinkedIn-tauglich" = dein Content-Backlog
  7. Käufer-Perspektive — Filter auf "Käufer-relevant" = dein Dataroom

Kosten

  • Telegram Bot: kostenlos
  • Claude API (Sonnet): ~$0.001–0.003 pro Nachricht
  • Notion: kostenlos (Free Plan reicht)
  • Gesamt: <$1/Monat bei normaler Nutzung

Projekt-Kontext

Dieses Tool ist Teil des Valorem Capital Micro-PE-Frameworks: Deutsche KMUs ohne Nachfolger kaufen, mit KI automatisieren, den gesamten Prozess öffentlich dokumentieren.

Der Activity Log ist das Herzstück — gleichzeitig Operator-Tagebuch, Entscheidungsarchiv, Dataroom-Fundament und Content-Pipeline.


Lizenz

MIT — fork it, bau es um, mach es zu deinem.

About

KI-Agent der dein Unternehmen vom ersten Tag an verkaufbar dokumentiert. Telegram → Claude API → Notion.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages