kwcompound

name	kw:compound
description	Extract and save learnings from a completed knowledge work session. Saves to docs/knowledge/ so future plans automatically find them.

Compound

Close the loop. Extract what you learned and save it where future work will find it.

When to Use

• After completing a plan, campaign, analysis, or strategy session

• "Compound this session", "Save what we learned", "What should we remember?"

• After a data correction, process fix, or strategic insight

• At the end of any meaningful work session

Process

Step 1: Identify learnings

Scan the current session for compoundable insights. Look for:

Type	Signals
Insight	"We discovered...", surprising finding, counter-intuitive result
Playbook	Repeatable process that worked, step-by-step that others could follow
Correction	Wrong assumption fixed, data source clarified, definition updated
Pattern	Something that keeps recurring, systemic observation

Extract 1-3 learnings max. Quality over quantity. If nothing is worth saving, say so:

"Nothing from this session seems worth saving as a standalone learning. The work is captured in the plan/deliverables."

For each learning, draft:

**Learning:** [One sentence — what we now know]
**Type:** [insight | playbook | correction | pattern]
**Why it matters:** [One sentence — how this changes future work]

Step 2: Get user approval

Present the drafted learnings and ask:

"Found [N] learnings worth saving. Review and approve?"

Show each learning with its classification. User can:

• Approve as-is

• Edit the wording

• Skip individual learnings

• Add learnings you missed

Do not save anything without approval.

Step 3: Check for duplicates

For each approved learning, search existing knowledge:

Grep: [key phrases] in docs/knowledge/
Grep: [key phrases] in docs/solutions/

If a similar learning already exists:

• Show the existing entry

• Ask: "Update existing or save as new?"

• If updating, edit the existing file

Step 3.5: Check for stale knowledge

After identifying what to save, launch the stale knowledge checker:

Launch Task agent: compound-knowledge:research:stale-knowledge-checker

• Pass: the new learning(s) being saved
• Returns: existing entries that may be contradicted or superseded

If stale entries are found, present them to the user:

"This new learning may conflict with existing knowledge:

• [existing file] says [X], but the new learning says [Y]
• Recommendation: [Update / Remove / Keep both]

Want me to update the old entry?"

<critical_requirement> Agents return TEXT only. They must NOT write or delete files. Only the orchestrating compound skill writes files — both new learnings and updates to stale entries. </critical_requirement>

Step 4: Save locally

Write each learning to docs/knowledge/:

Filename: docs/knowledge/{descriptive-slug}.md

Create the directory if it doesn't exist: mkdir -p docs/knowledge/

File format:

---
type: [insight | playbook | correction | pattern]
tags: [relevant keywords for future search]
confidence: [high | medium | low]
created: [today's date]
source: [brief description of what triggered this]
---

# [Learning Title]

[2-4 sentences explaining the learning. Be specific enough that someone reading this in 3 months understands what happened and why it matters.]

## Context

[What you were doing when you discovered this.]

## Implication

[How this should change future work. Be concrete: "When doing X, always check Y first."]

Step 5: Confirm and offer next steps

## Compounded

**Saved:**
- docs/knowledge/{filename}.md

**This learning will be surfaced by /kw:plan** when future work touches:
- [list the tags that would trigger retrieval]

Use AskUserQuestion:

Question: "Learnings saved. What next?"

Options:

1. Run /kw:plan — Start a new planning cycle (the learnings will be found)
2. Push to Proof — Share the learnings for team review
3. Done — Session complete

Important Rules

• 1-3 learnings max per session. If you're saving 5 things, you're not filtering enough.

• Approval required. Never auto-save. The user decides what's worth remembering.

• Be specific. "Use the right data source" is useless. "Revenue metrics come from [specific dashboard], not [other source] which overcounts by ~$X" is useful.

• Duplicates are waste. Always check before creating. Update existing entries when possible.

• Confidence matters. Mark low if based on one data point. Mark high if verified across multiple sessions or with data.

• Tags are for retrieval. Choose tags that /kw:plan's grep search would match on. Think: "What future question would this answer?"

Pipeline Mode

When invoked with disable-model-invocation context (e.g., from an orchestrator or automation):

• Skip all AskUserQuestion prompts
• Use sensible defaults for all choices
• Write output files without waiting for confirmation
• Proceed to the next suggested skill automatically
• Output structured results that the calling context can parse