@fernado03/zoo-flow 0.11.0 → 0.11.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 +60 -5
- package/bin/zoo-flow.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -130,9 +130,36 @@ For team usage, see `docs/team-mode.md`.
|
|
|
130
130
|
npx @fernado03/zoo-flow@latest update
|
|
131
131
|
```
|
|
132
132
|
|
|
133
|
-
Backs up your current `.
|
|
134
|
-
|
|
135
|
-
|
|
133
|
+
Backs up your current Zoo Flow files to `.zoo-flow-backup/<timestamp>/`, then replaces them with the latest template. Preview with `--dry-run`.
|
|
134
|
+
|
|
135
|
+
- **Zoo Code**: Backs up `.roomodes` and `.roo/`
|
|
136
|
+
- **Claude Code**: Backs up `CLAUDE.md` and `.claude/`
|
|
137
|
+
|
|
138
|
+
## Scratch working memory
|
|
139
|
+
|
|
140
|
+
Certain skills (like `/review`, `/diagnose`, and `/zoom-out`) use a scratch working memory pattern for deeper analysis. These skills:
|
|
141
|
+
|
|
142
|
+
- Create structured `.scratch/` subdirectories with date and context
|
|
143
|
+
- Write intermediate findings to separate files during multi-pass analysis
|
|
144
|
+
- Read back previous passes before synthesizing final insights
|
|
145
|
+
|
|
146
|
+
**Example structure:**
|
|
147
|
+
```
|
|
148
|
+
.scratch/
|
|
149
|
+
reviews/
|
|
150
|
+
2026-06-14_auth-refactor/
|
|
151
|
+
01_security.md # Security analysis pass
|
|
152
|
+
02_architecture.md # Architecture review pass
|
|
153
|
+
03_synthesis.md # Final insights from both passes
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
This enables:
|
|
157
|
+
- **Cross-angle insights**: Later passes reference earlier findings, catching issues that span multiple perspectives
|
|
158
|
+
- **Persistent reasoning**: Findings aren't lost in context window limits
|
|
159
|
+
- **Audit trail**: You can review the reasoning process, not just final conclusions
|
|
160
|
+
- **Ultracode-level depth**: Achieves thorough analysis within Zoo Flow's single-agent architecture
|
|
161
|
+
|
|
162
|
+
See `templates/full/.roo/rules/07-scratch-working-memory.md` for the protocol details.
|
|
136
163
|
|
|
137
164
|
## Token discipline
|
|
138
165
|
|
|
@@ -213,6 +240,8 @@ For command-addition rules, see [`docs/command-design.md`](docs/command-design.m
|
|
|
213
240
|
|
|
214
241
|
If you would rather copy the template by hand:
|
|
215
242
|
|
|
243
|
+
### Zoo Code
|
|
244
|
+
|
|
216
245
|
```sh
|
|
217
246
|
git clone https://github.com/Fernado03/zoo-flow.git /tmp/zoo-flow
|
|
218
247
|
cp /tmp/zoo-flow/templates/full/.roomodes .
|
|
@@ -227,14 +256,40 @@ grep -qxF "# Zoo Flow — generated config (never committed)" .gitignore 2>/dev/
|
|
|
227
256
|
|
|
228
257
|
Windows uses `git clone ... C:\Temp\zoo-flow` and `Copy-Item` (including `Copy-Item -Recurse` for `.roo\` and `.zoo-flow\`) instead. Add `.roomodes`, `.roo/`, and `.zoo-flow/` to `.gitignore`.
|
|
229
258
|
|
|
259
|
+
### Claude Code
|
|
260
|
+
|
|
261
|
+
```sh
|
|
262
|
+
git clone https://github.com/Fernado03/zoo-flow.git /tmp/zoo-flow
|
|
263
|
+
cp /tmp/zoo-flow/templates/claude-code/CLAUDE.md .
|
|
264
|
+
cp -R /tmp/zoo-flow/templates/claude-code/.claude .
|
|
265
|
+
cp -R /tmp/zoo-flow/templates/claude-code/.zoo-flow .
|
|
266
|
+
touch .gitignore
|
|
267
|
+
grep -qxF "# Zoo Flow — generated config (never committed)" .gitignore 2>/dev/null || {
|
|
268
|
+
printf "\n# Zoo Flow — generated config (never committed)\n" >> .gitignore
|
|
269
|
+
printf ".claude/\n.zoo-flow/\n" >> .gitignore
|
|
270
|
+
}
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
Windows uses the same approach with `Copy-Item` for `.claude\` and `.zoo-flow\`. Add `.claude/` and `.zoo-flow/` to `.gitignore`.
|
|
274
|
+
|
|
230
275
|
## Development
|
|
231
276
|
|
|
232
|
-
Before publishing, run:
|
|
277
|
+
Before publishing, run validation scripts from the package root:
|
|
233
278
|
|
|
234
279
|
```bash
|
|
235
|
-
|
|
280
|
+
# Run all validation checks
|
|
281
|
+
npm run check
|
|
282
|
+
|
|
283
|
+
# Run individual validations
|
|
284
|
+
npm run token-budget
|
|
285
|
+
npm run package-manifest
|
|
286
|
+
npm run golden-transcripts
|
|
287
|
+
npm run project-shapes
|
|
288
|
+
npm run score-quality
|
|
236
289
|
```
|
|
237
290
|
|
|
291
|
+
Note: These validate the template source, not an installed project. To validate an installation, run `npx @fernado03/zoo-flow@latest doctor` inside the target project.
|
|
292
|
+
|
|
238
293
|
## Migration
|
|
239
294
|
|
|
240
295
|
Zoo Flow started as a Roo Flow template and was renamed for Zoo Code.
|
package/bin/zoo-flow.js
CHANGED
|
@@ -61,8 +61,8 @@ const CLAUDE_CODE_GITIGNORE_MARKER = "# Zoo Flow — Claude Code config (never c
|
|
|
61
61
|
const CLAUDE_CODE_GITIGNORE_ENTRIES = [".claude/", ".zoo-flow/"];
|
|
62
62
|
|
|
63
63
|
function detectPlatform(projectRoot) {
|
|
64
|
-
if (pathExists(path.join(projectRoot, "CLAUDE.md"))) return "claude-code";
|
|
65
|
-
if (pathExists(path.join(projectRoot, ".roomodes"))) return "zoo-code";
|
|
64
|
+
if (pathExists(path.join(projectRoot, "CLAUDE.md")) || pathExists(path.join(projectRoot, ".claude"))) return "claude-code";
|
|
65
|
+
if (pathExists(path.join(projectRoot, ".roomodes")) || pathExists(path.join(projectRoot, ".roo"))) return "zoo-code";
|
|
66
66
|
return null;
|
|
67
67
|
}
|
|
68
68
|
|