112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
# 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)*
|