Files
kaizen-agentic/CLAUDE.md
Bernd Worsch 07c4a70907 feat(agency): complete WP-0002 Part 3 — E2E tests, docs, sys-medic cross-refs, bugfix
T25: add tests/test_e2e_agency_framework.py — 16 E2E tests covering the full
memory lifecycle (init, show, brief, clear) and protocol list/show commands.

T26: replace agency-framework.md protocols placeholder with full documentation —
location convention, frontmatter schema, CLI reference, sys-medic memory
extensions, and protocols table.

T27: add Related Documents footer to agent-sys-medic.md linking to the k3s
protocol runbook, ADR-002, ADR-003, and agency-framework.md.

Fix: rename CLI command function list() → list_agents() to stop it shadowing
Python's built-in list(). The shadow caused memory_brief() to invoke the
agent-list command instead of constructing a list from dict keys, producing
the agent list as output on every `memory brief` invocation.

All 27 WP-0002 tasks complete. Test suite: 51 passed, 1 skipped.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-19 00:27:39 +00:00

3.9 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:

Testing

  • 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.

Use these agents by referencing them in your Claude Code interactions.

Documentation

  • claude-documentation: Specialized assistant for Claude and Claude Code documentation, features, and best practices

Meta

  • coach: Coaching meta-agent that reads all agent memories in a project and synthesises cross-agent briefs and new-agent orientations

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.
  • 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.
  • tooling-optimization: Meta-agent that analyzes and optimizes repository tooling usage to improve development efficiency

Project Management

  • keepaChangelog: Specialized assistant for maintaining CHANGELOG.md files following Keep a Changelog format
  • keepaContributingfile: Specialized assistant for maintaining CONTRIBUTING.md files following Keep a Contributing-File V0.0.1 format within the Kaizen Agentic framework
  • keepaTodofile: Specialized assistant for maintaining TODO.md files following Keep a Todofile V0.0.1 format

Development Process

  • priority-evaluation: Specialized assistant to help evaluate and establish priorities for issues and tasks.
  • releaseManager: Manages software releases, version control, and publication workflows for Python packages
  • 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
  • scope-analyst: Analyze a repository and produce/improve SCOPE.md for rapid orientation
  • wisdom-encouragement: Provides encouraging wisdom and guidance for complex implementation tasks and challenging technical work

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

Testing

  • 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.
  • 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.