kb

Knowledge Base Capture

Capture this into the knowledge base: $ARGUMENTS

Knowledge Base Location

All files live in lambda/scripts/memory/. The index is at lambda/scripts/memory/INDEX.md.

Step 1: Read the current index

Read lambda/scripts/memory/INDEX.md to understand what's already captured and avoid duplicates.

Step 2: Choose a category

If none fit, create a new category directory and add a section to INDEX.md.

Step 3: Create the entry file

Filename: lowercase-kebab-case, descriptive. Example: watch-echo-loop-bug.md

Entry format:

---
date: YYYY-MM-DD
tags: [relevant, tags]
---
# Title

Concise description of the finding/decision/pattern.
Keep it 5-20 lines. Link to relevant source files where useful.
Focus on the WHY and the non-obvious parts — assume the reader is a developer familiar with the codebase.

Step 4: Update INDEX.md

Add a one-liner entry under the appropriate category heading:

- [filename.md](category/filename.md) — concise one-liner (max 80 chars)

Keep entries sorted by relevance within each category (most important first), not by date.

When to auto-invoke this skill

Capture knowledge when ANY of these happen during a conversation:

• An architectural decision is made (chose X over Y)
• A non-obvious bug root cause is discovered
• A new subsystem or data format is designed
• A significant refactor changes how something works
• The user discusses product strategy or feature scope
• Performance investigation reveals important findings
• A workaround for an external limitation is implemented

Do NOT capture:

• Routine code changes (rename variable, fix typo)
• Information already in the knowledge base
• Temporary debugging steps
• Anything the user explicitly says is experimental/throwaway