gh-coalesce-labs-catalyst-plugins-meta/commands/discover_workflows.md

---
description: Research and catalog workflows from external Claude Code repositories
category: workflow-discovery
tools: mcp__deepwiki__ask_question, mcp__deepwiki__read_wiki_structure, Read, Write
model: inherit
version: 1.0.0
workspace_only: true
---

# Discover Workflows

You are tasked with researching external Claude Code repositories to discover, analyze, and catalog
their agents, commands, and workflow patterns.

## Purpose

This command helps you learn from the Claude Code community by analyzing workflow repositories and
extracting reusable patterns.

## Supported Repositories

Default repositories to research:

- `catlog22/Claude-Code-Workflow` - Multi-agent automation
- `automazeio/ccpm` - Project management system
- `wshobson/commands` - Production slash commands
- `wshobson/agents` - Production subagents
- `qdhenry/Claude-Command-Suite` - 148+ commands, 54 agents
- `VoltAgent/awesome-claude-code-subagents` - 100+ subagents
- `hesreallyhim/awesome-claude-code` - Curated commands/agents
- `feiskyer/claude-code-settings` - Workflow improvements
- `OneRedOak/claude-code-workflows` - Code review workflows
- `anthropics/claude-code` - Official Claude Code repo
- `winfunc/opcode` - GUI toolkit for agents/commands

## Initial Response

When invoked:

```
I'll research Claude Code workflows from external repositories.

Which repository would you like to explore?
1. wshobson/commands - Production slash commands
2. wshobson/agents - Production subagents
3. qdhenry/Claude-Command-Suite - 148+ commands
4. VoltAgent/awesome-claude-code-subagents - 100+ subagents
5. Custom repository (provide org/repo)

Or type 'all' to catalog all supported repos (this may take a while).
```

## Process

### Step 1: Select Repository

Get user selection or use provided parameter.

### Step 2: Research Repository (Parallel Sub-Agents)

**IMPORTANT**: Spawn 3 parallel research tasks for efficiency and context isolation.

Use TodoWrite to track the 3 parallel research tasks.

**Task 1 - Workflow Discovery**:

```
Use external-research agent:
"Research {repo-name}. What commands and agents are available? List all workflows with brief descriptions of what each does."

Tools: mcp__deepwiki__read_wiki_structure, mcp__deepwiki__ask_question
Return: Complete list of all workflows found
```

**Task 2 - Frontmatter Analysis**:

```
Use external-research agent:
"Research {repo-name}. What frontmatter format is used for agents and commands? Provide specific examples showing all frontmatter fields used."

Tools: mcp__deepwiki__ask_question
Return: Frontmatter patterns with concrete examples
```

**Task 3 - Implementation Patterns**:

```
Use external-research agent:
"Research {repo-name}. What are the common implementation patterns, structures, and conventions used across workflows? Include naming conventions, file organization, and any templates."

Tools: mcp__deepwiki__ask_question
Return: Patterns, templates, conventions observed
```

**WAIT for all 3 tasks to complete before proceeding.**

**Why parallel**:

- 3x faster than sequential
- Each agent has isolated context
- No context contamination between research areas
- Better token efficiency per agent

### Step 3: Aggregate Parallel Results

Combine findings from the 3 parallel research tasks:

- Workflows list from Task 1
- Frontmatter patterns from Task 2
- Implementation patterns from Task 3

Mark all 3 tasks complete in TodoWrite.

### Step 4: Analyze and Extract

From the aggregated results, extract:

1. **Available Workflows**
   - List all agents and commands
   - What each one does
   - When to use them

2. **Frontmatter Patterns**
   - What fields are used
   - Naming conventions
   - Tool specifications
   - Categories/tags

3. **Implementation Patterns**
   - Common structures
   - Reusable templates
   - Integration patterns

4. **Unique Features**
   - Novel approaches
   - Interesting combinations
   - Advanced techniques

### Step 5: Create Catalog Entry

Save research to `thoughts/shared/workflows/{repo-name}/analysis.md`:

````markdown
# Workflow Analysis: {Repo Name}

**Repository**: {org/repo} **Analyzed**: {date} **Focus**: {agents/commands/both}

## Summary

[1-2 sentence overview of what this repo offers]

## Available Workflows

### Commands

