Draft workplan with 16 tasks across publish verification, install doc
sync, packaged agent parity, CI hardening, and ecosystem handoff.
Refresh TODO.md and SCOPE.md; register State Hub workstream.
Add make package-check/publish-gitea, tag-triggered Gitea Actions workflow,
PACKAGE_RELEASE.md, and update README/GETTING_STARTED install instructions
for the Coulomb registry (v1.1.0+).
Add kaizen-agentic feedback CLI, Gitea issue templates, CI workflow,
pre-commit hooks, FEEDBACK/TELEMETRY docs, and cross-platform path tests.
Improve CLI registry error messages; remove agents_backup scaffolding.
Apply black formatting across src/tests for CI consistency.
State Hub message sent to agentic-resources for Helix correlation doc link.
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.
Add metrics frontmatter and session-close recording to tdd-workflow,
document the reference implementation in wiki/AboutKaizenAgents.md,
and add an e2e test covering record → show → optimize → brief.
Add Performance Summary block to memory brief, document metrics synthesis in
agent-coach, and add e2e and CLI tests for qualitative plus quantitative briefs.
Add ADR-004 storage layer with append-only executions, summary
regeneration, idempotency keys, and retention pruning. Wire memory init
to scaffold .kaizen/metrics/ by default and add unit tests.
Persist INTENT and ecosystem assessments in history/, add ADR-004 for
project metrics with Helix Forge correlation, and register WP-0003 and
WP-0004 workplans with State Hub. Update SCOPE, README, and agency-framework
docs to reflect the two-layer measurement model.
Add agents/agent-optimization.md — the Kaizen Optimizer meta-agent for
analyzing and improving agent performance. Also update .gitignore to
suppress agents_backup_*/ directories produced by optimization scripts.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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>
- Add agents/agent-coach.md: new meta-category coaching agent that reads
all project agent memories, synthesises cross-agent briefs, and produces
targeted orientation briefs for incoming agents
- Complete memory brief command: now reads all .kaizen/agents/*/memory.md,
formats structured orientation output following coach agent spec, adds
--raw flag for unformatted dump
- Coach validates and appears under kaizen-agentic list --category meta
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds a State Hub Task IDs table to each workplan file so task UUIDs are
always available without requiring list_tasks lookups in future sessions.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Integrates sys-medic as a standard kaizen-agentic agent with YAML frontmatter,
source attribution, and single-prompt format. Validated via list and validate.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Three-part workplan (27 tasks) covering:
- Part 1: sys-medic integration as standard kaizen-agentic agent (T01-T06)
- Part 2: agency framework — project memory model, coaching meta-agent,
and CLI memory command group (T07-T16)
- Part 3: sys-medic extended with protocols runbook and node-profile
memory, built on the Part 2 framework (T17-T27)
Workstream registered in state-hub as kaizen-wp-0002-agency-framework.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Moves 8 tasks from TODO.md [Unreleased] into
workplans/kaizen-agentic-WP-0001-community-engagement.md and registers
them in the state-hub as workstream kaizen-wp-0001-community-engagement.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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>
Using the repo in the experimental capability subrepo style breaks
coordination and we need to get the pieces together again. I will be
switching to using Pull Requests in the future.
- Extend safe_cli_wrapper() to suppress spurious Click errors for both
install and update commands; add success indicators for update output
- Add test_update_command_error_suppression to verify error suppression
- Expand CLAUDE.md to document all 17 agents with categories
- Add Keep a Contributing-File format header to CONTRIBUTING.md
- Fix TodoFileGuide URL reference in TODO.md
- Add RELEASE_NOTES_v1.0.1.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Update agent to reference TODO.md instead of NEXT.md for task management
following the todofile system implementation in main project.
- Updated key project files documentation to reference TODO.md
- Modified session wrap-up protocol to use todofile format
- Maintains consistency with main project's todofile adoption
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
🔧 Extended Click library workaround to cover update command
📚 Updated CLAUDE.md with all 17 agents organized by category
🧪 Added comprehensive test coverage for update command
✅ All 11 CLI error handling tests pass
Major improvements:
- Both install and update commands now provide clean professional output
- Complete agent ecosystem documentation (17 agents vs previous 6)
- Unified error handling approach across affected CLI commands
- Enhanced test suite covering all CLI error scenarios
User experience: Clean output for kaizen-agentic install/update commands
Technical: Extended safe_cli_wrapper to handle ["install", "update"] commands
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add make install-global target with intelligent installation methods
- Support pipx (recommended), pip --user, and fallback options
- Resolve issue where kaizen-agentic was only available in local venv
- Update documentation to clearly explain 4 installation options:
- Development mode (local venv)
- Global installation (any directory)
- Local package testing (local venv)
- Future PyPI installation
- CLI now available globally from any directory after make install-global
Fixes the core issue where users couldn't access kaizen-agentic from other repos.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Copy agent-releaseManager.md to src/kaizen_agentic/data/agents/
- Ensure releaseManager agent is packaged and distributed with v1.0.0
- Complete v1.0.0 package now includes all 17 agents including release management
- Final package ready for PyPI publication with full feature set
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add release management system with agent-releaseManager and 6 release- targets
- Include install-local target for PyPI-equivalent local testing
- Document enhanced Makefile with structured release workflow
- Complete v1.0.0 feature documentation for production release
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add Option B: From Local Package installation instructions
- Include make install-local target in both README.md and GETTING_STARTED.md
- Provide clear path for testing PyPI-equivalent installation locally
- Maintains development, local package, and future PyPI installation options
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add make install-local target to install from locally built wheel package
- Provides equivalent to PyPI installation for testing before publication
- Includes comprehensive installation validation with import and CLI tests
- Shows package information and validates core functionality
- Perfect for testing the installation experience without PyPI dependency
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Apply black formatting to all Python files
- Fix various flake8 violations in agent system code
- Clean up imports and whitespace issues
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add agent-releaseManager.md with comprehensive publication workflow guidance
- Add 6 release- prefixed make targets for structured release process:
- release-check: Validate release readiness
- release-prepare: Build packages and prepare release
- release-test: Test publication via TestPyPI
- release-publish: Publish to production PyPI
- release-finalize: Post-release tasks (tags, GitHub releases)
- release-rollback: Emergency rollback procedures
- Update pyproject.toml version from 0.1.0 to 1.0.0 for consistency with CHANGELOG.md
- Update installation documentation in README.md and GETTING_STARTED.md
- Add current "from source" installation instructions
- Maintain "from PyPI" instructions for post-publication
- Framework now ready for v1.0.0 publication with complete release workflow
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update CHANGELOG.md with comprehensive v1.0.0 release notes
- Document both Scenario 1 (greenfield) and Scenario 2 (existing project integration) achievements
- Move completed Scenario 2 tasks from active to completed sections in TODO.md
- Mark both major usage scenarios as production-ready with full feature coverage
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major documentation improvements:
- Fixed all outdated agent names throughout README.md and GETTING_STARTED.md
- Updated agent references from old names (todo-keeper, changelog-keeper, setup-repository)
to new names (keepaTodofile, keepaChangelog, setupRepository)
- Created comprehensive HELLO_WORLD_TUTORIAL.md with step-by-step guide for new users
- Added prominent tutorial links in README.md and GETTING_STARTED.md for better discoverability
- Updated Python version requirements from 3.8 to 3.9 in project templates
- Enhanced first-time user experience with clear guidance and working examples
Documentation now provides:
✅ Working commands that match actual agent names
✅ Clear separation between new users and experienced users
✅ Complete tutorial from installation to running code
✅ Proper guidance for scenario one (greenfield projects)
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
