deepflow 0.1.6 → 0.1.8

package/.claude/commands/df/execute.md

@@ -76,16 +76,15 @@ Ready = `[ ]` + all `blocked_by` complete + not in checkpoint.
 
 If context ≥50%: wait for agents, checkpoint, exit.
 
-| Ready | Strategy |
-|-------|----------|
-| 1-3 | All parallel |
-| 4+ | 5 parallel, queue rest |
+All ready tasks run in parallel. File conflicts execute sequentially.
 
-1 writer per file. On failure: spawn `reasoner`.
+On failure: spawn `reasoner`.
 
 ### 6. PER-TASK (agent)
 
-Implement → verify → commit → write result file.
+1. Read existing code patterns (if any)
+2. Implement following existing style
+3. Verify → commit → write result file
 
 ### 7. COMPLETE SPECS
 

package/.claude/commands/df/plan.md

@@ -42,7 +42,16 @@ Determine source_dir from config or default to src/
 
 If no new specs: report counts, suggest `/df:execute`.
 
-### 2. ANALYZE CODEBASE
+### 2. DETECT PROJECT CONTEXT
+
+For existing codebases, identify:
+- Code style/conventions
+- Existing patterns (error handling, API structure)
+- Integration points
+
+Include patterns in task descriptions for agents to follow.
+
+### 3. ANALYZE CODEBASE
 
 **Spawn Explore agents** (haiku, read-only) with dynamic count:
 
@@ -59,7 +68,7 @@ If no new specs: report counts, suggest `/df:execute`.
 - Stub functions, placeholder returns
 - Skipped tests, incomplete coverage
 
-### 3. COMPARE & PRIORITIZE
+### 4. COMPARE & PRIORITIZE
 
 **Spawn `reasoner` agent** (Opus) for analysis:
 
@@ -77,15 +86,15 @@ If no new specs: report counts, suggest `/df:execute`.
 2. Impact — core features before enhancements
 3. Risk — unknowns early
 
-### 4. OUTPUT PLAN.md
+### 5. OUTPUT PLAN.md
 
 Append tasks grouped by `### doing-{spec-name}`. Include spec gaps if any.
 
-### 5. RENAME SPECS
+### 6. RENAME SPECS
 
 `mv specs/feature.md specs/doing-feature.md`
 
-### 6. REPORT
+### 7. REPORT
 
 `✓ Plan generated — {n} specs, {n} tasks. Run /df:execute`
 
@@ -96,12 +105,12 @@ Append tasks grouped by `### doing-{spec-name}`. Include spec gaps if any.
 - Prefer existing utilities over new code
 - Flag spec gaps, don't silently ignore
 
-## Agent Limits
+## Agent Scaling
 
-| Agent | Base | Scale | Cap |
-|-------|------|-------|-----|
-| Explore (search) | 10 | +1 per 20 files | 100 |
-| Reasoner (analyze) | 5 | +1 per 2 specs | 20 |
+| Agent | Base | Scale |
+|-------|------|-------|
+| Explore (search) | 10 | +1 per 20 files |
+| Reasoner (analyze) | 5 | +1 per 2 specs |
 
 ## Example
 

package/README.md

@@ -14,8 +14,7 @@
 <p align="center">
   <a href="#quick-start">Quick Start</a> •
   <a href="#the-flow">The Flow</a> •
-  <a href="#commands">Commands</a> •
-  <a href="docs/getting-started.md">Docs</a>
+  <a href="#commands">Commands</a>
 </p>
 
 ---
@@ -25,9 +24,8 @@
 - **Stay in flow** — Minimize context switches, maximize deep work
 - **Conversational ideation** with proactive gap discovery
 - **Specs define intent**, tasks close reality gaps
-- **Parallel execution** with dependency awareness
+- **Parallel execution** with context-aware checkpointing
 - **Atomic commits** for clean rollback
-- **Minimal ceremony** — 4 commands, not 27
 
 ## Quick Start
 
@@ -38,7 +36,7 @@ npx deepflow
 # In your project
 claude
 
-# 1. Discuss what you want to build (conversation)
+# 1. Discuss what you want to build
 # 2. Generate spec when ready
 /df:spec image-upload
 
@@ -57,39 +55,42 @@ claude
 ```
 CONVERSATION
     │ Describe what you want
-    │ LLM asks gap questions (scope, edge cases, constraints)
+    │ LLM asks gap questions
     ▼
 /df:spec <name>
-    │ Generates specs/{name}.md
+    │ Creates specs/{name}.md
     ▼
 /df:plan
-    │ Compares specs to codebase
-    │ Finds TODOs, stubs, missing implementations
-    │ Outputs PLAN.md with prioritized tasks
+    │ Analyzes specs vs codebase
+    │ Creates PLAN.md with tasks
+    │ Renames: feature.md → doing-feature.md
     ▼
 /df:execute
-    │ Runs tasks respecting dependencies
-    │ Parallel for independent tasks
+    │ Parallel agents per wave
+    │ Context-aware (≥50% → checkpoint)
     │ Atomic commit per task
     ▼
 /df:verify
-    │ Checks spec requirements met
-    │ Updates PLAN.md status
+    │ Checks requirements met
+    │ Renames: doing-feature.md → done-feature.md
 ```
 
-## File Structure
-
-After running deepflow, your project will have:
+## Spec Lifecycle
 
 ```
-your-project/
-├── specs/
-│   ├── feature-a.md
-│   └── feature-b.md
-├── PLAN.md          # Task checklist
-└── STATE.md         # Decisions & learnings
+specs/
+  feature.md        → new, needs /df:plan
+  doing-feature.md  → in progress, has tasks in PLAN.md
+  done-feature.md   → completed, history embedded
 ```
 
+## Context-Aware Execution
+
+Statusline shows context usage. At ≥50%:
+- Waits for running agents
+- Checkpoints state
+- Resume with `/df:execute --continue`
+
 ## Commands
 
 | Command | Purpose |
@@ -98,40 +99,40 @@ your-project/
 | `/df:plan` | Compare specs to code, create tasks |
 | `/df:execute` | Run tasks with parallel agents |
 | `/df:verify` | Check specs satisfied |
+| `/df:update` | Update deepflow to latest |
+
+## File Structure
+
+```
+your-project/
+├── specs/
+│   ├── auth.md           # new spec
+│   ├── doing-upload.md   # in progress
+│   └── done-payments.md  # completed
+├── PLAN.md               # active tasks only
+└── .deepflow/
+    ├── context.json      # context % for execution
+    ├── checkpoint.json   # resume state
+    └── results/          # agent results
+```
 
 ## Configuration
 
-Create `.deepflow/config.yaml` in your project:
+Create `.deepflow/config.yaml`:
 
 ```yaml
 project:
   source_dir: src/
   specs_dir: specs/
-
-planning:
-  search_patterns:
-    - "TODO"
-    - "FIXME"
-    - "stub"
-    - "placeholder"
-
-parallelism:
-  max_search_agents: 50
-  max_write_agents: 5
-
-models:
-  search: sonnet
-  implement: sonnet
-  reason: opus
 ```
 
 ## Principles
 
 1. **Stay in flow** — Uninterrupted deep work
-2. **Confirm before assume** — Search code before creating "missing" tasks
+2. **Confirm before assume** — Search code before marking "missing"
 3. **Complete implementations** — No stubs, no placeholders
 4. **Atomic commits** — One task = one commit
-5. **Single writer per file** — Avoid race conditions
+5. **Context-aware** — Checkpoint before limits
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepflow",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Stay in flow state - lightweight spec-driven task orchestration for Claude Code",
   "keywords": [
     "claude",