@qazuor/claude-code-config 0.1.0

package/templates/commands/meta/create-command.md

@@ -0,0 +1,312 @@
+---
+name: create-command
+type: meta
+category: system
+description: Interactive wizard to create new slash commands
+config_required:
+  - command_types: "Define command categories (development, planning, quality, etc.)"
+  - category_mapping: "Map types to subdirectories"
+  - template_types: "Specify command templates available"
+  - base_path: "Define commands directory location"
+---
+
+# Create Command
+
+## Purpose
+
+Interactive wizard for creating slash commands following project standards. Ensures proper integration with workflow and comprehensive documentation.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `command_types` | Available types | `development, planning, quality, audit, meta, git` |
+| `category_mapping` | Type to directory map | `development: workflow, quality: validation` |
+| `template_types` | Template options | `workflow, audit, utility` |
+| `base_path` | Commands directory | `.claude/commands/` |
+| `name_pattern` | Validation regex | `^[a-z][a-z0-9-]*[a-z0-9]$` |
+
+## Usage
+
+```bash
+/create-command [options]
+```
+
+### Options
+
+- `--name <name>`: Command name (without slash)
+- `--type <type>`: Command type
+- `--interactive`: Full interactive mode (default)
+- `--template <type>`: Use template
+
+## When to Use
+
+- New workflow action needed
+- System integration required
+- Developer productivity shortcuts
+- Quality gates needed
+
+## Command Creation Process
+
+### Step 1: Discovery & Planning
+
+**Wizard Questions**:
+
+1. Command name (without slash)
+2. Command type
+3. Category (subdirectory)
+4. One-line description
+5. Detailed purpose
+6. When to use scenarios
+
+### Step 2: Specification
+
+**Define**:
+
+1. Options/parameters
+2. Usage examples
+3. Process steps
+4. Output format
+
+### Step 3: File Generation
+
+**File Created**: `{base_path}/{category}/{command-name}.md`
+
+**YAML Frontmatter**:
+
+```yaml
+---
+name: {command-name}
+type: {type}
+category: {category}
+description: {description}
+---
+```
+
+**Structure**:
+
+```markdown
+# {Command Name} Command
+
+## Purpose
+{detailed_purpose}
+
+## When to Use
+{scenarios}
+
+## Usage
+{syntax}
+
+## Process
+{steps}
+
+## Output Format
+{output}
+
+## Integration
+{workflow_integration}
+
+## Best Practices
+{practices}
+```
+
+### Step 4: Integration & Documentation
+
+**Updates**:
+
+- Commands README
+- Main documentation (if major)
+- Quick start (if user-facing)
+
+### Step 5: Validation
+
+**Checks**:
+
+- Name follows conventions
+- YAML valid
+- All sections complete
+- Examples clear
+- Process actionable
+- File in correct directory
+
+**Test**: Verify command loads and works
+
+### Step 6: Commit
+
+**Format**:
+
+```bash
+feat(commands): add /{command-name} command
+
+- {description}
+- {key_features}
+
+Usage: /{command-name} [options]
+
+Examples:
+  - {example}
+
+Updates:
+- {command_file} (new)
+- README.md (updated)
+```
+
+## Interactive Wizard Flow
+
+```text
+⚙️ Create New Command Wizard
+
+📝 Step 1: Command Identity
+Command Name: {input}
+Type: {selection}
+Category: {input}
+Description: {input}
+
+📋 Step 2: Purpose & Usage
+Purpose: {input}
+When to use: {input}
+
+🔧 Step 3: Options & Parameters
+Options: {input}
+
+📊 Step 4: Process Definition
+Steps: {input}
+
+📝 Step 5: Review & Confirm
+{summary}
+Proceed? (y/n)
+
+✨ Creating Command
+✓ Generated file
+✓ Updated documentation
+✓ Validation passed
+```
+
+## Command Templates
+
+### Workflow Command
+
+```markdown
+---
+name: {name}
+type: development
+category: workflow
+description: {desc}
+---
+
+# {Name} Command
+
+## Purpose
+{purpose}
+
+## Usage
+/{name} [options]
+
+## Process
+### Step 1: {name}
+{actions}
+
+## Output Format
+{format}
+```
+
+### Audit Command
+
+```markdown
+---
+name: {name}
+type: audit
+category: quality
+description: {desc}
+---
+
+# {Name} Command
+
+## Audit Process
+### 1. {Area}
+**Checks**: {checks}
+**Benchmarks**: {benchmarks}
+
+## Output Format
+{format}
+```
+
+## Validation Rules
+
+### Command Name
+
+- Format: kebab-case
+- Length: 3-30 characters
+- Pattern: Configured regex
+- Must be unique
+- No slash included
+
+### YAML Frontmatter
+
+**Required**: name, type, category, description
+
+**Valid Types**: Configured command types
+
+**Description**: One-line, under 120 chars
+
+### Directory Structure
+
+```text
+{base_path}/
+├── workflow/
+├── planning/
+├── quality/
+├── audit/
+├── meta/
+└── git/
+```
+
+## Best Practices
+
+### Design
+
+- Single, clear responsibility
+- Descriptive name
+- Comprehensive docs
+- Sensible defaults
+- Clear feedback
+
+### Integration
+
+- Fit existing workflow
+- Work with other commands
+- Idempotent when possible
+
+## Common Patterns
+
+### Quality Check
+
+```bash
+/{check-name} [--scope <area>] [--fix] [--report]
+```
+
+### Workflow Automation
+
+```bash
+/{action-name} [--options]
+```
+
+### Audit
+
+```bash
+/{audit-name} [--scope <area>] [--depth <level>] [--report]
+```
+
+## Related Commands
+
+- `/create-agent` - Create new agent
+- `/create-skill` - Create new skill
+- `/help` - System help
+
+## Notes
+
+- Use verb-noun pattern for names
+- Full words in options
+- Keep examples updated
+- Test before committing
+- Always update README

