hivemind-agents 0.1.11 → 0.1.12

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