paiupgrade

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/PAIUpgrade/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)

You MUST send this notification BEFORE doing anything else when this skill is invoked.

1. Send voice notification:

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the PAIUpgrade skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. Output text notification:

   Running the **WorkflowName** workflow in the **PAIUpgrade** skill to ACTION...
   

This is not optional. Execute this curl command immediately upon skill invocation.

PAIUpgrade Skill

Primary Purpose: Generate prioritized upgrade recommendations for the user's existing PAI setup by understanding their context and discovering what's new in the ecosystem.

The skill runs two parallel agent threads that converge into personalized recommendations:

Thread 1: USER CONTEXT           Thread 2: SOURCE COLLECTION
┌─────────────────────┐         ┌─────────────────────┐
│ TELOS Analysis      │         │ Anthropic Sources   │
│ Project Analysis    │         │ YouTube Channels    │
│ Recent Work History │         │ Custom USER Sources │
│ PAI System State    │         │ Community Updates   │
└─────────────────────┘         └─────────────────────┘
           │                              │
           └──────────┬───────────────────┘
                      ▼
        ┌─────────────────────────────┐
        │  PRIORITIZED RECOMMENDATIONS │
        │  (personalized to user)      │
        └─────────────────────────────┘

---

Workflow Routing

Workflow	Trigger	File
Upgrade	"check for upgrades", "check sources", "any updates", "check Anthropic", "check YouTube", "upgrade", "pai upgrade"	Workflows/Upgrade.md
ResearchUpgrade	"research this upgrade", "deep dive on [feature]", "further research"	Workflows/ResearchUpgrade.md
FindSources	"find upgrade sources", "find new sources", "discover channels"	Workflows/FindSources.md

Default workflow: If user says "upgrade" or "check for upgrades" without specifics, run the Upgrade workflow.

---

Primary Output Format

Granular. Extracted. PAI-Contextualized.

The output provides SPECIFIC TECHNIQUES extracted from actual content, not links to watch or recommendations to read. Every tip explains WHY it matters for YOUR PAI system.

# PAI Upgrade Report
**Generated:** [timestamp]
**Sources Processed:** [N] release notes parsed | [N] videos transcribed | [N] docs analyzed

---

## 🎯 Extracted Techniques

These are SPECIFIC techniques pulled from actual content. Each one maps to your PAI system.

### From Release Notes

#### [Feature/Change Name]
**Source:** GitHub claude-code v2.1.16, commit abc123

**What It Is (16-32 words):**
[Describe the technique itself - what it does, how it works, what capability it provides. Must be 16-32 words, concrete and specific.]

**How It Helps PAI (16-32 words):**
[Describe the specific benefit to our PAI system - which component improves, what gap it fills, what becomes possible. Must be 16-32 words.]

**The Technique:**
> [Exact code pattern, configuration, or approach - quoted or code-blocked]