1. **{command-name}**
   - **Purpose**: [what it does]
   - **Use when**: [scenario]
   - **Frontmatter**:
     ```yaml
     [actual frontmatter from repo]
     ```

2. **{command-name}** [...]

### Agents

1. **{agent-name}**
   - **Purpose**: [what it does]
   - **Tools**: [tools it uses]
   - **Frontmatter**:
     ```yaml
     [actual frontmatter from repo]
     ```

## Frontmatter Patterns

### Standard Fields

- name: [how they define it]
- description: [format they use]
- tools: [how specified]
- [other fields observed]

### Naming Conventions

- [pattern 1]
- [pattern 2]

## Implementation Patterns

### Common Structures

[Patterns you notice across workflows]

### Reusable Templates

[Templates that could be adapted]

## Unique Features

[Novel or interesting approaches]

## Integration Notes

[How these could integrate with your workspace]

## Recommendations

### High-Value Imports

1. **{workflow-name}** - [why it's valuable]
2. **{workflow-name}** - [why it's valuable]

### Patterns to Adopt

- [Pattern 1]: [how to use it]
- [Pattern 2]: [how to use it]

## References

- DeepWiki searches: [links]
- Repository: {URL}
- Analyzed on: {date}
````

### Step 6: Update Master Catalog

Update `thoughts/shared/workflows/catalog.md`:

```markdown
# Workflow Catalog

Discovered workflows from the Claude Code community.

## Repositories Analyzed

### wshobson/commands

- **Analyzed**: 2025-01-08
- **Workflows**: 15 commands
- **Focus**: Production-ready automation
- **Details**: [See analysis](wshobson-commands/analysis.md)
- **Top Picks**:
  - code-review: Automated code review workflow
  - refactor: Safe refactoring patterns

[... more repos]

## By Category

### Code Review

- wshobson/commands: code-review
- OneRedOak/claude-code-workflows: review-pr

### Documentation

- qdhenry/Claude-Command-Suite: doc-generator
- hesreallyhim/awesome-claude-code: readme-generator

[... more categories]

## By Use Case

### "I want to automate code reviews"

1. wshobson/commands/code-review
2. OneRedOak/claude-code-workflows/review-pr
3. [Details in respective analyses]

### "I need project management workflows"

1. automazeio/ccpm - Full PM system
2. [...]
```

### Step 7: Present Summary

Show user what was found:

```markdown
# Discovery Results: {Repo Name}

## Summary

Discovered {N} workflows ({X} commands, {Y} agents)

## Highlights

### Top Workflows

1. **{name}** - {brief description}
2. **{name}** - {brief description}
3. **{name}** - {brief description}

### Interesting Patterns

- {Pattern 1}
- {Pattern 2}

### Recommended for Import

- **{workflow-name}**: {why}

## Next Steps

1. **Review the analysis**: `thoughts/shared/workflows/{repo}/analysis.md`
2. **Import a workflow**: `/import-workflow {repo} {workflow-name}`
3. **Discover another repo**: `/discover-workflows`

Catalog updated at: `thoughts/shared/workflows/catalog.md`
```

## Advanced Usage

### Discover All Repos (Maximum Parallelism)

```
/discover-workflows all
```

This will:

1. Spawn parallel research for ALL supported repos simultaneously
2. Each repo gets 3 sub-agents (structure, frontmatter, patterns)
3. Total: 11 repos × 3 agents = 33 parallel tasks
4. Aggregate all results
5. Create analysis for each repo
6. Update master catalog
7. Present summary comparison

**Performance**: ~10-15x faster than sequential research

**Context efficiency**: Each agent loads only its research area

### Discover Custom Repo

```
/discover-workflows org/repo
```

Works with any public GitHub repo with Claude Code workflows.

### Focus on Specific Type

```
/discover-workflows wshobson/agents --focus agents
```

Only analyzes agents, skips commands.

## Important Notes

- **Read-only**: This command only researches, doesn't import
- **Catalog persistence**: Saved in thoughts/ for future reference
- **Reusable**: Run anytime to update catalog
- **Combinable**: Use with `/import-workflow` to actually import

## Integration with Other Commands

- **Discover** → `/discover-workflows` (this command)
- **Import** → `/import-workflow` (imports discovered workflows)
- **Create** → `/create-workflow` (creates new using discovered patterns)
- **Validate** → `/validate-frontmatter` (ensures consistency)

This command is the first step in workflow discovery and reuse!