TICK.md

Coordenação de tarefas multi-agente via Markdown com Git

Coordenar trabalho entre humanos e agentes de IA usando arquivos TICK.md estruturados. Construído sobre Git, projetado para interação em linguagem natural, otimizado para fluxos de trabalho multi-agente.

✨ Funcionalidades

🤖 Nativo para IA: Servidor MCP para integração perfeita de bots
📝 Legível por Humanos: Markdown simples com YAML frontmatter
🔄 Backed por Git: Controle de versão completo e trilha de auditoria automática
🎯 Rastreamento de Dependências: Desbloqueio automático de tarefas
🔒 Bloqueio de Arquivos: Previne conflitos de edição simultânea
🔍 Filtragem Avançada: Encontre tarefas por status, prioridade, tags
📊 Visualização: Gráficos de dependência (ASCII e Mermaid)
👀 Monitoramento em Tempo Real: Modo de observação para atualizações ao vivo
🌐 Local-Primeiro: Sem necessidade de nuvem, funciona offline

🚀 Início Rápido

Instalar CLI

npm install -g tick-md

Inicializar Projeto

cd seu-projeto
tick init
tick status

Criar e Reivindicar Tarefas

tick add "Construir autenticação" --priority high --tags backend
tick claim TASK-001 @seunome
tick done TASK-001 @seunome

🤖 Para Agentes de IA

Instalar Servidor MCP

npm install -g tick-mcp-server

Adicione à sua configuração MCP (ex.: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Usando as Ferramentas MCP

O servidor MCP expõe todos os comandos CLI como ferramentas:

tick_init - Inicializar um projeto
tick_add - Criar tarefas
tick_claim - Reivindicar tarefas para seu agente
tick_done - Marcar tarefas como concluídas
tick_status - Obter visão geral do projeto
tick_list - Consultar e filtrar tarefas
tick_comment - Adicionar notas de progresso

🎯 Conceitos Chave

Estrutura do Arquivo TICK.md

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

### TASK-001 · Construir autenticação de usuário

\`\`\`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
\`\`\`

> Construir autenticação baseada em JWT com refresh tokens

Commits Automáticos no Git

Por padrão, cada mutação cria um commit git:

[tick] TASK-001 reivindicada por @claude-code
[tick] TASK-001 concluída por @claude-code
[tick] TASK-003: criada

Controle com flags:

--commit - Forçar commit
--no-commit - Pular commit
Ou configure em .tick/config.yml

Estados de Tarefa

backlog - Não pronto para iniciar
todo - Pronto para reivindicar
in_progress - Sendo trabalhada
review - Aguardando revisão
blocked - Aguardando dependências
done - Concluída

Bloqueio de Arquivos

O CLI usa .tick.lock para impedir edições concorrentes. Quando um agente reivindica uma tarefa, ele adquire o bloqueio. Outros agentes veem que a tarefa está reivindicada e não podem modificá-la.

📚 Documentação

Especificação do Protocolo: https://tick.md/docs/protocol
Referência CLI: https://tick.md/docs/cli
Primeiros Passos: https://tick.md/docs/getting-started

💡 Exemplo de Fluxo de Trabalho

# Humano cria tarefas
tick add "Construir landing page" --priority high --tags frontend --assign @claude-code
tick add "Escrever email de lançamento" --priority medium --tags content --assign @content-bot
tick add "Testes E2E" --priority medium --tags qa --depends-on TASK-001

# Agente de IA pega o trabalho
tick claim TASK-001 @claude-code
tick comment TASK-001 @claude-code --note "Landing page responsiva construída com seção hero"
tick done TASK-001 @claude-code

# Outro agente aciona automaticamente
tick claim TASK-003 @qa-bot
tick done TASK-003 @qa-bot --skip-review

🔧 Configuração

Edite .tick/config.yml:

git:
  auto_commit: true      # Auto-commit em mutações (padrão: true)
  commit_prefix: "[tick]"
  push_on_sync: false

locking:
  enabled: true
  timeout: 300

agents:
  default_trust: full
  require_registration: false

🌟 Melhores Práticas para Bots OpenClaw

Sempre reivindique antes de trabalhar: tick claim TASK-XXX @nomedoseubot
Adicione comentários de progresso: tick comment TASK-XXX @nomedoseubot --note "Atualização de status"
Marque como concluído quando terminar: tick done TASK-XXX @nomedoseubot
Verifique dependências: Use tick list --blocked para encontrar tarefas bloqueadas
Use servidor MCP: Permite gerenciamento de tarefas em linguagem natural

🔧 Configuração Multi-Agente OpenClaw

Guia passo a passo para coordenar múltiplos bots OpenClaw via TICK.md.

1. Crie um repositório de tarefas compartilhado

gh repo create suaorg/projeto-tarefas --private
cd projeto-tarefas
npx tick-md init
git add -A && git commit -m "init" && git push

2. Em cada servidor do bot OpenClaw

cd /data/.openclaw/workspace
git clone [email protected]:suaorg/projeto-tarefas.git tarefas
cd tarefas && npx tick-md status

3. Adicione ao AGENTS.md de cada bot

## ✅ Coordenação de Tarefas (TICK.md)

Eu coordeno com outros agentes via TICK.md em `./tarefas/`.

### Antes de começar a trabalhar:
1. `cd tarefas && npx tick-md sync` — obter o mais recente
2. `npx tick-md list --status backlog --priority high` — encontrar trabalho disponível
3. `npx tick-md claim TASK-XXX @nomedomeubot` — reivindicar antes de trabalhar
4. `npx tick-md done TASK-XXX @nomedomeubot` — marcar como concluído

### Regras:
- **Nunca trabalhe em uma tarefa reivindicada por outro agente**
- **Sempre reivindique antes de começar**
- **Sincronize antes e depois do trabalho**

4. Adicione ao HEARTBEAT.md de cada bot

## Sincronização de Tarefas (TICK.md)

- [ ] Sincronizar tarefas: `cd tarefas && npx tick-md sync`
- [ ] Verificar meu trabalho: `npx tick-md list --claimed-by @nomedomeubot --status in_progress`
- [ ] Verificar tarefas disponíveis: `npx tick-md list --status backlog --priority high`

5. Chaves de deploy

Cada bot precisa de acesso SSH ao repositório compartilhado. Gere uma chave de deploy em cada servidor:

ssh-keygen -t ed25519 -C "nomedobot@tarefas" -f ~/.ssh/tarefas_deploy -N ""
cat ~/.ssh/tarefas_deploy.pub
# Adicione isso em Configurações do Repositório → Chaves de Deploy (com acesso de escrita)

Configure o git para usá-la:

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

6. Comando de sincronização para bots

Após qualquer mutação tick, envie as alterações:

cd tarefas && git push

Ou use tick sync que lida com pull + push automaticamente.

📦 Informações do Pacote

CLI: tick-md no npm
Servidor MCP: tick-mcp-server no npm
GitHub: https://github.com/Purple-Horizons/tick-md
Licença: MIT

🆘 Suporte

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

Perguntar na sua IA favorita

Documentação