Lessons Learned

Lessons Learned: {{PROJECT_NAME}} 
 
 Project: {{PROJECT_NAME}}
 Version: {{VERSION}}
 Date: {{DATE}}
 Author: {{AUTHOR}}
 Status: Draft | In Review | Approved
 Reviewers: {{REVIEWERS}} 
 
 Document History 
 
 
 
 Version 
 Date 
 Author 
 Changes 
 
 
 
 
 0.1 
 {{DATE}} 
 {{AUTHOR}} 
 Initial draft 
 
 
 
 

 1. Session Metadata 
 
 
 
 Field 
 Value 
 
 
 
 
 Session Type 
 Sprint Retrospective / Phase Review / Post-Mortem / Project Close 
 
 
 Project 
 {{PROJECT_NAME}} 
 
 
 Phase / Sprint 
 {{PHASE_OR_SPRINT}} 
 
 
 Period Covered 
 {{START_DATE}} – {{END_DATE}} 
 
 
 Facilitator 
 {{NAME}} 
 
 
 Participants 
 {{LIST_OF_PARTICIPANTS}} 
 
 
 Date of Session 
 {{DATE}} 
 
 
 Duration 
 {{DURATION}} 
 
 
 
 
 2. What Went Well (Keep Doing) 

 
 
 
 # 
 What Went Well 
 Why It Worked 
 How to Preserve 
 Category 
 
 
 
 
 KD-01 
 {{DESCRIPTION}} 
 {{ROOT_CAUSE_OF_SUCCESS}} 
 {{PROCESS/RULE/HABIT}} 
 Process / Technical / Communication / Tools 
 
 
 KD-02 
 
 
 
 
 
 
 KD-03 
 
 
 
 
 
 
 KD-04 
 
 
 
 
 
 
 KD-05 
 
 
 
 
 
 
 
 Highlights 

 KD-01 Detail: 
{{EXTENDED_NARRATIVE_OF_WHAT_WORKED_AND_WHY}} 
 
 3. What Didn't Go Well (Stop Doing) 

 
 
 
 # 
 What Didn't Work 
 Root Cause 
 Impact (1-10) 
 Action Item 
 Owner 
 Deadline 
 
 
 
 
 SD-01 
 {{DESCRIPTION}} 
 {{ROOT_CAUSE}} 
 {{IMPACT}} 
 {{SPECIFIC_ACTION}} 
 {{OWNER}} 
 {{DATE}} 
 
 
 SD-02 
 
 
 
 
 
 
 
 
 SD-03 
 
 
 
 
 
 
 
 
 SD-04 
 
 
 
 
 
 
 
 
 
 Root Cause Analysis — Deep Dives 

 SD-{{XX}}: {{ISSUE_TITLE}} 
 Problem: {{CLEAR_PROBLEM_STATEMENT}} 
 5 Whys: 
 
 Why did this happen? → {{ANSWER_1}} 
 Why did {{ANSWER_1}} happen? → {{ANSWER_2}} 
 Why did {{ANSWER_2}} happen? → {{ANSWER_3}} 
 Why did {{ANSWER_3}} happen? → {{ANSWER_4}} 
 Why did {{ANSWER_4}} happen? → {{ROOT_CAUSE}} 
 
 Root Cause: {{DEFINITIVE_ROOT_CAUSE}}
 Systemic Fix: {{HOOK/TOOL/RULE/PROCESS_CHANGE}}
 Ljestvica Fikseva (ZAKON #1): Hook > Tool > Rule > CLAUDE.md > Memory 
 
 4. What to Try Next (Start Doing) 

 
 
 
 # 
 What to Try 
 Expected Benefit 
 Hypothesis 
 Success Metric 
 Trial Period 
 
 
 
 
 ST-01 
 {{NEW_PRACTICE}} 
 {{EXPECTED_BENEFIT}} 
 If we do {{X}}, then {{Y}} will improve by {{Z}}% 
 {{MEASURABLE_METRIC}} 
 {{SPRINT_COUNT}} sprints 
 
 
 ST-02 
 
 
 
 
 
 
 
 ST-03 
 
 
 
 
 
 
 
 
 
 5. Key Findings by Category 

 5.1 Technical Findings 
 
 
 
 # 
 Finding 
 Impact 
 Recommendation 
 
 
 
 
 TF-01 
 {{TECHNICAL_FINDING}} 
 {{HIGH/MEDIUM/LOW}} 
 {{RECOMMENDATION}} 
 
 
 TF-02 
 
 
 
 
 
 
 Technical Patterns Observed: 
 
 {{PATTERN_1}} — {{IMPLICATION_AND_RECOMMENDATION}} 
 {{PATTERN_2}} 
 
 5.2 Process Findings 
 
 
 
 # 
 Finding 
 Root Cause 
 Recommendation 
 
 
 
 
 PF-01 
 {{PROCESS_FINDING}} 
 {{ROOT_CAUSE}} 
 {{RECOMMENDATION}} 
 
 
 PF-02 
 
 
 
 
 
 
 Process Patterns Observed: 
 
 {{PATTERN}} 
 
 5.3 Communication Findings 
 
 
 
 # 
 Finding 
 Stakeholder Impact 
 Recommendation 
 
 
 
 
 CF-01 
 {{COMMUNICATION_FINDING}} 
 {{IMPACT}} 
 {{RECOMMENDATION}} 
 
 
 CF-02 
 
 
 
 
 
 
 5.4 Tools & Infrastructure Findings 
 
 
 
 # 
 Finding 
 Impact 
 Recommendation 
 
 
 
 
 IF-01 
 {{TOOLING_FINDING}} 
 {{IMPACT}} 
 {{RECOMMENDATION}} 
 
 
 IF-02 
 
 
 
 
 
 
 5.5 Team & Collaboration Findings 
 
 
 
 # 
 Finding 
 Impact 
 Recommendation 
 
 
 
 
 TM-01 
 {{TEAM_FINDING}} 
 {{IMPACT}} 
 {{RECOMMENDATION}} 
 
 
 
 
 6. Action Items 

 
 
 
 # 
 Action Item 
 Category 
 Owner 
 Sprint / Deadline 
 Priority 
 Status 
 
 
 
 
 AI-01 
 {{SPECIFIC_ACTIONABLE_ITEM}} 
 Process / Technical / Communication / Tools 
 {{OWNER}} 
 Sprint {{X}} 
 P1/P2/P3 
 Open 
 
 
 AI-02 
 
 
 
 
 
 
 
 
 AI-03 
 
 
 
 
 
 
 
 
 AI-04 
 
 
 
 
 
 
 
 
 AI-05 
 
 
 
 
 
 
 
 
 
 Action Item Review: At the START of next sprint planning, PM reviews status of all open action items.
Incomplete P1 items are escalated to John. 
 
 7. Metrics Comparison — Planned vs. Actual 

 7.1 Timeline 
 
 
 
 Milestone 
 Planned 
 Actual 
 Variance 
 Root Cause (if significant) 
 
 
 
 
 Requirements Complete 
 {{DATE}} 
 {{DATE}} 
 {{+/- DAYS}} 
 {{ROOT_CAUSE}} 
 
 
 Design Complete 
 
 
 
 
 
 
 MVP Release 
 
 
 
 
 
 
 UAT Complete 
 
 
 
 
 
 
 Launch 
 
 
 
 
 
 
 
 Timeline Accuracy: {{ACTUAL_DURATION}} vs. planned {{PLANNED_DURATION}} ({{VARIANCE_PCT}}% {{over/under}}) 
 7.2 Budget 
 
 
 
 Category 
 Planned (NOK) 
 Actual (NOK) 
 Variance 
 Notes 
 
 
 
 
 Development 
 {{AMOUNT}} 
 {{AMOUNT}} 
 {{+/-}} 
 
 
 
 Design 
 
 
 
 
 
 
 Infrastructure 
 
 
 
 
 
 
 Testing 
 
 
 
 
 
 
 Total 
 {{TOTAL}} 
 {{TOTAL}} 
 {{+/-}} 
 
 
 
 
 Budget Accuracy: {{ACTUAL}} vs. planned {{PLANNED}} ({{VARIANCE_PCT}}% {{over/under}}) 
 7.3 Quality 
 
 
 
 Metric 
 Target 
 Actual 
 Status 
 
 
 
 
 Test coverage 
 ≥ 80% 
 {{PCT}}% 
 {{✅/⚠️/❌}} 
 
 
 Critical bugs at launch 
 0 
 {{COUNT}} 
 {{✅/⚠️/❌}} 
 
 
 Post-launch bugs (30 days) 
 < 5 
 {{COUNT}} 
 {{✅/⚠️/❌}} 
 
 
 Lighthouse performance score 
 ≥ 90 
 {{SCORE}} 
 {{✅/⚠️/❌}} 
 
 
 Accessibility (WCAG AA violations) 
 0 
 {{COUNT}} 
 {{✅/⚠️/❌}} 
 
 
 
 7.4 Velocity & Estimation 
 
 
 
 Sprint 
 Estimated Points 
 Completed Points 
 Accuracy 
 
 
 
 
 Sprint 1 
 {{ESTIMATE}} 
 {{ACTUAL}} 
 {{PCT}}% 
 
 
 Sprint 2 
 
 
 
 
 
 Sprint 3 
 
 
 
 
 
 Average 
 
 
 {{AVG_PCT}}% 
 
 
 
 Estimation Accuracy Notes: {{PATTERNS_IN_OVER_UNDER_ESTIMATION}} 
 
 8. Recommendations for Future Projects 

 
 
 
 # 
 Recommendation 
 Category 
 Confidence 
 Applicable When 
 
 
 
 
 REC-01 
 {{RECOMMENDATION}} 
 Technical / Process / Communication 
 High / Medium 
 {{WHEN_TO_APPLY}} 
 
 
 REC-02 
 
 
 
 
 
 
 REC-03 
 
 
 
 
 
 
 REC-04 
 
 
 
 
 
 
 REC-05 
 
 
 
 
 
 
 
 Top 3 Most Important Learnings 

 
 
 {{LEARNING_1_TITLE}}: {{EXPLANATION_AND_RECOMMENDATION}} 
 
 
 {{LEARNING_2_TITLE}}: {{EXPLANATION_AND_RECOMMENDATION}} 
 
 
 {{LEARNING_3_TITLE}}: {{EXPLANATION_AND_RECOMMENDATION}} 
 
 
 
 9. Knowledge Base Contribution 

 
 
 
 Finding 
 Contribution Type 
 Target System 
 Status 
 Owner 
 
 
 
 
 {{FINDING}} 
 New rule / Updated tool / New hook / HiveMind entry / CLAUDE.md update 
 {{SYSTEM}} 
 Open / Done 
 {{OWNER}} 
 
 
 
 HiveMind entries added: 
 
 node ~/system/agents/hivemind/hivemind.js post "{{KEY_LEARNING}}" (run this) 
 
 Rules updated: 
 
 ~/system/rules/{{RULE_FILE}} — {{WHAT_WAS_ADDED}} 
 
 Memory updated: 
 
 ~/.claude/projects/-Users-makinja/memory/{{MEMORY_FILE}} — {{WHAT_WAS_ADDED}} 
 
 
 Approval 
 
 
 
 Role 
 Name 
 Date 
 Signature 
 
 
 
 
 Author 
 
 
 
 
 
 Reviewer 
 
 
 
 
 
 Project Manager 
 
 
 
 
 
 AI Director (John) 
 
 
 
 
 
 Team 
 (retrospective agreement)