Skip to content

Latest commit

 

History

History
702 lines (568 loc) · 30.5 KB

File metadata and controls

702 lines (568 loc) · 30.5 KB

Claude Code Agents Directory

This document provides a comprehensive overview of all available AI agents for the Labor Law Assistant project.

Quick Reference

Category Count Agents
Product & Planning 4 pm, po, ba, scrum-master
System Design 4 sa, sd, architect, cloud-architect
UI/UX Design 2 uiux, visual-designer
Development 6 frontend, backend, full-stack, app, dba, api-designer
Data & AI 3 data-engineer, data-scientist, ai-engineer
Quality 3 qa, qc, code-reviewer
Debugging 2 debugger, error-resolver
Security & Compliance 2 security, compliance
Infrastructure 5 devops, sre, cloud-architect, network, release-manager
Performance 1 performance
Accessibility & i18n 2 accessibility, i18n
Content & SEO 3 senior-technical-writer, senior-content-strategist, senior-seo
Analytics 1 senior-analytics
Leadership 1 senior-tech-lead
Domain Expert 1 senior-legal-expert
End User Support 6 senior-customer-support, senior-technical-support, user-advocate, user-researcher, user-support, senior-onboarding-specialist
Total 45

Complete Agent Reference

Sorting Note: Ordered by usage frequency in the Labor Law Assistant project, with most frequently used agents listed first.

