convez.ai
AgenteAutomaçãoAvançado
suraj-phanindra

Datum – Camada de Coordenação em Tempo Real para Agentes de IA

suraj-phanindra/datum

Coordenação de agentes em tempo real — Git para código, Datum para agentes em movimento

Ver no GitHub
BomPluginScore · de 0 a 100

Datum é uma camada de coordenação que sincroniza equipes de agentes de código (como Claude Code) trabalhando no mesmo repositório, detectando e prevenindo desvios de contrato antes que se materializem em merge. Funciona através de hooks determinísticos rápidos (sem modelo) para detecção e proteção, combinados com um árbitro assíncrono que gera advisories personalizadas e PRs de correção. Resolve o problema de múltiplos agentes construindo contra especificações obsoletas em paralelo.

Instalação

$npx convez-ai suraj-phanindra/datum

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Desenvolvimento colaborativo com múltiplos agentes de código no mesmo repositório
  • Detecção de desvios de contrato (mudanças de schema, APIs alteradas, decisões registradas) antes de merge
  • Sincronização de contexto entre agentes paralelos com atualização live da fonte de verdade
  • Geração automatizada de PRs de correção e advisories para agentes desincronizados

Veredito

Datum endereça um problema real e emergente em workflows de desenvolvimento com agentes de IA paralelos. A arquitetura de caminho rápido (sem modelo) + árbitro assíncrono é elegante, mas a curva de adoção é íngreme (requer setup de hooks, bus compartilhado e integração profunda com Claude Code). Recomendado para equipes em DevOps/Infra que já rodam agentes em coordenação e podem absorver a complexidade inicial.

README

A tradução para o português deste README ainda está na fila.

⌖ datum

Git coordinates code at rest. Datum coordinates agents in motion.

npm version license: MIT CI

Datum is the real-time coordination layer for teams whose engineers each run AI coding agents (such as Claude Code) against the same repo. It catches contract drift (a renamed database column, a swapped dependency, a changed API shape, a recorded decision) at the next write instead of at merge, by giving agents in flight a live, versioned source of truth that the agent cannot ignore.

The problem

Teams do spec-driven development right (a shared spec, a common CLAUDE.md, PRDs split per engineer), then implementation starts and truth changes. One agent renames a column; the others keep building against a contract that no longer exists, and the drift surfaces at merge after the rework is already paid for. Specs are snapshots; agents in flight need a live source of truth.

How it works

A deterministic fast path with a model slow path:

  • Detect (fast, no model). A PostToolUse hook streams every edit to a shared bus. A path-and-parser watchlist flags contract-relevant changes and bumps a monotonic registry version in milliseconds.
  • Protect (fast, no model). A PreToolUse fence runs a version check plus a set intersection on every tool call. A stale write that targets a changed contract is denied before it executes, with a reason naming the contract, the change, and the author, so the agent self-corrects on its next action. It fails open (never bricks an agent) if the bus is down.
  • Judge (slow, async, Opus 4.8). An arbiter off the critical path writes a per-recipient advisory tailored to each teammate's in-flight task and opens a pull request that patches the spec. It is model-agnostic.

The model is never on the critical path: the fence fires with the arbiter disabled.

Install

Claude Code plugin (recommended)

If you use Claude Code, install Datum as a plugin in one step:

/plugin marketplace add suraj-phanindra/datum
/plugin install datum@datum

The plugin wires everything an agent needs to coordinate natively:

  • The four hooks: datum-join (SessionStart), datum-claim (PostToolUse), datum-fence (PreToolUse), and datum-guard (Stop).
  • The MCP server, so agents can read the registry and ledger and publish claims, syncs, and decisions.
  • Five skills, namespaced under /datum:, that teach the agent the coordination loop and drive the MCP tools: coordinate, claim, sync, resolve-fence, and decide.

It is zero-init: the datum-join hook self-seeds git-native identity (human, email, branch, and workspace from your git config) on the first session, so there is no separate datumctl init step. Solo users get http://127.0.0.1:4317 by default; teams get their bus from the committed datum.json.

Manual / non-plugin alternative

If you are not on the Claude Code plugin path, install the CLI directly:

npx datumctl init        # wire Claude Code hooks + MCP, seed local state
datumctl serve           # start the coordination bus (point sessions here)

Either way, datumctl serve runs the coordination bus that sessions point at.

datumctl ships as a self-contained npm package with zero runtime dependencies (Node built-ins only). The installed hooks need Node ≥ 18; the bus (datumctl serve) uses node:sqlite and needs Node ≥ 22.5.

Teams (self-hosted, git-native)

The team is the repo. There is no login and no member list to maintain: membership is having the repo. Identity comes from your git config (user.name / user.email), and the workspace id derives from the git remote, so every clone of the same repo lands in the same team automatically.

# 1) one shared bus for the whole team (run it on a VM or behind a tunnel)
datumctl serve --public          # binds 0.0.0.0 and prints a tailscale/ngrok/cloudflared hint

# 2) datumctl init per engineer (the first init creates the committed datum.json)
datumctl init                    # human <- git user.name, email <- user.email,
                                 # branch <- current branch, workspace <- the remote
git add datum.json && git commit -m "datum: shared team config"

# 3) see the live fleet
datumctl team                    # workspace + bus + roster

The committed datum.json (repo root) shares the team's bus_url and workspace; the first init creates it, the rest read it. Full git-native model: docs/prd/teams.md.

Open core

The MIT-licensed core is the whole protocol: the CLI, the hooks, the MCP server, the single-team bus plus registry plus fence, the arbiter (bring your own Anthropic key), the git-native team layer, and the Claude Code skills. The core is never crippled, and a team can self-host all of it. Datum Cloud (premium, per-seat) adds the hosted multi-tenant bus, the team-management dashboard, a pooled arbiter (we pay the model cost), SSO, retention and audit, and analytics. Full model and architecture: docs/ROADMAP.md.

Project layout

datum/
  cli/                 datumctl entry + commands
  hooks/               datum-fence, datum-claim, datum-join, datum-guard
  server/              bus + registry + watchlist + arbiter + MCP server
  web/                 the read-only "tower" dashboard
  demo/                headless scenario (npm run demo)
  test/                node --test suites
  docs/                ROADMAP.md + design + spec
  datum Design System/ design tokens export

Develop

npm test          # node --test over TypeScript, no build step
npm run build     # bundle via esbuild -> dist/
npm run demo      # headless coordination scenario
npm run web       # serve the tower

Requires Node ≥ 22.6 for source and tests (native TypeScript type-stripping plus node:sqlite). Use Node 24 for development and CI. The arbiter uses claude-opus-4-8 via ANTHROPIC_API_KEY when set, else the authenticated claude CLI.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md.

Security

Found a vulnerability? Please follow the disclosure process in SECURITY.md.

License

MIT.

Ver o original no GitHub

Bom para

Relacionados