Commit Graph

11 Commits

Author SHA1 Message Date
4a9c2d9bea WP-0003 Part 6: packaging sync and docs close-out
Sync coach, sys-medic, scope-analyst, optimization, and updated
tdd-workflow to packaged data (20 agents). Update architecture.md,
README orientation, and CHANGELOG for the metrics loop. Mark WP-0003
completed.
2026-06-16 01:49:27 +02:00
bd74d7d122 Document measurement loop plan and ecosystem integration strategy.
Persist INTENT and ecosystem assessments in history/, add ADR-004 for
project metrics with Helix Forge correlation, and register WP-0003 and
WP-0004 workplans with State Hub. Update SCOPE, README, and agency-framework
docs to reflect the two-layer measurement model.
2026-06-16 01:34:13 +02:00
15f4cce238 docs(agency): add agency-framework.md and update README (WP-0002 T15-T16)
- Add docs/agency-framework.md: full explanation of the project memory
  model, session protocols, memory frontmatter field, CLI reference,
  coach meta-agent usage, and protocols preview (Part 3)
- Update README: reposition as agency framework (not just agent library),
  add Agency Framework section with memory CLI examples, update feature
  list to 18 agents, add sys-medic and coach to agent listing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:44:05 +00: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
b257b3c906 Add global installation capability and fix venv accessibility issue
- Add make install-global target with intelligent installation methods
- Support pipx (recommended), pip --user, and fallback options
- Resolve issue where kaizen-agentic was only available in local venv
- Update documentation to clearly explain 4 installation options:
  - Development mode (local venv)
  - Global installation (any directory)
  - Local package testing (local venv)
  - Future PyPI installation
- CLI now available globally from any directory after make install-global

Fixes the core issue where users couldn't access kaizen-agentic from other repos.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 22:03:10 +02:00
63dacda163 Update documentation for local package installation option
- Add Option B: From Local Package installation instructions
- Include make install-local target in both README.md and GETTING_STARTED.md
- Provide clear path for testing PyPI-equivalent installation locally
- Maintains development, local package, and future PyPI installation options

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 20:55:09 +02:00
30daabf12c Add release management system and prepare v1.0.0 publication
- Add agent-releaseManager.md with comprehensive publication workflow guidance
- Add 6 release- prefixed make targets for structured release process:
  - release-check: Validate release readiness
  - release-prepare: Build packages and prepare release
  - release-test: Test publication via TestPyPI
  - release-publish: Publish to production PyPI
  - release-finalize: Post-release tasks (tags, GitHub releases)
  - release-rollback: Emergency rollback procedures
- Update pyproject.toml version from 0.1.0 to 1.0.0 for consistency with CHANGELOG.md
- Update installation documentation in README.md and GETTING_STARTED.md
  - Add current "from source" installation instructions
  - Maintain "from PyPI" instructions for post-publication
- Framework now ready for v1.0.0 publication with complete release workflow

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 13:42:32 +02:00
ca6909a04f Update documentation for first-time users and fix outdated agent names
Major documentation improvements:
- Fixed all outdated agent names throughout README.md and GETTING_STARTED.md
- Updated agent references from old names (todo-keeper, changelog-keeper, setup-repository)
  to new names (keepaTodofile, keepaChangelog, setupRepository)
- Created comprehensive HELLO_WORLD_TUTORIAL.md with step-by-step guide for new users
- Added prominent tutorial links in README.md and GETTING_STARTED.md for better discoverability
- Updated Python version requirements from 3.8 to 3.9 in project templates
- Enhanced first-time user experience with clear guidance and working examples

Documentation now provides:
 Working commands that match actual agent names
 Clear separation between new users and experienced users
 Complete tutorial from installation to running code
 Proper guidance for scenario one (greenfield projects)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 09:13:50 +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
fc0b1ffec8 Update README.md 2025-10-18 17:06:32 +00:00
Coulomb Social
1c3e231f2d Initial commit 2025-10-18 17:05:20 +00:00