Agent Name Role Category Key Expertise Example Task
senior-legal-expert Legal Expert Domain Expert Taiwan labor law, regulatory compliance Verify overtime calculation formulas comply with Taiwan Labor Standards Act
senior-backend Backend Engineer Development Python, Node.js, Go, Rust, APIs, databases Implement API endpoint for labor law case search
senior-frontend Frontend Engineer Development React, Vue, TypeScript, CSS, performance Build user interface for legal query form
senior-full-stack Full Stack Engineer Development End-to-end development, frontend-backend integration Implement end-to-end wage calculation feature
senior-qa QA Engineer Quality Test strategy, test automation, quality assurance Create test cases for leave calculation logic
senior-code-reviewer Code Reviewer Quality Code quality, security review, best practices Review authentication implementation for security issues
senior-ai-engineer AI/ML Engineer Data & AI LLM, RAG, prompt engineering, MLOps Improve RAG pipeline for legal document retrieval
senior-dba Database Administrator Development PostgreSQL, MySQL, MongoDB, query optimization Design database schema for labor law cases
senior-api-designer API Designer Development RESTful API, GraphQL, OpenAPI specifications Design REST API for legal consultation endpoints
senior-compliance Compliance Specialist Security & Compliance GDPR, PDPA, privacy policies, data protection Ensure user data handling complies with Taiwan PDPA
user-support User Support (Domain) End User Support Labor law Q&A, system navigation Answer user questions about severance pay calculations
senior-uiux UI/UX Designer UI/UX Design User experience, interface design, usability Improve user flow for case lookup feature
senior-debugger Debugger Debugging Root cause analysis, stack trace analysis, profiling Investigate why overtime calculation returns incorrect values
senior-error-resolver Error Resolver Debugging Runtime errors, dependency conflicts, quick fixes Fix ImportError in legal document parser
senior-security Security Engineer Security & Compliance OWASP, penetration testing, security architecture Audit API endpoints for SQL injection vulnerabilities
senior-devops DevOps Engineer Infrastructure CI/CD, Docker, Kubernetes, Infrastructure as Code Set up CI/CD pipeline for automated testing
senior-architect Software Architect System Design System architecture, technology selection, scalability Design scalable architecture for legal consultation system
senior-technical-writer Technical Writer Content & SEO API docs, user guides, README files Write API documentation for legal query endpoints
senior-i18n i18n Specialist Accessibility & i18n Internationalization, localization, multi-language Implement Traditional Chinese / English language switching
senior-accessibility Accessibility Specialist Accessibility & i18n WCAG compliance, screen readers, keyboard navigation Ensure legal query form is screen reader accessible
senior-performance Performance Engineer Performance Load testing, bottleneck analysis, optimization Optimize database queries for legal case search
senior-sre Site Reliability Engineer Infrastructure Monitoring, incident response, SLA management Set up monitoring for API uptime and response time
senior-po Product Owner Product & Planning Backlog management, sprint planning, stakeholder communication Prioritize features for next sprint (leave vs overtime)
senior-pm Product Manager Product & Planning Product strategy, roadmap, feature prioritization Define product roadmap for Q1-Q2 labor law features
senior-ba Business Analyst Product & Planning Requirement gathering, stakeholder interviews, process modeling Conduct interviews with HR professionals about their needs
senior-sa System Analyst System Design System requirements, technical specifications, process flows Write technical specification for severance calculator
senior-sd System Designer System Design System design, component design, interface design Create component diagram for legal consultation module
user-researcher User Researcher End User Support User interviews, usability testing, behavior analysis Conduct usability testing for wage calculator interface
user-advocate User Advocate End User Support User perspective, usability evaluation, UX advocacy Evaluate if legal terminology is too complex for users
senior-onboarding-specialist Onboarding Specialist End User Support User onboarding, tutorials, welcome sequences Design tutorial for first-time users of the legal query system
senior-visual-designer Visual Designer UI/UX Design Visual systems, brand guidelines, typography, colors Define color palette and typography for the application
senior-data-scientist Data Scientist Data & AI ML, statistics, predictive modeling, analysis Analyze user query patterns to improve search relevance
senior-data-engineer Data Engineer Data & AI Data pipelines, ETL, data warehouses, Spark Build ETL pipeline for importing legal regulation updates
senior-tech-lead Tech Lead Leadership Technical decisions, team guidance, technical debt Decide between PostgreSQL vs MongoDB for legal data storage
senior-qc Quality Control Quality Quality standards, process control, defect prevention Establish code quality standards for the team
senior-scrum-master Scrum Master Product & Planning Agile facilitation, sprint management, impediment removal Facilitate sprint retrospective meeting
senior-release-manager Release Manager Infrastructure Release planning, version control, change management Plan v2.0 release with new overtime calculation features
senior-cloud-architect Cloud Architect System Design Cloud architecture, multi-cloud strategy, cost optimization Design cloud infrastructure on AWS/GCP for scalability
senior-network Network Engineer Infrastructure Network architecture, load balancing, DNS Configure load balancer for high traffic during tax season
senior-customer-support Customer Support End User Support Issue handling, FAQ creation, support processes Create FAQ for common labor law questions
senior-technical-support Technical Support End User Support Technical troubleshooting, user guidance Help user troubleshoot login issues
senior-content-strategist Content Strategist Content & SEO Content planning, information architecture, editorial Plan content structure for legal knowledge base
senior-seo SEO Specialist Content & SEO Search optimization, content strategy, technical SEO Optimize site for search terms like "台灣加班費計算"
senior-analytics Analytics Specialist Analytics Product analytics, event tracking, dashboards Track which legal topics users search for most
senior-app Mobile App Engineer Development iOS, Android, React Native, Flutter Build mobile app version of labor law assistant

How to Use Agents

Basic Syntax

Use [agent-name] agent to [task description]

Usage Examples

Use senior-architect agent to review the current system architecture
Use senior-code-reviewer agent to check my recent changes
Use senior-qa agent to create test cases for the authentication module
Use senior-legal-expert agent to verify the overtime calculation content

Parallel Invocation

You can use multiple agents simultaneously for comprehensive review:

Use senior-security agent and senior-code-reviewer agent to review authentication implementation

Agent Collaboration

For complex tasks, use multiple agents in sequence:

1. Use senior-ba agent to gather requirements
2. Use senior-sa agent to create technical specification
3. Use senior-architect agent to design architecture
4. Use senior-code-reviewer agent to review implementation

Agent Selection Guide

By Task Type

