Commit Graph

9 Commits

Author SHA1 Message Date
53dfd55916 feat(protocols): add protocols artifact convention, sys-medic protocol + CLI (WP-0002 T17-T24)
- ADR-003: protocols artifact convention (location, structure, lifecycle)
- agents/protocols/README.md: directory-level index and usage guide
- agents/protocols/sys-medic/k3s-node-health-assessment.md: full structured
  k3s node health assessment protocol (8 steps: OS baseline, process hygiene,
  memory, CPU, disk, network, k3s node state, runtime services)
- agent-sys-medic.md: add memory: enabled frontmatter, session-start/close
  protocols, node-profile memory template extensions, protocol reference in
  Default Task
- cli.py: add protocols command group (list, show); extend memory init to hint
  protocol commands for agents that have protocols

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:48:09 +00:00
23345cc5fd feat(agency): add coach meta-agent and complete memory brief command (WP-0002 T12-T14)
- Add agents/agent-coach.md: new meta-category coaching agent that reads
  all project agent memories, synthesises cross-agent briefs, and produces
  targeted orientation briefs for incoming agents
- Complete memory brief command: now reads all .kaizen/agents/*/memory.md,
  formats structured orientation output following coach agent spec, adds
  --raw flag for unformatted dump
- Coach validates and appears under kaizen-agentic list --category meta

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:41:17 +00:00
4b4b1ff1f1 feat(memory): add memory CLI command group and project memory ADRs
- Add docs/adr/ADR-001-workplan-convention.md (formalises existing convention)
- Add docs/adr/ADR-002-project-memory-convention.md (file location, structure,
  session protocols, opt-out, CLI interface)
- Implement `kaizen-agentic memory` command group: show, init, brief, clear
  - Memory stored at .kaizen/agents/<name>/memory.md in project root
  - `init` scaffolds the standard memory template with YAML frontmatter
  - `brief` lists all agent memories + note that coach synthesis is pending T13
  - `clear` deletes with confirmation prompt

WP-0002 T07 and T08 done.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:25:48 +00:00
3858141ce6 Extend update command error handling and update documentation
- Extend safe_cli_wrapper() to suppress spurious Click errors for both
  install and update commands; add success indicators for update output
- Add test_update_command_error_suppression to verify error suppression
- Expand CLAUDE.md to document all 17 agents with categories
- Add Keep a Contributing-File format header to CONTRIBUTING.md
- Fix TodoFileGuide URL reference in TODO.md
- Add RELEASE_NOTES_v1.0.1.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-27 09:02:04 +01:00
803f032818 Release v1.0.1: Fix CLI error messages and improve user experience
### Key Fixes
- Resolve spurious "Got unexpected extra argument" error messages in Click library
- Fix malformed YAML frontmatter in agent definition files
- Enhance global installation capability with improved make install-global

### Technical Implementation
- Add intelligent CLI error handling with safe_cli_wrapper() function
- Implement comprehensive test suite for error suppression (11 test cases)
- Create detailed documentation and future maintenance guide
- Update entry point to provide clean user experience

### Files Added
- tests/test_cli_error_handling.py - Comprehensive test coverage
- CLICK_WORKAROUND.md - Technical documentation and removal timeline

### Files Modified
- pyproject.toml - Version bump to 1.0.1 and entry point update
- CHANGELOG.md - Detailed release notes for v1.0.1
- README.md - Added known issues section
- src/kaizen_agentic/cli.py - Click error handling implementation
- Multiple agent files - Fixed YAML frontmatter formatting

Resolves: Issue #3 - CLI argument parsing errors and user confusion

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 07:05:32 +02:00
d68310793b Fix linting violations for v1.0.0 release preparation
- Apply black formatting to all Python files
- Fix various flake8 violations in agent system code
- Clean up imports and whitespace issues

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 20:44:58 +02:00
6fb302075d Implement complete Scenario 2: Integration with existing projects having agents
Built comprehensive system for introducing Kaizen agents to existing projects:

🔍 **Detection System (detection.py)**:
- Detects 9+ types of existing agent systems (Kaizen, Claude Code, custom agents, etc.)
- Analyzes agent files with YAML frontmatter parsing
- Identifies conflicts and functional overlaps
- Generates integration strategies and migration recommendations

🔄 **Migration Framework (migration.py)**:
- Creates detailed migration plans for each detected agent
- Supports 5 migration strategies: replace, extend, preserve, merge, remove
- Intelligent conflict resolution with multiple resolution types
- Safe execution with backup creation and rollback capability

🔗 **Extension System (extensions.py)**:
- Project-specific agent customizations and extensions
- Multiple extension types: config overlay, functional extension, workflow integration
- Template generation for basic and advanced extensions
- Legacy agent integration with wrapper creation

🛠️ **CLI Integration**:
- `kaizen-agentic detect` - Analyze existing agent systems
- `kaizen-agentic migrate` - Execute migration plans with dry-run support
- `kaizen-agentic extensions` - Complete extension management commands

📖 **Integration Patterns Documentation**:
- 5 proven integration scenarios with detailed patterns
- Conflict resolution strategies and decision matrices
- Safe transition strategies with phased rollout
- Best practices and troubleshooting guides

**Key Features**:
 Respects existing project structure and workflows
 Safe transitions with comprehensive backup strategies
 Conflict detection and automated resolution
 Extension mechanisms for preserving custom functionality
 Comprehensive tooling for all transition scenarios

Scenario 2 is now production-ready for integrating Kaizen agents into any existing project!

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 11:47:17 +02:00
da6eee7d47 Fix all flake8 violations across the codebase
CODE STYLE FIXES:
- Fixed line length violations by breaking long lines appropriately
- Removed unused imports (os from installer.py and registry.py)
- Removed unused variables (package_name in _create_pyproject_toml)
- Fixed f-string usage (removed f-strings without placeholders)
- Fixed import organization and removed redundant imports
- Added missing newlines at end of files

SPECIFIC FIXES:
- cli.py: Split long option line, fixed f-string usage, added newline
- installer.py: Removed unused imports/variables, fixed line breaks, improved validation logic
- registry.py: Removed unused import/variable, broke long condition line
- test files: Removed unused imports, fixed long assertion lines, added newlines

All 24 tests still pass and flake8 now reports no violations.
Code is now compliant with PEP 8 style guidelines.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 08:15:42 +02:00
38965c1d4a 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>
2025-10-19 02:31:15 +02:00