Implement hybrid agent distribution system

Complete implementation of the agent distribution framework including:

CORE INFRASTRUCTURE:
- AgentRegistry: Agent discovery, categorization, and dependency management
- AgentInstaller: Agent installation, updates, and removal with safety measures
- ProjectInitializer: Template-based project initialization with agent integration
- CLI Tool: Comprehensive kaizen-agentic command-line interface

DISTRIBUTION FEATURES:
- Python package distribution with console script entry point
- Agent categorization (project-management, development-process, code-quality, etc.)
- Project templates (python-basic, python-web, python-cli, python-data, comprehensive)
- Dependency resolution and validation
- Idempotent operations with backup and rollback support

CLI COMMANDS:
- kaizen-agentic init: Initialize new projects with agents
- kaizen-agentic install/update/remove: Manage agents in existing projects
- kaizen-agentic list/status/validate: Discovery and maintenance
- kaizen-agentic templates: Project template management

INTEGRATION & DOCUMENTATION:
- Makefile targets for agent management (list-agents, update-agents, etc.)
- Automatic Claude Code configuration updates (CLAUDE.md)
- Comprehensive documentation (GETTING_STARTED, AGENT_DISTRIBUTION, CLI_CHEAT_SHEET)
- Multi-language build system integration examples
- Complete test coverage for all components

PACKAGE STRUCTURE:
- Console script: kaizen-agentic command available globally
- Package data: All agents included for distribution
- Dependencies: click, pyyaml for CLI and parsing
- Testing: Comprehensive test suite for registry and installer

This enables sharing specialized AI agents across projects with easy installation,
updates, and management through both CLI and integrated Makefile targets.

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-19 02:31:15 +02:00
parent cf45bea63b
commit 38965c1d4a
28 changed files with 6402 additions and 3 deletions

View File

@@ -1,6 +1,6 @@
# Makefile for Kaizen Agentic development tasks
.PHONY: help setup-complete setup-structure setup-python setup-tools setup-docs setup-tests setup-verify ensure-project-structure install-dev standards-check standards-fix standards-test test test-all build clean lint format venv-status
.PHONY: help setup-complete setup-structure setup-python setup-tools setup-docs setup-tests setup-verify ensure-project-structure install-dev standards-check standards-fix standards-test test test-all build clean lint format venv-status list-agents update-agents validate-agents agent-status install-agent-cli
# Variables
VENV = .venv
@@ -31,6 +31,13 @@ help:
@echo " standards-fix - Fix any standards violations found"
@echo " standards-test - Run repository standards compliance tests"
@echo ""
@echo "Agent Management:"
@echo " list-agents - List installed agents"
@echo " update-agents - Update agents to latest versions"
@echo " validate-agents - Validate agent definitions"
@echo " agent-status - Show agent status and project info"
@echo " install-agent-cli - Install kaizen-agentic CLI tool"
@echo ""
@echo "Development:"
@echo " test - Run unit tests only (fast)"
@echo " test-all - Run comprehensive test suite (tests + standards + quality)"
@@ -43,6 +50,7 @@ help:
@echo " make setup-complete # Set up new repository"
@echo " make test-all # Run full test suite"
@echo " make standards-check # Audit repository compliance"
@echo " make agent-status # Check installed agents"
# Virtual environment status check
venv-status:
@@ -645,4 +653,57 @@ standards-test: $(VENV)/bin/activate
echo "❌ Repository standards compliance: FAILED ($$ISSUES violations)"; \
echo " Run 'make standards-fix' to resolve issues."; \
exit 1; \
fi
fi
# ============================================================================
# Agent Management Targets
# ============================================================================
# List installed agents
list-agents:
@echo "🤖 Installed agents:"
@if [ -d "agents" ]; then \
ls agents/ 2>/dev/null | grep agent- | sed 's/agent-//g' | sed 's/.md//g' | sort || echo "No agents installed"; \
else \
echo "No agents directory found"; \
fi
# Update installed agents to latest versions
update-agents: $(VENV)/bin/activate
@echo "🔄 Updating agents..."
@if command -v kaizen-agentic >/dev/null 2>&1; then \
kaizen-agentic update; \
else \
echo "⚠️ kaizen-agentic CLI not found. Install with: pip install kaizen-agentic"; \
fi
# Validate installed agents
validate-agents:
@echo "✅ Validating agents..."
@if command -v kaizen-agentic >/dev/null 2>&1; then \
kaizen-agentic validate; \
else \
echo "⚠️ kaizen-agentic CLI not found. Install with: pip install kaizen-agentic"; \
fi
# Show agent status and project information
agent-status:
@echo "📊 Agent status:"
@if command -v kaizen-agentic >/dev/null 2>&1; then \
kaizen-agentic status; \
else \
echo "⚠️ kaizen-agentic CLI not found. Install with: pip install kaizen-agentic"; \
echo ""; \
echo "Manual agent check:"; \
if [ -d "agents" ]; then \
echo "Agents directory exists with $$(ls agents/ | wc -l) files"; \
else \
echo "No agents directory found"; \
fi; \
fi
# Install agent distribution CLI
install-agent-cli: $(VENV)/bin/activate
@echo "📦 Installing Kaizen Agentic CLI..."
@$(VENV_PIP) install -e .
@echo "✅ CLI installed. Use 'kaizen-agentic --help' for usage."