learn

Learn from Conversation

Analyze the conversation to extract lessons learned, then persist them to AI assistant configuration files or new skills.

Arguments

Optional text to narrow what to learn (e.g. sandbox workaround, that build fix).

If $ARGUMENTS is help, --help, -h, or ?, skip the workflow and read references/options.md.

If $ARGUMENTS is a non-empty, non-help string, use it as a focus filter in Step 2: only surface learnings related to the specified topic, skip unrelated findings.

Process

1. Detect Configurations and Existing Skills

for f in CLAUDE.md GEMINI.md AGENTS.md .cursorrules .github/copilot-instructions.md \
  .windsurf/rules/rules.md .continuerc.json; do
  [ -f "$f" ] && wc -l "$f"
done
find .cursor/rules -name "*.mdc" -exec wc -l {} \; 2>/dev/null
find . -name "SKILL.md" -type f 2>/dev/null | grep -v node_modules | \
  xargs grep -l "^name:" | while read -r f; do grep -m1 "^name:" "$f" | sed 's/name: //'; done

Config detection:

• Single config found → use it
• Multiple configs found → MANDATORY: read references/multiconfig-routing.md in full to evaluate auto-skip vs. prompt before proceeding.
• No configs found → MANDATORY: read references/assistant-configs.md in full to show init commands, then exit. Do NOT load refactoring.md, options.md, or multiconfig-routing.md at this step.

Size thresholds for any config file:

• < 400 lines: healthy, add directly
• 400–500 lines: add carefully, note the file is getting large

• 500 lines: MANDATORY: read references/refactoring.md in full before proceeding, then offer to refactor. Do NOT load assistant-configs.md for this path unless also applying Route A changes.

2. Analyze Conversation

Default is reject. Each candidate learning must earn inclusion by passing three filters in order:

1. Would I forget this? If any developer already knows it (npm install before npm start, commit before switching branches, read errors carefully), skip it. Baseline knowledge dilutes the config and trains agents to skim.
2. Is this already covered? Search existing config entries for the topic — if found, tightening the wording beats adding a second rule.
3. Is this universal or local? Environment-specific workarounds (broken keyring, one repo's tooling quirk) must carry a scope qualifier, not be globalized.