Files
clawdbot/projects/werk-vision.md

3.2 KiB

werk — Vision

Ein Werkzeug, das AI-Agenten ermöglicht, fokussiert und effizient an komplexen Projekten zu arbeiten — alleine oder im Team.


Das Problem

"Was soll ich jetzt tun?" und "Was darf ich nicht vergessen?"

Diese Fragen muss ein AI-Agent schnell, token-effizient und zuverlässig beantworten können — egal ob es um einen simplen Reminder oder ein komplexes Projekt geht.

Bestehende Tools sind für Menschen gebaut. Sie verschwenden Tokens, haben Overhead, und verstehen nicht was ein LLM braucht.


Das Spektrum

werk deckt alles ab — vom Einfachen bis zum Komplexen:

Einfach Komplex
"Erinnere mich um 15 Uhr an den Friseurtermin" Multi-Agent Software-Projekt
Einzelner Task mit Zeitpunkt Hierarchien, Abhängigkeiten, Blocker
Mensch fragt, Agent erinnert Drei Agents arbeiten parallel

Ein Tool, ein Interface, ein Konzept — skaliert von der Einkaufsliste bis zum Produkt-Launch.


Die Lösung

werk — ein schlankes, lokales CLI-Tool, optimiert für die Arbeitsweise von LLMs.

Keine GUI. Kein Daemon. Keine Cloud. Nur Files und ein schnelles CLI.


Constraints (Leitplanken)

Constraint Begründung
Blitzschnell Wird ständig aufgerufen, darf nicht bremsen
Token-minimal Jedes Wort im Output muss zählen
Lokal & stateless Files sind die Wahrheit, kein Server
Multi-Agent safe Mehrere Agents arbeiten parallel, keine Kollisionen
Zeitgesteuert Cron fragt: "Was ist jetzt fällig?"
Blocker-aware Wartet auf Mensch/API/Script? → Nicht vorschlagen
Hierarchie-fähig Projekte → Tasks → Subtasks abbildbar
Abhängigkeiten Task B erst wenn Task A fertig
Status auf einen Blick Wo steht das Projekt? — schnell beantwortbar

Freiheiten (vom LLM zu entscheiden)

  • Dateiformat (YAML, JSON, Markdown, ...)
  • CLI-Struktur & Befehle
  • Locking-Strategie für Multi-Agent
  • Interne Architektur
  • Alles, was nicht in den Constraints steht

Das LLM soll basierend auf seinen Trainingsdaten das optimale Design wählen — nicht gegen vorgefertigte Schablonen arbeiten.


Der Lackmus-Test

Wenn werk fertig ist, funktioniert folgendes:

Ein Cron-Job ruft jede Minute werk auf.

Drei Claude Code Agents arbeiten parallel am gleichen Projekt.

Jeder holt sich seinen nächsten Task, arbeitet ihn ab, markiert ihn als done.

Keiner blockiert den anderen. Keiner macht doppelte Arbeit.

Das Projekt schreitet voran — wie von Geisterhand.


Wer erstellt Tasks?

  • Agents: Können selbstständig Tasks erstellen (z.B. bei Breakdown eines größeren Tasks)
  • Menschen: Können Tasks erstellen (z.B. neue Anforderung von Auftraggeber)
  • Beide: Arbeiten am gleichen Task-Pool

Wer nutzt werk?

  • AI Coding Agents (Claude Code, Codex, etc.)
  • OpenClaw / Clawdbot
  • Andere AI-Tools die Task-Management brauchen
  • Im Zweifel: auch Menschen via CLI

Was werk NICHT ist

  • Kein Jira/Linear-Ersatz für Teams aus Menschen
  • Keine GUI-Anwendung
  • Kein Cloud-Service
  • Kein Projekt-Management-Tool im klassischen Sinn

Erstellt: 2026-02-01 Domain: werk.bot GitHub Org: werkreset (geplant)