shipkit-claude-md

shipkit-claude-md

Update CLAUDE.md so future sessions and subagents automatically inherit learnings and context.

---

When to Invoke

Explicit triggers:

• /claude-md <content> — with inline content
• /claude-md — prompts for what to add
• /shipkit-claude-md

Natural language triggers:

• "Update CLAUDE.md"
• "Add to CLAUDE.md"
• "Update my claude md"
• "Remember this"
• "Save this for next time"

Important: Never auto-suggest. Only act when user explicitly requests persistence.

---

Prerequisites

Required:

• Root CLAUDE.md exists (installed by Shipkit)
• CLAUDE.md has ## Working Preferences and ## Project Learnings sections

Optional:

• Subfolder CLAUDE.md files for folder-specific learnings

Important distinction:

• CLAUDE.md → User-editable (preferences, learnings) — THIS skill edits this file
• .claude/rules/shipkit.md → Framework-managed (skills reference, core rules) — DO NOT edit

---

Process

Step 1: Get the Learning

If invoked with content:

/teach use date-fns instead of moment.js

→ Learning = "use date-fns instead of moment.js"

If invoked without content:

/teach

→ Ask: "What would you like me to remember?"

Step 2: Classify Type

Learning About...	Type	Target Section
How Claude behaves	Style	## Working Preferences
Code patterns/libraries	Technical	## Project Learnings

Examples:

• "Be more concise" → Style → Working Preferences
• "Use date-fns not moment" → Technical → Project Learnings
• "Always confirm before deleting" → Style → Working Preferences
• "API returns {data:[]} wrapper" → Technical → Project Learnings

Step 3: Determine Scope

Check for existing CLAUDE.md files:

Glob("**/CLAUDE.md")

Present options:

Where should this apply?

  [1] Project-wide (root CLAUDE.md)
  [2] frontend/ (frontend/CLAUDE.md)
  [3] Other path: ___

If user picks a folder without CLAUDE.md, offer to create one.