package/templates/commands/meta/create-skill.md

@@ -0,0 +1,321 @@
+---
+name: create-skill
+type: meta
+category: system
+description: Interactive wizard to create reusable skills for specialized workflows
+config_required:
+  - skill_categories: "Define skill categories (testing, development, validation, etc.)"
+  - skill_types: "Specify skill types (workflow, validation, utility, etc.)"
+  - base_path: "Define skills directory location"
+  - template_types: "Available skill templates"
+---
+
+# Create Skill Command
+
+## Purpose
+
+Interactive wizard for creating skills - specialized, reusable workflows invoked by agents. Ensures skills follow standards and integrate properly.
+
+## ⚙️ Configuration
+
+| Setting | Description | Example |
+|---------|-------------|---------|
+| `skill_categories` | Available categories | `testing, development, validation, documentation, automation` |
+| `skill_types` | Skill types | `workflow, validation, utility, template, analysis` |
+| `base_path` | Skills directory | `.claude/skills/` |
+| `name_pattern` | Validation regex | `^[a-z][a-z0-9-]*[a-z0-9]$` |
+| `template_types` | Template options | `workflow, validation, utility` |
+
+## Usage
+
+```bash
+/create-skill [options]
+```
+
+### Options
+
+- `--name <name>`: Skill name (kebab-case)
+- `--category <category>`: Skill category
+- `--interactive`: Full interactive mode (default)
+- `--template <type>`: Use template
+
+## When to Use
+
+- Reusable workflows needed
+- Domain expertise codification
+- Complex procedures documentation
+- Best practice standardization
+
+## Skill Creation Process
+
+### Step 1: Discovery & Planning
+
+**Wizard Questions**:
+
+1. Skill name (kebab-case)
+2. Skill category
+3. One-line description
+4. Detailed purpose
+5. Primary users (agents)
+6. Skill type
+
+### Step 2: Workflow Definition
+
+**Define**:
+
+1. Input requirements
+2. Process steps
+3. Output/deliverables
+4. Success criteria
+
+### Step 3: File Generation
+
+**File Created**: `{base_path}/{category}/{skill-name}.md`
+
+**YAML Frontmatter**:
+
+```yaml
+---
+name: {skill-name}
+category: {category}
+description: {description}
+usage: {usage_context}
+input: {input_requirements}
+output: {output_produced}
+---
+```
+
+**Structure**:
+
+```markdown
+# {Skill Name}
+
+## Overview
+{purpose_and_users}
+
+## When to Use
+{scenarios}
+
+## Prerequisites
+{requirements}
+
+## Workflow
+### Step 1: {name}
+{actions_and_validation}
+
+## Output
+{deliverables_and_criteria}
+
+## Examples
+{scenarios}
+
+## Error Handling
+{errors_and_solutions}
+```
+
+### Step 4: Integration & Documentation
+
+**Updates**:
+
+- Skills README
+- Agent documentation (if agent-specific)
+- Quick start (if widely used)
+
+### Step 5: Validation
+
+**Checks**:
+
+- Name follows conventions
+- YAML valid
+- All sections complete
+- Workflow clear and actionable
+- Prerequisites defined
+- Success criteria measurable
+- File in correct directory
+
+**Test**: Invoke from agent context
+
+### Step 6: Commit
+
+**Format**:
+
+```bash
+feat(skills): add {skill-name} skill
+
+- {description}
+- Primary users: {agents}
+
+Workflow: {key_steps}
+Output: {deliverables}
+
+Updates:
+- {skill_file} (new)
+- README.md (updated)
+```
+
+## Interactive Wizard Flow
+
+```text
+🎯 Create New Skill Wizard
+
+📝 Step 1: Skill Identity
+Skill Name: {input}
+Category: {selection}
+Description: {input}
+Type: {selection}
+
+📋 Step 2: Purpose & Users
+Purpose: {input}
+Primary users: {input}
+
+🔧 Step 3: Workflow Definition
+Steps: {input}
+Input: {input}
+Output: {input}
+Success criteria: {input}
+
+📝 Step 4: Review & Confirm
+{summary}
+Proceed? (y/n)
+
+✨ Creating Skill
+✓ Generated file
+✓ Updated documentation
+✓ Validation passed
+```
+
+## Skill Templates
+
+### Workflow Skill
+
+```markdown
+---
+name: {name}
+category: {category}
+description: {desc}
+usage: Invoke when {context}
+input: {requirements}
+output: {deliverables}
+---
+
+# {Name}
+
+## Overview
+**Purpose**: {purpose}
+**Primary Users**: {agents}
+
+## Workflow
+### Step 1: {name}
+**Objective**: {goal}
+**Actions**: {steps}
+**Validation**: {checks}
+**Output**: {result}
+
+## Output
+**Produces**: {outputs}
+**Success Criteria**: {criteria}
+```
+
+### Validation Skill
+
+```markdown
+---
+name: {name}
+category: validation
+description: {desc}
+usage: Use to validate {what}
+input: {what_to_validate}
+output: Validation report
+---
+
+# {Name}
+
+## Validation Checklist
+### {Category}
+- [ ] {check}
+
+## Validation Process
+{steps}
+
+## Output Format
+{report_format}
+```
+
+## Validation Rules
+
+### Skill Name
+
+- Format: kebab-case
+- Length: 3-40 characters
+- Pattern: Configured regex
+- Must be unique
+
+### YAML Frontmatter
+
+**Required**: name, category, description, usage, input, output
+
+**Valid Categories**: Configured categories
+
+**Valid Types**: Configured types
+
+### Directory Structure
+
+```text
+{base_path}/
+├── testing/
+├── development/
+├── validation/
+├── documentation/
+├── automation/
+└── analysis/
+```
+
+## Best Practices
+
+### Design
+
+- Generic and reusable
+- Parameterized for context
+- Modular steps
+- Clear objectives
+- Actionable steps
+- Validated at each step
+
+### Documentation
+
+- Realistic examples
+- Error scenarios documented
+- Clear prerequisites
+- Agent-aware design
+
+## Common Patterns
+
+### Testing Workflow
+
+1. Prerequisites check
+2. Test planning
+3. Test implementation
+4. Validation
+5. Documentation
+
+### Validation Workflow
+
+1. Input validation
+2. Criteria checking
+3. Result compilation
+4. Report generation
+
+## Related Commands
+
+- `/create-agent` - Create new agent
+- `/create-command` - Create new command
+- `/help` - System help
+
+## Notes
+
+- Skills invoked by agents, not users
+- Keep focused on single responsibility
+- Comprehensive docs critical
+- Test from actual agent context
+- Skills evolve with patterns
+- Use action-oriented names