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>
This commit is contained in:
2026-02-27 09:02:04 +01:00
parent 167222d45b
commit 3858141ce6
6 changed files with 281 additions and 41 deletions

115
CLAUDE.md
View File

@@ -21,13 +21,24 @@ kaizen-agentic/
├── tests/ # Test suite with pytest
│ ├── __init__.py
│ └── test_core.py # Core functionality tests
├── agents/ # Agent definitions and configurations
├── agents/ # Agent definitions and configurations (17 total)
│ ├── agent-claude-documentation.md
│ ├── agent-project-management.md
│ ├── agent-repository-structure.md
│ ├── agent-keepaTodofile.md
│ ├── agent-code-refactoring.md
│ ├── agent-datamodel-optimization.md
│ ├── agent-keepaChangelog.md
── [other agent definitions]
── agent-keepaContributingfile.md
│ ├── agent-keepaTodofile.md
│ ├── agent-optimization.md
│ ├── agent-priority-evaluation.md
│ ├── agent-project-management.md
│ ├── agent-releaseManager.md
│ ├── agent-requirements-engineering.md
│ ├── agent-setupRepository.md
│ ├── agent-tdd-workflow.md
│ ├── agent-test-maintenance.md
│ ├── agent-testing-efficiency.md
│ ├── agent-tooling-optimization.md
│ └── agent-wisdom-encouragement.md
├── .claude/ # Claude Code configuration
│ └── settings.local.json # Local permissions and settings
├── .venv/ # Python virtual environment (created by setup)
@@ -153,37 +164,83 @@ The repository provides a working AI agent framework with kaizen optimization:
### Agent System Architecture
Specialized agent definitions in `agents/` directory:
Specialized agent definitions in `agents/` directory (17 total):
1. **claude-expert** (`agent-claude-documentation.md`)
- Specialized in Claude Code documentation and features
- Access to official docs.claude.com resources
- Handles Claude Code configuration and best practices
#### Documentation & Claude Integration
1. **claude-documentation** (`agent-claude-documentation.md`)
- Specialized assistant for Claude and Claude Code documentation, features, and best practices
- Access to official docs.claude.com resources and Claude Code configuration
2. **project-assistant** (`agent-project-management.md`)
- Project status tracking and progress management
- Manages ProjectStatusDigest.md, ProjectDiary.md, and NEXT.md
- Handles session start-up and wrap-up protocols
#### Project Management
2. **project-management** (`agent-project-management.md`)
- Specialized assistant for project status, progress tracking, and development planning
- Manages project coordination and workflow optimization
3. **repository-assistant** (`agent-repository-structure.md`)
- Repository structure management and refactoring
- Enforces directory structure conventions
- Optimizes project organization
3. **priority-evaluation** (`agent-priority-evaluation.md`)
- Specialized assistant to help evaluate and establish priorities for issues and tasks
- Decision support and task prioritization
4. **todo-keeper** (`agent-keepaTodofile.md`)
- Specialized Todo.md file management and maintenance
4. **releaseManager** (`agent-releaseManager.md`)
- Manages software releases, version control, and publication workflows for Python packages
- Handles semantic versioning and release automation
#### Documentation Keepers
5. **keepaTodofile** (`agent-keepaTodofile.md`)
- Specialized assistant for maintaining TODO.md files following Keep a Todofile V0.0.1 format
- Task tracking, progress monitoring, and workflow optimization
- Integrates todo management with issue tracking and TDD workflows
5. **changelog-keeper** (`agent-keepaChangelog.md`)
- Specialized CHANGELOG.md file management and version history documentation
- Semantic versioning and change categorization (Added, Changed, Fixed, etc.)
- Integrates with release workflows and maintains Keep a Changelog format
6. **keepaChangelog** (`agent-keepaChangelog.md`)
- Specialized assistant for maintaining CHANGELOG.md files following Keep a Changelog format
- Semantic versioning and change categorization
6. **contributing-keeper** (`agent-keepaContributingfile.md`)
- Specialized CONTRIBUTING.md file management and developer onboarding
- Development workflow documentation and code standards maintenance
- Contributor guidelines and community standards management
7. **keepaContributingfile** (`agent-keepaContributingfile.md`)
- Specialized assistant for maintaining CONTRIBUTING.md files following Keep a Contributing-File V0.0.1 format
- Developer onboarding and contribution guidelines
#### Development Process
8. **tdd-workflow** (`agent-tdd-workflow.md`)
- Expert guidance for the TDD8 workflow methodology
- ISSUE-TEST-RED-GREEN-REFACTOR-DOCUMENT-REFINE-PUBLISH cycle with sophisticated sidequest management
9. **requirements-engineering** (`agent-requirements-engineering.md`)
- Specialized agent designed to prevent interface compatibility issues and mock object mismatches
- Ensures solid foundation planning before implementation
#### Testing & Quality Assurance
10. **test-maintenance** (`agent-test-maintenance.md`)
- Specialized agent for analyzing and fixing failing tests in the project
- Test suite maintenance and optimization
11. **testing-efficiency** (`agent-testing-efficiency.md`)
- Specialized agent designed to optimize TDD8 workflow test execution
- Resolves pytest reliability issues and enhances testing efficiency
#### Code Quality & Optimization
12. **code-refactoring** (`agent-code-refactoring.md`)
- Analyze code structure and quality, identify improvement opportunities
- Provides actionable refactoring guidance (Use PROACTIVELY)
13. **datamodel-optimization** (`agent-datamodel-optimization.md`)
- Systematically analyzes, optimizes, and enhances dataclasses, models, and data structures
- Provides comprehensive datamodel improvements
14. **optimization** (`agent-optimization.md`)
- Meta-agent that analyzes and optimizes other Claude Code subagents
- Based on performance data, usage patterns, and effectiveness metrics (Use PROACTIVELY)
#### Infrastructure & Tooling
15. **setupRepository** (`agent-setupRepository.md`)
- Specialized assistant for setting up new Python repositories following PythonVibes best practices
- Repository initialization and standards compliance
16. **tooling-optimization** (`agent-tooling-optimization.md`)
- Meta-agent that analyzes and optimizes repository tooling usage to improve development efficiency
- Discovers and recommends better tool utilization
#### Support & Guidance
17. **wisdom-encouragement** (`agent-wisdom-encouragement.md`)
- Provides encouraging wisdom and guidance for complex implementation tasks and challenging technical work
- Fortune cookie-style wisdom for developers facing technical challenges
## Development Workflow Patterns