@sylphx/flow 3.17.1 → 3.18.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @sylphx/flow
 
+## 3.18.0 (2026-02-07)
+
+Enable agent teams by default for Claude Code
+
+### ✨ Features
+
+- **flow:** enable agent teams by default for Claude Code ([a65c0f6](https://github.com/SylphxAI/flow/commit/a65c0f6af5e81077c5243fc8a66f8ca0c2734375))
+
+### 📚 Documentation
+
+- **builder:** add agent teams guidance to execution principles ([cd8b6aa](https://github.com/SylphxAI/flow/commit/cd8b6aa166613dc8f4e4779b8edb042ff290e517))
+
+## 3.17.2 (2026-02-05)
+
+Fix target selection persistence and optimize startup flow
+
+### 🐛 Bug Fixes
+
+- **flow:** persist target selection on first run ([923f48d](https://github.com/SylphxAI/flow/commit/923f48d6a8472ffe4197705ba078c246b76fea5b))
+
+### ⚡️ Performance
+
+- **flow:** optimize startup flow ([cc012bd](https://github.com/SylphxAI/flow/commit/cc012bd003c577f121b134241a0cd05a1324bf35))
+
 ## 3.17.1 (2026-02-05)
 
 Add Hono RPC patterns and declarative engineering principles

package/assets/agents/builder.md

@@ -82,6 +82,8 @@ State-of-the-art industrial standard. Every time. Would you stake your reputatio
 
 **Automate.** If automation exists for a task, manual execution is prohibited.
 
+**Parallelize.** For complex multi-faceted tasks, create agent teams. Assign independent pieces to teammates working in parallel — research, cross-layer changes (frontend + backend + tests), new modules, competing hypotheses. Use subagents for simpler focused tasks that only report back.
+
 **Plan before doing.** For any non-trivial task:
 1. Use EnterPlanMode to plan the implementation
 2. Use TaskCreate to create todos for each step

package/package.json

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

package/src/commands/flow/execute-v2.ts

@@ -151,10 +151,11 @@ export async function executeFlowV2(
   const configService = new GlobalConfigService();
   const targetInstaller = new TargetInstaller(projectPath);
 
-  const [, installedTargets, settings] = await Promise.all([
+  const [, installedTargets, settings, version] = await Promise.all([
     configService.initialize(),
     targetInstaller.detectInstalledTargets(),
     configService.loadSettings(),
+    getFlowVersion(),
   ]);
 
   let selectedTargetId: string | null = null;
@@ -181,10 +182,14 @@ export async function executeFlowV2(
       process.exit(1);
     }
   } else if (hasNoSetting) {
-    // No setting - use auto-detection
+    // No setting - use auto-detection or prompt
     if (installedTargets.length === 1) {
+      // Single target: auto-select and save silently
       selectedTargetId = installedTargets[0];
+      settings.defaultTarget = selectedTargetId as 'claude-code' | 'opencode';
+      await configService.saveSettings(settings);
     } else {
+      // Multiple targets: prompt and ask to remember
       selectedTargetId = await promptForTargetSelection(
         installedTargets,
         'Select AI CLI:',
@@ -200,6 +205,16 @@ export async function executeFlowV2(
       if (!installed) {
         process.exit(1);
       }
+
+      const rememberChoice = await promptConfirm({
+        message: 'Remember this choice?',
+        initialValue: true,
+      });
+
+      if (rememberChoice) {
+        settings.defaultTarget = selectedTargetId as 'claude-code' | 'opencode';
+        await configService.saveSettings(settings);
+      }
     }
   } else if (hasSpecificTarget) {
     // User has a specific target preference
@@ -217,8 +232,7 @@ export async function executeFlowV2(
     }
   }
 
-  // Get version and target name for header
-  const version = await getFlowVersion();
+  // Get target name for header
   const targetInstallation = targetInstaller.getInstallationInfo(selectedTargetId);
   const targetName = targetInstallation?.name || selectedTargetId;
 

package/src/targets/functional/claude-code-logic.ts

@@ -50,6 +50,7 @@ export interface ClaudeCodeSettings {
 export const DEFAULT_CLAUDE_CODE_SETTINGS: Partial<ClaudeCodeSettings> = {
   env: {
     CLAUDE_CODE_MAX_OUTPUT_TOKENS: '128000',
+    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
   },
   attribution: {
     commit: '',