Task Recommended Agent(s)
Plan new feature senior-pm, senior-po, senior-ba
Design system senior-architect, senior-sd, senior-sa
Design UI/UX senior-uiux, senior-visual-designer
Write frontend code senior-frontend, senior-full-stack
Write backend code senior-backend, senior-full-stack
Design API senior-api-designer, senior-backend
Design database senior-dba
Build AI feature senior-ai-engineer
Write tests senior-qa
Review code senior-code-reviewer
Fix bugs senior-debugger, senior-error-resolver
Security audit senior-security
Deploy application senior-devops, senior-release-manager
Monitor system senior-sre
Optimize performance senior-performance
Write documentation senior-technical-writer
Improve SEO senior-seo
Add analytics senior-analytics
Add i18n senior-i18n
Ensure accessibility senior-accessibility
Ensure compliance senior-compliance
Review legal content senior-legal-expert
Support users senior-customer-support, senior-technical-support, user-support

By Question Type

Question Recommended Agent
"How should we architect this?" senior-architect
"Is this code secure?" senior-security
"Why is this slow?" senior-performance
"Why is this failing?" senior-debugger
"How to fix this error?" senior-error-resolver
"Is this legally accurate?" senior-legal-expert
"Is this accessible?" senior-accessibility
"How to prioritize features?" senior-po, senior-pm
"What do users need?" user-researcher, senior-ba

Detailed Use Cases by Agent

This section provides multiple practical use cases for commonly used agents to help you select the most appropriate agent more precisely.

🔴 High Priority Agents

senior-legal-expert - Taiwan Labor Law Expert

When to Use:

  • Verify overtime pay calculation formulas comply with Taiwan Labor Standards Act
  • Review severance pay calculation logic for legal accuracy
  • Confirm annual leave day calculations comply with labor law regulations
  • Check labor contract templates for legal compliance
  • Verify appropriateness of legal disclaimer content

Example Commands:

Use senior-legal-expert agent to verify the overtime pay calculation logic complies with Taiwan Labor Standards Act Article 24
Use senior-legal-expert agent to review the severance pay formula for legal accuracy

senior-backend - Backend Engineer

When to Use:

  • Implement API endpoint for labor law case search
  • Design wage calculation engine business logic
  • Build backend service for legal article search functionality
  • Implement user authentication and authorization system
  • Integrate with third-party legal database APIs

Example Commands:

Use senior-backend agent to implement REST API for labor law case search
Use senior-backend agent to design the wage calculation engine business logic
Use senior-backend agent to integrate with Taiwan Ministry of Labor API

senior-frontend - Frontend Engineer

When to Use:

  • Build user interface for legal consultation forms
  • Implement interactive form for wage calculator
  • Develop case search results display page
  • Optimize frontend performance (reduce load time)
  • Implement responsive design (RWD) to support mobile devices

Example Commands:

Use senior-frontend agent to build the legal consultation form UI
Use senior-frontend agent to create an interactive wage calculator interface
Use senior-frontend agent to optimize page load performance

senior-full-stack - Full Stack Engineer

When to Use:

  • Implement complete annual leave calculation feature (frontend + backend)
  • Develop end-to-end case submission and response system
  • Build complete user profile management functionality
  • Implement real-time legal consultation chat feature
  • Develop legal document upload and analysis system

Example Commands:

Use senior-full-stack agent to implement end-to-end annual leave calculation feature
Use senior-full-stack agent to build a complete case submission and response system

senior-qa - QA Engineer

When to Use:

  • Create test cases for overtime pay calculation logic
  • Design boundary tests for annual leave calculation
  • Build automated test scripts
  • Execute regression tests to ensure new features don't break existing functionality
  • Design performance test plans

Example Commands:

Use senior-qa agent to create test cases for overtime pay calculation
Use senior-qa agent to design boundary tests for annual leave logic
Use senior-qa agent to build automated test suite for wage calculator

senior-ai-engineer - AI/ML Engineer

When to Use:

  • Optimize RAG pipeline for legal document retrieval
  • Design prompt engineering strategies to improve answer quality
  • Implement semantic search for legal articles
  • Build LLM integration for legal Q&A
  • Optimize embedding model selection and fine-tuning

Example Commands:

Use senior-ai-engineer agent to improve RAG pipeline for legal document retrieval
Use senior-ai-engineer agent to design prompt templates for legal Q&A
Use senior-ai-engineer agent to implement semantic search for labor law articles

🟡 Medium Priority Agents

senior-code-reviewer - Code Reviewer

When to Use:

  • Review authentication system security
  • Check code quality of new features
  • Ensure code adheres to project style guidelines (CLAUDE.md)
  • Identify potential performance issues
  • Perform comprehensive review before PR submission

