[Enhancement] research-analyst - Gold Standard Quality Improvements

[laywill]

Gold Standard Quality Improvements

Agent: research-analyst
File: categories/10-research-analysis/research-analyst.md
Risk Level: 🟢 LOW (Safe - File changes only OR read-only)
Category: Research & Analysis
Current Focus: General research and synthesis, read-only

Current Status

This agent is classified as LOW risk because:

• ✅ Cannot execute dangerous shell commands (no Bash OR minimal Bash for safe operations)
• ✅ Limited to file system changes that are easily reversible via git
• ✅ Cannot affect production infrastructure
• ✅ Appropriate tool restrictions for its role

Opportunity for Enhancement

While this agent is already safe, it can be improved to match Gold Standard quality demonstrated by agents like penetration-tester and chaos-engineer.

Suggested Improvements

• Add research methodology frameworks
• Include source evaluation criteria
• Provide synthesis and analysis techniques
• Add literature review guidelines
• Include research reporting standards

Gold Standard Quality Checklist

Consider adding the following sections to enhance agent quality:

1. Best Practices Section

• Clear examples of high-quality output
• Common pitfalls to avoid
• Code style guidelines specific to this agent's domain

2. Quality Validation

• Self-check criteria before completing tasks
• Testing/verification recommendations
• Output quality standards

3. Workflow Optimization

• Step-by-step methodology for complex tasks
• Decision trees for common scenarios
• Integration patterns with other tools/agents

4. Documentation Quality

• More detailed examples and code snippets
• Clear success criteria for tasks
• Troubleshooting guidance

5. User Experience

• Clear communication patterns
• Progress indicators for long-running tasks
• Helpful error messages and recovery guidance

Gold Standard Reference

Model enhancements after:

• penetration-tester: Clear checklists, ethical guidelines, pre-engagement requirements
• chaos-engineer: Specific measurable criteria, structured workflows, safety-first approach
• Existing patterns: Review other agents in your category for common patterns

Acceptance Criteria

• Added or enhanced best practices section
• Included concrete examples and code snippets
• Defined clear quality criteria
• Improved workflow documentation
• Enhanced user experience elements
• Reviewed against Gold Standard examples

Benefits

Enhancing this agent to Gold Standard will:

• 📈 Improve consistency and quality of outputs
• 🎯 Provide clearer guidance for users
• 🚀 Increase agent effectiveness and efficiency
• ✨ Contribute to overall repository quality

---

Related: Security Audit Report - This agent is classified as LOW risk (safe)