deepflow 0.1.69 → 0.1.71
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 +11 -12
- package/bin/install.js +10 -20
- package/package.json +1 -1
- package/src/commands/df/auto.md +16 -0
package/README.md
CHANGED
|
@@ -77,10 +77,8 @@ You write the specs, then walk away. The AI runs the full pipeline — hypothesi
|
|
|
77
77
|
```bash
|
|
78
78
|
# You define WHAT (the specs), the AI figures out HOW, overnight
|
|
79
79
|
|
|
80
|
-
#
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
deepflow auto # process all specs in specs/
|
|
80
|
+
# Inside Claude Code (requires Agent Teams)
|
|
81
|
+
/df:auto # process all specs in specs/
|
|
84
82
|
```
|
|
85
83
|
|
|
86
84
|
**What the AI does alone:**
|
|
@@ -93,7 +91,7 @@ deepflow auto # process all specs in specs/
|
|
|
93
91
|
7. If rejected: generates new hypotheses, retries (up to max-cycles)
|
|
94
92
|
8. On convergence: verifies (L0-L4 gates), creates PR, merges to main
|
|
95
93
|
|
|
96
|
-
**What you do:** Write specs (via interactive mode or manually) in `specs/`, run `
|
|
94
|
+
**What you do:** Write specs (via interactive mode or manually) in `specs/`, run `/df:auto` inside Claude Code, read the report at `.deepflow/auto-report.md`. No need to run `/df:plan` first — auto mode promotes plain specs to `doing-*` automatically.
|
|
97
95
|
|
|
98
96
|
**How to use:**
|
|
99
97
|
```bash
|
|
@@ -103,15 +101,16 @@ $ claude
|
|
|
103
101
|
> /df:spec auth # creates specs/auth.md
|
|
104
102
|
> /exit
|
|
105
103
|
|
|
106
|
-
#
|
|
107
|
-
|
|
108
|
-
$ deepflow auto
|
|
104
|
+
# Inside Claude Code — run auto mode
|
|
105
|
+
> /df:auto
|
|
109
106
|
|
|
110
107
|
# Next morning — check what happened
|
|
111
108
|
$ cat .deepflow/auto-report.md
|
|
112
109
|
$ git log --oneline
|
|
113
110
|
```
|
|
114
111
|
|
|
112
|
+
**Requires:** `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in your environment (agent teams is an experimental Claude Code feature).
|
|
113
|
+
|
|
115
114
|
**Safety:** Never pushes to remote. Failed approaches recorded in `.deepflow/experiments/` and never repeated. Specs validated before processing (malformed specs are skipped).
|
|
116
115
|
|
|
117
116
|
### The Boundary
|
|
@@ -166,7 +165,7 @@ $ git log --oneline
|
|
|
166
165
|
## The Flow (Autonomous)
|
|
167
166
|
|
|
168
167
|
```
|
|
169
|
-
|
|
168
|
+
/df:auto
|
|
170
169
|
| Discover specs (auto-promote, topological sort by depends_on)
|
|
171
170
|
| For each doing-* spec:
|
|
172
171
|
|
|
|
@@ -225,7 +224,7 @@ Execution happens in an isolated git worktree:
|
|
|
225
224
|
|
|
226
225
|
## LSP Integration
|
|
227
226
|
|
|
228
|
-
|
|
227
|
+
/df:automatically enables Claude Code's LSP tools during install, giving agents access to `goToDefinition`, `findReferences`, and `workspaceSymbol` for precise code navigation instead of grep-based searching.
|
|
229
228
|
|
|
230
229
|
- **Global install:** sets `ENABLE_LSP_TOOL=1` in `~/.claude/settings.json`
|
|
231
230
|
- **Project install:** sets it in `.claude/settings.local.json`
|
|
@@ -235,7 +234,7 @@ Agents prefer LSP tools when available and fall back to Grep/Glob silently. You'
|
|
|
235
234
|
|
|
236
235
|
## Spec Validation
|
|
237
236
|
|
|
238
|
-
Specs are validated before downstream consumption by `/df:spec`, `/df:plan`, and
|
|
237
|
+
Specs are validated before downstream consumption by `/df:spec`, `/df:plan`, and `/df:auto`:
|
|
239
238
|
|
|
240
239
|
- **Hard invariants** (block on failure): required sections present, REQ-N prefixes, checkbox ACs, no duplicate IDs
|
|
241
240
|
- **Advisory warnings** (warn interactively, block in auto mode): long specs, orphaned requirements, excessive technical notes
|
|
@@ -263,7 +262,7 @@ Statusline shows context usage. At >=50%:
|
|
|
263
262
|
| `/df:consolidate` | Deduplicate and clean up decisions.md |
|
|
264
263
|
| `/df:resume` | Session continuity briefing |
|
|
265
264
|
| `/df:update` | Update deepflow to latest |
|
|
266
|
-
|
|
|
265
|
+
| `/df:auto` | Autonomous execution via agent teams (no human needed) |
|
|
267
266
|
|
|
268
267
|
## File Structure
|
|
269
268
|
|
package/bin/install.js
CHANGED
|
@@ -10,25 +10,15 @@ const os = require('os');
|
|
|
10
10
|
const readline = require('readline');
|
|
11
11
|
const { execFileSync } = require('child_process');
|
|
12
12
|
|
|
13
|
-
//
|
|
13
|
+
// Legacy subcommand: `deepflow auto` is now `/df:auto` inside Claude Code
|
|
14
14
|
if (process.argv[2] === 'auto') {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
console.error(' deepflow auto');
|
|
23
|
-
console.error('');
|
|
24
|
-
process.exit(1);
|
|
25
|
-
}
|
|
26
|
-
try {
|
|
27
|
-
execFileSync('claude', ['--agent', '.claude/agents/deepflow-auto.md', '-p', 'Run the full autonomous cycle. Process all doing-* specs.', ...process.argv.slice(3)], { stdio: 'inherit' });
|
|
28
|
-
} catch (e) {
|
|
29
|
-
process.exit(e.status || 1);
|
|
30
|
-
}
|
|
31
|
-
process.exit(0);
|
|
15
|
+
console.error('`deepflow auto` has moved inside Claude Code for better visibility.');
|
|
16
|
+
console.error('');
|
|
17
|
+
console.error('Usage:');
|
|
18
|
+
console.error(' 1. Open Claude Code: claude');
|
|
19
|
+
console.error(' 2. Run: /df:auto');
|
|
20
|
+
console.error('');
|
|
21
|
+
process.exit(1);
|
|
32
22
|
}
|
|
33
23
|
|
|
34
24
|
// Colors
|
|
@@ -196,9 +186,9 @@ async function main() {
|
|
|
196
186
|
console.log(`${c.green}Installation complete!${c.reset}`);
|
|
197
187
|
console.log('');
|
|
198
188
|
console.log(`Installed to ${c.cyan}${CLAUDE_DIR}${c.reset}:`);
|
|
199
|
-
console.log(' commands/df/ — /df:discover, /df:debate, /df:spec, /df:plan, /df:execute, /df:verify, /df:note, /df:resume, /df:update');
|
|
189
|
+
console.log(' commands/df/ — /df:discover, /df:debate, /df:spec, /df:plan, /df:execute, /df:verify, /df:auto, /df:note, /df:resume, /df:update');
|
|
200
190
|
console.log(' skills/ — gap-discovery, atomic-commits, code-completeness');
|
|
201
|
-
console.log(' agents/ — reasoner, deepflow-auto (autonomous
|
|
191
|
+
console.log(' agents/ — reasoner, deepflow-auto (/df:auto — autonomous execution)');
|
|
202
192
|
if (level === 'global') {
|
|
203
193
|
console.log(' hooks/ — statusline, update checker');
|
|
204
194
|
}
|
package/package.json
CHANGED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# /df:auto — Autonomous Mode
|
|
2
|
+
|
|
3
|
+
Run the full autonomous cycle via agent teams. Auto-promotes unprefixed specs to `doing-*`, then processes all `doing-*` specs through every phase: discover, pre-check, hypothesize, spike, implement, select, verify, PR, report.
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
```
|
|
7
|
+
/df:auto # process all specs
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Behavior
|
|
11
|
+
|
|
12
|
+
Load and execute the lead agent at `.claude/agents/deepflow-auto.md`.
|
|
13
|
+
|
|
14
|
+
Run the full autonomous cycle now. Auto-promote unprefixed specs to `doing-*`, then process all `doing-*` specs through every phase. Do not ask questions — act autonomously.
|
|
15
|
+
|
|
16
|
+
Output progress as each phase completes. Generate `.deepflow/auto-report.md` at the end.
|