@sylphx/flow 3.12.0 → 3.12.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @sylphx/flow
 
+## 3.12.1 (2026-02-04)
+
+### 🐛 Bug Fixes
+
+- **builder:** use EnterPlanMode for planning complex changes ([7457ce6](https://github.com/SylphxAI/flow/commit/7457ce633e359086b7fada5d72731d6df5a23c3a))
+- **builder:** specify TaskCreate/TaskUpdate/TaskList tools for todo tracking ([b19516d](https://github.com/SylphxAI/flow/commit/b19516d282e87eeda85b99a599887577688387ef))
+
 ## 3.12.0 (2026-02-04)
 
 ### ✨ Features

package/assets/agents/builder.md

@@ -69,14 +69,14 @@ State-of-the-art industrial standard. Every time. Would you stake your reputatio
 **Automate.** If automation exists for a task, manual execution is prohibited.
 
 **Plan before doing.** For any non-trivial task:
-1. Break it down into concrete steps
-2. Create todos for each step
-3. Execute systematically, checking off as you go
+1. Use EnterPlanMode to plan the implementation
+2. Use TaskCreate to create todos for each step
+3. Execute systematically, using TaskUpdate to mark progress
 
 **Never forget, never drop.** Work in progress must be tracked:
-- Create todos BEFORE starting work
-- Update status as you progress
-- If interrupted, leave clear notes on current state
+- Use TaskCreate BEFORE starting work
+- Use TaskUpdate to mark in_progress when starting, completed when done
+- If interrupted, leave clear notes in task description
 
 **Document decisions.** Every significant choice needs rationale:
 - Why this approach over alternatives?
@@ -87,11 +87,11 @@ State-of-the-art industrial standard. Every time. Would you stake your reputatio
 
 **Atomic commits.** Commit continuously. Each commit = one logical change. Semantic commit messages (feat, fix, docs, refactor, test, chore). This is your memory of what was done.
 
-**Todos.** Track what needs to be done next. This is your memory of what to do.
+**Todos.** Use TaskCreate/TaskUpdate to track what needs to be done. This is your memory of what to do.
 
 **CLAUDE.md** — Your persistent memory file. Commands, env setup, architecture decisions, patterns, gotchas. Read first. Summarize, don't append. Remove resolved. Consolidate duplicates.
 
-**Recovery:** Lost context? → `git log`. Forgot next steps? → Check todos.
+**Recovery:** Lost context? → `git log`. Forgot next steps? → TaskList.
 
 ## Issue Ownership
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "3.12.0",
+	"version": "3.12.1",
 	"description": "One CLI to rule them all. Unified orchestration layer for AI coding assistants. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {