# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- **Complete hybrid agent distribution system** with AgentRegistry, AgentInstaller, and ProjectInitializer
- **CLI tool `kaizen-agentic`** with comprehensive command interface for agent management
- **Agent registry and installer functionality** for discovering, installing, and managing agents across projects
- **Project templates system** with python-basic, python-web, python-cli, python-data, and comprehensive templates
- **Agent categorization system** (project-management, development-process, code-quality, documentation, testing)
- **Dependency resolution and validation** with safety measures and backup/rollback support
- **Console script entry point** making kaizen-agentic command available globally after pip install
- **Context manifest system** with external documentation references (ContextManifest.md)
- **Reference documentation** for Keep a Contributing-File V0.0.1 and Keep a Todofile V0.0.1 formats
- **PythonVibes integration** with Python project best practices reference
- **Comprehensive 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 operations
  - `kaizen-agentic templates` - Project template management
- **Integrated Makefile targets** for agent management (agents-list, agents-update, agents-validate, agents-status)
- **Automatic Claude Code configuration** updates via CLAUDE.md integration
- **Comprehensive documentation**:
  - GETTING_STARTED.md - Complete setup and usage guide
  - AGENT_DISTRIBUTION.md - Agent distribution system architecture
  - CLI_CHEAT_SHEET.md - Quick reference for all CLI commands
- **Multi-language build system integration** examples and patterns
- **Complete test coverage** for all distribution system components
- **Package data distribution** with all agents included in pip-installable package

### Changed
- **Makefile target reorganization** with consistent naming conventions:
  - Agent management targets now use `agents-` prefix (agents-list, agents-update, agents-validate)
  - Setup targets maintain `setup-` prefix for consistency
  - Standards targets use `standards-` prefix (standards-check, standards-fix, standards-test)
- **Enhanced dependency management** with YAML frontmatter support and precise reference detection
- **Improved backup and safety systems** with microsecond timestamps and collision prevention
- **Updated agent definitions** to align with official documentation standards and distribution requirements
- **Streamlined Makefile structure** with visual section separators and clear help documentation
- **Agent repository consolidation** removing duplicates and focusing on comprehensive implementations

### Fixed
- **All flake8 violations** across the entire codebase for PEP 8 compliance
- **Test reliability issues** with backup directory collision prevention
- **Dependency detection accuracy** with more precise agent reference detection
- **Code style compliance**:
  - Line length violations with appropriate line breaks
  - Unused imports and variables removal
  - F-string usage corrections
  - Import organization and newline standardization
- **Test suite stability** with all 24 tests now passing consistently
- **Validation error reporting** improvements for better debugging
- **Virtual environment setup** reliability issues on fresh repositories

## [0.1.0] - 2025-10-18

### Added
- Initial Kaizen Agentic framework with core agent optimization infrastructure
- Agent and AgentConfig base classes for AI agent development
- OptimizationLoop and PerformanceMetrics for continuous improvement tracking
- Complete Python project structure with pyproject.toml configuration
- Comprehensive testing infrastructure with pytest framework
- Code quality tools integration (black, flake8, mypy)
- Virtual environment management with automatic setup
- Specialized agent definitions framework in `agents/` directory
- Claude Code integration with settings and permissions configuration
- Comprehensive Makefile with 50+ development commands
- Test-driven development (TDD) workflow support
- Issue management integration with Gitea API
- Architectural testing capabilities for 7-layer architecture
- Randomized testing for dependency detection
- Requirements engineering toolkit integration
- TODO.md and CHANGELOG.md following Keep a Todofile and Keep a Changelog formats
- 17+ specialized agents for development tasks
- Changelog keeper agent for version history maintenance
- Todo keeper agent for structured task management
- Project assistant agent for status and progress management
- Repository assistant agent for structure management and refactoring

[Unreleased]: https://github.com/kaizen-agentic/kaizen-agentic/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/kaizen-agentic/kaizen-agentic/releases/tag/v0.1.0