cowork-flow 0.0.24 → 0.0.25
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/package.json
CHANGED
|
@@ -20,7 +20,7 @@ Use this skill as a manual advisory roundtable. Coordinate true child agents, no
|
|
|
20
20
|
Built-in defaults:
|
|
21
21
|
|
|
22
22
|
- `max_agents=3`
|
|
23
|
-
- `max_rounds=
|
|
23
|
+
- `max_rounds=5`
|
|
24
24
|
|
|
25
25
|
These defaults are configurable values, not hard-coded constants. Effective config order:
|
|
26
26
|
|
|
@@ -35,7 +35,7 @@ Configurable fields:
|
|
|
35
35
|
- agent roster or review lenses
|
|
36
36
|
- report enabled
|
|
37
37
|
- report path
|
|
38
|
-
-
|
|
38
|
+
- round phase policy, including when challenge may continue and when convergence must begin
|
|
39
39
|
|
|
40
40
|
Safety gates:
|
|
41
41
|
|
|
@@ -47,10 +47,14 @@ Safety gates:
|
|
|
47
47
|
## Round Model
|
|
48
48
|
|
|
49
49
|
1. Frame the question, decision needed, scope, and evidence packet.
|
|
50
|
-
2.
|
|
51
|
-
3.
|
|
52
|
-
4.
|
|
53
|
-
5.
|
|
50
|
+
2. Select the smallest useful agent roster or review lenses within effective `max_agents`. Record why each selected voice is useful and why omitted voices are not needed.
|
|
51
|
+
3. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
|
|
52
|
+
4. Synthesize evidence-backed positions into a compact claim table: `claim_id`, owner, claim, evidence, counterclaim, evidence gap, and decision impact.
|
|
53
|
+
5. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children, and bind each prompt to one `claim_id`.
|
|
54
|
+
6. Follow-up rounds should prefer the same live child that produced or challenged the relevant position. Send only the target claim, counterclaim, evidence gap, and ask the child to `agree`, `reject`, or `revise`.
|
|
55
|
+
7. For Challenge rounds, the default stance is scrutiny. Test the opposing claim first; choose `agree` only after naming the evidence that compels agreement.
|
|
56
|
+
8. Spawn an extra child only when the effective roster or lens config allows it, a live child failed, or the user approves expansion.
|
|
57
|
+
9. Stop when any stop condition is met and no dispatched child is still running. Then close live children through the Host Adapter close primitive.
|
|
54
58
|
|
|
55
59
|
Round intent:
|
|
56
60
|
|
|
@@ -61,10 +65,10 @@ Round intent:
|
|
|
61
65
|
Default mapping:
|
|
62
66
|
|
|
63
67
|
- Round 1 = Opening.
|
|
64
|
-
- Round 2 = Challenge.
|
|
65
|
-
-
|
|
68
|
+
- Round 2+ = Challenge while continue conditions still expose material disagreement, material risk, missing evidence, or untestable acceptance criteria.
|
|
69
|
+
- Convergence begins when the coordinator can write one recommended direction and no material challenge condition remains.
|
|
66
70
|
|
|
67
|
-
|
|
71
|
+
After convergence begins, do not reopen exploration unless the user approves or new concrete evidence appears.
|
|
68
72
|
|
|
69
73
|
## Continue Conditions
|
|
70
74
|
|
|
@@ -86,6 +90,13 @@ Stop when any condition holds:
|
|
|
86
90
|
- Effective `max_rounds` is reached.
|
|
87
91
|
- Output fails schema, and one repair prompt does not fix it.
|
|
88
92
|
|
|
93
|
+
## Waiting Children
|
|
94
|
+
|
|
95
|
+
- A wait timeout is not a child timeout.
|
|
96
|
+
- If a child remains live after a wait timeout, wait again or report it in `pending_children`.
|
|
97
|
+
- Do not close, cancel, omit, or synthesize around a live child unless the user explicitly asks to close it.
|
|
98
|
+
- When the discussion has converged or the user ends it, close live children after their final output is recorded.
|
|
99
|
+
|
|
89
100
|
## Child Output Schema
|
|
90
101
|
|
|
91
102
|
Each child must return these core fields. Extra fields are allowed only after them.
|
|
@@ -100,6 +111,18 @@ acceptance_signal:
|
|
|
100
111
|
what_would_change_my_mind:
|
|
101
112
|
```
|
|
102
113
|
|
|
114
|
+
Follow-up rounds may add these fields after the core fields:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
claim_id:
|
|
118
|
+
responding_to:
|
|
119
|
+
opposing_claim:
|
|
120
|
+
position_delta:
|
|
121
|
+
evidence_delta:
|
|
122
|
+
still_disagree:
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Use `position_delta` to say whether the child maintained, narrowed, or changed its position.
|
|
103
126
|
Reject unsupported opinion. Evidence should name files, commands, rules, observed behavior, user scenarios, or concrete assumptions.
|
|
104
127
|
|
|
105
128
|
## Coordinator Output Schema
|
|
@@ -107,6 +130,13 @@ Reject unsupported opinion. Evidence should name files, commands, rules, observe
|
|
|
107
130
|
Final synthesis must return these core fields. Extra fields are allowed only after them.
|
|
108
131
|
|
|
109
132
|
```text
|
|
133
|
+
effective_max_agents:
|
|
134
|
+
effective_max_rounds:
|
|
135
|
+
rounds_used:
|
|
136
|
+
selected_agents:
|
|
137
|
+
claim_table:
|
|
138
|
+
agent_turns:
|
|
139
|
+
pending_children:
|
|
110
140
|
consensus:
|
|
111
141
|
disagreements:
|
|
112
142
|
evidence:
|
|
@@ -114,7 +144,8 @@ decision:
|
|
|
114
144
|
rejected_options:
|
|
115
145
|
acceptance_criteria:
|
|
116
146
|
open_questions:
|
|
147
|
+
early_stop_reason:
|
|
117
148
|
stop_reason:
|
|
118
149
|
```
|
|
119
150
|
|
|
120
|
-
Keep the final decision traceable to child evidence. Do not count votes as validation.
|
|
151
|
+
`selected_agents` must include the selected agent or lens names and selection reasons. `agent_turns` should preserve a compact transcript with round, agent or lens, `claim_id`, position, and `position_delta`. Keep the final decision traceable to child evidence. Do not count votes as validation.
|
|
@@ -20,7 +20,7 @@ Use this skill as a manual advisory roundtable. Coordinate true child agents, no
|
|
|
20
20
|
Built-in defaults:
|
|
21
21
|
|
|
22
22
|
- `max_agents=3`
|
|
23
|
-
- `max_rounds=
|
|
23
|
+
- `max_rounds=5`
|
|
24
24
|
|
|
25
25
|
These defaults are configurable values, not hard-coded constants. Effective config order:
|
|
26
26
|
|
|
@@ -35,7 +35,7 @@ Configurable fields:
|
|
|
35
35
|
- agent roster or review lenses
|
|
36
36
|
- report enabled
|
|
37
37
|
- report path
|
|
38
|
-
-
|
|
38
|
+
- round phase policy, including when challenge may continue and when convergence must begin
|
|
39
39
|
|
|
40
40
|
Safety gates:
|
|
41
41
|
|
|
@@ -47,10 +47,14 @@ Safety gates:
|
|
|
47
47
|
## Round Model
|
|
48
48
|
|
|
49
49
|
1. Frame the question, decision needed, scope, and evidence packet.
|
|
50
|
-
2.
|
|
51
|
-
3.
|
|
52
|
-
4.
|
|
53
|
-
5.
|
|
50
|
+
2. Select the smallest useful agent roster or review lenses within effective `max_agents`. Record why each selected voice is useful and why omitted voices are not needed.
|
|
51
|
+
3. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
|
|
52
|
+
4. Synthesize evidence-backed positions into a compact claim table: `claim_id`, owner, claim, evidence, counterclaim, evidence gap, and decision impact.
|
|
53
|
+
5. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children, and bind each prompt to one `claim_id`.
|
|
54
|
+
6. Follow-up rounds should prefer the same live child that produced or challenged the relevant position. Send only the target claim, counterclaim, evidence gap, and ask the child to `agree`, `reject`, or `revise`.
|
|
55
|
+
7. For Challenge rounds, the default stance is scrutiny. Test the opposing claim first; choose `agree` only after naming the evidence that compels agreement.
|
|
56
|
+
8. Spawn an extra child only when the effective roster or lens config allows it, a live child failed, or the user approves expansion.
|
|
57
|
+
9. Stop when any stop condition is met and no dispatched child is still running. Then close live children through the Host Adapter close primitive.
|
|
54
58
|
|
|
55
59
|
Round intent:
|
|
56
60
|
|
|
@@ -61,10 +65,10 @@ Round intent:
|
|
|
61
65
|
Default mapping:
|
|
62
66
|
|
|
63
67
|
- Round 1 = Opening.
|
|
64
|
-
- Round 2 = Challenge.
|
|
65
|
-
-
|
|
68
|
+
- Round 2+ = Challenge while continue conditions still expose material disagreement, material risk, missing evidence, or untestable acceptance criteria.
|
|
69
|
+
- Convergence begins when the coordinator can write one recommended direction and no material challenge condition remains.
|
|
66
70
|
|
|
67
|
-
|
|
71
|
+
After convergence begins, do not reopen exploration unless the user approves or new concrete evidence appears.
|
|
68
72
|
|
|
69
73
|
## Continue Conditions
|
|
70
74
|
|
|
@@ -86,6 +90,13 @@ Stop when any condition holds:
|
|
|
86
90
|
- Effective `max_rounds` is reached.
|
|
87
91
|
- Output fails schema, and one repair prompt does not fix it.
|
|
88
92
|
|
|
93
|
+
## Waiting Children
|
|
94
|
+
|
|
95
|
+
- A wait timeout is not a child timeout.
|
|
96
|
+
- If a child remains live after a wait timeout, wait again or report it in `pending_children`.
|
|
97
|
+
- Do not close, cancel, omit, or synthesize around a live child unless the user explicitly asks to close it.
|
|
98
|
+
- When the discussion has converged or the user ends it, close live children after their final output is recorded.
|
|
99
|
+
|
|
89
100
|
## Child Output Schema
|
|
90
101
|
|
|
91
102
|
Each child must return these core fields. Extra fields are allowed only after them.
|
|
@@ -100,6 +111,18 @@ acceptance_signal:
|
|
|
100
111
|
what_would_change_my_mind:
|
|
101
112
|
```
|
|
102
113
|
|
|
114
|
+
Follow-up rounds may add these fields after the core fields:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
claim_id:
|
|
118
|
+
responding_to:
|
|
119
|
+
opposing_claim:
|
|
120
|
+
position_delta:
|
|
121
|
+
evidence_delta:
|
|
122
|
+
still_disagree:
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Use `position_delta` to say whether the child maintained, narrowed, or changed its position.
|
|
103
126
|
Reject unsupported opinion. Evidence should name files, commands, rules, observed behavior, user scenarios, or concrete assumptions.
|
|
104
127
|
|
|
105
128
|
## Coordinator Output Schema
|
|
@@ -107,6 +130,13 @@ Reject unsupported opinion. Evidence should name files, commands, rules, observe
|
|
|
107
130
|
Final synthesis must return these core fields. Extra fields are allowed only after them.
|
|
108
131
|
|
|
109
132
|
```text
|
|
133
|
+
effective_max_agents:
|
|
134
|
+
effective_max_rounds:
|
|
135
|
+
rounds_used:
|
|
136
|
+
selected_agents:
|
|
137
|
+
claim_table:
|
|
138
|
+
agent_turns:
|
|
139
|
+
pending_children:
|
|
110
140
|
consensus:
|
|
111
141
|
disagreements:
|
|
112
142
|
evidence:
|
|
@@ -114,7 +144,8 @@ decision:
|
|
|
114
144
|
rejected_options:
|
|
115
145
|
acceptance_criteria:
|
|
116
146
|
open_questions:
|
|
147
|
+
early_stop_reason:
|
|
117
148
|
stop_reason:
|
|
118
149
|
```
|
|
119
150
|
|
|
120
|
-
Keep the final decision traceable to child evidence. Do not count votes as validation.
|
|
151
|
+
`selected_agents` must include the selected agent or lens names and selection reasons. `agent_turns` should preserve a compact transcript with round, agent or lens, `claim_id`, position, and `position_delta`. Keep the final decision traceable to child evidence. Do not count votes as validation.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
0.0.
|
|
1
|
+
0.0.25
|