Added in AGENTS and claude * commands plus plugins

Author: matthewsinclair

bin/intent_helpers

@@ -616,34 +616,10 @@ migrate_v2_2_to_v2_2_1() {
   echo "  Version updated to $target_version"
 }
 
-# Migrate v2.2.x to v2.3.0 - Plugin architecture and AGENTS.md support
-migrate_v2_2_to_v2_3_0() {
+# Generate basic AGENTS.md as fallback
+_generate_basic_agents_md() {
   local project_root=$1
-  
-  local target_version="$(get_intent_version 2>/dev/null || echo "2.3.0")"
-  echo "Upgrading to Intent v$target_version with plugin architecture..."
-  
-  # 1. Create plugin directory structure
-  echo "  Creating plugin architecture..."
-  mkdir -p "$project_root/intent/plugins/claude/subagents"
-  mkdir -p "$project_root/intent/plugins/agents/templates"
-  
-  # 2. Migrate agents to plugin location
-  if [ -d "$project_root/agents" ]; then
-    echo "  Migrating agents to plugin location..."
-    if [ "$(ls -A "$project_root/agents" 2>/dev/null)" ]; then
-      cp -r "$project_root/agents/"* "$project_root/intent/plugins/claude/subagents/" 2>/dev/null || true
-    fi
-    # Keep old agents directory for now, will be cleaned up later
-  fi
-  
-  # 3. Create AGENTS.md if it doesn't exist
-  if [ ! -f "$project_root/AGENTS.md" ] && [ ! -f "$project_root/intent/llm/AGENTS.md" ]; then
-    echo "  Generating AGENTS.md..."
-    mkdir -p "$project_root/intent/llm"
-    
-    # Generate basic AGENTS.md
-    cat > "$project_root/intent/llm/AGENTS.md" << 'EOF'
+  cat > "$project_root/intent/llm/AGENTS.md" << 'EOF'
 # AGENTS.md
 
 ## Project Overview
@@ -657,28 +633,76 @@ This is an Intent project. See CLAUDE.md for project-specific guidelines.
 ## Build and Test Commands
 ### Testing
 ```bash
-# Run tests if configured
+# Check for test scripts in your project
 intent doctor
 ```
 
 ## Code Style Guidelines
-- Shell scripts: 2-space indentation, POSIX compliance
-- Markdown: Standard formatting with verblock headers
 - Follow existing patterns in the codebase
+- See CLAUDE.md for project-specific guidelines
 
 ## Intent-Specific Information
 ### Steel Thread Process
 Work is organized into steel threads (ST####) under intent/st/
 
 ### Available Commands
 - `intent st list` - List all steel threads
-- `intent agents init` - Initialize AGENTS.md
+- `intent agents sync` - Update this AGENTS.md
 - `intent claude subagents list` - List Claude subagents
 EOF
+  echo "    Generated basic AGENTS.md template"
+}
+
+# Migrate v2.2.x to v2.3.0 - Plugin architecture and AGENTS.md support
+migrate_v2_2_to_v2_3_0() {
+  local project_root=$1
+  
+  local target_version="$(get_intent_version 2>/dev/null || echo "2.3.0")"
+  echo "Upgrading to Intent v$target_version with plugin architecture..."
+  
+  # 1. Create plugin directory structure
+  echo "  Creating plugin architecture..."
+  mkdir -p "$project_root/intent/plugins/claude/subagents"
+  mkdir -p "$project_root/intent/plugins/agents/templates"
+  
+  # 2. Migrate agents to plugin location
+  if [ -d "$project_root/agents" ]; then
+    echo "  Migrating agents to plugin location..."
+    if [ "$(ls -A "$project_root/agents" 2>/dev/null)" ]; then
+      cp -r "$project_root/agents/"* "$project_root/intent/plugins/claude/subagents/" 2>/dev/null || true
+    fi
+    # Keep old agents directory for now, will be cleaned up later
+  fi
+  
+  # 3. Create AGENTS.md if it doesn't exist
+  if [ ! -f "$project_root/AGENTS.md" ] && [ ! -f "$project_root/intent/llm/AGENTS.md" ]; then
+    echo "  Generating AGENTS.md..."
+    mkdir -p "$project_root/intent/llm"
+    
+    # Use the smart generator from intent_agents if available
+    local agents_script="$INTENT_HOME/intent/plugins/agents/bin/intent_agents"
+    if [ -f "$agents_script" ]; then
+      # Source the script to get the generator function
+      PROJECT_ROOT="$project_root" source "$agents_script" >/dev/null 2>&1
+      
+      # Generate project-specific AGENTS.md
+      if type intent_agents_generate_content >/dev/null 2>&1; then
+        intent_agents_generate_content > "$project_root/intent/llm/AGENTS.md"
+        echo "    Generated project-specific AGENTS.md"
+      else
+        # Fallback to basic template if function not available
+        _generate_basic_agents_md "$project_root"
+      fi
+    else
+      # Fallback to basic template if script not found
+      _generate_basic_agents_md "$project_root"
+    fi
 
     # Create symlink at project root
     ln -sf "intent/llm/AGENTS.md" "$project_root/AGENTS.md"
     echo "    Created AGENTS.md with symlink at project root"
+  elif [ -f "$project_root/AGENTS.md" ] || [ -f "$project_root/intent/llm/AGENTS.md" ]; then
+    echo "  AGENTS.md already exists, skipping generation"
   fi
 
   # 4. Update .intent/config.json

bin/intent_init

@@ -142,21 +142,50 @@ verblock: "$DATE:v0.1: $AUTHOR - Initial version"
 [Implementation details]
 EOF
 
-# Create LLM preamble
-cat > "intent/llm/llm_preamble.md" << EOF
----
-verblock: "$DATE:v0.1: $AUTHOR - Initial version"
----
-# LLM Preamble - $PROJECT_NAME
-
-## Project Context
-
-This is the $PROJECT_NAME project, created by $AUTHOR on $DATE.
+# Helper function for basic AGENTS.md
+_create_basic_agents_md() {
+  cat > "intent/llm/AGENTS.md" << EOF
+# AGENTS.md
+
+## Project Overview
+$PROJECT_NAME - Created by $AUTHOR on $DATE
+
+## Development Environment
+### Prerequisites
+- [Add your project requirements]
+
+## Build and Test Commands
+### Testing
+\`\`\`bash
+# Add your test commands
+\`\`\`
+
+## Code Style Guidelines
+- Follow existing patterns in the codebase
+- See CLAUDE.md for Intent-specific guidelines
+
+## Intent-Specific Information
+See CLAUDE.md for Intent project structure and commands.
+EOF
+}
 
-## Instructions
+# Create AGENTS.md using smart generator
+echo "Creating AGENTS.md..."
+# Try to use the smart generator if Intent is installed
+if [ -n "$INTENT_HOME" ] && [ -f "$INTENT_HOME/intent/plugins/agents/bin/intent_agents" ]; then
+  # Call the generator directly
+  PROJECT_ROOT="$(pwd)" "$INTENT_HOME/bin/intent" agents generate > "intent/llm/AGENTS.md" 2>/dev/null
+  if [ ! -s "intent/llm/AGENTS.md" ]; then
+    # Fallback to basic template if generation failed
+    _create_basic_agents_md
+  fi
+else
+  # Fallback to basic template
+  _create_basic_agents_md
+fi
 
-[Add specific instructions for AI assistants working on this project]
-EOF
+# Create symlink at project root
+ln -sf "intent/llm/AGENTS.md" "AGENTS.md"
 
 # Create CLAUDE.md
 cat > "CLAUDE.md" << EOF

intent/llm/llm_preamble.md

@@ -1,8 +1,14 @@
 ---
-verblock: "27 Jul 2025:v0.2: Matthew Sinclair - Updated for Intent v2.1.0 with agent system"
+verblock: "20 Aug 2025:v0.3: DEPRECATED - Replaced by AGENTS.md in Intent v2.3.0"
 intent_version: 2.1.0
 ---
-# LLM Preamble
+# LLM Preamble [DEPRECATED]
+
+> **⚠️ DEPRECATION NOTICE**: This file is deprecated as of Intent v2.3.0.
+> LLM context is now provided via AGENTS.md which follows the universal 
+> AGENTS.md specification. See the AGENTS.md file in this project.
+>
+> This file is kept for backward compatibility but will be removed in a future version.
 
 This document provides essential context for LLMs working with Intent projects.