# 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)*