majiayu000 /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
| Category | Location | Examples |
|---|---|---|
| Agents | .claude/agents/ |
System prompts, specializations |
| Skills | .claude/skills/ |
Workflow steps, validation |
| Templates | shared/templates/ |
Spec structure, doc skeletons |
| Workflows | CLAUDE.md |
Command chains, processes |
| Documentation | Various | Clarity, completeness |
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]