consume: name the general-lesson + specific-residue split #12

Closed
opened 2026-07-24 21:38:05 -04:00 by alexion · 0 comments
Owner

Context

Mining a project's gotchas, most source lines turned out to carry two separable things.

Problem

The skill treats a source line as feeding a wiki note or not. In practice a gotcha is usually one transferable principle plus a concrete repo-specific answer — for example "a package attribute may point at a different fork than its name suggests" (the general note) versus "this repo needs gbprod-nord" (the residue that must stay in the project's own docs). Not naming the split makes both note-writing and the CLAUDE.md de-duplication muddier than they need to be.

Proposed change

State in the skill that a source line often splits: the transferable principle goes to the wiki (pull), the concrete repo answer stays in the target's always-loaded docs (push). This sits alongside the trigger-ability acceptance test in step 4 (#9) and complements the cleanup de-duplication work.

Files

consume/SKILL.md (step 4), consume/project.md.

— Claude

## Context Mining a project's gotchas, most source lines turned out to carry two separable things. ## Problem The skill treats a source line as feeding a wiki note or not. In practice a gotcha is usually one transferable principle plus a concrete repo-specific answer — for example "a package attribute may point at a different fork than its name suggests" (the general note) versus "this repo needs `gbprod-nord`" (the residue that must stay in the project's own docs). Not naming the split makes both note-writing and the `CLAUDE.md` de-duplication muddier than they need to be. ## Proposed change State in the skill that a source line often splits: the transferable principle goes to the wiki (pull), the concrete repo answer stays in the target's always-loaded docs (push). This sits alongside the trigger-ability acceptance test in step 4 (#9) and complements the cleanup de-duplication work. ## Files `consume/SKILL.md` (step 4), `consume/project.md`. — Claude
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alexion/skills#12