parallel-exploring
Parallel Explore
Use this skill when you need to understand a large or unfamiliar codebase quickly — onboarding onto a new project, investigating how a feature works across layers, or mapping the architecture.
How It Works
Cursor's explore subagent is a fast, read-only agent optimized for searching and reading code. You can launch multiple explore agents in a single message and they run concurrently, each investigating a different area.
Steps
-
Identify the areas to explore — break the codebase into logical zones. For a typical full-stack app:
- Frontend: components, pages, routing, state management
- Backend: API routes, database models, middleware, auth
- Infrastructure: CI/CD, Docker, deployment config
- Shared: types, utilities, constants
-
Launch parallel explore agents — use the Task tool with
subagent_type: "explore"for each area. Launch them all in one message:Task 1: "Explore the frontend — find the main pages, routing setup, state management approach, and UI component library. Check src/app/, src/components/, src/pages/. Report the framework, router, styling approach, and key components." Task 2: "Explore the backend — find the API routes, database setup, ORM, auth middleware, and data models. Check src/server/, src/api/, lib/, prisma/. Report the framework, database, auth strategy, and key endpoints." Task 3: "Explore the infrastructure — find CI/CD config, Docker setup, deployment targets, and environment variable management. Check .github/, docker*, *.config.*, .env*. Report the deploy target, CI provider, and any IaC." -
Synthesize the results — when all agents return, combine their findings into a coherent picture:
- Tech stack summary (frontend, backend, database, infra)
- Architecture diagram (describe the data flow)
- Key files and entry points
- Potential concerns or tech debt
Other Use Cases
- Cross-cutting investigation: "Where is user authentication checked?" — launch agents to search the frontend (route guards), backend (middleware), and database (session storage) simultaneously.
- Dependency audit: launch agents to check different parts of the dependency tree for outdated packages, security issues, and unused imports.
- Migration planning: have agents simultaneously assess the frontend, backend, and tests to estimate the scope of a framework migration.
Notes
- Explore agents are read-only — they can't modify files.
- Use
thoroughness: "very thorough"in the prompt for comprehensive analysis. - Each agent has its own context window, so they can each read many files without running out of space.
- For a single focused question, just use Grep or SemanticSearch directly — subagents are for broad exploration.
More from spencerpauly/awesome-cursor-skills
reviewing-code
Perform a thorough code review focused on correctness, maintainability, performance, and best practices.
32saving-workspace-context
Automatically persist useful context — research, decisions, learnings, templates — to workspace files so knowledge survives across conversations.
31suggesting-cursor-rules
When the user repeats the same correction or convention multiple times, suggest a Cursor rule to encode it permanently.
31suggesting-cursor-hooks
When the user keeps asking for the same check to run (lint, tests, type-check), suggest a Cursor hook to automate it.
29database-design
Design database schemas — tables, relationships, indexes, constraints, and ORM setup. Covers relational design, normalization, and common patterns.
28monitoring-terminal-errors
Watch running terminal processes for crashes and stack traces. When an error appears, navigate to the failing file and line, diagnose, and fix it automatically.
28