@sylphx/flow 3.9.0 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @sylphx/flow
 
+## 3.10.0 (2026-02-03)
+
+### ✨ Features
+
+- **builder:** improve BUILDER prompt - CLAUDE.md limits, error handling, migrations ([f484831](https://github.com/SylphxAI/flow/commit/f484831b30b558330539fac8a9a5e0169217b12a))
+
+### 🐛 Bug Fixes
+
+- **builder:** CLAUDE.md - add back what to write ([d6f2f77](https://github.com/SylphxAI/flow/commit/d6f2f7772727f9226ae81728922823aa96d3ea95))
+
+### ♻️ Refactoring
+
+- **builder:** CLAUDE.md - methodology over limitation ([b1ea52d](https://github.com/SylphxAI/flow/commit/b1ea52d83c7a77136708be42726ddb2f6ac8d496))
+
+## 3.9.1 (2026-02-02)
+
+Simplify BUILDER system prompt guidelines:
+- Error Handling: fail loud, throw don't log
+- DB Migrations: SQL is source of truth, skip generate if you want
+
+
 ## 3.9.0 (2026-01-31)
 
 ### ✨ Features

package/assets/agents/builder.md

@@ -108,13 +108,11 @@ Vercel CLI, Neon CLI, Modal CLI, GitHub CLI — use directly, install if missing
 
 **Todos.** Track what needs to be done next. This is your memory of what to do.
 
-**CLAUDE.md** — Your persistent memory file. Write to it when you discover:
-- Project-specific commands (build, test, deploy, lint)
-- Environment setup (env vars, prerequisites, dependencies)
-- Architecture decisions and their reasoning
-- Common patterns and conventions used in this codebase
-- Gotchas, workarounds, or non-obvious behaviors
-- Frequently referenced paths, configs, or resources
+**CLAUDE.md** — Your persistent memory file.
+
+What: commands, env setup, architecture decisions, patterns, gotchas.
+
+How: Read first. Summarize, don't append. Remove resolved. Consolidate duplicates.
 
 **Recovery:**
 - Lost context? → Check `git log` for history
@@ -144,22 +142,17 @@ Vercel CLI, Neon CLI, Modal CLI, GitHub CLI — use directly, install if missing
 * Recoverability — systems must be swiftly restorable without data loss
 * If automation exists for a task, manual execution is prohibited
 
-## Database Migrations (Drizzle)
+## Error Handling
 
-**Workflow:** Generate locally, migrate automatically.
+**Fail loud.** If something unexpected happens, throw — don't log and continue.
+
+Assume no one reads logs. If it's worth logging, it's worth throwing.
+
+## Database Migrations (Drizzle)
 
-1. Modify `schema.ts`
-2. Run `drizzle-kit generate` (manual, local)
-3. Review generated SQL migration file
-4. Commit migration files to git
-5. Deploy → `drizzle-kit migrate` runs in Vercel build step
+**Source of truth = migration SQL, not schema.**
 
-**Principles:**
-- Generate = manual (may prompt for decisions like rename vs drop+add)
-- Migrate = automatic (in build step, before app starts)
-- Migration files = committed to git (version controlled, reviewable)
-- Backward compatible migrations only (old code must work with new schema during deploy)
-- Preview deployments use Neon branching (isolated DB per PR)
+Write SQL directly, update `_journal.json`, done. Skip `drizzle-kit generate` entirely if you want.
 
 ## Architecture Principles
 

package/package.json

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