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 generate produces distribution artifacts from components/

  • AND agentsmgr populate copies distribution artifacts to downstream targets

  • AND supports detect, generate, populate, and validate commands

Scenario: Generated content management

  • WHEN content is generated

  • THEN pre-generated artifacts are committed in distribution/ for review visibility

  • AND downstream populate copies files and manages .git/info/exclude at file level

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