ai/opencode/tech-team/skills/meta-learning-engineering-retrospection/SKILL.md
Use after completing major features, recovering from incidents, making architectural decisions that turned out wrong, or when repeated mistakes suggest stagnant mental models and missing feedback loops.
npx skillsauth add akshay-na/dotfiles meta-learning-engineering-retrospectionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Build a feedback-driven improvement loop to accelerate long-term growth. Every project, incident, and decision is raw material for learning -- but only if you extract the lesson deliberately. Growth compounds through structured reflection, not just accumulated experience.
| Competency | Key Question | |---|---| | Structured retrospectives | What went well, what went wrong, and what would I change? | | Flawed assumptions | Which beliefs turned out to be incorrect? | | Prediction accuracy | How did my estimate or design assumption compare to reality? | | Reusable lessons | Can this learning be generalized and applied to future work? | | Heuristic refinement | Should I update my decision-making rules based on this outcome? |
Stop and reflect if you observe:
| Signal | Root Cause | |---|---| | Repeating the same mistakes | No retrospective performed; lesson not extracted | | No documentation of lessons | Learning stays tacit; lost when context fades | | Defensive reaction to failure | Failure treated as threat instead of data | | Stagnant mental models | No new inputs challenging existing assumptions | | Estimates consistently wrong in the same direction | Systematic bias not identified or corrected | | Same incident class recurring | Postmortem action items not completed or not effective |
Personal Retrospective Template:
## What I Worked On
Brief description of the project, feature, or incident.
## What Went Well
- What decisions paid off?
- What processes worked?
- What would I repeat?
## What Went Wrong
- What surprised me negatively?
- Where was my mental model incorrect?
- What took longer or was harder than expected?
## Root Causes
- Why did the wrong things go wrong? (not symptoms, causes)
- What assumptions were flawed?
- What information was I missing?
## Prediction vs Reality
| Prediction | Reality | Delta |
|------------|---------|-------|
| | | |
## Lessons Extracted
- What reusable principle can I take from this?
- Does this change any of my decision heuristics?
- Should I update a checklist, skill, or process?
## Action Items
| Action | Type (process/tooling/knowledge) | Due |
|--------|----------------------------------|-----|
| | | |
Heuristic Refinement Log:
## Heuristic
State the rule of thumb.
## Origin
When and why did I adopt this heuristic?
## Evidence For
Instances where it held true.
## Evidence Against
Instances where it failed or misled.
## Updated Heuristic
Refined version based on accumulated evidence.
## Confidence
High / Medium / Low -- based on evidence volume.
| Mistake | Fix | |---|---| | Skipping retrospectives when things went well | Success hides lessons too; review what worked and why | | Retrospectives without action items | Every retrospective must produce at least one concrete change | | Blaming external factors exclusively | Focus on what was within your control and what you would change | | Documenting lessons but never revisiting | Schedule periodic reviews of past lessons; update or archive | | Treating heuristics as permanent rules | Heuristics are hypotheses; update them as evidence accumulates | | Reflecting only on failures | Successes reveal which heuristics and processes are worth keeping |
development
Discovery + naming convention reference for typed dev/SME/QA/devops team members in any workspace folder. Primary consumer: `tech-lead` (org-tier).
devops
Automated task classification, agent selection, and state tracking. Use when routing tasks to agents, selecting pipelines, or managing task state.
testing
Use when designing scalable systems, evaluating consistency models, planning state management, making architectural decisions, or when trade-offs around coupling, failure isolation, and reversibility need explicit reasoning before implementation.
tools
CTO/tech-lead helper — split work into disjoint shard briefs with caps (instance_cap, partition_basis, determinism keys).