Metadata-Version: 2.4
Name: kaizen-agentic
Version: 1.1.0
Summary: AI agent development framework embracing continuous improvement (kaizen)
Author: Kaizen Agentic Team
License: MIT License
        
        Copyright (c) 2025 CoulombCore
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
        associated documentation files (the "Software"), to deal in the Software without restriction, including 
        without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
        copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
        following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial 
        portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
        LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
        EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
        USE OR OTHER DEALINGS IN THE SOFTWARE.
        
Project-URL: Homepage, https://github.com/kaizen-agentic/kaizen-agentic
Project-URL: Bug Reports, https://github.com/kaizen-agentic/kaizen-agentic/issues
Project-URL: Source, https://github.com/kaizen-agentic/kaizen-agentic
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: pre-commit>=2.20.0; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=6.0.0; extra == "test"
Requires-Dist: pytest-cov>=4.0.0; extra == "test"
Requires-Dist: pytest-randomly>=3.10.0; extra == "test"
Dynamic: license-file

# Kaizen Agentic

AI **agency** framework: 18 specialized agents that arrive in your project informed, learn from experience, and improve over time.

kaizen-agentic provides two things: a library of agent instruction sets you deploy into projects, and an **agency framework** that gives those agents persistent memory and coordination. Agents accumulate project-scoped knowledge across sessions. A Coach meta-agent synthesises patterns across the entire fleet and briefs incoming agents on what to know first.

This project embraces the Japanese concept of "kaizen" (continuous improvement) applied to AI agent development. Every agent becomes part of an optimization loop where performance is measured, patterns are analyzed, and knowledge is carried forward.

## Quick Start

### Install the Package

**From Source (Development):**
```bash
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):**
```bash
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:**
```bash
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):**
```bash
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](docs/HELLO_WORLD_TUTORIAL.md) for a complete step-by-step guide.

### Create a Project (Experienced Users)
```bash
# 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
```bash
# 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
```

## Agency Framework

Agents deployed into a project can accumulate **project-scoped memory** — a structured file written at session close and read at session start. A **Coach** meta-agent reads across all agent memories and produces targeted orientation briefs for incoming agents.

```bash
# Scaffold memory for an agent
kaizen-agentic memory init sys-medic

# Brief an incoming agent using all existing project memories
kaizen-agentic memory brief tdd-workflow

# Review an agent's accumulated knowledge
kaizen-agentic memory show project-management
```

See [docs/agency-framework.md](docs/agency-framework.md) for the full model.

## Orientation

Read in this order for strategic context:

1. [INTENT.md](INTENT.md) — purpose, boundaries, design principles
2. [wiki/KaizenAgenticMission.md](wiki/KaizenAgenticMission.md) — product narrative
3. [wiki/AboutKaizenAgents.md](wiki/AboutKaizenAgents.md) — agent concepts and metrics pilot
4. [wiki/EcosystemIntegration.md](wiki/EcosystemIntegration.md) — ecosystem composition
5. [SCOPE.md](SCOPE.md) — repository boundaries and current state
6. [history/](history/) — persisted assessments and gap analyses

Released **v1.1.0** — see [CHANGELOG.md](CHANGELOG.md). Workplans: WP-0001 through WP-0004 completed.

Feedback: `kaizen-agentic feedback` · [docs/FEEDBACK.md](docs/FEEDBACK.md)

## Features

- **20 Specialized Agents**: Project management, testing, code quality, infrastructure, meta
- **Agency Framework**: Project-scoped agent memory + Coach meta-agent for cross-agent synthesis
- **CLI Tool**: Easy agent installation, management, and memory commands (`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

## 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
- **sys-medic**: Infrastructure health monitoring and diagnostics

### Meta
- **coach**: Coaching meta-agent — reads all project agent memories, synthesises cross-agent briefs, and orients incoming agents

[View complete agent list](docs/AGENT_DISTRIBUTION.md#agent-categories)

## Project Templates

```bash
# 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](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
