Research codebase and external sources to document existing patterns before planning
Conducts comprehensive research across your codebase and external sources to document existing patterns, APIs, and implementations. Use this before planning new features to understand current architecture and verify up-to-date library usage.
/plugin marketplace add astrosteveo/claude-code-plugins/plugin install superharness@astrosteveo-plugins<research question or area of interest>You are tasked with conducting comprehensive research across the codebase AND external sources to answer user questions by spawning parallel sub-agents and synthesizing their findings.
web-researcher agent for external documentationWhen this command is invoked, respond with:
I'm ready to research the codebase. Please provide your research question or area of interest, and I'll analyze it thoroughly by exploring relevant components, connections, AND verifying current external documentation.
Then wait for the user's research query.
If the user mentions specific files (tickets, docs, configs):
Create multiple sub-agents to research different aspects concurrently:
Codebase Research Agents:
Documentation Research Agents:
.harness/ about the topic.harness/ documentsExternal Research (IMPORTANT - Don't skip this):
Key Principles:
Wait for ALL sub-agents to complete, then:
Filename format: .harness/NNN-feature-slug/research.md
.harness/003-authentication/research.mdIf researching a standalone topic (not tied to a feature):
.harness/research/YYYY-MM-DD-topic.mdDocument structure:
---
date: [ISO timestamp with timezone]
researcher: Claude
topic: "[User's Question/Topic]"
tags: [research, codebase, relevant-component-names]
status: complete
---
# Research: [User's Question/Topic]
## Research Question
[Original user query]
## Summary
[High-level documentation of what was found, answering the user's question]
## Detailed Findings
### [Component/Area 1]
- Description of what exists
- How it connects to other components
- Current implementation details (without evaluation)
### [Component/Area 2]
...
## External Documentation Findings
[What current docs/APIs say - include version numbers and links]
- Library X v2.3.4: [Key API patterns found]
- Current best practices: [Summary with sources]
## Code References
- `path/to/file.py:123` - Description of what's there
- `another/file.ts:45-67` - Description of the code block
## Architecture Documentation
[Current patterns, conventions, and design implementations]
## Related .harness/ Documents
[References to other relevant documents found]
## Open Questions
[Any areas that need further investigation]
Present findings to the user:
Research complete. I've documented my findings in:
`.harness/NNN-feature-slug/research.md`
Key discoveries:
- [Discovery 1]
- [Discovery 2]
- [Discovery 3]
External verification:
- [Library/API] is currently at version [X] (docs verified)
Please review the research before we proceed to planning.
Ready to answer follow-up questions or proceed to `/superharness:create-plan`.
If the user has follow-ups:
## Follow-up Research [timestamp]/superharness:create-plan to create an implementation plan/researchLightweight router for intelligent codebase exploration via researcher agent