feat: add EARS specification for claude-commands config feature

- Created comprehensive requirements specification using EARS format
- Defined 14 functional and non-functional requirements
- Covered configuration management, error handling, and CLI interface
- Includes traceability matrix and change log
- Keeps implementation simple: delegate to existing configure-claude-code.sh
- Focuses on essential features: --list, --template, --help options

Ready for implementation of claude-commands config command

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: PaulDuvall

specs/claude-commands-config-requirements.md

@@ -0,0 +1,190 @@
+# Claude Commands Config Feature Requirements
+
+## Document Information
+- **Version:** 1.0.0
+- **Date:** 2025-08-21
+- **Author:** Claude Code Development Team
+- **Status:** Draft
+
+## Glossary
+- **Claude Code**: The official CLI tool from Anthropic for interacting with Claude
+- **claude-commands**: The NPM package CLI for managing custom commands
+- **Configuration Template**: Pre-defined settings file for specific use cases
+- **settings.json**: Claude Code's main configuration file located at ~/.claude/settings.json
+
+## Assumptions and Dependencies
+- Claude Code is already installed and functional
+- The claude-commands package is installed globally
+- The configure-claude-code.sh script exists and is functional
+- Configuration templates exist in the templates/ directory
+
+## Functional Requirements
+
+### Configuration Management Requirements
+
+#### REQ-CONFIG-001: List Available Templates
+**Priority:** High
+**WHEN** the user runs `claude-commands config --list`
+**THE SYSTEM SHALL** display all available configuration templates with descriptions
+**Rationale:** Users need to see what configuration options are available
+**Acceptance Criteria:** 
+- Shows template names (basic, comprehensive, security)
+- Shows brief description for each template
+- Returns exit code 0 on success
+
+#### REQ-CONFIG-002: Apply Configuration Template
+**Priority:** High
+**WHEN** the user runs `claude-commands config --template <template-name>`
+**THE SYSTEM SHALL** apply the specified configuration template to Claude Code
+**Rationale:** Users need a simple way to configure Claude Code optimally
+**Acceptance Criteria:**
+- Validates template name exists
+- Backs up existing settings.json
+- Applies template settings
+- Reports success/failure clearly
+
+#### REQ-CONFIG-003: Backup Existing Configuration
+**Priority:** High
+**WHEN** applying a configuration template
+**THE SYSTEM SHALL** create a backup of the existing settings.json file
+**Rationale:** Users should be able to restore previous settings
+**Acceptance Criteria:**
+- Creates backup with timestamp: settings.json.backup.YYYY-MM-DD-HHMMSS
+- Backup created before any changes are made
+- Backup location is ~/.claude/
+
+#### REQ-CONFIG-004: Validate Template Existence
+**Priority:** High  
+**WHEN** the user specifies a template name
+**THE SYSTEM SHALL** validate that the template exists before proceeding
+**Rationale:** Prevent errors from invalid template names
+**Acceptance Criteria:**
+- Checks if template file exists in templates/ directory
+- Provides helpful error message for invalid template names
+- Suggests available templates if invalid name provided
+
+#### REQ-CONFIG-005: Configuration Help
+**Priority:** Medium
+**WHEN** the user runs `claude-commands config --help`
+**THE SYSTEM SHALL** display configuration command usage and options
+**Rationale:** Users need guidance on how to use the config feature
+**Acceptance Criteria:**
+- Shows all available config options
+- Provides examples for each option
+- Follows consistent help format with other commands
+
+### Integration Requirements
+
+#### REQ-CONFIG-006: Delegate to Existing Script
+**Priority:** High
+**WHEN** applying configuration changes
+**THE SYSTEM SHALL** use the existing configure-claude-code.sh script functionality
+**Rationale:** Reuse existing, tested configuration logic
+**Acceptance Criteria:**
+- Calls appropriate functions from configure-claude-code.sh
+- Passes correct parameters for non-interactive mode
+- Handles script execution errors gracefully
+
+#### REQ-CONFIG-007: Non-Interactive Execution
+**Priority:** High
+**WHEN** running configuration through claude-commands
+**THE SYSTEM SHALL** execute in non-interactive mode
+**Rationale:** CLI commands should not require user prompts
+**Acceptance Criteria:**
+- No prompts for user input during execution
+- Uses sensible defaults for all operations
+- Creates backups automatically without asking
+
+### Error Handling Requirements
+
+#### REQ-CONFIG-008: Handle Missing Claude Code
+**Priority:** High
+**IF** Claude Code is not installed, **THEN**
+**THE SYSTEM SHALL** display an error message and exit gracefully
+**Rationale:** Configuration is meaningless without Claude Code
+**Acceptance Criteria:**
+- Checks for Claude Code installation
+- Provides clear error message with installation instructions
+- Returns appropriate exit code for error
+
+#### REQ-CONFIG-009: Handle Permission Errors
+**Priority:** High
+**IF** the system cannot write to ~/.claude/ directory, **THEN**
+**THE SYSTEM SHALL** display a permission error and suggest solutions
+**Rationale:** Users need guidance on fixing permission issues
+**Acceptance Criteria:**
+- Detects write permission issues
+- Provides specific error message about permissions
+- Suggests chmod/chown commands to fix
+
+#### REQ-CONFIG-010: Handle Invalid Templates
+**Priority:** Medium
+**IF** a specified template is invalid or corrupted, **THEN**
+**THE SYSTEM SHALL** display an error and list valid templates
+**Rationale:** Help users recover from invalid template selection
+**Acceptance Criteria:**
+- Validates template file format
+- Shows clear error for corrupted templates
+- Lists all valid alternatives
+
+## Non-Functional Requirements
+
+### Performance Requirements
+
+#### REQ-CONFIG-011: Command Response Time
+**Priority:** Medium
+**THE SYSTEM SHALL** complete configuration operations within 10 seconds
+**Rationale:** Users expect responsive CLI commands
+**Acceptance Criteria:**
+- Template listing completes within 2 seconds
+- Configuration application completes within 10 seconds
+- Help display completes within 1 second
+
+### Usability Requirements
+
+#### REQ-CONFIG-012: Consistent CLI Interface
+**Priority:** High
+**THE SYSTEM SHALL** follow the same command patterns as other claude-commands
+**Rationale:** Consistency improves user experience
+**Acceptance Criteria:**
+- Uses same option naming conventions (--template, --list, --help)
+- Follows same error message formatting
+- Uses same exit code conventions
+
+## Interface Requirements
+
+### Command Line Interface
+
+#### REQ-CONFIG-013: Template Option
+**Priority:** High
+**THE SYSTEM SHALL** accept `--template <name>` option to apply configuration
+**Rationale:** Primary use case for the config command
+**Acceptance Criteria:**
+- Accepts template name as parameter
+- Validates template name before processing
+- Provides feedback on success/failure
+
+#### REQ-CONFIG-014: List Option
+**Priority:** High
+**THE SYSTEM SHALL** accept `--list` option to show available templates
+**Rationale:** Users need to discover available templates
+**Acceptance Criteria:**
+- Shows all templates in templates/ directory
+- Displays template descriptions if available
+- Formatted for easy reading
+
+## Traceability Matrix
+
+| Requirement ID | Implementation File | Test Cases | Priority |
+|----------------|--------------------|-----------:----------|
+| REQ-CONFIG-001 | claude-commands config list | test_REQ_CONFIG_001_list_templates | High |
+| REQ-CONFIG-002 | claude-commands config apply | test_REQ_CONFIG_002_apply_template | High |
+| REQ-CONFIG-003 | backup functionality | test_REQ_CONFIG_003_backup_creation | High |
+| REQ-CONFIG-004 | template validation | test_REQ_CONFIG_004_template_validation | High |
+| REQ-CONFIG-005 | help command | test_REQ_CONFIG_005_help_display | Medium |
+
+## Change Log
+
+| Version | Date | Changes | Author |
+|---------|------|---------|--------|
+| 1.0.0 | 2025-08-21 | Initial specification | Claude Code Team |