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:
115
CLAUDE.md
115
CLAUDE.md
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user