Files
kaizen-agentic/.claude/rules/architecture.md
tegwick 3acd5c1064 feat(agents): add scope-analyst agent + fix project-management category
- Add agent-scope-analyst.md: repo scope analysis persona with embedded SCOPE.md template
- Fix agent-project-management.md: add missing category field (was causing ValueError in AgentRegistry)
- Add scope-analyst row to architecture.md category table (project-management category)
- Add SCOPE.md for kaizen-agentic itself

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 23:10:12 +01:00

1.3 KiB

Architecture

kaizen-agentic has two distinct layers:

1. Python framework (src/kaizen_agentic/)

  • core.pyAgent (abstract base) + AgentConfig (dataclass). Tracks performance, supports config updates, implements kaizen interface.
  • optimization.pyOptimizationLoop (runs improvement cycles, detects trends, generates recommendations) + PerformanceMetrics (execution time, success rate, quality scores).

2. Agent definitions (agents/ — 17 files)

Markdown instruction sets read and followed by Claude. Not executables. Naming convention: agent-{name}.md.

Category Agents
Testing tdd-workflow, test-maintenance, testing-efficiency
Quality code-refactoring, datamodel-optimization, optimization
Process requirements-engineering, keepaTodofile, keepaChangelog, keepaContributingfile, project-management, priority-evaluation, scope-analyst
Infrastructure setupRepository, tooling-optimization
Release releaseManager
Docs claude-documentation
Support wisdom-encouragement

Custodian integration

The state-hub MCP resolves the agents directory via host_paths[hostname]local_path. Tools: list_kaizen_agents(category?), get_kaizen_agent(name).