tegwick
843cf4eee0
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>
3.7 KiB
3.7 KiB
kaizen-agentic — Claude Code Instructions
@.claude/rules/repo-identity.md @.claude/rules/session-protocol.md @.claude/rules/first-session.md @.claude/rules/workplan-convention.md @.claude/rules/stack-and-commands.md @.claude/rules/architecture.md @.claude/rules/repo-boundary.md
Installed Agents
This project includes the following specialized agents:
Documentation
- claude-documentation: Specialized assistant for Claude and Claude Code documentation, features, and best practices
- keepaContributingfile: Specialized assistant for maintaining CONTRIBUTING.md files following Keep a Contributing-File V0.0.1 format within the Kaizen Agentic framework
- wisdom-encouragement: Provides encouraging wisdom and guidance for complex implementation tasks and challenging technical work
Meta
- coach: Coaching meta-agent that reads all agent memories in a project and synthesises cross-agent briefs and new-agent orientations
- optimization: Meta-agent that analyzes and optimizes other Claude Code subagents based on their performance data, usage patterns, and effectiveness metrics. Use PROACTIVELY for agent ecosystem improvement.
Code Quality
- code-refactoring: Analyze code structure and quality, identify improvement opportunities, and provide actionable refactoring guidance. Use PROACTIVELY for code quality assessment and improvement.
- datamodel-optimization: Specialized agent that systematically analyzes, optimizes, and enhances dataclasses, models, and data structures within a codebase. Provides comprehensive datamodel improvements including convenience methods, interface consistency, code reduction, and test alignment.
Project Management
- keepaChangelog: Specialized assistant for maintaining CHANGELOG.md files following Keep a Changelog format
- keepaTodofile: Specialized assistant for maintaining TODO.md files following Keep a Todofile V0.0.1 format
- priority-evaluation: Specialized assistant to help evaluate and establish priorities for issues and tasks.
- project-assistant: Specialized assistant for project status, progress tracking, and development planning
- releaseManager: Manages software releases, version control, and publication workflows for Python packages
- scope-analyst: Analyze a repository and produce/improve SCOPE.md for rapid orientation
Development Process
- requirements-engineering: Specialized agent designed to prevent interface compatibility issues and mock object mismatches by ensuring solid foundation planning before implementation. Based on lessons learned from Issue
- tdd-workflow: Expert guidance for the TDD8 workflow methodology, specializing in the comprehensive ISSUE-TEST-RED-GREEN-REFACTOR-DOCUMENT-REFINE-PUBLISH cycle with sophisticated sidequest management and proper test organization.
Infrastructure
- setupRepository: Specialized assistant for setting up new Python repositories following PythonVibes best practices
- sys-medic: Linux/Kubernetes node health assessment agent — diagnoses process, memory, CPU, disk, network, and kubelet issues with safe, prioritized, evidence-driven guidance
- tooling-optimization: Meta-agent that analyzes and optimizes repository tooling usage to improve development efficiency
Testing
- test-maintenance: Specialized agent for analyzing and fixing failing tests in the project
- testing-efficiency: Specialized agent designed to optimize TDD8 workflow test execution, resolve pytest reliability issues, and enhance overall testing efficiency for red-green iterations. Focuses on smart test selection, parallel execution, and agent integration patterns.
Use these agents by referencing them in your Claude Code interactions.