Example Commands:

Use senior-code-reviewer agent to review the authentication implementation
Use senior-code-reviewer agent to check code quality of wage calculation module

senior-dba - Database Administrator

When to Use:

  • Design database schema for labor law cases
  • Optimize query performance for legal article search
  • Design indexing strategy to accelerate queries
  • Plan database backup and recovery strategy
  • Review SQL query performance bottlenecks

Example Commands:

Use senior-dba agent to design database schema for labor law cases
Use senior-dba agent to optimize query performance for legal article search
Use senior-dba agent to create indexing strategy for case lookup

senior-api-designer - API Designer

When to Use:

  • Design REST API specification for legal consultation
  • Define request/response format for wage calculation API
  • Create OpenAPI/Swagger documentation
  • Design API versioning strategy
  • Plan API rate limiting and authentication mechanisms

Example Commands:

Use senior-api-designer agent to design REST API specification for legal consultation
Use senior-api-designer agent to create OpenAPI documentation for wage calculator API

senior-compliance - Compliance Specialist

When to Use:

  • Ensure user data processing complies with Taiwan Personal Data Protection Act (PDPA)
  • Review privacy policy content for regulatory compliance
  • Design data encryption and access control strategies
  • Ensure GDPR compliance (if serving EU users)
  • Plan data retention and deletion policies

Example Commands:

Use senior-compliance agent to ensure user data handling complies with Taiwan PDPA
Use senior-compliance agent to review privacy policy for legal compliance

senior-uiux - UI/UX Designer

When to Use:

  • Improve user flow for case lookup
  • Design simplified legal form interface
  • Conduct user experience optimization
  • Design information architecture (IA)
  • Create interactive prototypes

Example Commands:

Use senior-uiux agent to improve user flow for case lookup feature
Use senior-uiux agent to design simplified legal consultation form
Use senior-uiux agent to create information architecture for legal knowledge base

senior-debugger - Debugger

When to Use:

  • Investigate why overtime pay calculation returns incorrect values
  • Trace root cause of test failures
  • Analyze performance bottleneck issues
  • Resolve complex bugs
  • Analyze stack traces to identify error sources

Example Commands:

Use senior-debugger agent to investigate why overtime calculation returns incorrect values
Use senior-debugger agent to trace the root cause of test failures

senior-devops - DevOps Engineer

When to Use:

  • Build CI/CD pipeline for automated testing and deployment
  • Configure Docker containerized environment
  • Set up GitHub Actions workflows
  • Establish development/testing/production environments
  • Configure automated deployment scripts

Example Commands:

Use senior-devops agent to set up CI/CD pipeline for automated testing and deployment
Use senior-devops agent to configure Docker containers for development environment
Use senior-devops agent to create GitHub Actions workflow for PR checks

🟢 Specialized Agents

senior-architect - Software Architect

When to Use:

  • Design overall system architecture
  • Select technology stack (database, framework, etc.)
  • Plan microservices architecture
  • Design system scalability strategy
  • Evaluate architectural trade-offs

Example Commands:

Use senior-architect agent to design scalable architecture for legal consultation system
Use senior-architect agent to evaluate PostgreSQL vs MongoDB for legal data storage

senior-technical-writer - Technical Writer

When to Use:

  • Write API documentation
  • Create user operation manuals
  • Write README files
  • Write developer documentation
  • Create technical specification documents

Example Commands:

Use senior-technical-writer agent to write API documentation for legal query endpoints
Use senior-technical-writer agent to create user guide for wage calculator

senior-i18n - Internationalization Specialist

When to Use:

  • Implement Traditional Chinese/English language switching
  • Design i18n architecture
  • Handle date, time, and currency format localization
  • Establish translation file management strategy
  • Review completeness of multi-language support

Example Commands:

Use senior-i18n agent to implement Traditional Chinese / English language switching
Use senior-i18n agent to design i18n architecture for multi-language support

senior-accessibility - Accessibility Specialist

When to Use:

  • Ensure forms comply with WCAG accessibility standards
  • Test screen reader compatibility
  • Implement keyboard navigation support
  • Review color contrast ratios
  • Ensure correct use of ARIA labels

