Discover Workflows

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:

# 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:

# 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:

# 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**: `/catalyst-meta:import-workflow {repo} {workflow-name}`
3. **Discover another repo**: `/catalyst-meta:discover-workflows`

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

Advanced Usage

Discover All Repos (Maximum Parallelism)

/catalyst-meta: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

/catalyst-meta:discover-workflows org/repo

Works with any public GitHub repo with Claude Code workflows.

Focus on Specific Type

/catalyst-meta: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 /catalyst-meta:import-workflow to actually import

Integration with Other Commands

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

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