docs(agency): add agency-framework.md and update README (WP-0002 T15-T16)
- Add docs/agency-framework.md: full explanation of the project memory model, session protocols, memory frontmatter field, CLI reference, coach meta-agent usage, and protocols preview (Part 3) - Update README: reposition as agency framework (not just agent library), add Agency Framework section with memory CLI examples, update feature list to 18 agents, add sys-medic and coach to agent listing Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
33
README.md
33
README.md
@@ -1,8 +1,10 @@
|
||||
# Kaizen Agentic
|
||||
|
||||
AI agent development framework embracing continuous improvement through specialized agents and comprehensive development workflows.
|
||||
AI **agency** framework: 18 specialized agents that arrive in your project informed, learn from experience, and improve over time.
|
||||
|
||||
This project embraces the Japanese concept of "kaizen" (continuous improvement) applied to AI agent development. Every coding subagent becomes part of an optimization loop where performance is measured, patterns are analyzed, and specifications are refined over time.
|
||||
kaizen-agentic provides two things: a library of agent instruction sets you deploy into projects, and an **agency framework** that gives those agents persistent memory and coordination. Agents accumulate project-scoped knowledge across sessions. A Coach meta-agent synthesises patterns across the entire fleet and briefs incoming agents on what to know first.
|
||||
|
||||
This project embraces the Japanese concept of "kaizen" (continuous improvement) applied to AI agent development. Every agent becomes part of an optimization loop where performance is measured, patterns are analyzed, and knowledge is carried forward.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -70,14 +72,31 @@ kaizen-agentic install keepaTodofile keepaChangelog tdd-workflow
|
||||
kaizen-agentic status
|
||||
```
|
||||
|
||||
## Agency Framework
|
||||
|
||||
Agents deployed into a project can accumulate **project-scoped memory** — a structured file written at session close and read at session start. A **Coach** meta-agent reads across all agent memories and produces targeted orientation briefs for incoming agents.
|
||||
|
||||
```bash
|
||||
# Scaffold memory for an agent
|
||||
kaizen-agentic memory init sys-medic
|
||||
|
||||
# Brief an incoming agent using all existing project memories
|
||||
kaizen-agentic memory brief tdd-workflow
|
||||
|
||||
# Review an agent's accumulated knowledge
|
||||
kaizen-agentic memory show project-management
|
||||
```
|
||||
|
||||
See [docs/agency-framework.md](docs/agency-framework.md) for the full model.
|
||||
|
||||
## Features
|
||||
|
||||
- **16+ Specialized Agents**: Project management, testing, code quality, documentation
|
||||
- **CLI Tool**: Easy agent installation and management (`kaizen-agentic`)
|
||||
- **18 Specialized Agents**: Project management, testing, code quality, infrastructure, meta
|
||||
- **Agency Framework**: Project-scoped agent memory + Coach meta-agent for cross-agent synthesis
|
||||
- **CLI Tool**: Easy agent installation, management, and memory commands (`kaizen-agentic`)
|
||||
- **Project Templates**: Pre-configured setups for different project types
|
||||
- **Claude Code Integration**: Seamless integration with Claude Code workflows
|
||||
- **Comprehensive Testing**: Full test coverage with multiple testing strategies
|
||||
- **Standards Compliance**: Follows PythonVibes and industry best practices
|
||||
|
||||
## Available Agents
|
||||
|
||||
@@ -101,6 +120,10 @@ kaizen-agentic status
|
||||
- **setupRepository**: Repository initialization and standards compliance
|
||||
- **claude-documentation**: Claude Code configuration and documentation
|
||||
- **tooling-optimization**: Repository tooling usage optimization
|
||||
- **sys-medic**: Infrastructure health monitoring and diagnostics
|
||||
|
||||
### Meta
|
||||
- **coach**: Coaching meta-agent — reads all project agent memories, synthesises cross-agent briefs, and orients incoming agents
|
||||
|
||||
[View complete agent list](docs/AGENT_DISTRIBUTION.md#agent-categories)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user