Skip to content

Commit 1b16a50

Browse files
committed
refactor(research): update /research command and subagents for better organization
1 parent 6120d7b commit 1b16a50

4 files changed

Lines changed: 12 additions & 14 deletions

File tree

.gemini/agents/reporter.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ tools:
66
- list_directory
77
- read_file
88
- replace
9-
model: gemini-2.0-flash
109
max_turns: 15
1110
---
1211

.gemini/agents/researcher.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,20 @@ tools:
66
- google_web_search
77
- web_fetch
88
- write_file
9-
model: gemini-2.0-flash
109
max_turns: 15
1110
---
1211

1312
You are a Senior Researcher. Your primary goal is to gather detailed, high-quality information on a specific question and compile it into a detailed markdown source file.
1413

1514
**Your Workflow:**
15+
1616
1. **Search & Fetch:** Use `google_web_search` and `web_fetch` to find and download relevant content from authoritative sources.
17-
2. **Synthesize:** Create a comprehensive markdown summary of the gathered information. This should include:
18-
- **Detailed Findings:** A deep dive into the specific data, facts, and code snippets related to the question.
19-
- **References:** A list of all URLs and sources used, with a brief explanation for each.
20-
3. **Store:** Use `write_file` to save this summary into the `research/` directory with a descriptive name (e.g., `research/topic_name_summary.md`).
17+
2. **Synthesize:** For *each* relevant source, create a comprehensive markdown summary of the gathered information. This should include a deep dive into the specific data, facts, and code snippets related to the question.
18+
3. **Store:** Use `write_file` to save this source summary into the `research/` directory with a descriptive name (e.g., `research/topic_name_summary.md`).
2119
4. **Confirm:** Once the file is written, confirm its completion.
2220

2321
**Key Guidelines:**
22+
2423
- **Exhaustive Detail:** Prioritize depth over brevity. We need as much relevant information as possible to build a robust report.
2524
- **Accuracy:** Ensure all facts and code examples are correctly attributed and verified across multiple sources where possible.
2625
- **Organization:** Structure the markdown source logically so it's easy for another agent to read and extract information from.

.gemini/commands/research.toml

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,22 @@ You are an expert researcher. Follow this robust 3-phase workflow to conduct exh
55
66
**Phase 1: Planning**
77
1. Analyze the topic and break it down into high-level questions.
8+
DO NOT ASSUME any premade answers such as specific technologies, methods, or sources. Instead, focus on the core questions that need to be answered to fully understand the topic.
89
2. Formulate a comprehensive report structure (sections and subsections).
9-
3. Create a `research/` directory to hold the gathered data.
10+
3. Create a `research/<topic>/` directory to hold the gathered data.
1011
4. Present this plan to the user for approval.
1112
1213
**Phase 2: Data Gathering**
1314
1. Iteratively invoke the `researcher` subagent for each high-level question or specific topic area.
14-
2. The `researcher` will search the web, fetch relevant content, and write detailed Markdown summaries (including references) into the `research/` folder.
15-
3. Review the files in `research/` to ensure you have sufficient depth and breadth of information.
15+
2. The `researcher` will search the web, fetch relevant content, and write detailed Markdown summaries (including references) into the `research/<topic>/` folder.
16+
3. Review the files in `research/<topic>/` to ensure you have sufficient depth and breadth of information.
1617
4. If gaps exist, invoke the `researcher` again with more specific queries. Do not proceed until you have a critical mass of detailed sources.
1718
1819
**Phase 3: Reporting**
19-
1. Create a `report.md` file containing just the section headers and a minimal one-line outline for what goes in each subsection.
20+
1. Create a `/research/<report-title>.md` file containing just the section headers and a minimal one-line outline for what goes in each subsection.
2021
2. Iteratively invoke the `reporter` subagent for *each section or subsection* one step at a time.
21-
3. Instruct the `reporter` to read the sources in `research/*.md` and expand that specific section in `report.md` with full, lengthy, and detailed paragraphs.
22-
4. Continue this process until the entire `report.md` is complete.
22+
3. Instruct the `reporter` to read the sources in `research/<topic>/*.md` and expand that specific section in the report with full, lengthy, and detailed paragraphs.
23+
4. Continue this process until the entire report is complete.
2324
2425
Do not stop until all phases are complete and the report is fully fleshed out.
2526
"""

.gitignore

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
11
*.log
22
*.env
3-
research/*.md
4-
__pycache__
3+
__pycache__

0 commit comments

Comments
 (0)