260304:1233 20260304:1200 update app to lcbp3

.agents/scripts/bash/agent-registry.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# Agent registry — maps agent types to file paths and display names
+# Extracted from update-agent-context.sh for modularity
+#
+# Usage:
+#   source agent-registry.sh
+#   init_agent_registry "$REPO_ROOT"
+#   get_agent_file "claude"    # → /path/to/CLAUDE.md
+#   get_agent_name "claude"    # → "Claude Code"
+
+# Initialize agent file paths (call after REPO_ROOT is set)
+init_agent_registry() {
+    local repo_root="$1"
+
+    # Agent type → file path mapping
+    declare -gA AGENT_FILES=(
+        [claude]="$repo_root/CLAUDE.md"
+        [gemini]="$repo_root/GEMINI.md"
+        [copilot]="$repo_root/.github/agents/copilot-instructions.md"
+        [cursor-agent]="$repo_root/.cursor/rules/specify-rules.mdc"
+        [qwen]="$repo_root/QWEN.md"
+        [opencode]="$repo_root/AGENTS.md"
+        [codex]="$repo_root/AGENTS.md"
+        [windsurf]="$repo_root/.windsurf/rules/specify-rules.md"
+        [kilocode]="$repo_root/.kilocode/rules/specify-rules.md"
+        [auggie]="$repo_root/.augment/rules/specify-rules.md"
+        [roo]="$repo_root/.roo/rules/specify-rules.md"
+        [codebuddy]="$repo_root/CODEBUDDY.md"
+        [qoder]="$repo_root/QODER.md"
+        [amp]="$repo_root/AGENTS.md"
+        [shai]="$repo_root/SHAI.md"
+        [q]="$repo_root/AGENTS.md"
+        [bob]="$repo_root/AGENTS.md"
+    )
+
+    # Agent type → display name mapping
+    declare -gA AGENT_NAMES=(
+        [claude]="Claude Code"
+        [gemini]="Gemini CLI"
+        [copilot]="GitHub Copilot"
+        [cursor-agent]="Cursor IDE"
+        [qwen]="Qwen Code"
+        [opencode]="opencode"
+        [codex]="Codex CLI"
+        [windsurf]="Windsurf"
+        [kilocode]="Kilo Code"
+        [auggie]="Auggie CLI"
+        [roo]="Roo Code"
+        [codebuddy]="CodeBuddy CLI"
+        [qoder]="Qoder CLI"
+        [amp]="Amp"
+        [shai]="SHAI"
+        [q]="Amazon Q Developer CLI"
+        [bob]="IBM Bob"
+    )
+
+    # Template file path
+    TEMPLATE_FILE="$repo_root/.specify/templates/agent-file-template.md"
+}
+
+# Get file path for an agent type
+get_agent_file() {
+    local agent_type="$1"
+    echo "${AGENT_FILES[$agent_type]:-}"
+}
+
+# Get display name for an agent type
+get_agent_name() {
+    local agent_type="$1"
+    echo "${AGENT_NAMES[$agent_type]:-}"
+}
+
+# Get all registered agent types
+get_all_agent_types() {
+    echo "${!AGENT_FILES[@]}"
+}
+
+# Check if an agent type is valid
+is_valid_agent() {
+    local agent_type="$1"
+    [[ -n "${AGENT_FILES[$agent_type]:-}" ]]
+}
+
+# Get supported agent types as a pipe-separated string (for error messages)
+get_supported_agents_string() {
+    local result=""
+    for key in "${!AGENT_FILES[@]}"; do
+        if [[ -n "$result" ]]; then
+            result="$result|$key"
+        else
+            result="$key"
+        fi
+    done
+    echo "$result"
+}

.agents/scripts/bash/content-generator.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Content generation functions for update-agent-context
+# Extracted from update-agent-context.sh for modularity
+
+# Get project directory structure based on project type
+get_project_structure() {
+    local project_type="$1"
+
+    if [[ "$project_type" == *"web"* ]]; then
+        echo "backend/\\nfrontend/\\ntests/"
+    else
+        echo "src/\\ntests/"
+    fi
+}
+
+# Get build/test commands for a given language
+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-specific conventions string
+get_language_conventions() {
+    local lang="$1"
+    echo "$lang: Follow standard conventions"
+}

