TICK.md

Multi-Agent-Aufgabenkoordination via Git-gestütztem Markdown

Koordiniere Arbeit zwischen Menschen und KI-Agenten mit strukturierten TICK.md-Dateien. Basierend auf Git, konzipiert für natürliche Sprachinteraktion, optimiert für Multi-Agenten-Workflows.

✨ Funktionen

🤖 KI-nativ: MCP-Server für nahtlose Bot-Integration
📝 Menschenlesbar: Einfaches Markdown mit YAML-Frontmatter
🔄 Git-gestützt: Vollständige Versionskontrolle und automatischer Prüfpfad
🎯 Abhängigkeitsverfolgung: Automatische Aufgabenentsperrung
🔒 Dateisperrung: Verhindert gleichzeitige Bearbeitungskonflikte
🔍 Erweiterte Filterung: Aufgaben nach Status, Priorität, Tags finden
📊 Visualisierung: Abhängigkeitsgraphen (ASCII und Mermaid)
👀 Echtzeit-Monitoring: Überwachungsmodus für Live-Updates
🌐 Lokal zuerst: Keine Cloud erforderlich, offline nutzbar

🚀 Schnellstart

CLI installieren

npm install -g tick-md

Projekt initialisieren

cd your-project
tick init
tick status

Aufgaben erstellen und beanspruchen

tick add "Authentifizierung bauen" --priority high --tags backend
tick claim TASK-001 @deinname
tick done TASK-001 @deinname

🤖 Für KI-Agenten

MCP-Server installieren

npm install -g tick-mcp-server

Zur MCP-Konfiguration hinzufügen (z. B. ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tick": {
      "command": "tick-mcp",
      "args": [],
      "env": {}
    }
  }
}

Die MCP-Werkzeuge nutzen

Der MCP-Server stellt alle CLI-Befehle als Werkzeuge bereit:

tick_init – Ein Projekt initialisieren
tick_add – Aufgaben erstellen
tick_claim – Aufgaben für deinen Agenten beanspruchen
tick_done – Aufgaben als erledigt markieren
tick_status – Projektübersicht erhalten
tick_list – Aufgaben abfragen und filtern
tick_comment – Fortschrittsnotizen hinzufügen

🎯 Schlüsselkonzepte

TICK.md-Dateistruktur

---
meta:
  project_id: my-project
  id_prefix: TASK
  next_id: 4
  updated: 2026-02-07T15:30:00-05:00
---

### TASK-001 · Benutzerauthentifizierung bauen

