# pg-agent-coach

A Claude Code tool that captures and shares "agentic mindset" knowledge from your sessions to Slack.

## What is this?

When you work with Claude Code, sometimes brilliant collaboration moments happen - intensive discussions where both you and Claude refine ideas through back-and-forth dialogue. These "wow moments" demonstrate the art of human-AI collaboration that's hard to teach but valuable to share.

**pg-agent-coach** automatically detects these moments and shares the insights with your team on Slack.

## How it works

```
┌─────────────────────────────────────────────────────────────┐
│  Your Claude Code Session                                   │
│                                                             │
│  You send a message                                         │
│         │                                                   │
│         ▼                                                   │
│  UserPromptSubmit hook fires → reminder injected to Claude  │
│         │                                                   │
│         ▼ (Claude processes with reminder in context)       │
│  If wow moment detected → /show-ropes command               │
│         │                                                   │
│         ▼ (extracts insights)                               │
│  knowledge-extractor agent                                  │
│         │                                                   │
│         ▼                                                   │
│  Slack message with shareable insight                       │
└─────────────────────────────────────────────────────────────┘
```

## Installation

```bash
curl -fsSL https://raw.githubusercontent.com/Positive-LLC/pg-agent-coach/main/install.sh | bash
```

During installation, you'll be prompted to enter your Slack webhook URL (required).

This installs three components to your `~/.claude` directory:
- `agents/knowledge-extractor.md` - Extracts and formats insights
- `commands/show-ropes.md` - The `/show-ropes` slash command
- `hooks/wow-moment-reminder.sh` - Hook that reminds Claude to check for wow moments

And configures the UserPromptSubmit hook in `~/.claude/settings.json`.

## Usage

### Automatic (recommended)

Just use Claude Code as normal. Before processing each message, the hook injects a reminder into Claude's context to evaluate whether the exchange demonstrated exceptional collaboration worth sharing. Claude looks for:

- Intensive back-and-forth discussions (4+ exchanges on same topic)
- Productive disagreements that lead to better solutions
- Breakthrough moments after sustained engagement
- Meta-collaboration (discussing *how* to approach problems)

When Claude detects a wow moment, it automatically invokes `/show-ropes` to extract and share the insight.

### Manual

Run `/show-ropes` in any Claude Code session to manually extract and share insights.

```
/show-ropes
```

Or with a focus:

```
/show-ropes the discussion about error handling
```

## What gets shared

Insights are posted to Slack in this format:

```
*Agentic Insight*

*The Technique:* "Asking Claude to argue against its own solution"

*What Happened:*
• User received a working solution but asked "What would you change if you were reviewing this critically?"
• Claude identified 3 improvements it hadn't initially suggested
• User picked one, leading to a more elegant final solution

*The Takeaway:*
Don't accept the first working answer. Ask Claude to critique its own work - it often knows improvements it didn't volunteer initially.
```

## Configuration

### Slack Webhook

Your Slack webhook URL is configured during installation. To update it later, edit `~/.claude/agents/knowledge-extractor.md` and replace the webhook URL.

### Hook Configuration

The hook is configured in `~/.claude/settings.json`:

```json
{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash ~/.claude/hooks/wow-moment-reminder.sh"
          }
        ]
      }
    ]
  }
}
```

**Why UserPromptSubmit?** Only `UserPromptSubmit` and `SessionStart` hooks inject their stdout into Claude's context. Other hook types (like `Stop`) only display output in verbose mode.

## Components

| Component | Purpose |
|-----------|---------|
| `wow-moment-reminder.sh` hook | Injects wow-moment reminder into Claude's context before each response |
| `/show-ropes` command | Triggers knowledge extraction (manual or automatic) |
| `knowledge-extractor` agent | Analyzes sessions and posts insights to Slack |

## Philosophy

This tool is about **"showing the ropes"** - capturing the tacit knowledge of effective AI collaboration. It focuses on:

- **The mindset**, not the code
- **The technique**, not the project details
- **Reusable patterns** anyone can apply

## License

MIT