.agents/scripts/bash/plan-parser.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# Plan parsing functions for update-agent-context
+# Extracted from update-agent-context.sh for modularity
+
+# Extract a field value from plan.md by pattern
+# Usage: extract_plan_field "Language/Version" "/path/to/plan.md"
+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}\*\*: ||" | \
+        sed 's/^[ \t]*//;s/[ \t]*$//' | \
+        grep -v "NEEDS CLARIFICATION" | \
+        grep -v "^N/A$" || echo ""
+}
+
+# Parse plan.md and set global variables: NEW_LANG, NEW_FRAMEWORK, NEW_DB, NEW_PROJECT_TYPE
+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
+
+    [[ -n "$NEW_FRAMEWORK" ]] && log_info "Found framework: $NEW_FRAMEWORK"
+    [[ -n "$NEW_DB" && "$NEW_DB" != "N/A" ]] && log_info "Found database: $NEW_DB"
+    [[ -n "$NEW_PROJECT_TYPE" ]] && log_info "Found project type: $NEW_PROJECT_TYPE"
+}
+
+# Format technology stack string from language and framework
+format_technology_stack() {
+    local lang="$1"
+    local framework="$2"
+    local parts=()
+
+    [[ -n "$lang" && "$lang" != "NEEDS CLARIFICATION" ]] && parts+=("$lang")
+    [[ -n "$framework" && "$framework" != "NEEDS CLARIFICATION" && "$framework" != "N/A" ]] && parts+=("$framework")
+
+    if [[ ${#parts[@]} -eq 0 ]]; then
+        echo ""
+    elif [[ ${#parts[@]} -eq 1 ]]; then
+        echo "${parts[0]}"
+    else
+        local result="${parts[0]}"
+        for ((i=1; i<${#parts[@]}; i++)); do
+            result="$result + ${parts[i]}"
+        done
+        echo "$result"
+    fi
+}

.agents/scripts/bash/update-agent-context.sh

@@ -2,7 +2,7 @@
 
 # Update agent context files with information from plan.md
 #
-# This script maintains AI agent context files by parsing feature specifications 
+# This script maintains AI agent context files by parsing feature specifications
 # and updating agent-specific configuration files with project information.
 #
 # MAIN FUNCTIONS:
@@ -52,13 +52,19 @@ set -o pipefail
 SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/common.sh"
 
+# Load modular components (extracted for maintainability)
+# See each file for documentation of the functions it provides
+source "$SCRIPT_DIR/plan-parser.sh"        # extract_plan_field, parse_plan_data, format_technology_stack
+source "$SCRIPT_DIR/content-generator.sh"  # get_project_structure, get_commands_for_language, get_language_conventions
+source "$SCRIPT_DIR/agent-registry.sh"     # init_agent_registry, get_agent_file, get_agent_name, etc.
+
 # Get all paths and variables from common functions
 eval $(get_feature_paths)
 
 NEW_PLAN="$IMPL_PLAN"  # Alias for compatibility with existing code
 AGENT_TYPE="${1:-}"
 
-# Agent-specific file paths  
+# Agent-specific file paths
 CLAUDE_FILE="$REPO_ROOT/CLAUDE.md"
 GEMINI_FILE="$REPO_ROOT/GEMINI.md"
 COPILOT_FILE="$REPO_ROOT/.github/agents/copilot-instructions.md"
@@ -131,7 +137,7 @@ validate_environment() {
         fi
         exit 1
     fi
-    
+
     # Check if plan.md exists
     if [[ ! -f "$NEW_PLAN" ]]; then
         log_error "No plan.md found at $NEW_PLAN"
@@ -141,7 +147,7 @@ validate_environment() {
         fi
         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"
@@ -156,7 +162,7 @@ validate_environment() {
 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}\*\*: ||" | \
@@ -167,39 +173,39 @@ extract_plan_field() {
 
 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
@@ -209,11 +215,11 @@ format_technology_stack() {
     local lang="$1"
     local framework="$2"
     local parts=()
-    
+
     # Add non-empty parts
     [[ -n "$lang" && "$lang" != "NEEDS CLARIFICATION" ]] && parts+=("$lang")
     [[ -n "$framework" && "$framework" != "NEEDS CLARIFICATION" && "$framework" != "N/A" ]] && parts+=("$framework")
-    
+
     # Join with proper formatting
     if [[ ${#parts[@]} -eq 0 ]]; then
         echo ""
@@ -235,7 +241,7 @@ format_technology_stack() {
 
 get_project_structure() {
     local project_type="$1"
-    
+
     if [[ "$project_type" == *"web"* ]]; then
         echo "backend/\\nfrontend/\\ntests/"
     else
@@ -245,7 +251,7 @@ get_project_structure() {
 
 get_commands_for_language() {
     local lang="$1"
-    
+
     case "$lang" in
         *"Python"*)
             echo "cd src && pytest && ruff check ."
@@ -272,40 +278,40 @@ create_new_agent_file() {
     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 using safer approach
     # Escape special characters for sed by using a different delimiter or escaping
     local escaped_lang=$(printf '%s\n' "$NEW_LANG" | sed 's/[\[\.*^$()+{}|]/\\&/g')
     local escaped_framework=$(printf '%s\n' "$NEW_FRAMEWORK" | sed 's/[\[\.*^$()+{}|]/\\&/g')
     local escaped_branch=$(printf '%s\n' "$CURRENT_BRANCH" | sed 's/[\[\.*^$()+{}|]/\\&/g')
-    
+
     # Build technology stack and recent change strings conditionally
     local tech_stack
     if [[ -n "$escaped_lang" && -n "$escaped_framework" ]]; then
@@ -338,7 +344,7 @@ create_new_agent_file() {
         "s|\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]|$language_conventions|"
         "s|\[LAST 3 FEATURES AND WHAT THEY ADDED\]|$recent_change|"
     )
-    
+
     for substitution in "${substitutions[@]}"; do
         if ! sed -i.bak -e "$substitution" "$temp_file"; then
             log_error "Failed to perform substitution: $substitution"
@@ -346,14 +352,14 @@ create_new_agent_file() {
             return 1
         fi
     done
-    
+
     # Convert \n sequences to actual newlines
     newline=$(printf '\n')
     sed -i.bak2 "s/\\\\n/${newline}/g" "$temp_file"
-    
+
     # Clean up backup files
     rm -f "$temp_file.bak" "$temp_file.bak2"
-    
+
     return 0
 }
 
@@ -363,49 +369,49 @@ create_new_agent_file() {
 update_existing_agent_file() {
     local target_file="$1"
     local current_date="$2"
-    
+
     log_info "Updating existing agent context file..."
-    
+
     # Use a single temporary file for atomic update
     local temp_file
     temp_file=$(mktemp) || {
         log_error "Failed to create temporary file"
         return 1
     }
-    
+
     # Process the file in one pass
     local tech_stack=$(format_technology_stack "$NEW_LANG" "$NEW_FRAMEWORK")
     local new_tech_entries=()
     local new_change_entry=""
-    
+
     # Prepare new technology entries
     if [[ -n "$tech_stack" ]] && ! grep -q "$tech_stack" "$target_file"; then
         new_tech_entries+=("- $tech_stack ($CURRENT_BRANCH)")
     fi
-    
+
     if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && [[ "$NEW_DB" != "NEEDS CLARIFICATION" ]] && ! grep -q "$NEW_DB" "$target_file"; then
         new_tech_entries+=("- $NEW_DB ($CURRENT_BRANCH)")
     fi
-    
+
     # Prepare new change entry
     if [[ -n "$tech_stack" ]]; then
         new_change_entry="- $CURRENT_BRANCH: Added $tech_stack"
     elif [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && [[ "$NEW_DB" != "NEEDS CLARIFICATION" ]]; then
         new_change_entry="- $CURRENT_BRANCH: Added $NEW_DB"
     fi
-    
+
     # Check if sections exist in the file
     local has_active_technologies=0
     local has_recent_changes=0
-    
+
     if grep -q "^## Active Technologies" "$target_file" 2>/dev/null; then
         has_active_technologies=1
     fi
-    
+
     if grep -q "^## Recent Changes" "$target_file" 2>/dev/null; then
         has_recent_changes=1
     fi
-    
+
     # Process file line by line
     local in_tech_section=false
     local in_changes_section=false
@@ -413,7 +419,7 @@ update_existing_agent_file() {
     local changes_entries_added=false
     local existing_changes_count=0
     local file_ended=false
-    
+
     while IFS= read -r line || [[ -n "$line" ]]; do
         # Handle Active Technologies section
         if [[ "$line" == "## Active Technologies" ]]; then
@@ -438,7 +444,7 @@ update_existing_agent_file() {
             echo "$line" >> "$temp_file"
             continue
         fi
-        
+
         # Handle Recent Changes section
         if [[ "$line" == "## Recent Changes" ]]; then
             echo "$line" >> "$temp_file"
@@ -461,7 +467,7 @@ update_existing_agent_file() {
             fi
             continue
         fi
-        
+
         # Update timestamp
         if [[ "$line" =~ \*\*Last\ updated\*\*:.*[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9] ]]; then
             echo "$line" | sed "s/[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/$current_date/" >> "$temp_file"
@@ -469,13 +475,13 @@ update_existing_agent_file() {
             echo "$line" >> "$temp_file"
         fi
     done < "$target_file"
-    
+
     # Post-loop check: if we're still in the Active Technologies section and haven't added new entries
     if [[ $in_tech_section == true ]] && [[ $tech_entries_added == false ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then
         printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"
         tech_entries_added=true
     fi
-    
+
     # If sections don't exist, add them at the end of the file
     if [[ $has_active_technologies -eq 0 ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then
         echo "" >> "$temp_file"
@@ -483,21 +489,21 @@ update_existing_agent_file() {
         printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"
         tech_entries_added=true
     fi
-    
+
     if [[ $has_recent_changes -eq 0 ]] && [[ -n "$new_change_entry" ]]; then
         echo "" >> "$temp_file"
         echo "## Recent Changes" >> "$temp_file"
         echo "$new_change_entry" >> "$temp_file"
         changes_entries_added=true
     fi
-    
+
     # Move temp file to target atomically
     if ! mv "$temp_file" "$target_file"; then
         log_error "Failed to update target file"
         rm -f "$temp_file"
         return 1
     fi
-    
+
     return 0
 }
 #==============================================================================
@@ -507,19 +513,19 @@ update_existing_agent_file() {
 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")
@@ -529,7 +535,7 @@ update_agent_file() {
             return 1
         fi
     fi
-    
+
     if [[ ! -f "$target_file" ]]; then
         # Create new file from template
         local temp_file
@@ -537,7 +543,7 @@ update_agent_file() {
             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"
@@ -557,12 +563,12 @@ update_agent_file() {
             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
@@ -570,7 +576,7 @@ update_agent_file() {
             return 1
         fi
     fi
-    
+
     return 0
 }
 
@@ -580,7 +586,7 @@ update_agent_file() {
 
 update_specific_agent() {
     local agent_type="$1"
-    
+
     case "$agent_type" in
         claude)
             update_agent_file "$CLAUDE_FILE" "Claude Code"
@@ -643,43 +649,43 @@ update_specific_agent() {
 
 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 [[ -f "$KILOCODE_FILE" ]]; then
         update_agent_file "$KILOCODE_FILE" "Kilo Code"
         found_agent=true
@@ -689,7 +695,7 @@ update_all_existing_agents() {
         update_agent_file "$AUGGIE_FILE" "Auggie CLI"
         found_agent=true
     fi
-    
+
     if [[ -f "$ROO_FILE" ]]; then
         update_agent_file "$ROO_FILE" "Roo Code"
         found_agent=true
@@ -714,12 +720,12 @@ update_all_existing_agents() {
         update_agent_file "$Q_FILE" "Amazon Q Developer CLI"
         found_agent=true
     fi
-    
+
     if [[ -f "$BOB_FILE" ]]; then
         update_agent_file "$BOB_FILE" "IBM Bob"
         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..."
@@ -729,19 +735,19 @@ update_all_existing_agents() {
 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-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|shai|q|bob|qoder]"
@@ -754,18 +760,18 @@ print_summary() {
 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..."
@@ -779,10 +785,10 @@ main() {
             success=false
         fi
     fi
-    
+
     # Print summary
     print_summary
-    
+
     if [[ "$success" == true ]]; then
         log_success "Agent context update completed successfully"
         exit 0

.agents/scripts/fix_links.py

@@ -1,26 +1,28 @@
 import os
 import re
+import sys
 from pathlib import Path
 
-# Configuration
-BASE_DIR = Path(r"d:\nap-dms.lcbp3\specs")
+# Configuration - default base directory, can be overridden via CLI argument
+DEFAULT_BASE_DIR = Path(__file__).resolve().parent.parent.parent / "specs"
+
 DIRECTORIES = [
-    "00-overview",
-    "01-requirements",
-    "02-architecture",
-    "03-implementation",
-    "04-operations",
-    "05-decisions",
-    "06-tasks"
+    "00-Overview",
+    "01-Requirements",
+    "02-Architecture",
+    "03-Data-and-Storage",
+    "04-Infrastructure-OPS",
+    "05-Engineering-Guidelines",
+    "06-Decision-Records"
 ]
 
 LINK_PATTERN = re.compile(r'(\[([^\]]+)\]\(([^)]+)\))')
 
-def get_file_map():
+def get_file_map(base_dir: Path):
     """Builds a map of {basename}.md -> {prefixed_name}.md across all dirs."""
     file_map = {}
     for dir_name in DIRECTORIES:
-        directory = BASE_DIR / dir_name
+        directory = base_dir / dir_name
         if not directory.exists():
             continue
         for file_path in directory.glob("*.md"):
@@ -53,41 +55,14 @@ def get_file_map():
                             if secondary_base:
                                 file_map[secondary_base] = f"{dir_name}/{actual_name}"
 
-    # Hardcoded specific overrides for versioning and common typos
-    overrides = {
-        "fullftack-js-v1.5.0.md": "03-implementation/03-01-fullftack-js-v1.7.0.md",
-        "fullstack-js-v1.5.0.md": "03-implementation/03-01-fullftack-js-v1.7.0.md",
-        "system-architecture.md": "02-architecture/02-01-system-architecture.md",
-        "api-design.md": "02-architecture/02-02-api-design.md",
-        "data-model.md": "02-architecture/02-03-data-model.md",
-        "backend-guidelines.md": "03-implementation/03-02-backend-guidelines.md",
-        "frontend-guidelines.md": "03-implementation/03-03-frontend-guidelines.md",
-        "document-numbering.md": "03-implementation/03-04-document-numbering.md",
-        "testing-strategy.md": "03-implementation/03-05-testing-strategy.md",
-        "deployment-guide.md": "04-operations/04-01-deployment-guide.md",
-        "environment-setup.md": "04-operations/04-02-environment-setup.md",
-        "monitoring-alerting.md": "04-operations/04-03-monitoring-alerting.md",
-        "backup-recovery.md": "04-operations/04-04-backup-recovery.md",
-        "maintenance-procedures.md": "04-operations/04-05-maintenance-procedures.md",
-        "security-operations.md": "04-operations/04-06-security-operations.md",
-        "incident-response.md": "04-operations/04-07-incident-response.md",
-        "document-numbering-operations.md": "04-operations/04-08-document-numbering-operations.md",
-        # Missing task files - redirect to README or best match
-        "task-be-011-notification-audit.md": "06-tasks/README.md",
-        "task-be-001-database-migrations.md": "06-tasks/TASK-BE-015-schema-v160-migration.md", # Best match
-    }
-
-    for k, v in overrides.items():
-        file_map[k] = v
-
     return file_map
 
-def fix_links():
-    file_map = get_file_map()
+def fix_links(base_dir: Path):
+    file_map = get_file_map(base_dir)
     changes_made = 0
 
     for dir_name in DIRECTORIES:
-        directory = BASE_DIR / dir_name
+        directory = base_dir / dir_name
         if not directory.exists():
             continue
 
@@ -107,8 +82,12 @@ def fix_links():
                 if not target_path:
                     continue
 
-                # Special case: file:///d:/nap-dms.lcbp3/specs/
-                clean_target_path = target_path.replace("file:///d:/nap-dms.lcbp3/specs/", "").replace("file:///D:/nap-dms.lcbp3/specs/", "")
+                # Special case: file:/// absolute paths
+                clean_target_path = re.sub(
+                    r'^file:///[a-zA-Z]:[/\\].*?specs[/\\]',
+                    '',
+                    target_path
+                )
 
                 resolved_locally = (file_path.parent / target_path).resolve()
                 if resolved_locally.exists() and resolved_locally.is_file():
@@ -119,7 +98,7 @@ def fix_links():
                 if target_filename in file_map:
                     correct_relative_to_specs = file_map[target_filename]
                     # Calculate relative path from current file's parent to the correct file
-                    correct_abs = (BASE_DIR / correct_relative_to_specs).resolve()
+                    correct_abs = (base_dir / correct_relative_to_specs).resolve()
 
                     try:
                         new_relative_path = os.path.relpath(correct_abs, file_path.parent).replace(os.sep, "/")
@@ -143,4 +122,14 @@ def fix_links():
     print(f"\nTotal files updated: {changes_made}")
 
 if __name__ == "__main__":
-    fix_links()
+    if len(sys.argv) > 1:
+        base_dir = Path(sys.argv[1])
+    else:
+        base_dir = DEFAULT_BASE_DIR
+
+    if not base_dir.exists():
+        print(f"Error: Directory not found: {base_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"Scanning specs directory: {base_dir}")
+    fix_links(base_dir)

.agents/scripts/powershell/common.ps1

@@ -0,0 +1,157 @@
+# PowerShell equivalents for key .agents bash scripts
+# These provide Windows-native alternatives for the most commonly used functions
+
+<#
+.SYNOPSIS
+    Common utility functions for Spec-Kit PowerShell scripts.
+.DESCRIPTION
+    PowerShell equivalent of .agents/scripts/bash/common.sh
+    Provides repository root detection, branch identification, and feature path resolution.
+#>
+
+function Get-RepoRoot {
+    try {
+        $root = git rev-parse --show-toplevel 2>$null
+        if ($LASTEXITCODE -eq 0) { return $root.Trim() }
+    } catch {}
+    # Fallback: navigate up from script location
+    return (Resolve-Path "$PSScriptRoot\..\..\..").Path
+}
+
+function Get-CurrentBranch {
+    # Check environment variable first
+    if ($env:SPECIFY_FEATURE) { return $env:SPECIFY_FEATURE }
+
+    try {
+        $branch = git rev-parse --abbrev-ref HEAD 2>$null
+        if ($LASTEXITCODE -eq 0) { return $branch.Trim() }
+    } catch {}
+
+    # Fallback: find latest feature directory
+    $repoRoot = Get-RepoRoot
+    $specsDir = Join-Path $repoRoot "specs"
+    if (Test-Path $specsDir) {
+        $latest = Get-ChildItem -Path $specsDir -Directory |
+            Where-Object { $_.Name -match '^\d{3}-' } |
+            Sort-Object Name -Descending |
+            Select-Object -First 1
+        if ($latest) { return $latest.Name }
+    }
+    return "main"
+}
+
+function Test-HasGit {
+    try {
+        git rev-parse --show-toplevel 2>$null | Out-Null
+        return $LASTEXITCODE -eq 0
+    } catch { return $false }
+}
+
+function Test-FeatureBranch {
+    param([string]$Branch, [bool]$HasGit)
+    if (-not $HasGit) {
+        Write-Warning "[specify] Git repository not detected; skipped branch validation"
+        return $true
+    }
+    if ($Branch -notmatch '^\d{3}-') {
+        Write-Error "Not on a feature branch. Current branch: $Branch"
+        Write-Error "Feature branches should be named like: 001-feature-name"
+        return $false
+    }
+    return $true
+}
+
+function Find-FeatureDir {
+    param([string]$RepoRoot, [string]$BranchName)
+    $specsDir = Join-Path $RepoRoot "specs"
+
+    if ($BranchName -match '^(\d{3})-') {
+        $prefix = $Matches[1]
+        $matches = Get-ChildItem -Path $specsDir -Directory -Filter "$prefix-*" -ErrorAction SilentlyContinue
+        if ($matches.Count -eq 1) { return $matches[0].FullName }
+        if ($matches.Count -gt 1) {
+            Write-Warning "Multiple spec dirs with prefix '$prefix': $($matches.Name -join ', ')"
+        }
+    }
+    return Join-Path $specsDir $BranchName
+}
+
+function Get-FeaturePaths {
+    $repoRoot = Get-RepoRoot
+    $branch = Get-CurrentBranch
+    $hasGit = Test-HasGit
+    $featureDir = Find-FeatureDir -RepoRoot $repoRoot -BranchName $branch
+
+    return [PSCustomObject]@{
+        RepoRoot     = $repoRoot
+        Branch       = $branch
+        HasGit       = $hasGit
+        FeatureDir   = $featureDir
+        FeatureSpec  = Join-Path $featureDir "spec.md"
+        ImplPlan     = Join-Path $featureDir "plan.md"
+        Tasks        = Join-Path $featureDir "tasks.md"
+        Research     = Join-Path $featureDir "research.md"
+        DataModel    = Join-Path $featureDir "data-model.md"
+        Quickstart   = Join-Path $featureDir "quickstart.md"
+        ContractsDir = Join-Path $featureDir "contracts"
+    }
+}
+
+<#
+.SYNOPSIS
+    Check prerequisites for Spec-Kit workflows.
+.DESCRIPTION
+    PowerShell equivalent of .agents/scripts/bash/check-prerequisites.sh
+.PARAMETER RequireTasks
+    Require tasks.md to exist (for implementation phase)
+.PARAMETER IncludeTasks
+    Include tasks.md in available docs list
+.PARAMETER PathsOnly
+    Only output paths, no validation
+.EXAMPLE
+    .\common.ps1
+    $result = Check-Prerequisites -RequireTasks
+#>
+function Check-Prerequisites {
+    param(
+        [switch]$RequireTasks,
+        [switch]$IncludeTasks,
+        [switch]$PathsOnly
+    )
+
+    $paths = Get-FeaturePaths
+    $valid = Test-FeatureBranch -Branch $paths.Branch -HasGit $paths.HasGit
+    if (-not $valid) { throw "Not on a feature branch" }
+
+    if ($PathsOnly) { return $paths }
+
+    # Validate required files
+    if (-not (Test-Path $paths.FeatureDir)) {
+        throw "Feature directory not found: $($paths.FeatureDir). Run /speckit.specify first."
+    }
+    if (-not (Test-Path $paths.ImplPlan)) {
+        throw "plan.md not found. Run /speckit.plan first."
+    }
+    if ($RequireTasks -and -not (Test-Path $paths.Tasks)) {
+        throw "tasks.md not found. Run /speckit.tasks first."
+    }
+
+    # Build available docs list
+    $docs = @()
+    if (Test-Path $paths.Research)  { $docs += "research.md" }
+    if (Test-Path $paths.DataModel) { $docs += "data-model.md" }
+    if ((Test-Path $paths.ContractsDir) -and (Get-ChildItem $paths.ContractsDir -ErrorAction SilentlyContinue)) {
+        $docs += "contracts/"
+    }
+    if (Test-Path $paths.Quickstart) { $docs += "quickstart.md" }
+    if ($IncludeTasks -and (Test-Path $paths.Tasks)) { $docs += "tasks.md" }
+
+    return [PSCustomObject]@{
+        FeatureDir    = $paths.FeatureDir
+        AvailableDocs = $docs
+        Paths         = $paths
+    }
+}
+
+# Export functions when dot-sourced
+Export-ModuleMember -Function * -ErrorAction SilentlyContinue 2>$null

.agents/scripts/powershell/create-new-feature.ps1

@@ -0,0 +1,138 @@
+<#
+.SYNOPSIS
+    Create a new feature branch and spec directory.
+.DESCRIPTION
+    PowerShell equivalent of .agents/scripts/bash/create-new-feature.sh
+    Creates a numbered feature branch and initializes the spec directory.
+.PARAMETER Description
+    Natural language description of the feature.
+.PARAMETER ShortName
+    Optional custom short name for the branch (2-4 words).
+.PARAMETER Number
+    Optional manual branch number (overrides auto-detection).
+.EXAMPLE
+    .\create-new-feature.ps1 -Description "Add user authentication" -ShortName "user-auth"
+#>
+param(
+    [Parameter(Mandatory = $true, Position = 0)]
+    [string]$Description,
+
+    [string]$ShortName,
+    [int]$Number = 0
+)
+
+$ErrorActionPreference = "Stop"
+
+# Load common functions
+. "$PSScriptRoot\common.ps1"
+
+$repoRoot = Get-RepoRoot
+$hasGit = Test-HasGit
+$specsDir = Join-Path $repoRoot "specs"
+if (-not (Test-Path $specsDir)) { New-Item -ItemType Directory -Path $specsDir | Out-Null }
+
+# Stop words for smart branch name generation
+$stopWords = @('i','a','an','the','to','for','of','in','on','at','by','with','from',
+               'is','are','was','were','be','been','being','have','has','had',
+               'do','does','did','will','would','should','could','can','may','might',
+               'must','shall','this','that','these','those','my','your','our','their',
+               'want','need','add','get','set')
+
+function ConvertTo-BranchName {
+    param([string]$Text)
+    $Text.ToLower() -replace '[^a-z0-9]', '-' -replace '-+', '-' -replace '^-|-$', ''
+}
+
+function Get-SmartBranchName {
+    param([string]$Desc)
+    $words = ($Desc.ToLower() -replace '[^a-z0-9]', ' ').Split(' ', [StringSplitOptions]::RemoveEmptyEntries)
+    $meaningful = $words | Where-Object { $_ -notin $stopWords -and $_.Length -ge 3 } | Select-Object -First 3
+    if ($meaningful.Count -gt 0) { return ($meaningful -join '-') }
+    return ConvertTo-BranchName $Desc
+}
+
+function Get-HighestNumber {
+    param([string]$Dir)
+    $highest = 0
+    if (Test-Path $Dir) {
+        Get-ChildItem -Path $Dir -Directory | ForEach-Object {
+            if ($_.Name -match '^(\d+)-') {
+                $num = [int]$Matches[1]
+                if ($num -gt $highest) { $highest = $num }
+            }
+        }
+    }
+    return $highest
+}
+
+# Generate branch suffix
+if ($ShortName) {
+    $branchSuffix = ConvertTo-BranchName $ShortName
+} else {
+    $branchSuffix = Get-SmartBranchName $Description
+}
+
+# Determine branch number
+if ($Number -gt 0) {
+    $branchNumber = $Number
+} else {
+    $highestSpec = Get-HighestNumber $specsDir
+    $highestBranch = 0
+    if ($hasGit) {
+        try {
+            git fetch --all --prune 2>$null | Out-Null
+            $branches = git branch -a 2>$null
+            foreach ($b in $branches) {
+                $clean = $b.Trim('* ') -replace '^remotes/[^/]+/', ''
+                if ($clean -match '^(\d{3})-') {
+                    $num = [int]$Matches[1]
+                    if ($num -gt $highestBranch) { $highestBranch = $num }
+                }
+            }
+        } catch {}
+    }
+    $branchNumber = [Math]::Max($highestSpec, $highestBranch) + 1
+}
+
+$featureNum = "{0:D3}" -f $branchNumber
+$branchName = "$featureNum-$branchSuffix"
+
+# Truncate if exceeding GitHub's 244-byte limit
+if ($branchName.Length -gt 244) {
+    $maxSuffix = 244 - 4  # 3 digits + 1 hyphen
+    $branchSuffix = $branchSuffix.Substring(0, $maxSuffix).TrimEnd('-')
+    Write-Warning "Branch name truncated to 244 bytes"
+    $branchName = "$featureNum-$branchSuffix"
+}
+
+# Create git branch
+if ($hasGit) {
+    git checkout -b $branchName
+} else {
+    Write-Warning "Git not detected; skipped branch creation for $branchName"
+}
+
+# Create feature directory and spec file
+$featureDir = Join-Path $specsDir $branchName
+New-Item -ItemType Directory -Path $featureDir -Force | Out-Null
+
+$templateFile = Join-Path $repoRoot ".specify" "templates" "spec-template.md"
+$specFile = Join-Path $featureDir "spec.md"
+if (Test-Path $templateFile) {
+    Copy-Item $templateFile $specFile
+} else {
+    New-Item -ItemType File -Path $specFile -Force | Out-Null
+}
+
+$env:SPECIFY_FEATURE = $branchName
+
+# Output
+[PSCustomObject]@{
+    BranchName = $branchName
+    SpecFile   = $specFile
+    FeatureNum = $featureNum
+}
+
+Write-Host "BRANCH_NAME: $branchName"
+Write-Host "SPEC_FILE: $specFile"
+Write-Host "FEATURE_NUM: $featureNum"

.agents/scripts/verify_links.py

@@ -1,30 +1,33 @@
 import os
 import re
+import sys
 from pathlib import Path
 
-# Configuration
-BASE_DIR = Path(r"d:\nap-dms.lcbp3\specs")
+# Configuration - default base directory, can be overridden via CLI argument
+DEFAULT_BASE_DIR = Path(__file__).resolve().parent.parent.parent / "specs"
+
 DIRECTORIES = [
-    "00-overview",
-    "01-requirements",
-    "02-architecture",
-    "03-implementation",
-    "04-operations",
-    "05-decisions"
+    "00-Overview",
+    "01-Requirements",
+    "02-Architecture",
+    "03-Data-and-Storage",
+    "04-Infrastructure-OPS",
+    "05-Engineering-Guidelines",
+    "06-Decision-Records"
 ]
 
 # Regex for Markdown links: [label](path)
 # Handles relative paths, absolute file paths, and anchors
 LINK_PATTERN = re.compile(r'\[([^\]]+)\]\(([^)]+)\)')
 
-def verify_links():
+def verify_links(base_dir: Path):
     results = {
         "total_links": 0,
         "broken_links": []
     }
 
     for dir_name in DIRECTORIES:
-        directory = BASE_DIR / dir_name
+        directory = base_dir / dir_name
         if not directory.exists():
             print(f"Directory not found: {directory}")
             continue
@@ -53,7 +56,7 @@ def verify_links():
                         # 2. Handle relative paths
                         # Remove anchor if present
                         clean_target_str = target.split("#")[0]
-                        if not clean_target_str: # It was just an anchor to another file but path is empty? Wait.
+                        if not clean_target_str:
                             continue
 
                         # Resolve path relative to current file
@@ -71,8 +74,17 @@ def verify_links():
     return results
 
 if __name__ == "__main__":
-    print(f"Starting link verification in {BASE_DIR}...")
-    audit_results = verify_links()
+    if len(sys.argv) > 1:
+        base_dir = Path(sys.argv[1])
+    else:
+        base_dir = DEFAULT_BASE_DIR
+
+    if not base_dir.exists():
+        print(f"Error: Directory not found: {base_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"Starting link verification in {base_dir}...")
+    audit_results = verify_links(base_dir)
 
     print(f"\nAudit Summary:")
     print(f"Total Internal Links Scanned: {audit_results['total_links']}")