tegwick 167222d45b Release v1.0.2: Extended CLI error suppression and updated documentation
🔧 Extended Click library workaround to cover update command
📚 Updated CLAUDE.md with all 17 agents organized by category
🧪 Added comprehensive test coverage for update command
 All 11 CLI error handling tests pass

Major improvements:
- Both install and update commands now provide clean professional output
- Complete agent ecosystem documentation (17 agents vs previous 6)
- Unified error handling approach across affected CLI commands
- Enhanced test suite covering all CLI error scenarios

User experience: Clean output for kaizen-agentic install/update commands
Technical: Extended safe_cli_wrapper to handle ["install", "update"] commands

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 07:24:29 +02:00
2025-10-18 17:05:20 +00:00

Kaizen Agentic

AI agent development framework embracing continuous improvement through specialized agents and comprehensive development workflows.

This project embraces the Japanese concept of "kaizen" (continuous improvement) applied to AI agent development. Every coding subagent becomes part of an optimization loop where performance is measured, patterns are analyzed, and specifications are refined over time.

Quick Start

Install the Package

From Source (Development):

git clone https://github.com/kaizen-agentic/kaizen-agentic.git
cd kaizen-agentic
make setup-complete
make agents-install-cli
source .venv/bin/activate  # Required for each session

Global Installation (Available from any directory):

git clone https://github.com/kaizen-agentic/kaizen-agentic.git
cd kaizen-agentic
make setup-complete
python3 -m build && make install-global
# No virtual environment activation needed

Local Package Testing:

git clone https://github.com/kaizen-agentic/kaizen-agentic.git
cd kaizen-agentic
make setup-complete
python3 -m build && make install-local
source .venv/bin/activate  # Required for each session

From PyPI (Coming Soon):

pip install kaizen-agentic  # Available after v1.0.0 publication
# or
pipx install kaizen-agentic  # Recommended for global CLI tools

Your First Project (New Users)

👋 New to Kaizen Agentic? Follow our Hello World Tutorial for a complete step-by-step guide.

Create a Project (Experienced Users)

# Create a new project with AI agents
kaizen-agentic init my-project --template python-web
cd my-project

# Set up development environment
make setup-complete

# Start coding with agent assistance!
make help  # See all available commands

Add Agents to Existing Project

# Navigate to your project
cd your-existing-project

# Install relevant agents
kaizen-agentic install keepaTodofile keepaChangelog tdd-workflow

# Check what was installed
kaizen-agentic status

Features

  • 16+ Specialized Agents: Project management, testing, code quality, documentation
  • CLI Tool: Easy agent installation and management (kaizen-agentic)
  • Project Templates: Pre-configured setups for different project types
  • Claude Code Integration: Seamless integration with Claude Code workflows
  • Comprehensive Testing: Full test coverage with multiple testing strategies
  • Standards Compliance: Follows PythonVibes and industry best practices

Available Agents

Project Management

  • keepaTodofile: Manages TODO.md files following Keep a Todofile format
  • keepaChangelog: Maintains CHANGELOG.md files following Keep a Changelog format
  • keepaContributingfile: Creates and updates CONTRIBUTING.md files
  • project-management: General project management and coordination

Development Process

  • tdd-workflow: Test-driven development workflow guidance
  • requirements-engineering: Requirements analysis and documentation
  • test-maintenance: Test suite maintenance and optimization

Code Quality

  • code-refactoring: Code improvement and refactoring guidance
  • optimization: Agent definition optimization and improvement
  • datamodel-optimization: Data model design and optimization

Infrastructure

  • setupRepository: Repository initialization and standards compliance
  • claude-documentation: Claude Code configuration and documentation
  • tooling-optimization: Repository tooling usage optimization

View complete agent list

Project Templates

# Available templates
kaizen-agentic templates

# python-basic: Basic Python project setup
# python-web: Web application development
# python-cli: Command-line tool development
# python-data: Data science and analysis
# comprehensive: All available agents

Known Issues

Click Library Workaround

The CLI currently implements a workaround for spurious error messages in the Click library. This affects the install command but is transparent to users. See CLICK_WORKAROUND.md for technical details and removal timeline.

User Impact: None - the workaround provides clean CLI output Status: Monitoring Click library updates for resolution

Description
A framework for vendor agnostic agentic assistance
Readme MIT 1.3 MiB
Languages
Python 84.4%
Makefile 15.6%