Guide for choosing the right role

A selection guide and help system when you're unsure which role to use.

Usage

bash
/role-help                      # General role selection guide
/role-help <situation/problem>  # Recommended roles for specific situations
/role-help compare <Role 1>,<Role 2> # Compare roles

Basic Examples

bash
# General guidance
/role-help
→ List of available roles and their characteristics

# Situation-specific recommendation
/role-help "Concerned about API security"
→ Recommendation and usage of security role

# Role comparison
/role-help compare frontend,mobile
→ Differences and appropriate usage between frontend and mobile roles

Situation-Based Role Selection Guide

Security-Related

text
Use security role for:
✅ Implementation of login/authentication functions
✅ Security vulnerability checks for APIs
✅ Data encryption and privacy protection
✅ Security compliance verification
✅ Penetration testing

Usage: /role security

🏗️ Architecture & Design

text
Use architect role for:
✅ Evaluation of overall system design
✅ Microservices vs monolith decisions
✅ Database design and technology selection
✅ Scalability and extensibility considerations
✅ Technical debt assessment and improvement planning

Usage: /role architect

⚡ Performance Issues

text
Use performance role for:
✅ Slow applications
✅ Database query optimization
✅ Web page loading speed improvement
✅ Memory and CPU usage optimization
✅ Scaling and load countermeasures

Usage: /role performance

🔍 Problem Root Cause Investigation

text
Use analyzer role for:
✅ Root cause analysis of bugs and errors
✅ Investigation of system failures
✅ Structural analysis of complex problems
✅ Data analysis and statistical research
✅ Understanding why problems occur

Usage: /role analyzer

🎨 Frontend & UI/UX

text
Use frontend role for:
✅ User interface improvements
✅ Accessibility compliance
✅ Responsive design
✅ Usability and ease of use enhancement
✅ General web frontend technologies

Usage: /role frontend

📱 Mobile App Development

text
Use mobile role for:
✅ iOS and Android app optimization
✅ Mobile-specific UX design
✅ Touch interface optimization
✅ Offline support and synchronization functions
✅ App Store and Google Play compliance

Usage: /role mobile

👀 Code Review & Quality

text
Use reviewer role for:
✅ Code quality checks
✅ Readability and maintainability evaluation
✅ Coding convention verification
✅ Refactoring proposals
✅ PR and commit reviews

Usage: /role reviewer

🧪 Testing & Quality Assurance

text
Use qa role for:
✅ Test strategy planning
✅ Test coverage evaluation
✅ Automated test implementation guidelines
✅ Bug prevention and quality improvement measures
✅ Test automation in CI/CD

Usage: /role qa

When Multiple Roles Are Needed

🔄 multi-role (Parallel Analysis)

text
Use multi-role for:
✅ Evaluation from multiple professional perspectives
✅ Creating integrated improvement plans
✅ Comparing evaluations from different fields
✅ Organizing contradictions and overlaps

Example: /multi-role security,performance

🗣️ role-debate (Discussion)

text
Use role-debate for:
✅ Trade-offs between specialized fields
✅ Divided opinions on technology selection
✅ Making design decisions through discussion
✅ Hearing debates from different perspectives

Example: /role-debate security,performance

🤖 smart-review (Automatic Proposal)

text
Use smart-review for:
✅ Uncertainty about which role to use
✅ Wanting to know the optimal approach for current situation
✅ Choosing from multiple options
✅ Beginner indecision

Example: /smart-review

Role Comparison Table

Security Category

| Role | Main Use | Strengths | Weaknesses | | -------- | ---------------------------------------- | -------------------------------------- | ------------------------------------ | | security | Vulnerability and attack countermeasures | Threat analysis, authentication design | UX, performance | | analyzer | Root cause analysis | Logical analysis, evidence collection | Preventive measures, future planning |

Design Category

| Role | Main Use | Strengths | Weaknesses | | --------- | ------------- | ------------------------------------------- | --------------------------------------------- | | architect | System design | Long-term perspective, overall optimization | Detailed implementation, short-term solutions | | reviewer | Code quality | Implementation level, maintainability | Business requirements, UX |

Performance Category

| Role | Main Use | Strengths | Weaknesses | | ----------- | ---------------------------------- | -------------------------------------- | -------------------- | | performance | Speed improvement and optimization | Measurement, bottleneck identification | Security, UX | | qa | Quality assurance | Testing, automation | Design, architecture |

User Experience Category

| Role | Main Use | Strengths | Weaknesses | | -------- | --------- | ---------------------- | ---------------- | | frontend | Web UI/UX | Browser, accessibility | Server-side, DB | | mobile | Mobile UX | Touch, offline support | Server-side, Web |

Decision Flowchart When Unsure

text
What is the nature of the problem?
├─ Security-related → security
├─ Performance issues → performance
├─ Bug/failure investigation → analyzer
├─ UI/UX improvement → frontend or mobile
├─ Design/architecture → architect
├─ Code quality → reviewer
├─ Testing-related → qa
└─ Complex/composite → smart-review for proposal

Spans multiple fields?
├─ Want integrated analysis → multi-role
├─ Discussion/trade-offs → role-debate
└─ Unsure → smart-review

Frequently Asked Questions

Q: What's the difference between frontend and mobile roles?

text
A:
frontend: Web browser-focused, HTML/CSS/JavaScript
mobile: Mobile app-focused, iOS/Android native, React Native, etc.

For issues related to both, multi-role frontend,mobile is recommended

Q: How to choose between security and analyzer roles?

text
A:
security: Prevention of attacks and threats, security design
analyzer: Analysis of causes of existing problems, investigation

For security incident investigations, use multi-role security,analyzer

Q: What's the difference between architect and performance roles?

text
A:
architect: Long-term design of entire systems, scalability
performance: Specific speed and efficiency improvements

For performance design of large-scale systems, use multi-role architect,performance

Collaboration with Claude

bash
# Combined with situation description
/role-help
"React app page loading is slow, receiving complaints from users"

# Combined with file content
cat problem-description.md
/role-help
"Recommend the most suitable role for this problem"

# When unsure between specific options
/role-help compare security,performance
"Which role is appropriate for JWT token expiration issues?"

Notes

• For complex problems, combining multiple roles is more effective
• For urgent matters, use single role for quick response
• When unsure, it's recommended to use smart-review for automatic proposals
• The final decision should be made by the user considering the nature of the problem