---

name: pattern-detect description: > Detect recurring patterns using the Agent Monitor's workflow intelligence — toolFlow transitions (tool A → B frequency matrices), recurring workflow patterns, agent co-occurrence pairs, model delegation habits, error propagation paths by agent depth, and compaction triggers. Use to discover habitual usage patterns and anti-patterns.

Pattern Detect

Identify recurring patterns using the Agent Monitor's workflow intelligence engine.

Input

The user provides: $ARGUMENTS

Options: "all", "tools", "errors", "workflows", "last N sessions".

Data Sources

| Endpoint | Returns | |----------|---------| | GET /api/sessions?limit=200 | Session list with status, model, cwd, metadata | | GET /api/analytics | tool_usage top 20, event_types, agent_types | | GET /api/workflows/{sessionId} | 11 datasets per session (see below) |

Workflow datasets used for pattern detection

| Dataset | Pattern insight | |---------|----------------| | toolFlow | Tool transition matrix: tool A → tool B with counts — reveals sequential habits | | patterns | Detected workflow patterns: recurring sequences with frequency scores | | cooccurrence | Agent co-occurrence: which agents frequently run together | | modelDelegation | Model habits: which models are chosen for which task types | | errorPropagation | Error patterns: where errors start and how they cascade by agent depth | | effectiveness | Subagent patterns: which types succeed most, avg duration per type | | compaction | Compaction triggers: what causes context overflow | | complexity | Complexity patterns: session complexity scores over time |

Pattern Categories

1. Tool Chain Patterns (from toolFlow)

• Most common sequences: Top 10 tool transitions (e.g., Read → Edit: 145 times)
• Starter tools: First tool used in sessions (indicates task type)
• Finisher tools: Last tool before Stop event
• Anti-patterns: Tool → same Tool repeated (retries/failures)
• Co-occurrence: Tools that always appear together in sessions

2. Workflow Patterns (from patterns)

• Named patterns: Workflow sequences the API has detected with frequency
• Session archetypes: Common session shapes (short edit, long debug, subagent-heavy)
• Project-specific: Patterns that appear in specific working directories

3. Error Patterns (from errorPropagation + event_types)

• Error origins: Which agent depth level produces most errors
• Cascade patterns: Errors that trigger chains of follow-up errors
• APIError frequency: quota hits, rate_limit, overloaded — by time of day
• Recovery patterns: How errors are typically resolved (tool retry vs agent switch)

4. Agent Patterns (from cooccurrence + effectiveness)

• Agent pairs: Which agents are spawned together frequently
• Delegation patterns: Main agent → subagent task delegation habits
• Success by type: Which subagent types (task/explore/code-review) work best for which tasks

5. Temporal Patterns (from session timestamps + daily_sessions)

• Peak hours: When sessions cluster
• Duration patterns: Short vs long session distribution
• Day-of-week trends: Productive days vs quiet days

Output

Pattern Report with top 10 patterns ranked by frequency × impact:

• Pattern name and description
• Frequency (occurrences across analyzed sessions)
• Impact: positive (reinforce), negative (eliminate), or neutral (observe)
• Actionable recommendation for each