Example Commands:

Use senior-accessibility agent to ensure legal query form is screen reader accessible
Use senior-accessibility agent to audit WCAG 2.1 AA compliance

user-support - Domain-Specific User Support

When to Use:

  • Answer user questions about severance pay calculations
  • Explain overtime pay calculation logic
  • Help users understand annual leave rules
  • Provide system operation guidance
  • Answer frequently asked legal questions (FAQ)

Example Commands:

Use user-support agent to answer user questions about severance pay calculations
Use user-support agent to explain overtime pay calculation logic in simple terms

Agents by Development Phase

📋 Phase 1: Planning & Requirements

Agent Role Expertise When to Use
senior-pm Product Manager Product strategy, roadmap, feature prioritization Planning product features and roadmap
senior-po Product Owner Backlog management, sprint planning, stakeholder communication Managing product backlog and sprints
senior-ba Business Analyst Requirement gathering, stakeholder interviews, process modeling Conducting requirement interviews
senior-scrum-master Scrum Master Agile facilitation, sprint management, impediment removal Running agile ceremonies

Usage Examples:

Use senior-ba agent to conduct requirement interview
Use senior-po agent to prioritize product backlog
Use senior-pm agent to create product roadmap
Use senior-scrum-master agent to facilitate sprint retrospective

🎨 Phase 2: Design

Agent Role Expertise When to Use
senior-sa System Analyst System requirements, technical specifications, process flows Writing technical specifications
senior-sd System Designer System design, component design, interface design Creating system design documents
senior-architect Software Architect System architecture, technology selection, scalability Designing system architecture
senior-cloud-architect Cloud Architect Cloud architecture, multi-cloud strategy, cost optimization Designing cloud infrastructure
senior-uiux UI/UX Designer User experience, interface design, usability Improving user experience
senior-visual-designer Visual Designer Visual systems, brand guidelines, typography, colors Creating design systems
senior-api-designer API Designer RESTful API, GraphQL, OpenAPI specifications Designing API contracts

Usage Examples:

Use senior-architect agent to design system architecture
Use senior-sd agent to create component diagrams
Use senior-uiux agent to review user flow
Use senior-visual-designer agent to define color palette
Use senior-api-designer agent to design REST API

💻 Phase 3: Development

Agent Role Expertise When to Use
senior-frontend Frontend Engineer React, Vue, TypeScript, CSS, performance Frontend development and optimization
senior-backend Backend Engineer Python, Node.js, Go, Rust, APIs, databases Backend development
senior-full-stack Full Stack Engineer End-to-end development, frontend-backend integration Full application development
senior-app Mobile App Engineer iOS, Android, React Native, Flutter Mobile app development
senior-dba Database Administrator PostgreSQL, MySQL, MongoDB, query optimization Database design and optimization
senior-data-engineer Data Engineer Data pipelines, ETL, data warehouses, Spark Building data infrastructure
senior-data-scientist Data Scientist ML, statistics, predictive modeling, analysis Data analysis and modeling
senior-ai-engineer AI/ML Engineer LLM, RAG, prompt engineering, MLOps Building AI features

Usage Examples:

Use senior-frontend agent to optimize React performance
Use senior-backend agent to design API endpoints
Use senior-full-stack agent to implement end-to-end feature
Use senior-dba agent to optimize database queries
Use senior-ai-engineer agent to improve RAG pipeline

✅ Phase 4: Quality Assurance

Agent Role Expertise When to Use
senior-qa QA Engineer Test strategy, test automation, quality assurance Creating test plans and automation
senior-qc Quality Control Quality standards, process control, defect prevention Establishing quality processes
senior-code-reviewer Code Reviewer Code quality, security review, best practices Reviewing code changes
senior-performance Performance Engineer Load testing, bottleneck analysis, optimization Performance testing and tuning
senior-accessibility Accessibility Specialist WCAG compliance, screen readers, keyboard navigation Ensuring accessibility compliance

Usage Examples:

Use senior-qa agent to create test strategy
Use senior-code-reviewer agent to review recent changes
Use senior-performance agent to analyze bottlenecks
Use senior-accessibility agent to audit WCAG compliance

