New authoring tooling and a fix for the doc-regeneration defect it exposed.
Added:
- src/kaizen_agentic/agent_docs.py — render + idempotent upsert of the
CLAUDE.md "## Installed Agents" section (shared by installer and CLI)
- `kaizen-agentic docs generate [--check]` — idempotent doc refresh / CI gate
- `kaizen-agentic create-agent` — scaffold a schema-valid agent
- Frontmatter schema validation in `kaizen-agentic validate`
(required name/description/category, known category, valid memory/model)
- tests: test_agent_docs, test_validate_schema, test_create_agent
Fixed:
- _update_documentation regex duplicated the Installed Agents block on every
run (stopped at the first ### subheading) — now idempotent
- declared frontmatter `category` is authoritative (heuristic is fallback)
- list_installed_agents reads the frontmatter name, not the filename
- renamed agent-project-management.md -> agent-project-assistant.md to satisfy
the agent-<name>.md convention (eliminates a name/filename collision that
caused install/update to write a divergent duplicate)
- test_cli_error_handling no longer installs into the repo root (uses tmp)
Version 1.4.0; CHANGELOG, CLI cheat sheet, agency-framework, TODO updated.
Workplan KAIZEN-WP-0007 closed.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Define activity-core scheduling for kaizen agents on preselected repos:
schedule manifest, prepare CLI, roster resolver handoff, and custodian pilot.
Point TODO/SCOPE at v1.3.0 active work.
Draft workplan with 16 tasks across publish verification, install doc
sync, packaged agent parity, CI hardening, and ecosystem handoff.
Refresh TODO.md and SCOPE.md; register State Hub workstream.
Moves 8 tasks from TODO.md [Unreleased] into
workplans/kaizen-agentic-WP-0001-community-engagement.md and registers
them in the state-hub as workstream kaizen-wp-0001-community-engagement.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- 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>
- Update CHANGELOG.md with comprehensive v1.0.0 release notes
- Document both Scenario 1 (greenfield) and Scenario 2 (existing project integration) achievements
- Move completed Scenario 2 tasks from active to completed sections in TODO.md
- Mark both major usage scenarios as production-ready with full feature coverage
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added two key usage scenarios to TODO.md for framework development:
Scenario 1: Establish codebase from scratch
- Research current onboarding experience and setup targets
- Identify documentation gaps for new project creation
- Validate project initialization workflows
- Evaluate agent selection systems for new projects
Scenario 2: Integration with existing projects having agents
- Research detection of existing agent systems
- Design conflict resolution for overlapping functionality
- Create migration paths for outdated project agents
- Develop extension mechanisms for project-specific customizations
- Define integration patterns respecting existing structure
- Build tooling for safe agent system transitions
These exploration tasks will guide development of capabilities needed
to support both greenfield projects and integration scenarios.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed YAML frontmatter errors in all agent files causing loading failures
- Added proper category fields to all 16 agents for correct classification
- Standardized agent names to match filenames for consistency
- Updated TODO.md to reflect completed agent system fixes
- Enhanced agents-install-cli make target with pip upgrade and user guidance
All agents now load properly without warnings and display in correct categories:
- Documentation (1), Code Quality (4), Project Management (4)
- Development Process (3), Infrastructure (1), Testing (3)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Used todo-keeper agent to comprehensively update the todofile:
MAJOR COMPLETION RECOGNITION:
- Moved all originally planned features to COMPLETED section
- Documented comprehensive CLI tool with 8 commands
- Recognized 24 tests with 100% pass rate achievement
- Acknowledged complete documentation system (4 guides)
- Celebrated code quality compliance (PEP 8, flake8 clean)
NEW ROADMAP FOR V0.3.0:
- Pre-commit hooks and CI/CD automation
- Enhanced error handling and performance optimization
- Cross-platform compatibility testing
- Agent metrics and telemetry systems
- Security enhancements and integrity verification
CURRENT STATE ASSESSMENT:
- Project transformed from basic framework to production-ready system
- All core functionality implemented and tested
- Remaining tasks focus on production enhancements
- Ready for broader adoption and deployment
Follows Keep a Todofile V0.0.1 format with proper categorization
and clear roadmap for continued development.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Essential project files: .gitignore, pyproject.toml, README.md
- Documentation framework: CHANGELOG.md, CONTRIBUTING.md, TODO.md, CLAUDE.md
- 15 specialized agent definitions for comprehensive development workflow
- Core source code structure with optimization framework
- Testing infrastructure with example tests
- Proper Python package structure following PythonVibes standards
This establishes the complete foundation for the AI agent development framework
with agent-driven workflows, continuous improvement principles, and comprehensive
development infrastructure.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
