Initial commit
This commit is contained in:
Zhongwei Li
367
commands/discover_workflows.md
Normal file
367
commands/discover_workflows.md
Normal file
@@ -0,0 +1,367 @@
|
||||
---
|
||||
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!
|
||||
Reference in New Issue
Block a user