🐛 Phase 5: Debugging & Troubleshooting

Agent Role Expertise When to Use
senior-debugger Debugger Root cause analysis, stack trace analysis, profiling Investigating complex bugs
senior-error-resolver Error Resolver Runtime errors, dependency conflicts, quick fixes Resolving common errors

Usage Examples:

Use senior-debugger agent to investigate test failure
Use senior-error-resolver agent to fix ImportError

🔒 Phase 6: Security & Compliance

Agent Role Expertise When to Use
senior-security Security Engineer OWASP, penetration testing, security architecture Security audits and reviews
senior-compliance Compliance Specialist GDPR, PDPA, privacy policies, data protection Ensuring regulatory compliance

Usage Examples:

Use senior-security agent to audit security vulnerabilities
Use senior-compliance agent to review privacy policy

🚀 Phase 7: Deployment & Operations

Agent Role Expertise When to Use
senior-devops DevOps Engineer CI/CD, Docker, Kubernetes, Infrastructure as Code Setting up deployment pipelines
senior-sre Site Reliability Engineer Monitoring, incident response, SLA management Ensuring system reliability
senior-release-manager Release Manager Release planning, version control, change management Coordinating releases
senior-network Network Engineer Network architecture, load balancing, DNS Network configuration

Usage Examples:

Use senior-devops agent to set up CI/CD pipeline
Use senior-sre agent to create incident response plan
Use senior-release-manager agent to plan release

📊 Phase 8: Analytics & Growth

Agent Role Expertise When to Use
senior-analytics Analytics Specialist Product analytics, event tracking, dashboards Implementing analytics
senior-seo SEO Specialist Search optimization, content strategy, technical SEO Improving search rankings
senior-content-strategist Content Strategist Content planning, information architecture, editorial Planning content strategy

Usage Examples:

Use senior-analytics agent to design tracking plan
Use senior-seo agent to audit SEO performance
Use senior-content-strategist agent to plan editorial calendar

🌐 Phase 9: Internationalization

Agent Role Expertise When to Use
senior-i18n i18n Specialist Internationalization, localization, multi-language Adding multi-language support

Usage Examples:

Use senior-i18n agent to design i18n architecture
Use senior-i18n agent to review localization readiness

📝 Phase 10: Documentation

Agent Role Expertise When to Use
senior-technical-writer Technical Writer API docs, user guides, README files Writing technical documentation

Usage Examples:

Use senior-technical-writer agent to write API documentation
Use senior-technical-writer agent to create user guide

👔 Leadership

Agent Role Expertise When to Use
senior-tech-lead Tech Lead Technical decisions, team guidance, technical debt Making technical decisions

Usage Examples:

Use senior-tech-lead agent to evaluate technology options
Use senior-tech-lead agent to plan technical roadmap

⚖️ Domain Expert

Agent Role Expertise When to Use
senior-legal-expert Legal Expert Taiwan labor law, regulatory compliance Reviewing legal content accuracy

Usage Examples:

Use senior-legal-expert agent to review labor law content
Use senior-legal-expert agent to verify legal citations

👥 End User Support

Agent Role Expertise When to Use
user-researcher User Researcher User interviews, usability testing, behavior analysis Understanding user needs
senior-customer-support Customer Support Issue handling, FAQ creation, support processes Handling user inquiries
user-advocate User Advocate User perspective, usability evaluation, UX advocacy Championing user needs
senior-technical-support Technical Support Technical troubleshooting, user guidance Helping users with technical issues
senior-onboarding-specialist Onboarding Specialist User onboarding, tutorials, welcome sequences Designing onboarding flows
user-support User Support (Domain) Labor law Q&A, system navigation Answering labor law questions

Usage Examples:

Use user-researcher agent to design user interview
Use senior-customer-support agent to create FAQ content
Use senior-onboarding-specialist agent to design welcome flow
Use user-support agent to answer labor law question

Maintenance

  • Agents are stored in .claude/agents/ directory
  • Each agent is a Markdown file with YAML frontmatter
  • To add a new agent, create a new .md file in the directory
  • To modify an agent, edit the corresponding .md file
  • Run /agents in Claude Code to view and manage agents