\`\`\`yaml
id: TASK-001
status: in_progress
priority: high
claimed_by: @claude-code
assigned_to: @claude-code
created_by: @gianni
created_at: 2026-02-07T10:00:00-05:00
updated_at: 2026-02-07T15:30:00-05:00
tags: [backend, auth]
depends_on: []
blocks: [TASK-002, TASK-003]
history:
  - ts: 2026-02-07T10:00:00  who: @gianni       action: created
  - ts: 2026-02-07T15:30:00  who: @claude-code  action: claimed
\`\`\`

> JWT-basierte Authentifizierung mit Refresh-Tokens bauen

Automatische Git-Commits

Standardmäßig erstellt jede Mutation einen Git-Commit:

[tick] TASK-001 von @claude-code beansprucht
[tick] TASK-001 von @claude-code abgeschlossen
[tick] TASK-003: erstellt

Mit Flags steuern:

--commit – Commit erzwingen
--no-commit – Commit überspringen
Oder in .tick/config.yml konfigurieren

Aufgabenstatus

backlog – Noch nicht bereit zum Starten
todo – Bereit zum Beanspruchen
in_progress – Wird bearbeitet
review – Wartet auf Überprüfung
blocked – Wartet auf Abhängigkeiten
done – Abgeschlossen

Dateisperrung

Die CLI verwendet .tick.lock, um gleichzeitige Bearbeitungen zu verhindern. Wenn ein Agent eine Aufgabe beansprucht, erwirbt er die Sperre. Andere Agenten sehen, dass die Aufgabe beansprucht ist, und können sie nicht ändern.

📚 Dokumentation

Protokollspezifikation: https://tick.md/docs/protocol
CLI-Referenz: https://tick.md/docs/cli
Erste Schritte: https://tick.md/docs/getting-started

💡 Beispiel-Workflow

# Mensch erstellt Aufgaben
tick add "Landingpage bauen" --priority high --tags frontend --assign @claude-code
tick add "Launch-E-Mail schreiben" --priority medium --tags content --assign @content-bot
tick add "E2E-Tests" --priority medium --tags qa --depends-on TASK-001

# KI-Agent nimmt Arbeit auf
tick claim TASK-001 @claude-code
tick comment TASK-001 @claude-code --note "Responsive Landingpage mit Hero-Bereich erstellt"
tick done TASK-001 @claude-code

# Ein anderer Agent löst automatisch aus
tick claim TASK-003 @qa-bot
tick done TASK-003 @qa-bot --skip-review

🔧 Konfiguration

Bearbeite .tick/config.yml:

git:
  auto_commit: true      # Automatischer Commit bei Mutationen (Standard: true)
  commit_prefix: "[tick]"
  push_on_sync: false

locking:
  enabled: true
  timeout: 300

agents:
  default_trust: full
  require_registration: false

🌟 Best Practices für OpenClaw Bots

Vor der Arbeit immer beanspruchen: tick claim TASK-XXX @deinbotname
Fortschrittskommentare hinzufügen: tick comment TASK-XXX @deinbotname --note "Statusupdate"
Bei Fertigstellung als erledigt markieren: tick done TASK-XXX @deinbotname
Abhängigkeiten prüfen: Verwende tick list --blocked, um blockierte Aufgaben zu finden
MCP-Server nutzen: Ermöglicht Aufgabenverwaltung in natürlicher Sprache

🔧 OpenClaw Multi-Agenten-Setup

Schritt-für-Schritt-Anleitung zur Koordination mehrerer OpenClaw Bots mit TICK.md.

1. Ein gemeinsam genutztes Aufgaben-Repo erstellen

gh repo create deineorg/projekt-tasks --private
cd projekt-tasks
npx tick-md init
git add -A && git commit -m "init" && git push

2. Auf jedem OpenClaw Bot-Server

cd /data/.openclaw/workspace
git clone [email protected]:deineorg/projekt-tasks.git tasks
cd tasks && npx tick-md status

3. Zu jedem Bot in AGENTS.md hinzufügen

## ✅ Aufgabenkoordination (TICK.md)

Ich koordiniere mich mit anderen Agenten über TICK.md in `./tasks/`.

### Vor Arbeitsbeginn:
1. `cd tasks && npx tick-md sync` – Neuesten Stand holen
2. `npx tick-md list --status backlog --priority high` – Verfügbare Arbeit finden
3. `npx tick-md claim TASK-XXX @meinbotname` – Vor der Arbeit beanspruchen
4. `npx tick-md done TASK-XXX @meinbotname` – Als erledigt markieren

### Regeln:
- **Niemals an einer Aufgabe arbeiten, die von einem anderen Agenten beansprucht wurde**
- **Vor dem Start immer beanspruchen**
- **Vor und nach der Arbeit synchronisieren**

4. Zu jedem Bot in HEARTBEAT.md hinzufügen

## Aufgaben-Sync (TICK.md)

- [ ] Aufgaben synchronisieren: `cd tasks && npx tick-md sync`
- [ ] Nach meiner Arbeit suchen: `npx tick-md list --claimed-by @meinbotname --status in_progress`
- [ ] Nach verfügbaren Aufgaben suchen: `npx tick-md list --status backlog --priority high`

5. Bereitstellungsschlüssel

Jeder Bot benötigt SSH-Zugriff auf das gemeinsam genutzte Repo. Erstelle auf jedem Server einen Deploy-Key:

ssh-keygen -t ed25519 -C "botname@tasks" -f ~/.ssh/tasks_deploy -N ""
cat ~/.ssh/tasks_deploy.pub
# Füge dies zu Repo-Einstellungen → Deploy-Keys hinzu (mit Schreibzugriff)

Konfiguriere Git zur Nutzung:

cd tasks
git config core.sshCommand "ssh -i ~/.ssh/tasks_deploy -o IdentitiesOnly=yes"

6. Sync-Befehl für Bots

Nach jeder Tick-Mutation Änderungen pushen:

cd tasks && git push

Oder tick sync verwenden, das Pull + Push automatisch erledigt.

📦 Paketinfo

CLI: tick-md auf npm
MCP-Server: tick-mcp-server auf npm
GitHub: https://github.com/Purple-Horizons/tick-md
Lizenz: MIT

🆘 Support

GitHub Issues: https://github.com/Purple-Horizons/tick-md/issues
Sponsor: https://github.com/sponsors/Purple-Horizons

In Ihrer bevorzugten KI fragen

Dokumentation