@henryqw/pi-subagent 11.1.0 → 11.1.1
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 +20 -4
- package/docs/delegate-flow.svg +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# `@henryqw/pi-subagent`
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Delegate bounded work from Main to isolated Pi Roles, or run independent implementation units through a fixed Git Flow.
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
## Why
|
|
8
8
|
|
|
9
|
-
- **Created for**:
|
|
10
|
-
- **Advantage**:
|
|
9
|
+
- **Created for**: Pi users who want focused child work without loading every detail into Main.
|
|
10
|
+
- **Advantage**: One Role system covers research, review, implementation, parallel work, and ordered chains.
|
|
11
11
|
|
|
12
12
|
## Install
|
|
13
13
|
|
|
@@ -16,16 +16,30 @@ pi install npm:@henryqw/pi-task-models
|
|
|
16
16
|
pi install npm:@henryqw/pi-subagent
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
+
Run `/task-models` and configure the `fast` profile before delegating.
|
|
20
|
+
|
|
19
21
|
## With
|
|
20
22
|
|
|
21
23
|
| Package | Why |
|
|
22
24
|
| --- | --- |
|
|
23
|
-
| `@henryqw/pi-task-models` | Required. Supplies `fast`, `balanced`, `frontier`, and `fav` model routes. |
|
|
25
|
+
| [`@henryqw/pi-task-models`](https://pi.henry.wang/extensions/pi-task-models) | Required. Supplies `fast`, `balanced`, `frontier`, and `fav` model routes. |
|
|
24
26
|
|
|
25
27
|
Routes come from `~/.pi/agent/config/pi-task-models/config.json`. It stores explicit task overrides. An explicit call `modelClass` wins over a Role `modelClass`; without either, pi-subagent uses its configured `pi-subagent/delegateTask` assignment or declared `fast` default. Missing shared model config warns once because delegation needs a route.
|
|
26
28
|
|
|
27
29
|
## Use
|
|
28
30
|
|
|
31
|
+
Start with one read-only delegation:
|
|
32
|
+
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"role": "scout",
|
|
36
|
+
"name": "Map sign-in flow",
|
|
37
|
+
"task": "Trace the sign-in request from entry point to session creation. Report the relevant files and unresolved risks. Do not edit files."
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
A separate child returns a bounded report to Main. It creates no saved Pi session and makes model requests through the selected route.
|
|
42
|
+
|
|
29
43
|
| Tool | Purpose |
|
|
30
44
|
| --- | --- |
|
|
31
45
|
| `delegate_task` | Run one bounded task, independent tasks in parallel, or dependent tasks in a chain. |
|
|
@@ -59,6 +73,8 @@ See the [orchestration guide](./docs/orchestration.md) for full delegation, tran
|
|
|
59
73
|
|
|
60
74
|
### Flow
|
|
61
75
|
|
|
76
|
+
|
|
77
|
+
|
|
62
78
|
Flow requires a clean Main worktree on an attached branch with a committed `HEAD`. Use it only for independent Git changes that can merge in any order. Do not split units that overlap files, APIs, schemas, generated output, package metadata, lockfiles, or invariants.
|
|
63
79
|
|
|
64
80
|
```text
|
package/docs/delegate-flow.svg
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
2
|
-
<svg viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="delegate-flow-title delegate-flow-desc">
|
|
2
|
+
<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="delegate-flow-title delegate-flow-desc">
|
|
3
3
|
<title id="delegate-flow-title">Delegate Flow lifecycle</title>
|
|
4
4
|
<desc id="delegate-flow-desc">Flowchart showing setup, implementation, validation, optional exact review, one repair attempt, integration, cleanup, and retained-worktree failure outcomes.</desc>
|
|
5
5
|
<defs>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@henryqw/pi-subagent",
|
|
3
|
-
"version": "11.1.
|
|
3
|
+
"version": "11.1.1",
|
|
4
4
|
"description": "Delegate bounded single, parallel, or chained tasks to isolated Pi roles.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
},
|
|
67
67
|
"dependencies": {
|
|
68
68
|
"@henryqw/pi-config-store": "^0.1.0",
|
|
69
|
-
"@henryqw/pi-multi-codex": "^0.
|
|
69
|
+
"@henryqw/pi-multi-codex": "^0.4.1",
|
|
70
70
|
"@henryqw/pi-task-models": "^4.0.0"
|
|
71
71
|
}
|
|
72
72
|
}
|