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>
57 lines
3.7 KiB
Markdown
57 lines
3.7 KiB
Markdown
# 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.
|