Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

Updating agent context files

Den Delimarsky 🌺219ad02e4a7a
diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.sh
index b9dff8292..4f9e6e31c 100644
--- a/scripts/bash/update-agent-context.sh
+++ b/scripts/bash/update-agent-context.sh
@@ -1,69 +1,683 @@
#!/usr/bin/env bash
+
+# Update agent context files with information from plan.md
+#
+# This script maintains AI agent context files by parsing feature specifications
+# and updating agent-specific configuration files with project information.
+#
+# MAIN FUNCTIONS:
+# 1. Environment Validation
+# - Verifies git repository structure and branch information
+# - Checks for required plan.md files and templates
+# - Validates file permissions and accessibility
+#
+# 2. Plan Data Extraction
+# - Parses plan.md files to extract project metadata
+# - Identifies language/version, frameworks, databases, and project types
+# - Handles missing or incomplete specification data gracefully
+#
+# 3. Agent File Management
+# - Creates new agent context files from templates when needed
+# - Updates existing agent files with new project information
+# - Preserves manual additions and custom configurations
+# - Supports multiple AI agent formats and directory structures
+#
+# 4. Content Generation
+# - Generates language-specific build/test commands
+# - Creates appropriate project directory structures
+# - Updates technology stacks and recent changes sections
+# - Maintains consistent formatting and timestamps
+#
+# 5. Multi-Agent Support
+# - Handles agent-specific file paths and naming conventions
+# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf
+# - Can update single agents or all existing agent files
+# - Creates default Claude file if no agent files exist
+#
+# Usage: ./update-agent-context.sh [agent_type]
+# Agent types: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf
+# Leave empty to update all existing agent files
+
set -e
+
+# Enable strict error handling
+set -u
+set -o pipefail
+
+#==============================================================================
+# Configuration and Global Variables
+#==============================================================================
+
REPO_ROOT=$(git rev-parse --show-toplevel)
CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
FEATURE_DIR="$REPO_ROOT/specs/$CURRENT_BRANCH"
NEW_PLAN="$FEATURE_DIR/plan.md"
-CLAUDE_FILE="$REPO_ROOT/CLAUDE.md"; GEMINI_FILE="$REPO_ROOT/GEMINI.md"; COPILOT_FILE="$REPO_ROOT/.github/copilot-instructions.md"; CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"; QWEN_FILE="$REPO_ROOT/QWEN.md"; AGENTS_FILE="$REPO_ROOT/AGENTS.md"; WINDSURF_FILE="$REPO_ROOT/.windsurf/rules/specify-rules.md"
-AGENT_TYPE="$1"
-[ -f "$NEW_PLAN" ] || { echo "ERROR: No plan.md found at $NEW_PLAN"; exit 1; }
-echo "=== Updating agent context files for feature $CURRENT_BRANCH ==="
-NEW_LANG=$(grep "^**Language/Version**: " "$NEW_PLAN" 2>/dev/null | head -1 | sed 's/^**Language\/Version**: //' | grep -v "NEEDS CLARIFICATION" || echo "")
-NEW_FRAMEWORK=$(grep "^**Primary Dependencies**: " "$NEW_PLAN" 2>/dev/null | head -1 | sed 's/^**Primary Dependencies**: //' | grep -v "NEEDS CLARIFICATION" || echo "")
-NEW_DB=$(grep "^**Storage**: " "$NEW_PLAN" 2>/dev/null | head -1 | sed 's/^**Storage**: //' | grep -v "N/A" | grep -v "NEEDS CLARIFICATION" || echo "")
-NEW_PROJECT_TYPE=$(grep "^**Project Type**: " "$NEW_PLAN" 2>/dev/null | head -1 | sed 's/^**Project Type**: //' || echo "")
-update_agent_file() { local target_file="$1" agent_name="$2"; echo "Updating $agent_name context file: $target_file"; local temp_file=$(mktemp); if [ ! -f "$target_file" ]; then
- echo "Creating new $agent_name context file..."; if [ -f "$REPO_ROOT/.specify/templates/agent-file-template.md" ]; then cp "$REPO_ROOT/.specify/templates/agent-file-template.md" "$temp_file"; else echo "ERROR: Template not found"; return 1; fi;
- sed -i.bak "s/\[PROJECT NAME\]/$(basename $REPO_ROOT)/" "$temp_file"; sed -i.bak "s/\[DATE\]/$(date +%Y-%m-%d)/" "$temp_file"; sed -i.bak "s/\[EXTRACTED FROM ALL PLAN.MD FILES\]/- $NEW_LANG + $NEW_FRAMEWORK ($CURRENT_BRANCH)/" "$temp_file";
- if [[ "$NEW_PROJECT_TYPE" == *"web"* ]]; then sed -i.bak "s|\[ACTUAL STRUCTURE FROM PLANS\]|backend/\nfrontend/\ntests/|" "$temp_file"; else sed -i.bak "s|\[ACTUAL STRUCTURE FROM PLANS\]|src/\ntests/|" "$temp_file"; fi;
- if [[ "$NEW_LANG" == *"Python"* ]]; then COMMANDS="cd src && pytest && ruff check ."; elif [[ "$NEW_LANG" == *"Rust"* ]]; then COMMANDS="cargo test && cargo clippy"; elif [[ "$NEW_LANG" == *"JavaScript"* ]] || [[ "$NEW_LANG" == *"TypeScript"* ]]; then COMMANDS="npm test && npm run lint"; else COMMANDS="# Add commands for $NEW_LANG"; fi; sed -i.bak "s|\[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES\]|$COMMANDS|" "$temp_file";
- sed -i.bak "s|\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]|$NEW_LANG: Follow standard conventions|" "$temp_file"; sed -i.bak "s|\[LAST 3 FEATURES AND WHAT THEY ADDED\]|- $CURRENT_BRANCH: Added $NEW_LANG + $NEW_FRAMEWORK|" "$temp_file"; rm "$temp_file.bak";
-else
- echo "Updating existing $agent_name context file..."; manual_start=$(grep -n "<!-- MANUAL ADDITIONS START -->" "$target_file" | cut -d: -f1); manual_end=$(grep -n "<!-- MANUAL ADDITIONS END -->" "$target_file" | cut -d: -f1); if [ -n "$manual_start" ] && [ -n "$manual_end" ]; then sed -n "${manual_start},${manual_end}p" "$target_file" > /tmp/manual_additions.txt; fi;
- python3 - "$target_file" <<'EOF'
-import re,sys,datetime
-target=sys.argv[1]
-with open(target) as f: content=f.read()
-NEW_LANG="'$NEW_LANG'";NEW_FRAMEWORK="'$NEW_FRAMEWORK'";CURRENT_BRANCH="'$CURRENT_BRANCH'";NEW_DB="'$NEW_DB'";NEW_PROJECT_TYPE="'$NEW_PROJECT_TYPE'"
-# Tech section
-m=re.search(r'## Active Technologies\n(.*?)\n\n',content, re.DOTALL)
-if m:
- existing=m.group(1)
- additions=[]
- if '$NEW_LANG' and '$NEW_LANG' not in existing: additions.append(f"- $NEW_LANG + $NEW_FRAMEWORK ($CURRENT_BRANCH)")
- if '$NEW_DB' and '$NEW_DB' not in existing and '$NEW_DB'!='N/A': additions.append(f"- $NEW_DB ($CURRENT_BRANCH)")
- if additions:
- new_block=existing+"\n"+"\n".join(additions)
- content=content.replace(m.group(0),f"## Active Technologies\n{new_block}\n\n")
-# Recent changes
-m2=re.search(r'## Recent Changes\n(.*?)(\n\n|$)',content, re.DOTALL)
-if m2:
- lines=[l for l in m2.group(1).strip().split('\n') if l]
- lines.insert(0,f"- $CURRENT_BRANCH: Added $NEW_LANG + $NEW_FRAMEWORK")
- lines=lines[:3]
- content=re.sub(r'## Recent Changes\n.*?(\n\n|$)', '## Recent Changes\n'+"\n".join(lines)+'\n\n', content, flags=re.DOTALL)
-content=re.sub(r'Last updated: \d{4}-\d{2}-\d{2}', 'Last updated: '+datetime.datetime.now().strftime('%Y-%m-%d'), content)
-open(target+'.tmp','w').write(content)
-EOF
- mv "$target_file.tmp" "$target_file"; if [ -f /tmp/manual_additions.txt ]; then sed -i.bak '/<!-- MANUAL ADDITIONS START -->/,/<!-- MANUAL ADDITIONS END -->/d' "$target_file"; cat /tmp/manual_additions.txt >> "$target_file"; rm /tmp/manual_additions.txt "$target_file.bak"; fi;
-fi; mv "$temp_file" "$target_file" 2>/dev/null || true; echo "βœ… $agent_name context file updated successfully"; }
-case "$AGENT_TYPE" in
- claude) update_agent_file "$CLAUDE_FILE" "Claude Code" ;;
- gemini) update_agent_file "$GEMINI_FILE" "Gemini CLI" ;;
- copilot) update_agent_file "$COPILOT_FILE" "GitHub Copilot" ;;
- cursor) update_agent_file "$CURSOR_FILE" "Cursor IDE" ;;
- qwen) update_agent_file "$QWEN_FILE" "Qwen Code" ;;
- opencode) update_agent_file "$AGENTS_FILE" "opencode" ;;
- codex) update_agent_file "$AGENTS_FILE" "Codex CLI" ;;
- windsurf) update_agent_file "$WINDSURF_FILE" "Windsurf" ;;
- "") [ -f "$CLAUDE_FILE" ] && update_agent_file "$CLAUDE_FILE" "Claude Code"; \
- [ -f "$GEMINI_FILE" ] && update_agent_file "$GEMINI_FILE" "Gemini CLI"; \
- [ -f "$COPILOT_FILE" ] && update_agent_file "$COPILOT_FILE" "GitHub Copilot"; \
- [ -f "$CURSOR_FILE" ] && update_agent_file "$CURSOR_FILE" "Cursor IDE"; \
- [ -f "$QWEN_FILE" ] && update_agent_file "$QWEN_FILE" "Qwen Code"; \
- [ -f "$AGENTS_FILE" ] && update_agent_file "$AGENTS_FILE" "Codex/opencode"; \
- [ -f "$WINDSURF_FILE" ] && update_agent_file "$WINDSURF_FILE" "Windsurf"; \
- if [ ! -f "$CLAUDE_FILE" ] && [ ! -f "$GEMINI_FILE" ] && [ ! -f "$COPILOT_FILE" ] && [ ! -f "$CURSOR_FILE" ] && [ ! -f "$QWEN_FILE" ] && [ ! -f "$AGENTS_FILE" ] && [ ! -f "$WINDSURF_FILE" ]; then update_agent_file "$CLAUDE_FILE" "Claude Code"; fi ;;
- *) echo "ERROR: Unknown agent type '$AGENT_TYPE' (expected claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf)"; exit 1 ;;
-esac
-echo; echo "Summary of changes:"; [ -n "$NEW_LANG" ] && echo "- Added language: $NEW_LANG"; [ -n "$NEW_FRAMEWORK" ] && echo "- Added framework: $NEW_FRAMEWORK"; [ -n "$NEW_DB" ] && [ "$NEW_DB" != "N/A" ] && echo "- Added database: $NEW_DB"; echo; echo "Usage: $0 [claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf]"
+AGENT_TYPE="${1:-}"
+
+# Agent-specific file paths
+CLAUDE_FILE="$REPO_ROOT/CLAUDE.md"
+GEMINI_FILE="$REPO_ROOT/GEMINI.md"
+COPILOT_FILE="$REPO_ROOT/.github/copilot-instructions.md"
+CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"
+QWEN_FILE="$REPO_ROOT/QWEN.md"
+AGENTS_FILE="$REPO_ROOT/AGENTS.md"
+WINDSURF_FILE="$REPO_ROOT/.windsurf/rules/specify-rules.md"
+
+# Template file
+TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"
+
+# Global variables for parsed plan data
+NEW_LANG=""
+NEW_FRAMEWORK=""
+NEW_DB=""
+NEW_PROJECT_TYPE=""
+
+#==============================================================================
+# Utility Functions
+#==============================================================================
+
+log_info() {
+ echo "INFO: $1"
+}
+
+log_success() {
+ echo "βœ“ $1"
+}
+
+log_error() {
+ echo "ERROR: $1" >&2
+}
+
+log_warning() {
+ echo "WARNING: $1" >&2
+}
+
+# Cleanup function for temporary files
+cleanup() {
+ local exit_code=$?
+ rm -f /tmp/agent_update_*_$$
+ rm -f /tmp/manual_additions_$$
+ exit $exit_code
+}
+
+# Set up cleanup trap
+trap cleanup EXIT INT TERM
+
+#==============================================================================
+# Validation Functions
+#==============================================================================
+
+validate_environment() {
+ # Check if we're in a git repository
+ if ! git rev-parse --show-toplevel >/dev/null 2>&1; then
+ log_error "Not in a git repository"
+ exit 1
+ fi
+
+ # Check if we have a current branch
+ if [[ -z "$CURRENT_BRANCH" ]]; then
+ log_error "Unable to determine current git branch"
+ exit 1
+ fi
+
+ # Check if plan.md exists
+ if [[ ! -f "$NEW_PLAN" ]]; then
+ log_error "No plan.md found at $NEW_PLAN"
+ log_info "Make sure you're on a feature branch with a corresponding spec directory"
+ exit 1
+ fi
+
+ # Check if template exists (needed for new files)
+ if [[ ! -f "$TEMPLATE_FILE" ]]; then
+ log_warning "Template file not found at $TEMPLATE_FILE"
+ log_warning "Creating new agent files will fail"
+ fi
+}
+
+#==============================================================================
+# Plan Parsing Functions
+#==============================================================================
+
+extract_plan_field() {
+ local field_pattern="$1"
+ local plan_file="$2"
+
+ grep "^**${field_pattern}**: " "$plan_file" 2>/dev/null | \
+ head -1 | \
+ sed "s/^**${field_pattern}**: //" | \
+ grep -v "NEEDS CLARIFICATION" | \
+ grep -v "^N/A$" || echo ""
+}
+
+parse_plan_data() {
+ local plan_file="$1"
+
+ if [[ ! -f "$plan_file" ]]; then
+ log_error "Plan file not found: $plan_file"
+ return 1
+ fi
+
+ if [[ ! -r "$plan_file" ]]; then
+ log_error "Plan file is not readable: $plan_file"
+ return 1
+ fi
+
+ log_info "Parsing plan data from $plan_file"
+
+ NEW_LANG=$(extract_plan_field "Language/Version" "$plan_file")
+ NEW_FRAMEWORK=$(extract_plan_field "Primary Dependencies" "$plan_file")
+ NEW_DB=$(extract_plan_field "Storage" "$plan_file")
+ NEW_PROJECT_TYPE=$(extract_plan_field "Project Type" "$plan_file")
+
+ # Log what we found
+ if [[ -n "$NEW_LANG" ]]; then
+ log_info "Found language: $NEW_LANG"
+ else
+ log_warning "No language information found in plan"
+ fi
+
+ if [[ -n "$NEW_FRAMEWORK" ]]; then
+ log_info "Found framework: $NEW_FRAMEWORK"
+ fi
+
+ if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]]; then
+ log_info "Found database: $NEW_DB"
+ fi
+
+ if [[ -n "$NEW_PROJECT_TYPE" ]]; then
+ log_info "Found project type: $NEW_PROJECT_TYPE"
+ fi
+}
+#==============================================================================
+# Template and Content Generation Functions
+#==============================================================================
+
+get_project_structure() {
+ local project_type="$1"
+
+ if [[ "$project_type" == *"web"* ]]; then
+ echo "backend/
+frontend/
+tests/"
+ else
+ echo "src/
+tests/"
+ fi
+}
+
+get_commands_for_language() {
+ local lang="$1"
+
+ case "$lang" in
+ *"Python"*)
+ echo "cd src && pytest && ruff check ."
+ ;;
+ *"Rust"*)
+ echo "cargo test && cargo clippy"
+ ;;
+ *"JavaScript"*|*"TypeScript"*)
+ echo "npm test && npm run lint"
+ ;;
+ *)
+ echo "# Add commands for $lang"
+ ;;
+ esac
+}
+
+get_language_conventions() {
+ local lang="$1"
+ echo "$lang: Follow standard conventions"
+}
+
+create_new_agent_file() {
+ local target_file="$1"
+ local temp_file="$2"
+ local project_name="$3"
+ local current_date="$4"
+
+ if [[ ! -f "$TEMPLATE_FILE" ]]; then
+ log_error "Template not found at $TEMPLATE_FILE"
+ return 1
+ fi
+
+ if [[ ! -r "$TEMPLATE_FILE" ]]; then
+ log_error "Template file is not readable: $TEMPLATE_FILE"
+ return 1
+ fi
+
+ log_info "Creating new agent context file from template..."
+
+ if ! cp "$TEMPLATE_FILE" "$temp_file"; then
+ log_error "Failed to copy template file"
+ return 1
+ fi
+
+ # Replace template placeholders
+ local project_structure
+ project_structure=$(get_project_structure "$NEW_PROJECT_TYPE")
+
+ local commands
+ commands=$(get_commands_for_language "$NEW_LANG")
+
+ local language_conventions
+ language_conventions=$(get_language_conventions "$NEW_LANG")
+
+ # Perform substitutions with error checking
+ local substitutions=(
+ "s/\[PROJECT NAME\]/$project_name/"
+ "s/\[DATE\]/$current_date/"
+ "s/\[EXTRACTED FROM ALL PLAN.MD FILES\]/- $NEW_LANG + $NEW_FRAMEWORK ($CURRENT_BRANCH)/"
+ "s|\[ACTUAL STRUCTURE FROM PLANS\]|$project_structure|"
+ "s|\[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES\]|$commands|"
+ "s|\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]|$language_conventions|"
+ "s|\[LAST 3 FEATURES AND WHAT THEY ADDED\]|- $CURRENT_BRANCH: Added $NEW_LANG + $NEW_FRAMEWORK|"
+ )
+
+ for substitution in "${substitutions[@]}"; do
+ if ! sed -i.bak "$substitution" "$temp_file"; then
+ log_error "Failed to perform substitution: $substitution"
+ rm -f "$temp_file" "$temp_file.bak"
+ return 1
+ fi
+ done
+
+ # Clean up backup files
+ rm -f "$temp_file.bak"
+
+ return 0
+}
+update_active_technologies() {
+ local target_file="$1"
+ local temp_file="$2"
+
+ # Find the Active Technologies section and add new entries
+ local tech_section_start
+ tech_section_start=$(grep -n "## Active Technologies" "$target_file" | cut -d: -f1)
+
+ if [[ -z "$tech_section_start" ]]; then
+ return 0 # No Active Technologies section found
+ fi
+
+ # Find the end of the Active Technologies section (next ## heading or empty line)
+ local tech_section_end
+ tech_section_end=$(tail -n +$((tech_section_start + 1)) "$target_file" | grep -n "^## \|^$" | head -1 | cut -d: -f1)
+
+ if [[ -n "$tech_section_end" ]]; then
+ tech_section_end=$((tech_section_start + tech_section_end))
+ else
+ tech_section_end=$(wc -l < "$target_file")
+ fi
+
+ # Extract existing technologies section
+ local existing_tech
+ existing_tech=$(sed -n "${tech_section_start},${tech_section_end}p" "$target_file")
+
+ # Build list of new additions
+ local additions=()
+ if [[ -n "$NEW_LANG" ]] && ! echo "$existing_tech" | grep -q "$NEW_LANG"; then
+ additions+=("- $NEW_LANG + $NEW_FRAMEWORK ($CURRENT_BRANCH)")
+ fi
+
+ if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && ! echo "$existing_tech" | grep -q "$NEW_DB"; then
+ additions+=("- $NEW_DB ($CURRENT_BRANCH)")
+ fi
+
+ # If we have additions, update the section
+ if [[ ${#additions[@]} -gt 0 ]]; then
+ {
+ # Copy everything before the Active Technologies section
+ head -n $((tech_section_start)) "$target_file"
+
+ # Copy existing tech section content
+ sed -n "$((tech_section_start + 1)),$((tech_section_end - 1))p" "$target_file"
+
+ # Add new technologies
+ printf '%s\n' "${additions[@]}"
+ echo
+
+ # Copy everything after the Active Technologies section
+ tail -n +$((tech_section_end + 1)) "$target_file"
+ } > "$temp_file"
+ else
+ cp "$target_file" "$temp_file"
+ fi
+}
+
+update_recent_changes() {
+ local temp_file="$1"
+ local temp_file2="$2"
+
+ # Find Recent Changes section
+ local changes_section_start
+ changes_section_start=$(grep -n "## Recent Changes" "$temp_file" | cut -d: -f1)
+
+ if [[ -z "$changes_section_start" ]]; then
+ return 0 # No Recent Changes section found
+ fi
+
+ # Find the end of the Recent Changes section
+ local changes_section_end
+ changes_section_end=$(tail -n +$((changes_section_start + 1)) "$temp_file" | grep -n "^## \|^$" | head -1 | cut -d: -f1)
+
+ if [[ -n "$changes_section_end" ]]; then
+ changes_section_end=$((changes_section_start + changes_section_end))
+ else
+ changes_section_end=$(wc -l < "$temp_file")
+ fi
+
+ # Extract existing changes, keep only non-empty lines, and limit to 2 (so we can add 1 new one)
+ local existing_changes=()
+ while IFS= read -r line; do
+ if [[ -n "$line" ]] && [[ "$line" == "- "* ]]; then
+ existing_changes+=("$line")
+ fi
+ done < <(sed -n "$((changes_section_start + 1)),$((changes_section_end - 1))p" "$temp_file")
+
+ # Keep only the first 2 existing changes
+ existing_changes=("${existing_changes[@]:0:2}")
+
+ # Create updated Recent Changes section
+ {
+ # Copy everything before Recent Changes
+ head -n "$changes_section_start" "$temp_file"
+
+ # Add new change at the top
+ echo "- $CURRENT_BRANCH: Added $NEW_LANG + $NEW_FRAMEWORK"
+
+ # Add existing changes (up to 2)
+ printf '%s\n' "${existing_changes[@]}"
+ echo
+
+ # Copy everything after Recent Changes section
+ tail -n +$((changes_section_end + 1)) "$temp_file"
+ } > "$temp_file2"
+}
+
+update_last_updated() {
+ local temp_file="$1"
+ local current_date="$2"
+
+ # Update the "Last updated" timestamp
+ sed -i.bak "s/Last updated: [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/Last updated: $current_date/" "$temp_file"
+ rm -f "$temp_file.bak"
+}
+
+preserve_manual_additions() {
+ local target_file="$1"
+ local temp_file="$2"
+
+ # Check if there are manual additions to preserve
+ local manual_start manual_end
+ manual_start=$(grep -n "<!-- MANUAL ADDITIONS START -->" "$target_file" 2>/dev/null | cut -d: -f1 || echo "")
+ manual_end=$(grep -n "<!-- MANUAL ADDITIONS END -->" "$target_file" 2>/dev/null | cut -d: -f1 || echo "")
+
+ if [[ -n "$manual_start" ]] && [[ -n "$manual_end" ]]; then
+ # Extract manual additions
+ local manual_file="/tmp/manual_additions_$$"
+ sed -n "${manual_start},${manual_end}p" "$target_file" > "$manual_file"
+
+ # Remove any existing manual additions from temp file
+ sed -i.bak '/<!-- MANUAL ADDITIONS START -->/,/<!-- MANUAL ADDITIONS END -->/d' "$temp_file"
+ rm -f "$temp_file.bak"
+
+ # Append preserved manual additions
+ cat "$manual_file" >> "$temp_file"
+ rm -f "$manual_file"
+ fi
+}
+
+update_existing_agent_file() {
+ local target_file="$1"
+ local current_date="$2"
+
+ log_info "Updating existing agent context file..."
+
+ local temp_file1="/tmp/agent_update_1_$$"
+ local temp_file2="/tmp/agent_update_2_$$"
+
+ # Step 1: Update Active Technologies section
+ update_active_technologies "$target_file" "$temp_file1"
+
+ # Step 2: Update Recent Changes section
+ update_recent_changes "$temp_file1" "$temp_file2"
+
+ # Step 3: Update timestamp
+ update_last_updated "$temp_file2" "$current_date"
+
+ # Step 4: Preserve manual additions
+ preserve_manual_additions "$target_file" "$temp_file2"
+
+ # Move the final result to target
+ mv "$temp_file2" "$target_file"
+
+ # Cleanup
+ rm -f "$temp_file1"
+}
+#==============================================================================
+# Main Agent File Update Function
+#==============================================================================
+
+update_agent_file() {
+ local target_file="$1"
+ local agent_name="$2"
+
+ if [[ -z "$target_file" ]] || [[ -z "$agent_name" ]]; then
+ log_error "update_agent_file requires target_file and agent_name parameters"
+ return 1
+ fi
+
+ log_info "Updating $agent_name context file: $target_file"
+
+ local project_name
+ project_name=$(basename "$REPO_ROOT")
+ local current_date
+ current_date=$(date +%Y-%m-%d)
+
+ # Create directory if it doesn't exist
+ local target_dir
+ target_dir=$(dirname "$target_file")
+ if [[ ! -d "$target_dir" ]]; then
+ if ! mkdir -p "$target_dir"; then
+ log_error "Failed to create directory: $target_dir"
+ return 1
+ fi
+ fi
+
+ if [[ ! -f "$target_file" ]]; then
+ # Create new file from template
+ local temp_file
+ temp_file=$(mktemp) || {
+ log_error "Failed to create temporary file"
+ return 1
+ }
+
+ if create_new_agent_file "$target_file" "$temp_file" "$project_name" "$current_date"; then
+ if mv "$temp_file" "$target_file"; then
+ log_success "Created new $agent_name context file"
+ else
+ log_error "Failed to move temporary file to $target_file"
+ rm -f "$temp_file"
+ return 1
+ fi
+ else
+ log_error "Failed to create new agent file"
+ rm -f "$temp_file"
+ return 1
+ fi
+ else
+ # Update existing file
+ if [[ ! -r "$target_file" ]]; then
+ log_error "Cannot read existing file: $target_file"
+ return 1
+ fi
+
+ if [[ ! -w "$target_file" ]]; then
+ log_error "Cannot write to existing file: $target_file"
+ return 1
+ fi
+
+ if update_existing_agent_file "$target_file" "$current_date"; then
+ log_success "Updated existing $agent_name context file"
+ else
+ log_error "Failed to update existing agent file"
+ return 1
+ fi
+ fi
+
+ return 0
+}
+
+#==============================================================================
+# Agent Selection and Processing
+#==============================================================================
+
+update_specific_agent() {
+ local agent_type="$1"
+
+ case "$agent_type" in
+ claude)
+ update_agent_file "$CLAUDE_FILE" "Claude Code"
+ ;;
+ gemini)
+ update_agent_file "$GEMINI_FILE" "Gemini CLI"
+ ;;
+ copilot)
+ update_agent_file "$COPILOT_FILE" "GitHub Copilot"
+ ;;
+ cursor)
+ update_agent_file "$CURSOR_FILE" "Cursor IDE"
+ ;;
+ qwen)
+ update_agent_file "$QWEN_FILE" "Qwen Code"
+ ;;
+ opencode)
+ update_agent_file "$AGENTS_FILE" "opencode"
+ ;;
+ codex)
+ update_agent_file "$AGENTS_FILE" "Codex CLI"
+ ;;
+ windsurf)
+ update_agent_file "$WINDSURF_FILE" "Windsurf"
+ ;;
+ *)
+ log_error "Unknown agent type '$agent_type'"
+ log_error "Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf"
+ exit 1
+ ;;
+ esac
+}
+
+update_all_existing_agents() {
+ local found_agent=false
+
+ # Check each possible agent file and update if it exists
+ if [[ -f "$CLAUDE_FILE" ]]; then
+ update_agent_file "$CLAUDE_FILE" "Claude Code"
+ found_agent=true
+ fi
+
+ if [[ -f "$GEMINI_FILE" ]]; then
+ update_agent_file "$GEMINI_FILE" "Gemini CLI"
+ found_agent=true
+ fi
+
+ if [[ -f "$COPILOT_FILE" ]]; then
+ update_agent_file "$COPILOT_FILE" "GitHub Copilot"
+ found_agent=true
+ fi
+
+ if [[ -f "$CURSOR_FILE" ]]; then
+ update_agent_file "$CURSOR_FILE" "Cursor IDE"
+ found_agent=true
+ fi
+
+ if [[ -f "$QWEN_FILE" ]]; then
+ update_agent_file "$QWEN_FILE" "Qwen Code"
+ found_agent=true
+ fi
+
+ if [[ -f "$AGENTS_FILE" ]]; then
+ update_agent_file "$AGENTS_FILE" "Codex/opencode"
+ found_agent=true
+ fi
+
+ if [[ -f "$WINDSURF_FILE" ]]; then
+ update_agent_file "$WINDSURF_FILE" "Windsurf"
+ found_agent=true
+ fi
+
+ # If no agent files exist, create a default Claude file
+ if [[ "$found_agent" == false ]]; then
+ log_info "No existing agent files found, creating default Claude file..."
+ update_agent_file "$CLAUDE_FILE" "Claude Code"
+ fi
+}
+print_summary() {
+ echo
+ log_info "Summary of changes:"
+
+ if [[ -n "$NEW_LANG" ]]; then
+ echo " - Added language: $NEW_LANG"
+ fi
+
+ if [[ -n "$NEW_FRAMEWORK" ]]; then
+ echo " - Added framework: $NEW_FRAMEWORK"
+ fi
+
+ if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]]; then
+ echo " - Added database: $NEW_DB"
+ fi
+
+ echo
+ log_info "Usage: $0 [claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf]"
+}
+
+#==============================================================================
+# Main Execution
+#==============================================================================
+
+main() {
+ # Validate environment before proceeding
+ validate_environment
+
+ log_info "=== Updating agent context files for feature $CURRENT_BRANCH ==="
+
+ # Parse the plan file to extract project information
+ if ! parse_plan_data "$NEW_PLAN"; then
+ log_error "Failed to parse plan data"
+ exit 1
+ fi
+
+ # Process based on agent type argument
+ local success=true
+
+ if [[ -z "$AGENT_TYPE" ]]; then
+ # No specific agent provided - update all existing agent files
+ log_info "No agent specified, updating all existing agent files..."
+ if ! update_all_existing_agents; then
+ success=false
+ fi
+ else
+ # Specific agent provided - update only that agent
+ log_info "Updating specific agent: $AGENT_TYPE"
+ if ! update_specific_agent "$AGENT_TYPE"; then
+ success=false
+ fi
+ fi
+
+ # Print summary
+ print_summary
+
+ if [[ "$success" == true ]]; then
+ log_success "Agent context update completed successfully"
+ exit 0
+ else
+ log_error "Agent context update completed with errors"
+ exit 1
+ fi
+}
+
+# Execute main function if script is run directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+ main "$@"
+fi
diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1
index 133b454c8..1e35b25a6 100644
--- a/scripts/powershell/update-agent-context.ps1
+++ b/scripts/powershell/update-agent-context.ps1
@@ -66,7 +66,7 @@ function Update-AgentFile($targetFile, $agentName) {
}
$content = [regex]::Replace($content, 'Last updated: \d{4}-\d{2}-\d{2}', "Last updated: $(Get-Date -Format 'yyyy-MM-dd')")
$content | Set-Content $targetFile -Encoding UTF8
- Write-Output "βœ… $agentName context file updated successfully"
+ Write-Output "βœ“ $agentName context file updated successfully"
}
switch ($AgentType) {