c3a151a87b
Creates MEMORY.md index and 10 memory files documenting: - Scripts: context-load, start-claude, install-hooks, setup-formatters, git-status-report - Skills: /log, /reflect-logs, /reflect, /distill-best-practices, /linter Each file covers purpose, usage, how it works, and gotchas. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# skill: /distill-best-practices
|
|
|
|
**Location:** `custom-claude-skills/skills/distill-best-practices/SKILL.md`
|
|
|
|
## Purpose
|
|
|
|
Cross-project best practices distillation. Reads changed memory files from all tracked projects and proposes additions, updates, or removals to `claude-foundations/best-practices/`. Always targets claude-foundations as output regardless of which project it's run from.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/distill-best-practices
|
|
```
|
|
|
|
No arguments. Interactive — presents proposals for approval before applying.
|
|
|
|
## How it works
|
|
|
|
1. Reads `settings.yaml` for tracked projects and `best-practices/.distill-state.json` for last-processed SHAs
|
|
2. For each project with changes since last SHA: finds changed `memory/*.md` files via `git diff`
|
|
3. Maps memory files to best-practices topics (e.g., `gotchas-k8s.md` → `kubernetes.md`)
|
|
4. Classifies each potential change as ADD, UPDATE, or REMOVE
|
|
5. Presents numbered proposals — waits for user approval
|
|
6. Applies approved changes, updates `BESTPRACTICES.md` index if new files created
|
|
7. Updates `.distill-state.json` with current HEADs
|
|
|
|
## Part of the knowledge pipeline
|
|
|
|
`/log` → `/reflect-logs` → `/distill-best-practices`
|
|
|
|
## Gotchas
|
|
|
|
- Generalises project-specific details: strips IPs, namespace names, hostnames — keeps principles and reasoning
|
|
- Only promotes lessons that would apply to at least one other project type
|
|
- Never auto-applies — always interactive
|