Setting the file. One moment.
Retrospective Templates · Retrospecting · bitwarden/ai-plugins · Skills Docs
Purpose : Standardized templates for comprehensive session retrospectives
Owner : Retrospective Skill
Storage : All reports generated in ${CLAUDE_PROJECT_DIR}/.claude/skills/retrospecting/reports/ directory
Back to the top of the page Running Work Transitions
Session Logs
~/.claude/projects/{project-dir}/{session-id}.jsonl
End of major feature implementations
Completion of multi-day or multi-task sessions
When significant learnings emerged
User requests detailed analysis
Sessions with noteworthy successes or challenges
Regular session wrap-ups
Single-task completions
Brief work sessions (< 1 hour)
Routine maintenance or updates
User requests lightweight summary
Naming Convention : YYYY-MM-DD-brief-description-SESSION_ID.md
Use ISO date format for chronological sorting
Keep description concise (3-5 words)
Use hyphens for readability
Include session ID from log files for traceability
Pattern Library Maintenance :
Extract reusable patterns from retrospectives in patterns/ directory
Update patterns as new evidence emerges
Organize by project type, technology, or problem domain
Reference specific retrospectives as evidence
These templates provide structured frameworks for capturing session insights and generating actionable recommendations for continuous improvement.
templates/retrospective-templates.md
| -------------------- | ------ | -------- | -------- |
| Task Completion Rate | 90% | X% | ✅/⚠️/❌ |
| Compilation Success | 100% | X% | ✅/⚠️/❌ |
| Test Coverage | 80% | X% | ✅/⚠️/❌ |
| Code Quality Score | 8/10 | X/10 | ✅/⚠️/❌ |
---
## What Went Well
### Successful Workflow Patterns
1. **[Pattern Name]** : [ Description ]
- **Evidence** : [Specific examples from session with file:line references]
- **Impact** : [Quantified benefit - time saved, quality improved, etc.]
- **Replicability** : [How to repeat this success in future sessions]
2. **[Pattern Name]** : [ Description ]
- **Evidence** : [Specific examples from session]
- **Impact** : [Quantified benefit]
- **Replicability** : [How to repeat success]
### Quality Achievements
- **Architecture Compliance** : [Specific examples of well-implemented patterns]
- **Test Coverage** : [Coverage metrics and thoroughness of tests]
- **Security Standards** : [Security best practices followed]
- **Performance** : [Performance optimizations or considerations]
### Communication & Collaboration
- **Effective Interactions** : [What communication patterns worked well]
- **Clear Requirements** : [Examples of well-defined tasks]
- **Useful Feedback** : [Valuable user input that improved outcomes]
---
## Pain Points & Challenges
### Workflow Friction Areas
1. **[Issue Category]** : [ Description ]
- **Root Cause** : [Analysis of underlying cause]
- **Impact** : [Quantified impact - time lost, quality affected, etc.]
- **Frequency** : [How often this occurred]
- **Prevention Strategy** : [How to avoid in future sessions]
2. **[Issue Category]** : [ Description ]
- **Root Cause** : [Analysis of underlying cause]
- **Impact** : [Quantified impact on workflow]
- **Prevention Strategy** : [How to avoid in future]
### Technical Challenges
- **Compilation Issues** : [Number of failures, causes, resolution]
- **Test Failures** : [Test-related problems and how they were resolved]
- **Tool Limitations** : [Constraints or issues with available tools]
- **Integration Problems** : [Difficulties combining components or changes]
### Communication Gaps
- **Unclear Requirements** : [Cases where instructions were ambiguous]
- **Missing Context** : [Information that should have been provided upfront]
- **Assumption Mismatches** : [Differences between expected and actual outcomes]
---
## Improvement Recommendations
### Immediate Actions (Next Session)
1. **[High Priority Item]** : [Specific action with expected impact]
2. **[High Priority Item]** : [Specific action with expected impact]
3. **[High Priority Item]** : [Specific action with expected impact]
### Short-term Enhancements (1-2 weeks)
1. **[Enhancement Area]** : [Description and implementation approach]
2. **[Enhancement Area]** : [Description and implementation approach]
### Long-term Vision (1-3 months)
1. **[Strategic Improvement]** : [Long-term enhancement with roadmap]
2. **[Strategic Improvement]** : [Long-term enhancement with roadmap]
---
## Workflow Optimization Analysis
### Cycle Time Analysis
- **Average Task Duration** : [Time from start to completion]
- **Rework Frequency** : [% of tasks requiring significant revision]
- **Bottlenecks** : [Where workflow got stuck or slowed]
- **Efficiency Wins** : [What made progress faster]
### Quality Progression
- **Code Quality Trend** : [Quality improvement over session duration]
- **Test Coverage Trend** : [Coverage changes over time]
- **Standard Compliance** : [Adherence to project guidelines]
- **Learning Evidence** : [Signs of improving effectiveness during session]
### Tool & Resource Usage
- **Tool Effectiveness** : [Which tools were most/least effective]
- **Context Sufficiency** : [Was enough context available]
- **Documentation Quality** : [Usefulness of available documentation]
---
## Patterns for Future Reference
### Successful Patterns to Replicate
1. **[Pattern Name]** : [Description and replication instructions]
2. **[Pattern Name]** : [Description and replication instructions]
### Anti-Patterns to Avoid
1. **[Anti-Pattern Name]** : [Description and prevention strategy]
2. **[Anti-Pattern Name]** : [Description and prevention strategy]
### Context-Specific Learnings
- **Project Type** : [Insights specific to this type of project]
- **Task Complexity** : [Approaches that worked for this complexity level]
- **Tech Stack** : [Technology-specific patterns discovered]
---
## Sub-agent Feedback (if applicable)
### [Sub-agent Name] Feedback
- **Strengths** : [What worked well in this sub-agent's tasks]
- **Challenges** : [What caused difficulty or confusion]
- **Suggestions** : [Recommendations for improved coordination]
### [Sub-agent Name] Feedback
- **Strengths** : [What worked well]
- **Challenges** : [What caused difficulty]
- **Suggestions** : [Recommendations for improvement]
---
## User Experience Summary
### Most Valuable Aspects
- [What the user found most helpful about this session]
- [Specific features or approaches that delivered value]
### Friction Points
- [What caused user frustration or confusion]
- [Process inefficiencies from user perspective]
### Desired Improvements
- [User suggestions for enhancement]
- [Features or capabilities user wishes were available]
---
## Next Session Preparation
### Workflow Optimizations to Implement
- [ ] [Specific workflow change based on learnings]
- [ ] [Process improvement to apply next session]
- [ ] [Tool usage optimization to implement]
### Context Enhancements
- [ ] [Additional context to provide upfront]
- [ ] [Documentation updates needed]
- [ ] [Reference materials to prepare]
### Success Criteria
- [ ] [Define clear goals for next session]
- [ ] [Establish metrics to track]
- [ ] [Identify resources needed]
---
**Report Generated** : [ Date/Time ]
**Generated By** : Retrospective Skill
**Next Review** : [Scheduled follow-up date]