# hybrid-distribution

## Purpose

Combines proven Copier template distribution for static base configuration with dynamic CLI-based content generation for rapid iteration. Enables fast updates to agent configurations without requiring full template releases.

## Requirements

### Requirement: Hybrid Distribution Architecture

The system SHALL combine base configuration templates with dynamic content generation to maintain proven distribution for static templates while enabling fast iteration for dynamic content.

Priority: High

#### Scenario: Minimal Copier template
- **WHEN** base configuration is distributed
- **THEN** minimal Copier template provides base settings templates
- **AND** provides directory structure
- **AND** handles hook path references
- **AND** handles MCP server configurations

#### Scenario: Dynamic content generation
- **WHEN** tool-specific content is needed
- **THEN** agentsmgr CLI generates content from structured data
- **AND** supports detect, populate, and validate commands

#### Scenario: Generated content management
- **WHEN** content is generated
- **THEN** generated content ignored via .gitignore patterns
- **AND** not committed to project repositories

#### Scenario: Configuration detection
- **WHEN** agentsmgr CLI runs
- **THEN** detects configuration from Copier answers files
- **AND** falls back to defaults when answers not available

#### Scenario: Plugin-based source handlers
- **WHEN** content sources are accessed
- **THEN** supports plugin-based source handlers
- **AND** includes git and local filesystem handlers
- **AND** provides extensible architecture for new handlers