Open Source — MIT License

Give your AI agents
a brain for planning.

TaskPulse ist dateibasierte Task-Infrastruktur für KI-Agents. Kein CLI, kein Binary, keine Datenbank. Nur Markdown + YAML in einem .taskpulse/ Verzeichnis.

0Dependencies
0Installation
2Modi
Agents

KI-Agents vergessen alles.

Jede Konversation startet bei Null. Kein Fortschritt, keine Entscheidungshistorie, kein Koordinationsprotokoll. Das macht komplexe Aufgaben unmöglich.

Kein Gedächtnis über Sessions

Ein Agent der gestern 80% einer Aufgabe erledigt hat, weiß heute nichts mehr davon. Jede Session ist ein Neustart — Kontext, Entscheidungen, Fortschritt: alles weg.

Parallele Agents kollidieren

Zwei Agents gleichzeitig? ID-Kollisionen, Race Conditions, überschriebene Dateien. Ohne Koordinationsprotokoll ist Multi-Agent-Arbeit pures Chaos.

Kein Statusüberblick

„Wie weit bist du?" — Eine Frage, die kein Agent beantworten kann. Ohne strukturierte Dokumentation gibt es keinen Projektstand, keine Blocker-Sichtbarkeit, keine Roadmap.

Markdown-Dateien. Mehr braucht es nicht.

TaskPulse gibt Agents eine strukturierte Planungsschicht — als reine Dateisystem-Konvention. Agents lesen und schreiben Markdown mit YAML-Frontmatter. Fertig.

Solo-Modus

Ein Agent, volle Kontrolle

Ein einzelner Agent plant, arbeitet und dokumentiert sequentiell. Er zerlegt Aufgaben in Sub-Tasks, hakt Schritte ab, protokolliert Entscheidungen und liefert jederzeit einen Statusüberblick.

Orchestrator-Modus

Parallele Agents, null Kollisionen

Ein übergeordneter Orchestrator verteilt Arbeit an Subagents — mit partitionierten ID-Ranges und isolierten Schreibbereichen. Kein Race Condition, kein Chaos.

Kern-Feature

Alles ist eine Datei

Jeder Task ist ein TP-001.md mit YAML-Frontmatter. Status, Priorität, Abhängigkeiten, Ergebnisse — alles versionierbar, durchsuchbar und menschenlesbar. Keine Datenbank, kein Lock-in, kein Vendor.

TP-003.md
--- id: TP-003 title: "Auth-Middleware Refactoring" type: feature status: in_progress priority: high agent: "code-agent" blocked_by: [] output: ["src/middleware/auth.ts"] --- ## Plan 1. [x] Bestehende Middleware analysieren 2. [x] JWT-Validierung implementieren 3. [ ] Rate-Limiting hinzufügen 4. [ ] Tests schreiben ## Entscheidungen - JWT statt Session-Cookies — Stateless, skalierbar, Subagent-kompatibel

Orchestrator-Modus im Detail

Partitionierte ID-Ranges eliminieren Kollisionen. Jeder Subagent hat seinen eigenen Schreibbereich — kollisionsfrei, parallel, skalierbar.

Orchestrator
Vergibt Ranges · Prüft Abhängigkeiten · Konsolidiert
↓   ↓   ↓
ID-Range Partitionierung
Code-Agent
Range 100–149
Test-Agent
Range 150–199
Docs-Agent
Range 200–249
↓   ↓   ↓
TP-103.md
TP-155.md
TP-201.md
.taskpulse/

Vom ersten Task zum Projekt-Board

TaskPulse wird nicht installiert — es wird benutzt. Der Agent erkennt die Konvention und arbeitet sofort los.

1

Agent erkennt Aufgabe

Ein Agent bekommt eine komplexe Aufgabe — z.B. „Refactore das Auth-System". Er prüft ob .taskpulse/ existiert. Falls nicht, legt er es selbstständig an.

2

Tasks werden zerlegt

Die Aufgabe wird in Sub-Tasks mit Abhängigkeiten, Prioritäten und Plänen aufgebrochen. Jeder Task bekommt eine eigene Markdown-Datei mit vollständigem YAML-Frontmatter.

3

Arbeit wird dokumentiert

Während der Arbeit aktualisiert der Agent Status, hakt Schritte ab, protokolliert Entscheidungen und schreibt Ergebnisse. Alles in der Task-Datei und im täglichen Agent-Log.

4

Board-Status jederzeit abrufbar

Der Mensch fragt „Wie ist der Stand?" und bekommt sofort ein kompaktes Board mit allen aktiven Tasks, Blockern und Fortschritt — automatisch generiert aus den Dateien.

