hivemind-agents 0.1.11 → 0.1.13

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 CHANGED
@@ -35,12 +35,19 @@ records goals, contracts, decisions and tasks in hivemind (tasks unassigned, wit
35
35
  each teammate's agent can claim one by key. You can also add things yourself with `hivemind add` or
36
36
  in the dashboard (`hivemind open`).
37
37
 
38
+ ## What belongs in the plan
39
+
40
+ The plan is for **coordinating with teammates**, not a log of each agent's work. Only what someone
41
+ else needs to know or act on goes in: who is doing what, interfaces between people's work, team
42
+ decisions, and questions for the team. An agent's own progress goes on its task. In a repo where
43
+ only one person has ever worked, hivemind tracks just task status.
44
+
38
45
  ## Plan and notebook
39
46
 
40
47
  hivemind keeps two things apart:
41
48
 
42
49
  - **The plan**: goals, tasks, contracts, decisions, open questions. What the team agreed and is doing.
43
- - **The notebook**: status, observations, measurements, environment state ("the lab box is busy until
50
+ - **The notebook**: status other people need, written on purpose (agents use `note_add`; the extractor never writes notes), expiring after 7 days: ("the lab box is busy until
44
51
  14:00", "precision 0.82 on the eval set", "image built locally, not pushed"). Agents see the last
45
52
  24 hours of notes at session start and can search the rest with `notebook_get`.
46
53
 
@@ -59,7 +66,10 @@ Plans that only grow stop being read. hivemind keeps them current on its own:
59
66
  active) closes what is superseded, duplicated or no longer true, marks tasks done that commits show
60
67
  finished, and moves status-like decisions to the notebook. Every change records its reason, and the
61
68
  run is logged in the notebook. Run it yourself with `hivemind tidy` (dry run) / `hivemind tidy --apply`.
62
- - **Stale work is visible:** a task stuck in progress shows "(no update for 6d)".
69
+ - **Tasks get concluded:** when an agent session ends, hivemind reads the end of its conversation and
70
+ settles the tasks it worked on: done, todo (with what's left) or blocked. Unfinished tasks and
71
+ questions nobody touches for a week are closed as abandoned. A task stuck in progress shows
72
+ "(no update for 6d)" until then.
63
73
 
64
74
  ## When the plan changes direction
65
75