@link-assistant/hive-mind 1.11.0 → 1.11.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @link-assistant/hive-mind
 
+## 1.11.1
+
+### Patch Changes
+
+- de2cc28: Use .gitkeep by default for --tool agent/opencode/codex instead of CLAUDE.md
+
+  When using non-Claude tools (agent, opencode, codex), the system now defaults to creating a `.gitkeep` file for task details instead of `CLAUDE.md`. This prevents pollution of CLAUDE.md, which has special meaning for Claude Code as a project-level instruction file.
+
+  **Tool-Specific Defaults:**
+  - `--tool claude`: defaults to `--claude-file` (existing behavior)
+  - `--tool agent/opencode/codex`: defaults to `--gitkeep-file`
+
+  Users can still explicitly override defaults with `--claude-file` or `--gitkeep-file` flags regardless of the selected tool.
+
 ## 1.11.0
 
 ### Minor Changes

package/package.json

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

package/src/solve.config.lib.mjs

@@ -130,12 +130,12 @@ export const createYargsConfig = yargsInstance => {
       })
       .option('claude-file', {
         type: 'boolean',
-        description: 'Create CLAUDE.md file for task details (default, mutually exclusive with --gitkeep-file)',
+        description: 'Create CLAUDE.md file for task details (default for --tool claude, mutually exclusive with --gitkeep-file)',
         default: true,
       })
       .option('gitkeep-file', {
         type: 'boolean',
-        description: 'Create .gitkeep file instead of CLAUDE.md (mutually exclusive with --claude-file)',
+        description: 'Create .gitkeep file instead of CLAUDE.md (default for --tool agent/opencode/codex, mutually exclusive with --claude-file)',
         default: false,
       })
       .option('auto-gitkeep-file', {
@@ -477,6 +477,20 @@ export const parseArguments = async (yargs, hideBin) => {
     argv.model = 'grok-code';
   }
 
+  // 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) {