Agents ohne vs. mit TaskPulse

⊘ Ohne TaskPulse

  • Agent vergisst Fortschritt nach jeder Session
  • Entscheidungen gehen verloren — gleiche Fehler wiederholt
  • Parallele Agents überschreiben sich gegenseitig
  • Kein Statusüberblick für den Menschen
  • Abhängigkeiten unsichtbar — Blocker werden übersehen
  • Kein Audit-Trail für Arbeit und Begründungen

● Mit TaskPulse

  • Fortschritt persistiert in Markdown-Dateien
  • Entscheidungen und Begründungen protokolliert
  • Parallele Agents mit partitionierten ID-Ranges
  • Board-Status in Sekunden generiert
  • Abhängigkeitsketten und Blocker sichtbar
  • Vollständiger Audit-Trail pro Agent pro Tag

TaskPulse in Aktion

Vom Solo-Sprint bis zum Multi-Agent-Sicherheitsaudit — TaskPulse skaliert mit der Komplexität.

Beispiel 1

Solo: Feature-Entwicklung

Ein Code-Agent bekommt „Implementiere API-Rate-Limiting". Er erstellt 5 Sub-Tasks, arbeitet sie sequentiell ab, dokumentiert die Entscheidung für Token-Bucket statt Sliding-Window, und liefert am Ende einen sauberen Ergebnis-Block mit Output-Pfaden.

Beispiel 2

Multi-Agent: Sicherheitsaudit

Der Orchestrator erstellt drei Auftrags-Tasks: Penetrationstest (Code-Agent), OWASP-Checklist (Test-Agent), Audit-Bericht (Docs-Agent). Jeder Agent bekommt eine eigene ID-Range und arbeitet parallel. Der Orchestrator konsolidiert — zero Konflikte.

Board-Output

Was der Mensch sieht

Board-Status
## TaskPulse — Auth-Refactoring (Orchestrator, 3 Agents) ### Gesamtfortschritt Aufträge: 3 | Erledigt: 1 | In Arbeit: 2 | Blockiert: 0 ### code-agent (Range 100-149, 12 Tasks) - 8 done, 3 in_progress, 1 blocked - Aktuell: [TP-108] ●● API-Middleware — Schritt 4/6 ### test-agent (Range 150-199, 7 Tasks) - 4 done, 2 in_progress, 1 backlog - Aktuell: [TP-155] Integration-Test Auth-Flow

Die Philosophie dahinter

"

Das beste Tool ist das, das nicht installiert werden muss. TaskPulse ist eine Konvention — kein Produkt. Agents verstehen es sofort, weil es nur aus Dateien besteht die sie ohnehin schon lesen und schreiben können.

— Zero-Dependency-Philosophie

🔓 Kein Lock-in

MIT-Lizenz. Markdown-Dateien. Git-versionierbar. Du kannst TaskPulse morgen durch etwas anderes ersetzen — und verlierst nichts, weil alles menschenlesbarer Text ist.

🧩 Universell einsetzbar

Funktioniert mit Claude Code, Claude Cowork, Codex CLI, Cursor, oder jedem anderen Agent-Framework. Die Konvention ist framework-agnostisch — es ist nur ein Ordner mit Dateien.

📈 Skaliert mit Komplexität

Solo-Modus für einfache Aufgaben, Orchestrator-Modus für Multi-Agent-Projekte. Die gleiche Dateistruktur, das gleiche Schema, die gleichen Konventionen — nur der Koordinationslayer kommt dazu.

🔍 Stale-Detection

Der Orchestrator erkennt verwaiste Tasks automatisch: Wenn ein Agent 30 Minuten nichts aktualisiert hat, wird der Task zurück in den Backlog gesetzt und kann neu zugewiesen werden.

Die Verzeichnisstruktur

Projekt-Root
projekt/ ├── .taskpulse/ │ ├── config.yml # Projektkonfiguration │ ├── TP-001.md # Task │ ├── TP-002.md # Task │ ├── log/ # Pro Agent partitioniert │ │ ├── 2026-03-08_orchestrator.md │ │ ├── 2026-03-08_code-agent.md │ │ └── 2026-03-08_test-agent.md │ └── archive/ # Erledigte Tasks │ └── TP-000.md └── ROADMAP.md # Auto-generiert

Ready to go?

Kopiere den Skill, leg los. Keine Installation, kein Setup, keine Config. Dein nächster Agent weiß sofort was zu tun ist.

Repo auf GitHub öffnen SKILL.md lesen →