# KCL Schemas Reference

This directory contains references to existing KCL schema implementations.

## Current Implementation Locations

### Settings Schema
- **Current**: `/Users/Akasha/repo-cnz/src/provisioning/kcl/settings.k`
- **New Reference**: `settings.k` (placeholder created)

### Provider Schemas
- **Current**: Various files in `/Users/Akasha/repo-cnz/src/provisioning/providers/*/kcl/`
- **New Reference**: `providers.k` (to be created)

### Workflow Schemas
- **Current**: Distributed across workflow implementations
- **New Reference**: `workflows.k` (to be created)

## Migration Strategy

### Phase 1: Analysis
- Inventory all existing KCL schemas
- Identify common patterns and duplications
- Document schema relationships

### Phase 2: Consolidation
- Create unified schema files
- Preserve backward compatibility
- Update import paths gradually

### Phase 3: Optimization
- Improve type safety
- Add comprehensive validation
- Enhance documentation

## Benefits of Consolidation

1. **Single Source of Truth**: Unified schema definitions
2. **Type Safety**: Compile-time validation across entire system
3. **Consistency**: Standardized configuration patterns
4. **Maintainability**: Easier schema evolution and updates

## Current Status

- **Reference Files**: Created with placeholders
- **Original Schemas**: Fully functional in existing locations
- **Migration**: Planned for future phase

## Integration

Consolidated schemas will be used by:
- Core provisioning engine
- Code generators
- Configuration validators
- Documentation systems
- IDE integrations (syntax highlighting, autocompletion)