https://github.com/aget-framework/template-researcher-aget
Research template for systematic investigation and knowledge discovery - Extends Advisor archetype
https://github.com/aget-framework/template-researcher-aget
Last synced: 20 days ago
JSON representation
Research template for systematic investigation and knowledge discovery - Extends Advisor archetype
- Host: GitHub
- URL: https://github.com/aget-framework/template-researcher-aget
- Owner: aget-framework
- Created: 2025-12-29T09:51:08.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-22T08:57:11.000Z (3 months ago)
- Last Synced: 2026-02-22T13:43:17.077Z (3 months ago)
- Language: Python
- Size: 129 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Governance: governance/CHARTER.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Template: Researcher Agent
> Synthesize knowledge through literature search and documented findings
**Version**: v3.12.0 | **Archetype**: Researcher | **Skills**: 2 specialized + 15 universal
---
## Why Researcher?
The Researcher archetype expands **knowledge through systematic inquiry**. Unlike casual information gathering, researcher agents provide:
- **Literature search** — Search across sources with structured queries and citation tracking
- **Documented findings** — Record discoveries with evidence, methodology, and implications
- **Knowledge synthesis** — Connect disparate information into coherent understanding
**For evaluators**: If you need an AI that can conduct methodical research and document findings for future reference, the Researcher archetype brings scholarly rigor to your knowledge work.
**Domain knowledge that compounds**: Researcher agents build persistent understanding of your research domain — prior findings, key sources, methodological preferences, and knowledge gaps. Unlike tools that start fresh each session, your agent accumulates research context that makes each literature search more targeted and each synthesis more connected.
---
## Skills
Researcher agents come with **2 archetype-specific skills** plus the universal AGET skills.
### Archetype Skills
| Skill | Description |
|-------|-------------|
| **aget-search-literature** | Search literature with structured queries. Tracks sources, extracts key findings, and maintains citation metadata. |
| **aget-document-finding** | Document research findings with evidence, methodology, and implications. Creates persistent, searchable records. |
### Universal Skills
All AGET agents include session management, knowledge capture, and health monitoring:
- `aget-wake-up` / `aget-wind-down` — Session lifecycle
- `aget-create-project` / `aget-review-project` — Project management
- `aget-record-lesson` / `aget-record-observation` — Learning capture
- `aget-check-health` / `aget-check-kb` / `aget-check-evolution` — Health monitoring
- `aget-propose-skill` / `aget-create-skill` — Skill development
- `aget-save-state` / `aget-file-issue` — State and issue management
---
## Ontology
Researcher agents use a **formal vocabulary** of 6 concepts organized into 2 clusters:
| Cluster | Concepts |
|---------|----------|
| **Research Process** | Query, Source, Finding |
| **Knowledge Artifacts** | Citation, Synthesis, Hypothesis |
This vocabulary enables precise communication about research activities.
See: [`ontology/ONTOLOGY_researcher.yaml`](ontology/ONTOLOGY_researcher.yaml)
---
## Quick Start
```bash
# 1. Clone the template
git clone https://github.com/aget-framework/template-researcher-aget.git my-researcher-agent
cd my-researcher-agent
# 2. Configure identity
# Edit .aget/version.json:
# "agent_name": "my-researcher-agent"
# "domain": "your-domain"
# 3. Verify setup
python3 -m pytest tests/ -v
# Expected: All tests passing
```
### Try the Skills
```bash
# In Claude Code CLI
/aget-search-literature # Search for information
/aget-document-finding # Record a research finding
```
---
## What Makes Researcher Different
| Aspect | Casual Search | Researcher Agent |
|--------|---------------|------------------|
| **Search** | Ad-hoc queries | Structured literature review |
| **Sources** | Links forgotten | Citation tracking |
| **Findings** | Mental notes | Documented records |
| **Synthesis** | Implicit | Explicit knowledge connection |
| **Domain memory** | Starts fresh each session | Accumulates research expertise over time |
---
## .claude/ Directory
| Directory | Purpose | Owner |
|-----------|---------|-------|
| `.claude/skills/` | Slash command definitions | Framework + Agent |
| `.claude/agents/` | Subagent definitions | Agent |
| `.claude/rules/` | Path-scoped context rules | Agent |
Skills are provided by the template. Agents and rules directories are scaffolded for your customization.
---
## Framework Specification
| Attribute | Value |
|-----------|-------|
| **Framework** | [AGET v3.12.0](https://github.com/aget-framework/aget) |
| **Archetype** | Researcher |
| **Skills** | 17 total (2 archetype + 15 universal) |
| **Ontology** | 6 concepts, 2 clusters |
| **License** | Apache 2.0 |
---
## Learn More
- **[AGET Framework](https://github.com/aget-framework/aget)** — Core framework documentation
- **[Archetype Guide](https://github.com/aget-framework/aget/blob/main/docs/GETTING_STARTED.md)** — All 12 archetypes explained
- **[Getting Started](https://github.com/aget-framework/aget/blob/main/docs/GETTING_STARTED.md)** — Full onboarding guide
---
## Related Archetypes
| Archetype | Best For |
|-----------|----------|
| **[Analyst](https://github.com/aget-framework/template-analyst-aget)** | Data analysis and metrics |
| **[Advisor](https://github.com/aget-framework/template-advisor-aget)** | Recommendations based on research |
| **[Spec-Engineer](https://github.com/aget-framework/template-spec-engineer-aget)** | Formalizing research into specs |
---
**AGET Framework** | Apache 2.0 | [Issues](https://github.com/aget-framework/aget/issues)