**Applies To:** `hooks/SecurityValidator.hook.ts`, ISC verification
**Implementation:**
```typescript
// Before (what you have now)
[current pattern]

// After (with this technique)
[new pattern]

---

From YouTube Videos

[Specific Technique Name]

Source: R Amjad - "Video Title" @ 12:34

What It Is (16-32 words): [Describe the technique itself - what it does, how it works, what capability it provides. Must be 16-32 words, concrete and specific.]

How It Helps PAI (16-32 words): [Describe the specific benefit to our PAI system - which component improves, what gap it fills, what becomes possible. Must be 16-32 words.]

The Technique:

"[Exact quote or paraphrased technique from transcript]"

Applies To: Browser skill, delegation system Implementation: [Specific steps to apply this technique]

---

From Documentation

[Specific Capability/Pattern]

Source: Claude Docs - Tool Use section, updated 2026-01-20

What It Is (16-32 words): [Describe the technique itself - what it does, how it works, what capability it provides. Must be 16-32 words, concrete and specific.]

How It Helps PAI (16-32 words): [Describe the specific benefit to our PAI system - which component improves, what gap it fills, what becomes possible. Must be 16-32 words.]

The Technique:

[Exact documentation excerpt showing the capability]

Applies To: skills/PAI/SKILL.md, agent spawning Implementation: [Specific changes needed]

---

📊 Technique Summary

#	Technique	Source	PAI Component	Impact
1	[technique name]	[source]	[component it affects]	[what changes]
2	[technique name]	[source]	[component it affects]	[what changes]

---

⏭️ Skipped Content

Content	Source	Why Skipped
[video/doc title]	[source]	[No extractable technique / Not relevant to PAI / Covers basics you already know]

---

🔍 Sources Processed

Release Notes Parsed:

• claude-code v2.1.14, v2.1.15, v2.1.16 → [N] techniques extracted
• MCP 2025-11-25 → [N] techniques extracted

Videos Transcribed:

• R Amjad: "Title" (23:45) → [N] techniques extracted
• AI Jason: "Title" (15:20) → 0 techniques (skipped: Gemini focus)

Docs Analyzed:

• Claude Tool Use docs → [N] techniques extracted

---

## Extraction Rules

**CRITICAL: Extract, don't summarize. Techniques, not recommendations.**

1. **Every output item must be a TECHNIQUE** - A specific pattern, code snippet, configuration, or approach
2. **Quote or code-block the actual content** - Show exactly what was said/written
3. **Map to PAI components** - Every technique must connect to a specific file, skill, workflow, or system component
4. **Two mandatory description fields (16-32 words each):**
   - **What It Is:** Describe the technique itself - what it does, how it works, what capability it provides
   - **How It Helps PAI:** Describe the specific benefit - which component improves, what gap it fills, what becomes possible
5. **Provide implementation** - Show before/after code or specific steps
6. **Skip, don't dilute** - If content has no extractable technique, put it in Skipped Content with reason

**Anti-patterns to AVOID:**
- ❌ "Check out this video for more"
- ❌ "This release has improvements"
- ❌ "Consider looking into this"
- ❌ Vague summaries without specific techniques
- ❌ Links without extracted content

**Source Type Labels:**
| Label | Meaning |
|-------|---------|
| `GitHub: claude-code vX.Y.Z` | Specific version release notes |
| `YouTube: Creator @ MM:SS` | Video with timestamp |
| `Docs: Section Name` | Documentation section |
| `Blog: Post Title` | Blog post |

---

## The Two-Thread Architecture

### Thread 1: User Context Analysis

**Purpose:** Deeply understand the user to personalize recommendations.

Launch **parallel agents** to analyze:

| Agent | Focus | Sources |
|-------|-------|---------|
| **TELOS Agent** | User's goals, challenges, current focus | `skills/PAI/USER/TELOS/*.md` |
| **Project Agent** | Active projects, tech stacks, dependencies | TELOS/PROJECTS.md, recent work context |
| **History Agent** | Recent work patterns, what's been done | `MEMORY/WORK/`, `MEMORY/STATE/current-work.json` |
| **PAI State Agent** | System capabilities, installed skills, gaps | `skills/`, `hooks/`, `settings.json` |

**Output:** A context object that includes:
- User's current focus areas and priorities
- Active projects and their tech stacks
- Recent work patterns and themes
- PAI system state and existing capabilities

### Thread 2: Source Collection

**Purpose:** Discover what's new in the ecosystem.

Launch **parallel agents** to check:

| Agent | Focus | Sources |
|-------|-------|---------|
| **Anthropic Agent** | Official Anthropic updates | `Tools/Anthropic.ts` (30+ sources) |
| **YouTube Agent** | Configured channels for new videos | USER customization channels |
| **Custom Source Agent** | Any USER-defined additional sources | USER/SKILLCUSTOMIZATIONS/PAIUpgrade/ |

**Output:** A collection of discoveries:
- New features, releases, changes from Anthropic
- New videos with transcripts and key insights
- Updates from custom sources

---

## Process Flow

### Step 1: Launch Both Threads in Parallel

Using BACKGROUNDDELEGATION, spawn both analysis threads simultaneously:

```markdown
## Thread 1: User Context (4 parallel agents)

### Agent 1: TELOS Analysis
Read and analyze:
- ~/.claude/skills/PAI/USER/TELOS/TELOS.md
- ~/.claude/skills/PAI/USER/TELOS/GOALS.md
- ~/.claude/skills/PAI/USER/TELOS/PROJECTS.md
- ~/.claude/skills/PAI/USER/TELOS/CHALLENGES.md
- ~/.claude/skills/PAI/USER/TELOS/STATUS.md

Extract: Current focus, priorities, active goals, project themes

### Agent 2: Recent Work Analysis
Read and analyze:
- ~/.claude/MEMORY/STATE/current-work.json
- Recent MEMORY/WORK/ directories

Extract: What user has been working on, patterns, open tasks

### Agent 3: PAI System State
Analyze:
- ~/.claude/skills/ (installed skills)
- ~/.claude/hooks/ (active hooks)
- ~/.claude/settings.json (configuration)

Extract: Current capabilities, potential gaps, system health

### Agent 4: Tech Stack Context
From PROJECTS and recent work, identify:
- Languages and frameworks in use
- Deployment targets
- Integration points

---

## T

---

*Content truncated.*