coulomb/kaizen-agentic
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
kaizen-agentic/.claude/rules/architecture.md

30 lines
1.5 KiB
Markdown
Raw Normal View History

chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
## Architecture
kaizen-agentic has two distinct layers:
### 1. Python framework (`src/kaizen_agentic/`)
- **`core.py`** — `Agent` (abstract base) + `AgentConfig` (dataclass). Tracks performance, supports config updates, implements kaizen interface.
- **`optimization.py`** — `OptimizationLoop` (runs improvement cycles, detects trends, generates recommendations) + `PerformanceMetrics` (execution time, success rate, quality scores).
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
- **`metrics.py`** — `MetricsStore` + `OptimizerStore` (project-scoped `.kaizen/metrics/` per ADR-004).
chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
### 2. Agent definitions (`agents/` — 20 files)
chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
Markdown instruction sets read and followed by Claude. Not executables. Naming convention: `agent-{name}.md`.
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
Packaged copies live in `src/kaizen_agentic/data/agents/` for `pip install` distribution.
chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
| Category | Agents |
|----------|--------|
| Testing | `tdd-workflow`, `test-maintenance`, `testing-efficiency` |
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
| Quality | `code-refactoring`, `datamodel-optimization` |
feat: agent authoring & doc generation (WP-0007, v1.4.0) 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>
2026-06-18 02:06:14 +02:00
| Process | `requirements-engineering`, `keepaTodofile`, `keepaChangelog`, `keepaContributingfile`, `project-assistant`, `priority-evaluation`, `scope-analyst` |
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
| Infrastructure | `setupRepository`, `tooling-optimization`, `sys-medic` |
chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
| Release | `releaseManager` |
| Docs | `claude-documentation` |
| Support | `wisdom-encouragement` |
WP-0003 Part 6: packaging sync and docs close-out Sync coach, sys-medic, scope-analyst, optimization, and updated tdd-workflow to packaged data (20 agents). Update architecture.md, README orientation, and CHANGELOG for the metrics loop. Mark WP-0003 completed.
2026-06-16 01:49:27 +02:00
| Meta | `coach`, `optimization` |
chore: migrate CLAUDE.md to @-import rule structure (custodian integration) Register with state-hub under custodian domain. Replace monolithic CLAUDE.md with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00
### 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)`.
Reference in a new issue Copy permalink