# Roles Directory

This directory contains role-specific guidance files that help Claude adopt different perspectives and expertise when working on your project.

## Purpose

Role files serve as specialized context that activates relevant knowledge areas in Claude's neural networks. You can think of them as different "hats" Claude can wear to approach problems from specific perspectives. The role system is sometimes described as giving Claude "superpowers," which is a helpful analogy for understanding how these files enhance Claude's capabilities for specific tasks.

## Usage

1. Create role files for different areas of expertise your project needs
2. Have Claude read role files before tackling specialized tasks (using `claude read roles/path-to-role.md`)
3. Combine multiple roles when tasks require cross-functional expertise

## Directory Structure

The roles directory is organized into two main sections:

- **generic/** - Core roles applicable to all projects
- **project-specific/** - Technology-specific roles organized by domain

### Generic Roles

Generic roles apply to any project type and provide foundational expertise:

- `architect.md` - System architecture and technical design
- `dev_lead.md` - Code implementation and development practices
- `project_manager.md` - Planning, progress tracking, and coordination
- `researcher.md` - Research methodologies and information gathering
- `senior_code_reviewer.md` - Code quality and best practices

### Project-Specific Roles

Project-specific roles are organized by domain and technology:

- **frontend/** - Roles for frontend technologies (React, Vue, Angular, etc.)
- **backend/** - Roles for backend technologies (NestJS, Express, Django, etc.)
- **mobile/** - Roles for mobile app development (React Native, Flutter, etc.)
- **data/** - Roles for data science and machine learning
- **devops/** - Roles for DevOps and infrastructure

## Role File Format

- Each role file should define the perspective, expertise, and approach for that role
- Role files should be written in first person to help Claude embody the perspective
- Include sections for responsibilities, skills, approach, and principles

For more detailed guidance on creating effective custom roles, see the documentation in `/references/docs/custom_role_creation.md`.

Feel free to add, modify, or remove roles based on project needs. You can use the provided `role_template.md` as a starting point for creating new roles.