tegwick
873120c2d3
MAKEFILE TARGET RENAMING: - Renamed agent management targets to use agents- prefix for consistency - list-agents → agents-list - update-agents → agents-update - validate-agents → agents-validate - agent-status → agents-status - install-agent-cli → agents-install-cli - Updated all documentation to reflect new naming convention TEST FIXES: - Fixed backup directory collision in tests by adding microseconds and counter - Improved dependency detection to be more precise and avoid false positives - Updated dependency parsing to support YAML frontmatter dependencies - Fixed test expectations to match actual validation behavior - All 24 tests now passing DEPENDENCY SYSTEM IMPROVEMENTS: - Enhanced dependency extraction from YAML frontmatter (dependencies, depends_on, requires) - More precise agent reference detection in content - Better handling of explicit vs implicit dependencies - Improved validation error reporting This ensures consistent naming convention (setup-, standards-, agents-) across all Makefile targets while fixing test reliability issues. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
4.8 KiB
4.8 KiB
Kaizen Agentic CLI Cheat Sheet
Quick reference for the kaizen-agentic command-line tool.
Installation
pip install kaizen-agentic
Core Commands
Project Initialization
# New project with default template
kaizen-agentic init my-project
# New project with specific template
kaizen-agentic init web-app --template python-web
# New project with custom agents
kaizen-agentic init cli-tool --agents todo-keeper,tdd-workflow,claude-documentation
# Initialize in specific directory
kaizen-agentic init my-project --parent-dir ~/projects
Agent Management
# List available agents
kaizen-agentic list
kaizen-agentic list --category project-management
kaizen-agentic list --verbose
# Install agents
kaizen-agentic install todo-keeper changelog-keeper
kaizen-agentic install tdd-workflow --target ~/my-project
kaizen-agentic install code-refactoring --no-backup --no-docs
# Update agents
kaizen-agentic update # Update all installed
kaizen-agentic update todo-keeper # Update specific agents
# Remove agents
kaizen-agentic remove old-agent-name
# Project status
kaizen-agentic status # Show current project status
kaizen-agentic validate # Validate agent installation
Information
# List templates
kaizen-agentic templates
# Show help
kaizen-agentic --help
kaizen-agentic install --help # Command-specific help
# Version
kaizen-agentic --version
Common Workflows
Setting Up New Python Web Project
kaizen-agentic init my-web-app --template python-web
cd my-web-app
make setup-complete
make test
Adding Agents to Existing Project
cd existing-project
kaizen-agentic install todo-keeper changelog-keeper
kaizen-agentic status
Maintaining Agents
# Weekly maintenance
kaizen-agentic update
kaizen-agentic validate
# Check what's installed
kaizen-agentic status
Team Onboarding
git clone team-repo
cd team-repo
pip install kaizen-agentic
kaizen-agentic status # See what agents are used
cat CLAUDE.md # Read agent documentation
Agent Categories
| Category | Example Agents | Use Cases |
|---|---|---|
project-management |
todo-keeper, changelog-keeper | Task tracking, documentation |
development-process |
tdd-workflow, requirements-engineering | Development methodology |
code-quality |
code-refactoring, datamodel-optimization | Code improvement |
infrastructure |
setup-repository, testing-efficiency | Project setup, tooling |
testing |
test-maintenance, tdd-workflow | Test management |
documentation |
claude-documentation, contributing-keeper | Documentation management |
Templates
| Template | Agents Included | Best For |
|---|---|---|
python-basic |
setup-repository, todo-keeper, changelog-keeper | Simple Python projects |
python-web |
Basic + tdd-workflow, code-refactoring, contributing-keeper | Web applications |
python-cli |
Basic + testing-efficiency, claude-documentation | Command-line tools |
python-data |
Basic + datamodel-optimization, requirements-engineering | Data science |
comprehensive |
All available agents | Complex projects |
Integration Commands
Without Makefile
# Direct CLI usage when Makefile targets aren't available
kaizen-agentic status # Instead of: make agents-list
kaizen-agentic update # Instead of: make agents-update
kaizen-agentic validate # Instead of: make agents-validate
With Build Tools
npm/package.json:
{
"scripts": {
"agents:status": "kaizen-agentic status",
"agents:update": "kaizen-agentic update"
}
}
Make targets (auto-added):
make agents-list # List installed agents
make agents-update # Update agents
make agents-validate # Validate agents
make agents-status # Show detailed status
Troubleshooting
Common Issues
# Command not found
pip install kaizen-agentic
# No agents directory
kaizen-agentic install todo-keeper
# Validation errors
kaizen-agentic validate
kaizen-agentic remove problematic-agent
kaizen-agentic install problematic-agent
Getting Help
kaizen-agentic --help # General help
kaizen-agentic COMMAND --help # Command help
kaizen-agentic status # Check current state
kaizen-agentic validate # Validate setup
Quick Examples
Start a data science project:
kaizen-agentic init ml-project --template python-data
cd ml-project && make setup-complete
Add testing workflow to existing project:
kaizen-agentic install tdd-workflow testing-efficiency
Update all agents monthly:
kaizen-agentic update && kaizen-agentic validate
Check what agents a project uses:
kaizen-agentic status
cat CLAUDE.md # Detailed info