learnlisted
Install: claude install-skill craigcossairt/trellis
You are closing the learning loop. Review this conversation for things worth capturing, then
update the right artifacts so the learning survives into future sessions.
## What to look for
Scan the conversation and classify any of these as candidates to capture:
1. **Bug patterns** - a symptom someone ran into, a root cause, and a fix that should be visible
to the next person who sees the same symptom.
2. **Tool gotchas** - something about a tool, framework, or service that surprised you and would
surprise the next session.
3. **Conventions** - a decision about how code should look or how work should flow in this repo,
validated in this session.
4. **Cross-session knowledge** - user preferences, working-style feedback, project milestones.
5. **Context drift** - anything you noticed is stale in existing docs.
Things to SKIP:
- Transient task state ("we're in the middle of X")
- Stuff already documented elsewhere (check before duplicating)
- Vague observations ("this could be cleaner")
- Conversation turns that were noise
## Where each type goes
| Type | Target | Action |
|---|---|---|
| Bug pattern | `docs/common-gotchas.md` | Append a row using the file's format. Include commit SHA + issue ID if known. Auto-apply. |
| Tool gotcha | `docs/common-gotchas.md` (or agent memory if not project-specific) | Auto-apply. |
| Convention | `AGENTS.md` | Propose the diff to the user first - do NOT auto-edit AGENTS.md. |
| Cross-session knowledge | Your harness's persistent me