skills.rest
clouseryan
clouseryanCOMMUNITY
Explore all skills by this author →
GitHub

research-agent

Map codebase structure, patterns, and dependencies into .dev-team/context.md.

Updated Mar 14, 2026
Search Tags:#architecture#documentation#context#codebase#patterns#analyze
One-click install
npx skills add https://github.com/clouseryan/agentic-skills --skill research-agent-clouseryan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-agent
Source: https://github.com/clouseryan/agentic-skills/tree/main/dev-team/research
Command: npx skills add https://github.com/clouseryan/agentic-skills --skill research-agent-clouseryan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps software teams deeply understand a codebase before any changes by mapping structure, conventions, and constraints, and by documenting findings for the entire team.

Core Features & Use Cases

  • Structural Survey: Understand project structure, languages, frameworks, and entry points.
  • Pattern Analysis: Identify naming conventions, file organization, and coding styles.
  • Dependency Mapping: Map internal and external dependencies across modules.
  • Context Building: Document findings in .dev-team/ for other agents.
  • Targeted Research: Locate files relevant to a specific feature or bug.
  • Phase-based workflow: Iterate through Phase 1–4 tasks as described.

Quick Start

Run the structural survey and pattern analysis by executing the scripts explore_codebase.py and analyze_patterns.py in dev-team/scripts to build the team's shared context.

Frequently Asked Questions about research-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a codebase to understand its architecture and dependencies?▼

To analyze a codebase, you can run structural survey and pattern analysis scripts that identify project structure, naming conventions, and module dependencies. This process maps the codebase architecture and records findings in a shared context file.

What is the best way to document codebase patterns for team onboarding?▼

Documenting codebase patterns for onboarding involves mapping file organization, coding styles, and internal dependencies into a shared context file. This establishes a team-wide understanding of architectural constraints before any development changes occur.

Can I use this to find files relevant to a specific bug or feature?▼

Yes, targeted research locates specific files relevant to a feature or bug. By mapping dependencies and patterns across modules, it narrows down the codebase structure to isolate the exact files needing modification.

Does this codebase analysis workflow require any external dependencies?▼

No external dependencies are required. The workflow uses provided Python scripts for exploration and pattern analysis, iterating through defined phases to map code structure and dependencies without needing additional packages.

How does mapping code structure help with refactoring and architectural planning?▼

Mapping code structure helps refactoring by identifying existing patterns and module dependencies before changes. This establishes a shared context that prevents architectural drift and ensures new code adheres to current conventions.

Related Skills

Explore More Software Engineering Skills→
manuelbrandner85manuelbrandner85

trailmark-summary

Analyzes a codebase to identify languages, entry points, and dependencies.

Community
Intermediate
ralvarezdevralvarezdev
3

improve-codebase-architecture

Identify shallow modules and propose seam-based interface deepening refactors.

Community
Advanced
vuralserhat86vuralserhat86
43

deps_npm

Audit npm and yarn dependencies for vulnerabilities and version control.

Community
Intermediate
XSpoonAiXSpoonAi
17

code-refactoring-advisor

Analyzes Python and Solidity code to detect smells and suggest refactorings.

Official
Advanced