dftracer-lessons
How to use and update the lessons-learned cache at .goose/lessons-learned.md — proactive lookup before any build/install/annotate step
SKILL.md.agents/skills/dftracer-lessons/SKILL.md
GitHubLessons-Learned Cache
A structured log of past failures and their fixes lives at .goose/lessons-learned.md.
Before attempting any build, install, configure, or annotation step:
- Read
.goose/lessons-learned.md. - Search for entries whose
tagsorerrormatch the current task (package name, build tool, error text). - Apply the recorded fix proactively — do not repeat a known failure.
After resolving any non-trivial error (not a simple typo):
Append a new entry to .goose/lessons-learned.md using this format:
---
date: YYYY-MM-DD
context: <one-line description of what was being attempted>
error: |
<exact error message or key excerpt>
root_cause: <why it happened>
fix: |
<exact steps or code change that resolved it>
tags: [<package>, <build-tool>, <error-keyword>, ...]
---
Keep entries cumulative — never delete old ones. They are the institutional memory for this project.