Hephaestus

Use this agent when you need a comprehensive backend task completed from start to finish in a Python codebase. This includes implementation, testing, validation, and proper integration. Examples:\n\n<example>\nContext: User needs a new API endpoint implemented with full test coverage.\nuser: "I need to add a POST /api/users endpoint that creates new users with email validation"\nassistant: "I'm going to use the Task tool to launch the backend-completion-specialist agent to implement this endpoint with complete functionality and tests."\n<commentary>\nThis is a complete backend task requiring implementation, testing, and validation - perfect for the backend-completion-specialist.\n</commentary>\n</example>\n\n<example>\nContext: User has a database migration that needs implementation with proper testing.\nuser: "We need to add a new table for storing user preferences with foreign key relationships to the users table"\nassistant: "Let me use the backend-completion-specialist agent to handle this database migration completely, including migration scripts, model updates, and tests."\n<commentary>\nComplete database work from schema to tests matches the backend-completion-specialist's expertise.\n</commentary>\n</example>\n\n<example>\nContext: User needs a bug fixed in an existing backend service.\nuser: "The authentication service is throwing 500 errors when tokens expire. Can you fix this?"\nassistant: "I'll launch the backend-completion-specialist agent to diagnose and fix this authentication issue, including adding tests to prevent regression."\n<commentary>\nBug fixes requiring thorough resolution and test coverage are ideal for this agent.\n</commentary>\n</example>

Use this agent when you need to verify and update documentation files in the docs/ folder to ensure they accurately reflect the current codebase implementation and are readable/understandable. This agent should be invoked:\n\n<example>\nContext: User wants to ensure a specific documentation file is up-to-date after recent code changes.\nuser: "I just refactored the monitoring system. Can you check if docs/MONITORING_ARCHITECTURE.md is still accurate?"\nassistant: "I'll use the Task tool to launch the docs-accuracy-auditor agent to review and update the monitoring architecture documentation."\n<commentary>\nThe user is requesting documentation verification after code changes, which is exactly what the docs-accuracy-auditor agent is designed for.\n</commentary>\n</example>\n\n<example>\nContext: Proactive documentation maintenance during code review.\nuser: "Here's my implementation of the new validation system"\nassistant: "Great work on the implementation! Let me review the code first."\n<code review happens>\nassistant: "The code looks good. Now I'm going to use the Task tool to launch the docs-accuracy-auditor agent to verify that docs/validation-system.md accurately reflects your implementation."\n<commentary>\nProactively ensuring documentation stays synchronized with code changes is a best practice. The agent should be used after significant implementation work.\n</commentary>\n</example>\n\n<example>\nContext: User reports confusion about documentation.\nuser: "I'm trying to understand the trajectory monitoring system but the docs are confusing"\nassistant: "I'll use the Task tool to launch the docs-accuracy-auditor agent to review and improve the clarity of the trajectory monitoring documentation."\n<commentary>\nWhen documentation is reported as unclear or confusing, this agent should audit and improve readability.\n</commentary>\n</example>

Use this agent when you need to implement frontend features, UI components, or pages in React. This agent excels at creating visually consistent, well-designed user interfaces that align with existing design patterns in the codebase. Call this agent for tasks like 'Create a new dashboard page', 'Implement the user profile component', 'Add a settings modal', or 'Build the navigation sidebar'. The agent will autonomously review existing components for design consistency before implementation and thoroughly test the implementation using Playwright.\n\nExamples:\n\n<example>\nContext: User needs a new feature page implemented in the React frontend.\nuser: "Please create a notifications page that shows a list of user notifications with read/unread status"\nassistant: "I'm going to use the Task tool to launch the senior-react-developer agent to implement this feature with proper design consistency and testing."\n<commentary>\nSince this is a React frontend implementation task requiring UI/UX expertise and consistency with existing pages, use the senior-react-developer agent.\n</commentary>\n</example>\n\n<example>\nContext: User has just finished backend API work and needs the frontend updated.\nuser: "The API for user preferences is now ready at /api/preferences"\nassistant: "Now that the backend is ready, I'm going to use the senior-react-developer agent to create the frontend interface for managing user preferences."\n<commentary>\nProactively launching the frontend agent to complement the completed backend work, ensuring the full feature is implemented end-to-end.\n</commentary>\n</example>\n\n<example>\nContext: User mentions inconsistent styling across pages.\nuser: "The settings page looks different from the rest of the app"\nassistant: "I'll use the senior-react-developer agent to review and fix the styling inconsistencies on the settings page."\n<commentary>\nThis requires UI/UX expertise and knowledge of design consistency, making it perfect for the senior-react-developer agent.\n</commentary>\n</example>