learn

<user_request> Analyze this session for learnable patterns and propose CLAUDE.md updates. $ARGUMENTS </user_request>

<quality_filter>
  Only propose learnings that are:
  1. Project-specific (not general best practices)
  2. Repeated OR explicitly stated as rules
  3. Actionable and specific
  4. New information (not already in CLAUDE.md)
</quality_filter>

</critical_constraints>

<phase number="2" name="Check Existing">
  <objective>Avoid duplicates and contradictions</objective>
  <steps>
    <step>
      Read current CLAUDE.md:
      ```bash
      # Check project CLAUDE.md
      cat .claude/CLAUDE.md 2>/dev/null || cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"
      ```
    </step>
    <step>
      Check if any detected patterns already exist in CLAUDE.md
    </step>
    <step>
      Check for contradictions with existing rules
    </step>
  </steps>
</phase>

<phase number="3" name="Present Findings">
  <objective>Show learnings with confidence levels</objective>
  <format>
    ```
    ## Session Learnings

    Analyzed this session for learnable patterns.

    ### HIGH Confidence
    [Only if repeated OR explicitly stated as rule]

    **1. [Short title]**
    Signal: "[Exact quote or description]"
    ```diff
    + [Proposed CLAUDE.md line]
    ```

    ### MEDIUM Confidence
    [Single clear corrections - ask for confirmation]

    **2. [Short title]**
    Signal: [Description of what happened]
    ```diff
    + [Proposed line]
    ```
    ⚠️ Only seen once - confirm before adding?

    ---

    **Summary**: [N] HIGH confidence, [M] MEDIUM confidence learnings detected.

    Apply HIGH confidence learnings to CLAUDE.md? [y/n/selective]
    ```
  </format>
</phase>

<phase number="4" name="Apply (if approved)">
  <objective>Update CLAUDE.md with approved learnings</objective>
  <steps>
    <step>
      If user approves, read current CLAUDE.md
    </step>
    <step>
      Find or create `## Learned Preferences` section
    </step>
    <step>
      Add approved learnings under appropriate subsections:
      - Code Style
      - Project Structure
      - Tools & Commands
      - Conventions
    </step>
    <step>
      Use Edit tool to update the file (preserve existing content)
    </step>
    <step>
      Confirm what was added:
      ```
      ✓ Added [N] learnings to CLAUDE.md:
      - [learning 1]
      - [learning 2]

      These will apply to future sessions in this project.
      ```
    </step>
  </steps>
</phase>