kaizen-improvement

Kaizen Improvement

Transform analysis findings from .planning/kaizen/ into actionable improvements — hooks, agent patches, skill refinements, CLAUDE.md updates, and automation scripts.

Prerequisite: Analysis findings must exist in .planning/kaizen/ (generated by the transcript-analysis skill).

Proposal Admission

Keep the audit's full set of findings. Turn a finding into a hook, agent, skill, CLAUDE.md, or script proposal only when it advances an intended outcome or an applicable contract. Each selected proposal records:

• the affected intended outcome or contract;
• observed harm, with its evidence;
• the improvement's material side effects; and
• one focused scenario that would expose the harm and the proposed correction.

Record observations without that connection as advisory analysis. They do not become patches, install candidates, or new gates. An explicitly requested broad process audit or improvement scope remains in scope; this check only separates its proposals from its advisory observations.

Improvement Types

Each category of output below has a delegation template:

1. Hook generation — PreToolUse deny/redirect, SubagentStart context injection, Stop quality gates
2. Agent prompt refinement — surgical fixes to agent system prompts via @subagent-refactorer
3. Skill patches — add missing knowledge to skills via /plugin-creator:skill-creator
4. CLAUDE.md updates — project-wide behavioral rules
5. Script automation — replace repeated manual workflows with scripts or skills

For detailed templates and examples, see Improvement Templates.

For the Autonomous Refinement Loop (ARL) knowledge base — Layer 3 implementation details, prerequisites, and research synthesis — see ARL Knowledge.

Workflow

flowchart TD
    Start([Read analysis findings]) --> Parse[Extract anti-patterns with frequency and evidence]
    Parse --> Admit{Advances intended outcome<br/>or applicable contract?}
    Admit -->|No| Advisory[Retain advisory analysis]
    Admit -->|Yes| Score[Score by frequency × impact]
    Score --> Top[Select top findings]
    Top --> Type{Improvement type?}
    Type -->|Repeated tool misuse| Hook[Generate hook — deny/redirect]
    Type -->|Agent behavior issue| Agent[Generate agent patch instruction set]
    Type -->|Knowledge gap| Skill[Generate skill patch instruction set]
    Type -->|Project-wide issue| Claude[Generate CLAUDE.md addition]
    Type -->|Manual workflow| Script[Generate automation proposal]
    Hook --> Output[Write to .planning/kaizen/improvements/]
    Agent --> Output
    Skill --> Output
    Claude --> Output
    Script --> Output
    Output --> Install{--install flag?}
    Install -->|Yes| Apply[Write hooks to settings, apply patches]
    Install -->|No| Draft[Leave as proposals for review]