auto-commit 2026-02-02: avatar variants, health notes, experimenta VPN docs, werk-vision project

projects/werk-vision.md

@@ -0,0 +1,111 @@
+# 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)*