Normalize agent instructions and workplan frontmatter (STATE-WP-0067)
Some checks failed
ci / test (push) Failing after 44s

- Align agent files with on-disk workplan prefixes (infer from workplan ids)
- Set workplan domain to registered domain_slug; add topic_slug where applicable
- Repair frontmatter delimiter formatting; migrate legacy task status literals
- Regenerate AGENTS.md, CLAUDE.md, and .claude/rules from State Hub templates
This commit is contained in:
2026-06-22 23:16:36 +02:00
parent 90761afe0c
commit 08df3a4697
19 changed files with 409 additions and 151 deletions

View File

@@ -1,29 +1,8 @@
## Architecture
kaizen-agentic has two distinct layers:
<!-- TODO: Describe the key design decisions and component structure.
Key modules, data flows, external integrations, state machines, etc. -->
### 1. Python framework (`src/kaizen_agentic/`)
## Quick Reference
- **`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).
- **`metrics.py`** — `MetricsStore` + `OptimizerStore` (project-scoped `.kaizen/metrics/` per ADR-004).
### 2. Agent definitions (`agents/` — 20 files)
Markdown instruction sets read and followed by Claude. Not executables. Naming convention: `agent-{name}.md`.
Packaged copies live in `src/kaizen_agentic/data/agents/` for `pip install` distribution.
| Category | Agents |
|----------|--------|
| Testing | `tdd-workflow`, `test-maintenance`, `testing-efficiency` |
| Quality | `code-refactoring`, `datamodel-optimization` |
| Process | `requirements-engineering`, `keepaTodofile`, `keepaChangelog`, `keepaContributingfile`, `project-assistant`, `priority-evaluation`, `scope-analyst` |
| Infrastructure | `setupRepository`, `tooling-optimization`, `sys-medic` |
| Release | `releaseManager` |
| Docs | `claude-documentation` |
| Support | `wisdom-encouragement` |
| Meta | `coach`, `optimization` |
### 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)`.
`~/state-hub/mcp_server/TOOLS.md` — MCP tool reference