hivemind-agents 0.1.3 → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -1
- package/dist/hivemind.mjs +84 -69
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -28,6 +28,26 @@ Check whether your current work depends on the breaking changes above and adapt
|
|
|
28
28
|
At session start it gets the whole plan: goals, contracts (API shapes, schemas, shared types),
|
|
29
29
|
decisions, who's doing what, and open questions.
|
|
30
30
|
|
|
31
|
+
## Starting a plan
|
|
32
|
+
|
|
33
|
+
Just ask your agent, e.g. *"We're 3 people building X this weekend. Make a plan for the team."* It
|
|
34
|
+
records goals, contracts, decisions and tasks in hivemind (tasks unassigned, with dependencies), and
|
|
35
|
+
each teammate's agent can claim one by key. You can also add things yourself with `hivemind add` or
|
|
36
|
+
in the dashboard (`hivemind open`).
|
|
37
|
+
|
|
38
|
+
## When the plan changes direction
|
|
39
|
+
|
|
40
|
+
Plans change mid-hackathon. hivemind makes sure the old direction doesn't linger next to the new one:
|
|
41
|
+
|
|
42
|
+
- **New goals must say how they relate** to existing ones: they *replace* them, or are a *competing
|
|
43
|
+
proposal*. Competing goals are flagged to every agent ("the team hasn't picked one yet, ask the
|
|
44
|
+
user") until someone resolves them.
|
|
45
|
+
- Decisions and contracts can **replace** earlier ones, and agents are shown existing entries when
|
|
46
|
+
they add new ones so they can spot contradictions. The background extractor removes entries that
|
|
47
|
+
the work clearly abandoned.
|
|
48
|
+
- `hivemind review` (or the `plan_review` tool) has the model check the whole plan for contradictions
|
|
49
|
+
and suggest fixes (~15 s).
|
|
50
|
+
|
|
31
51
|
## How it works
|
|
32
52
|
|
|
33
53
|
```
|
|
@@ -46,7 +66,7 @@ decisions, who's doing what, and open questions.
|
|
|
46
66
|
- **The plan updates itself.** When an agent finishes a turn, a background extractor reads only the
|
|
47
67
|
new part of its transcript and pulls out the things teammates need: contracts, decisions and task
|
|
48
68
|
progress, each with a quote as evidence. Agents can also publish explicitly through MCP tools
|
|
49
|
-
(`contract_publish`, `decision_log`, `task_claim`, …), and they're told to for anything urgent.
|
|
69
|
+
(`contract_publish`, `decision_log`, `task_add`, `task_claim`, …), and they're told to for anything urgent.
|
|
50
70
|
- **Updates arrive in seconds.** Typically 2–5 s from one agent's change to the other machine,
|
|
51
71
|
then shown at that agent's next tool call.
|
|
52
72
|
|
|
@@ -77,6 +97,7 @@ Same hooks and MCP tools, no npm needed. Use either the plugin or `npx … insta
|
|
|
77
97
|
hivemind status who's in the plan, last sync
|
|
78
98
|
hivemind plan print the shared plan
|
|
79
99
|
hivemind open live dashboard in your browser (and a form to add to the plan)
|
|
100
|
+
hivemind review check the plan for contradictions
|
|
80
101
|
hivemind add <goal|task|contract|decision|question> <key> <text> [--breaking]
|
|
81
102
|
hivemind doctor check that everything is wired up
|
|
82
103
|
hivemind disable turn hivemind off for this clone (hivemind enable to undo)
|