u-foo 1.9.1 → 1.9.2

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.
@@ -24,14 +24,15 @@ When you see a probe marker command like `/ufoo <marker>` (Claude) or `$ufoo <ma
24
24
 
25
25
  ### When to Record
26
26
 
27
- **"If it has information value, write it down."**
27
+ **"Only record decisions that matter beyond this session."**
28
28
 
29
- Record a decision whenever your work produces knowledge that would be useful to your future self, other agents, or the user. The threshold is LOWwhen in doubt, record it.
29
+ Record a decision for important, plan-level knowledge that other agents or your future self need. The threshold is HIGHmost tasks do NOT need a decision.
30
30
 
31
- - **Always record**: architectural choices, trade-off analysis, research findings, non-obvious gotchas, naming/convention changes, external API behavior discovered, performance observations, bug root causes
32
- - **Also record**: open questions you couldn't resolve, assumptions you made, approaches you considered and rejected (with reasons), edge cases noticed but not handled
31
+ - **Always record**: architectural choices, plan-level decisions with multiple options, cross-agent coordination decisions, trade-off analysis where alternatives were considered and rejected
32
+ - **Also record**: design patterns that set precedent, integration contracts between systems, decisions that constrain future work
33
+ - **Do NOT record**: routine bug fixes, simple implementation details, trivial observations, findings that only matter within the current task
33
34
  - **Write the decision BEFORE acting on it** — if your session dies, the knowledge survives
34
- - **Granularity**: one sentence or multi-page analysis match the depth to the information value
35
+ - **Rule of thumb**: if another agent wouldn't need to know about it, don't write a decision
35
36
 
36
37
  ### Commands
37
38
 
@@ -121,7 +122,35 @@ Notes:
121
122
 
122
123
  ---
123
124
 
124
- ## 3. Initialization (uinit)
125
+ ## 3. Message Format
126
+
127
+ Bus messages use a unified prefix format to distinguish sources:
128
+
129
+ - `[ufoo]<from:id(nickname)>` — message from another agent via the bus
130
+ - `[manual]<to:id(nickname)>` — manual user input directed at an agent
131
+
132
+ When you see `[ufoo]<from:xxx>` in your prompt, it's an inter-agent message — `xxx` is the sender's ID and nickname.
133
+ When you see `[manual]<to:xxx>`, it's a direct user instruction to an agent — `xxx` is the recipient's ID and nickname.
134
+
135
+ ---
136
+
137
+ ## 4. Team Activity (Input History)
138
+
139
+ Your bootstrap prompt may include a `## Team Activity` section showing recent prompts sent to all agents. Use this to understand:
140
+ - What each agent is currently working on
141
+ - Who sent what tasks to whom
142
+ - The overall coordination flow
143
+
144
+ Commands:
145
+ ```bash
146
+ ufoo history build # Rebuild timeline from bus + session data
147
+ ufoo history show [limit] # Show recent entries
148
+ ufoo history prompt [limit] # Render as injectable prompt block
149
+ ```
150
+
151
+ ---
152
+
153
+ ## 5. Initialization (uinit)
125
154
 
126
155
  Trigger: `/uinit` or `/ufoo init`
127
156
 
@@ -102,15 +102,17 @@ If pending events exist, show:
102
102
  ```
103
103
  === Pending Messages ===
104
104
 
105
- @you from claude-code:abc123
106
- Type: task/delegate
107
- Content: {"task":"review","file":"src/main.ts"}
105
+ [ufoo]<from:claude-code:abc123(architect)>
106
+ Type: message/targeted/message
107
+ Content: {"message":"review src/main.ts","injection_mode":"immediate"}
108
108
 
109
109
  ---
110
110
  Please handle the above messages, after completion you can reply:
111
- ufoo bus send "claude-code:abc123" "Review completed, found 2 issues..."
111
+ ufoo bus send "architect" "Review completed, found 2 issues..."
112
112
  ```
113
113
 
114
+ Note: Messages use `[ufoo]<from:id(nickname)>` prefix to distinguish from manual user input.
115
+
114
116
  ### 5. IMPORTANT: Acknowledge messages after handling
115
117
 
116
118
  After you have read and processed the messages, you MUST acknowledge them to prevent repeated notifications:
@@ -13,7 +13,8 @@ description: |
13
13
  Fast context check for daily use. Run at session start or anytime.
14
14
 
15
15
  Pre-flight reminder:
16
- - If the user is asking for evaluation/recommendation/plan, write a decision before replying.
16
+ - If the user is asking for an important architectural decision, a plan with multiple options, or a cross-agent coordination choice, write a decision before replying.
17
+ Do NOT write decisions for routine tasks, simple bug fixes, or trivial findings.
17
18
  Use: `ufoo ctx decisions new "<Title>"`
18
19
 
19
20
  ## Decision format (canonical)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "u-foo",
3
- "version": "1.9.1",
3
+ "version": "1.9.2",
4
4
  "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "homepage": "https://ufoo.dev",