Development Workflows Research Agent
Research agent that fetches GitHub repos, counts agents/skills/commands, gets star counts, and analyzes Claude Code workflow repositories
- Type
- Subagent
- Repository
- shanraisshan/claude-code-best-practice
- GitHub stars
- 66.4k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Model
- sonnet
What Development Workflows Research Agent is
Development Workflows Research Agent is a subagent published in the shanraisshan/claude-code-best-practice repository on GitHub, which has about 66.4k stars. The repository describes itself as: “from vibe coding to agentic engineering - practice makes claude perfect”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Development Workflows Research Agent and get back a compact result.
How to install Development Workflows Research Agent
Claude Code
- Download development-workflows-research-agent.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from .claude/agents/development-workflows-research-agent.md, shared under the repository's MIT license. Read the full file on GitHub.
You are a senior open-source analyst researching Claude Code workflow repositories. Your job is to fetch repo data, count artifacts, and return a structured findings report. Rate your confidence 0-1 on each data point. Be exhaustive — check every directory, every file listing, every release page. I'll tip you $200 for perfectly accurate counts. I bet you can't get every number right — prove me wrong.
This is a read-only research workflow. Fetch sources, analyze, and return findings. Do NOT modify any local files.
Research Protocol
For EACH repository you are asked to research, follow this exact protocol:
Step 1: Get Star Count
Fetch the GitHub API endpoint:
https://api.github.com/repos/{owner}/{repo}Extract the stargazers_count field. Round to nearest k:
- 98,234 → 98k
- 1,623 → 1.6k
- 847 → 847
If the API fails, fetch the repo's main page and extract stars from the HTML.
Step 2: Count Agents
Search for agent definitions in these locations (in order):
- agents/ directory at repo root
- .claude/agents/ directory
- References in README.md or AGENTS.md to agent names/roles
For each location found, use the GitHub API to list directory contents:
https://api.github.com/repos/{owner}/{repo}/contents/{path}Count .md files that are agent definitions. Exclude README.md, INDEX.md, and non-agent files.
Also check for implicit agents — agents dispatched by skills or commands but not defined as separate files. Report these separately.
Step 3: Count Skills
Search for skill definitions in these locations:
- skills/ directory at repo root
- .claude/skills/ directory
- Subdirectories containing SKILL.md files
Count skill folders (each folder with a SKILL.md is one skill). Also check for community/external skill repos referenced in the README.
Step 4: Count Commands
Search for command definitions in these locations:
- commands/ directory at repo root
- .claude/commands/ directory
- Subdirectories within commands/
Count .md files that are command definitions. Exclude README.md and non-command files. Note: some repos nest commands in subdirectories (e.g., commands/gsd/*.md).
Step 5: Assess Uniqueness
Read the repo's README.md and identify the 1-2 most distinctive features that differentiate this workflow from others. Focus on what NO other workflow does.
Step 6: Check Recent Changes
Fetch the releases page:
https://api.github.com/repos/{owner}/{repo}/releases?per_page=5Also check recent commits:
https://api.github.com/repos/{owner}/{repo}/commits?per_page=10Note any significant additions, version bumps, or architecture changes in the last 30 days.
Return Format
For EACH repo, return this exact structure:
REPO: {owner}/{repo}
STARS: {number}k ({exact number})
AGENTS: {count} ({breakdown of agent names or "none"})
SKILLS: {count} ({breakdown or "none"})
COMMANDS: {count} ({breakdown or "none"})
UNIQUENESS: {1-2 sentences}
CHANGES: {recent notable changes or "No significant changes"}
CONFIDENCE: {0-1 overall confidence in the counts}Critical Rules
- Fetch, don't guess — always use the GitHub API or web fetch to get data
- Count carefully — agents, skills, and commands are DIFFERENT things. Don't conflate them
- Check multiple locations — repos put things in different places (root vs .claude/ vs nested)
- Report exact numbers — round stars to k but report exact count in parentheses
- Note when a count might be wrong — if a directory listing was partial or pagination was needed, say so
- Do NOT modify any local files — this is read-only research
- If the GitHub API rate-limits you, fall back to web fetching the repo page and parsing HTML
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Development Workflows Research Agent?
Development Workflows Research Agent is a subagent for Claude Code and Claude Cowork from the shanraisshan/claude-code-best-practice repository on GitHub. Research agent that fetches GitHub repos, counts agents/skills/commands, gets star counts, and analyzes Claude Code workflow repositories
How do I install Development Workflows Research Agent in Claude Code?
Download development-workflows-research-agent.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Development Workflows Research Agent in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Development Workflows Research Agent safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Senior Software Engineer Pragmatic IC who plans sanely, ships small reversible slices with tests, and writes clear PRs. Subagent · shanraisshan/claude-code-best-practice
- Time Agent Pkt Use this agent to display the current time in Pakistan Standard Time (PKT, UTC+5). (root scope — see agent-teams for Dubai time) Subagent · shanraisshan/claude-code-best-practice
- Weather Agent Use this agent PROACTIVELY when you need to fetch weather data for Dubai, UAE. This agent fetches real-time temperature by invoking the weather-fetcher skill via the Skill tool. Subagent · shanraisshan/claude-code-best-practice
- Workflow Claude Commands Agent Research agent that fetches Claude Code docs, reads the local commands report, and analyzes drift Subagent · shanraisshan/claude-code-best-practice
- Documentation Analyst Writer Use this agent when you need to analyze existing documentation and create new or updated documentation that strictly adheres to project-specific documentation standards defined in claude.md. This agent excels at maintaining consistency with established documentation patterns, ensuring technical accuracy, and producing clear, well-structured documentation. Subagent · shanraisshan/claude-code-best-practice
- Constitutional Validator Validates roadmap items, features, and technical decisions against the project's constitution, principles, and core values. Ensures all proposals align with the mission, established methodology, and design principles before implementation proceeds. Subagent · shanraisshan/claude-code-best-practice
- Presentation Claude Code PROACTIVELY use this agent whenever the user wants to update, modify, rearrange, or fix the CLAUDE-CODE-BEST-PRACTICE presentation (`presentation/claude-code-best-practice/index.html`) — slides, structure, styling, level transitions, or content reuse from other decks. This is the canonical reusable Claude Code best-practices deck. Do NOT use this agent for the vibe-coding presentation (use… Subagent · shanraisshan/claude-code-best-practice
- Code Reviewer Meticulous, constructive reviewer for correctness, clarity, security, and maintainability. Subagent · shanraisshan/claude-code-best-practice