@fernado03/zoo-flow 0.1.2 → 0.1.3
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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Zoo Flow
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **Workflow control plane for [Zoo Code](https://docs.zoocode.dev/).**
|
|
4
4
|
|
|
5
5
|
A small, opinionated template that turns Zoo Code into a predictable
|
|
6
6
|
mode + command + skill orchestrator. Three modes, a fixed routing
|
|
@@ -32,15 +32,7 @@ A timestamped backup is always written to `.zoo-flow-backup/` before
|
|
|
32
32
|
overwrite.
|
|
33
33
|
|
|
34
34
|
After install, reload VS Code (Command Palette → **Developer: Reload
|
|
35
|
-
Window**)
|
|
36
|
-
small request like:
|
|
37
|
-
|
|
38
|
-
> change a harmless comment in `README`
|
|
39
|
-
|
|
40
|
-
Numbered choices are safe to click or type. Suggestions never carry
|
|
41
|
-
slash commands or mode names, so they will not route you into another
|
|
42
|
-
mode — see
|
|
43
|
-
[`docs/troubleshooting.md`](docs/troubleshooting.md#clickable-suggestions-can-route-incorrectly).
|
|
35
|
+
Window**) and open Zoo Code.
|
|
44
36
|
|
|
45
37
|
> **Note**: `.roomodes`, `.roo/commands/`, and `.roo/rules-{mode-slug}/`
|
|
46
38
|
> are kept as-is because they are the official Zoo Code configuration
|
|
@@ -55,6 +47,32 @@ skills know your tracker, labels, and domain layout. Skip it if you
|
|
|
55
47
|
only plan to use `/tweak`, `/fix`, `/explore`, `/refactor`,
|
|
56
48
|
`/diagnose`, `/prototype`, `/update-docs`, or `/commit-and-document`.
|
|
57
49
|
|
|
50
|
+
## Using it
|
|
51
|
+
|
|
52
|
+
Zoo Code switches modes automatically when you type a slash command,
|
|
53
|
+
based on the `mode:` field in the command file. That gives you two
|
|
54
|
+
ways to drive Zoo Flow, and the choice matters:
|
|
55
|
+
|
|
56
|
+
- **Free-form request from `custom-orchestrator`** (no leading slash).
|
|
57
|
+
The orchestrator picks a workflow, proposes it as a numbered choice,
|
|
58
|
+
and delegates only after you confirm. Use this when you want the
|
|
59
|
+
router to think first. This is how `custom-orchestrator` is
|
|
60
|
+
designed to work.
|
|
61
|
+
|
|
62
|
+
> change a harmless comment in `README`
|
|
63
|
+
|
|
64
|
+
- **Direct slash command from any mode.** The host switches you to
|
|
65
|
+
the command's configured mode and runs it, bypassing the
|
|
66
|
+
orchestrator entirely. Use this when you already know which
|
|
67
|
+
workflow you want.
|
|
68
|
+
|
|
69
|
+
> /tweak fix the typo in `README`
|
|
70
|
+
|
|
71
|
+
Numbered choices the orchestrator presents are answered by typing
|
|
72
|
+
the number. Clicking is safe when the suggestion has no mode-switch
|
|
73
|
+
indicator at the bottom-right; otherwise type instead. See
|
|
74
|
+
[`docs/troubleshooting.md`](docs/troubleshooting.md#clickable-suggestions-can-route-incorrectly).
|
|
75
|
+
|
|
58
76
|
## Update
|
|
59
77
|
|
|
60
78
|
```bash
|
|
@@ -118,13 +136,8 @@ need them.
|
|
|
118
136
|
Command files live in
|
|
119
137
|
[`templates/full/.roo/commands/`](templates/full/.roo/commands).
|
|
120
138
|
|
|
121
|
-
##
|
|
122
|
-
|
|
123
|
-
A short, fixed set of smoke tests in
|
|
124
|
-
[`docs/smoke-tests.md`](docs/smoke-tests.md) verifies routing, mode
|
|
125
|
-
boundaries, and skill loading. Worked examples:
|
|
139
|
+
## Worked examples
|
|
126
140
|
|
|
127
|
-
- [`examples/tweak-smoke-test.md`](examples/tweak-smoke-test.md)
|
|
128
141
|
- [`examples/fix-flow.md`](examples/fix-flow.md)
|
|
129
142
|
- [`examples/feature-flow.md`](examples/feature-flow.md)
|
|
130
143
|
|
package/bin/zoo-flow.js
CHANGED
|
@@ -246,7 +246,7 @@ ${didBackup ? `Backup:\n ${backupDir}\n` : ""}Next:
|
|
|
246
246
|
1. Reload VS Code
|
|
247
247
|
2. Open Zoo Code
|
|
248
248
|
3. Switch to custom-orchestrator
|
|
249
|
-
4.
|
|
249
|
+
4. Try a small request, e.g.:
|
|
250
250
|
change a harmless comment in README
|
|
251
251
|
|
|
252
252
|
When workflow choices appear, type the number manually, e.g. 1.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fernado03/zoo-flow",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "Workflow control plane for Zoo Code.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"zoo-flow": "bin/zoo-flow.js"
|
|
@@ -6,6 +6,7 @@ Suggestions:
|
|
|
6
6
|
|
|
7
7
|
- Descriptive labels OK.
|
|
8
8
|
- No slash commands or mode names.
|
|
9
|
+
- No per-option mode-switch indicator unless clicking that option really should switch modes. For "pick a number" routing questions, leave the indicator off.
|
|
9
10
|
- Include a Hold/Skip option when relevant.
|
|
10
11
|
|
|
11
12
|
Question body:
|
|
@@ -19,7 +20,7 @@ Example:
|
|
|
19
20
|
|
|
20
21
|
Question: Pick a regression test option.
|
|
21
22
|
|
|
22
|
-
1. Import-time
|
|
23
|
+
1. Import-time sanity check
|
|
23
24
|
2. Extract helper and unit-test
|
|
24
25
|
3. AST guard test
|
|
25
26
|
4. Hold
|