name: improve-processes
description: "Reflect on current session and suggest improvements to agents, commands, templates, workflows"
model: claude-haiku-4-5-20251001
allowed-tools: Read, Write, Edit, Glob, Grep

/improve-processes

Reflect on the current session and suggest improvements to tooling.

Usage

/improve-processes                    # Reflect on entire session
/improve-processes --focus agents     # Focus on agent improvements
/improve-processes --focus commands   # Focus on command improvements
/improve-processes --focus templates  # Focus on template improvements
/improve-processes --focus workflows  # Focus on workflow improvements

What Can Be Improved

Execution Flow

1. Session Reflection

Analyze conversation to identify:

Commands & Workflows
- Which commands were invoked?
- Were any commands missing?
- Did workflow feel natural?

Friction Points
- Manual steps repeated?
- Workarounds needed?
- Multiple explanations required?

Gaps Discovered
- Missing template sections?
- Agent capabilities lacking?
- Documentation unclear?

Patterns Emerged
- Things done multiple times?
- Decisions that should be documented?

2. Generate Suggestions

## Suggestion N/Total: [Category]

**Observation**:
[What happened that revealed the opportunity]

**Suggestion**:
[Specific, actionable improvement]

**Affected file(s)**:
[Path(s) to modify]

**Rationale**:
[Why this would help]

3. Interactive Presentation

Present suggestions one at a time:

Action for this suggestion?
1. Implement now - Make the change
2. Create issue - Track for later
3. Skip - Not needed

4. Execute Actions

Implement now:
- Read affected file(s)
- Make improvement
- Confirm change

Create issue:
- Create in ideas/meta-repo/issues/
- Create TASK.md with details

Skip:
- Note and move on

5. Session Summary

## Session Retrospective Complete

### Actions Taken
- Implemented: N improvements
- Issues created: N
- Skipped: N

### Files Modified
- [list of files changed]

### Issues Created
- [list of issues]

Reflection Prompts

Agent Improvements

• Did any agent lack knowledge?
• Were responses too verbose/terse?
• Did agents coordinate well?

Skill Improvements

• Were any steps unnecessary?
• Were any steps missing?
• Did arguments make sense?

Template Improvements

• Did templates have all sections?
• Were sections consistently skipped?
• Were templates too long/short?

Workflow Improvements

• Did command chain flow naturally?
• Were there missing connections?
• Were there redundant steps?

When to Use

• End of significant work session
• After implementing new feature
• When something felt "off"
• Periodically as maintenance

Focus Mode

/improve-processes --focus templates

Narrows reflection to template-related findings only.

Integration

[work session] → /improve-processes → [improvements] → [next session]