@link-assistant/hive-mind 1.26.4 → 1.27.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @link-assistant/hive-mind
 
+## 1.27.0
+
+### Minor Changes
+
+- f6e909e: feat: make --gitkeep-file enabled by default for all --tools (Issue #1385)
+
+  Previously, `--claude-file` was the default for `--tool claude`, while `--gitkeep-file` was the default for other tools. Now `--gitkeep-file` is the universal default for all `--tool` values, including `--tool claude`.
+
+  As explained in the referenced video, CLAUDE.md and AGENT.md files generally do not help AI tools and should be avoided. Users who need CLAUDE.md-based task passing can still explicitly opt in with `--claude-file`.
+
 ## 1.26.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.26.4",
+  "version": "1.27.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/solve.auto-pr.lib.mjs

@@ -70,8 +70,8 @@ export async function handleAutoPrCreation({ argv, tempDir, branchName, issueNum
         }
       }
     } else {
-      // .gitkeep mode (via explicit --gitkeep-file or auto-gitkeep-file fallback)
-      const modeDesc = argv.gitkeepFile === true ? '.gitkeep (explicit --gitkeep-file)' : '.gitkeep (CLAUDE.md is ignored)';
+      // .gitkeep mode (default for all tools, or auto-gitkeep-file fallback)
+      const modeDesc = argv.claudeFile === false ? '.gitkeep (default)' : '.gitkeep (CLAUDE.md is ignored)';
       await log(formatAligned('📝', 'Creating:', modeDesc));
 
       filePath = path.join(tempDir, '.gitkeep');
@@ -133,7 +133,7 @@ Proceed.
       }
     } else {
       // .gitkeep: Use minimal metadata format (explicit --gitkeep-file or auto-gitkeep-file fallback)
-      const creationReason = argv.gitkeepFile === true ? '# This file was created with --gitkeep-file flag' : '# This file was created because CLAUDE.md is in .gitignore (--auto-gitkeep-file=true)';
+      const creationReason = argv.claudeFile === false ? '# This file was created with --gitkeep-file (default)' : '# This file was created because CLAUDE.md is in .gitignore (--auto-gitkeep-file=true)';
       const gitkeepContent = `# Auto-generated file for PR creation
 # Issue: ${issueUrl}
 # Branch: ${branchName}
@@ -297,8 +297,8 @@ ${creationReason}
     }
 
     await log(formatAligned('📝', 'Creating commit:', `With ${commitFileName} file`));
-    // Commit message distinguishes between explicit --gitkeep-file and auto-gitkeep-file fallback
-    const fileDesc = commitFileName === 'CLAUDE.md' ? 'CLAUDE.md with task information for AI processing' : `.gitkeep for PR creation (${argv.gitkeepFile === true ? 'created with --gitkeep-file flag' : 'CLAUDE.md is in .gitignore'})`;
+    // Commit message distinguishes between CLAUDE.md and .gitkeep modes
+    const fileDesc = commitFileName === 'CLAUDE.md' ? 'CLAUDE.md with task information for AI processing' : `.gitkeep for PR creation (${argv.claudeFile === false ? 'default mode' : 'CLAUDE.md is in .gitignore'})`;
     const commitMessage = `Initial commit with task details\n\nAdding ${fileDesc}.\nThis file will be removed when the task is complete.\n\nIssue: ${issueUrl}`;
 
     // Use explicit cwd option for better reliability

package/src/solve.config.lib.mjs

@@ -101,13 +101,13 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   'claude-file': {
     type: 'boolean',
-    description: 'Create CLAUDE.md file for task details (default for --tool claude, mutually exclusive with --gitkeep-file)',
-    default: true,
+    description: 'Create CLAUDE.md file for task details (mutually exclusive with --gitkeep-file)',
+    default: false,
   },
   'gitkeep-file': {
     type: 'boolean',
-    description: 'Create .gitkeep file instead of CLAUDE.md (default for --tool agent/opencode/codex, mutually exclusive with --claude-file)',
-    default: false,
+    description: 'Create .gitkeep file instead of CLAUDE.md (default for all --tool values, mutually exclusive with --claude-file)',
+    default: true,
   },
   'auto-gitkeep-file': {
     type: 'boolean',
@@ -541,20 +541,6 @@ export const parseArguments = async (yargs, hideBin) => {
     argv.model = 'minimax-m2.5-free';
   }
 
-  // Tool-specific defaults for --claude-file and --gitkeep-file
-  // For non-Claude tools, use .gitkeep by default to avoid polluting CLAUDE.md
-  // (CLAUDE.md has special meaning for Claude Code as a project-level instruction file)
-  // See: https://github.com/link-assistant/hive-mind/issues/1158
-  const claudeFileExplicitlyProvided = rawArgs.includes('--claude-file') || rawArgs.includes('--no-claude-file');
-  const gitkeepFileExplicitlyProvided = rawArgs.includes('--gitkeep-file') || rawArgs.includes('--no-gitkeep-file');
-
-  if (argv.tool !== 'claude' && !claudeFileExplicitlyProvided && !gitkeepFileExplicitlyProvided) {
-    // User did not explicitly provide either option, so use the correct defaults for non-Claude tools
-    // Non-Claude tools (agent, opencode, codex) should use .gitkeep by default
-    argv.claudeFile = false;
-    argv.gitkeepFile = true;
-  }
-
   // Validate mutual exclusivity of --claude-file and --gitkeep-file
   // Check if both are explicitly enabled (user passed both --claude-file and --gitkeep-file)
   if (argv.claudeFile && argv.gitkeepFile) {
@@ -588,7 +574,7 @@ export const parseArguments = async (yargs, hideBin) => {
     argv.claudeFile = false;
   }
 
-  // If user explicitly set --no-gitkeep-file, enable claude-file (this is the default anyway)
+  // If user explicitly set --no-gitkeep-file, enable claude-file
   if (noGitkeepFile && !argv.claudeFile) {
     argv.claudeFile = true;
     argv.gitkeepFile = false;