docs: define researcher agent specification (#68) #166

Merged
shahondin1624 merged 2 commits from feature/issue-68-researcher-agent-spec into main 2026-03-11 06:04:03 +01:00

Summary

  • Create comprehensive researcher agent specification in specs/researcher-agent.md
  • Defines system prompt, context window structure, tool use conventions, confidence signaling, return schema mapping to SubagentResult proto, termination conditions, and agent lineage
  • Serves as the template for implementing all subagent types

Test plan

  • Specification reviewed for completeness against acceptance criteria
  • Return schema matches SubagentResult proto fields
  • Confidence signals map to ResultQuality enum values

Note: This is a Phase 8 issue (researcher agent). PR is left open for manual review as it requires model behavior validation.

Closes #68

## Summary - Create comprehensive researcher agent specification in `specs/researcher-agent.md` - Defines system prompt, context window structure, tool use conventions, confidence signaling, return schema mapping to SubagentResult proto, termination conditions, and agent lineage - Serves as the template for implementing all subagent types ## Test plan - [x] Specification reviewed for completeness against acceptance criteria - [x] Return schema matches SubagentResult proto fields - [x] Confidence signals map to ResultQuality enum values **Note**: This is a Phase 8 issue (researcher agent). PR is left open for manual review as it requires model behavior validation. Closes #68
shahondin1624 added 1 commit 2026-03-10 16:58:39 +01:00
Create comprehensive researcher agent specification covering:
- System prompt with role, capabilities, tool use format, constraints
- 6-section context window structure with compaction rules
- Token budget allocation (~4096 total)
- Tool call/result conventions with provenance headers
- Confidence signaling mapped to ResultQuality proto enum
- Return schema mapped to SubagentResult proto message
- 5 termination conditions and agent lineage structure

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
shahondin1624 added 1 commit 2026-03-11 06:04:00 +01:00
# Conflicts:
#	implementation-plans/_index.md
shahondin1624 merged commit 43cbb2a3b7 into main 2026-03-11 06:04:03 +01:00
shahondin1624 deleted branch feature/issue-68-researcher-agent-spec 2026-03-11 06:04:03 +01:00
Sign in to join this conversation.