# Full-Stack Manager Guide Index
**Quick reference for all full-stack development managers.**
---
## Manager Overview
| Manager | File | Purpose | Key Focus |
|---------|------|---------|-----------|
| Frontend | [FRONTEND_MANAGER.md](./FRONTEND_MANAGER.md) | UI components, styling, state | React/Vue/Svelte, accessibility, responsive |
| Backend | [BACKEND_MANAGER.md](./BACKEND_MANAGER.md) | Server logic, middleware | Express/FastAPI/Django, error handling |
| Database | [DATABASE_MANAGER.md](./DATABASE_MANAGER.md) | Schema, migrations, queries | Prisma/TypeORM, indexing, N+1 |
| API | [API_MANAGER.md](./API_MANAGER.md) | Endpoints, protocols | REST/GraphQL, versioning, auth |
| DevOps | [DEVOPS_MANAGER.md](./DEVOPS_MANAGER.md) | CI/CD, containers | Docker, GitHub Actions, monitoring |
| Testing | [TESTING_MANAGER.md](./TESTING_MANAGER.md) | Test strategies | Unit/Integration/E2E, mocking |
| Security | [SECURITY_MANAGER.md](./SECURITY_MANAGER.md) | Auth, protection | OWASP, JWT, input validation |
| Performance | [PERFORMANCE_MANAGER.md](./PERFORMANCE_MANAGER.md) | Optimization | Caching, profiling, Core Web Vitals |
---
## MCP Tool Names
```typescript
mcp__fullstack-mcp__frontend-manager(prompt, cwd)
mcp__fullstack-mcp__backend-manager(prompt, cwd)
mcp__fullstack-mcp__database-manager(prompt, cwd)
mcp__fullstack-mcp__api-manager(prompt, cwd)
mcp__fullstack-mcp__devops-manager(prompt, cwd)
mcp__fullstack-mcp__testing-manager(prompt, cwd)
mcp__fullstack-mcp__security-manager(prompt, cwd)
mcp__fullstack-mcp__performance-manager(prompt, cwd)
```
---
## When to Use Each Manager
### Frontend Manager
- Building React/Vue/Svelte components
- Implementing state management
- Styling with Tailwind/CSS
- Accessibility improvements
- Client-side routing
- Form handling
### Backend Manager
- Express/FastAPI/Django routes
- Middleware implementation
- Service layer logic
- Error handling patterns
- File uploads
- Background jobs
### Database Manager
- Schema design
- Migrations
- Query optimization
- ORM configuration
- Connection pooling
- Transactions
### API Manager
- REST endpoint design
- GraphQL schema
- Authentication endpoints
- Rate limiting
- API documentation
- WebSocket implementation
### DevOps Manager
- Dockerfile creation
- docker-compose setup
- CI/CD pipelines
- Environment configuration
- Monitoring setup
- Deployment scripts
### Testing Manager
- Unit test implementation
- Integration tests
- E2E tests with Playwright
- Mocking strategies
- Test fixtures
- Coverage configuration
### Security Manager
- Authentication flows
- Authorization middleware
- Input validation
- CSRF protection
- Security headers
- Secret management
### Performance Manager
- Query optimization
- Caching strategies
- Bundle optimization
- Image optimization
- Load testing
- Profiling
---
## Common Patterns Across Managers
### Error Handling
```typescript
// Standard error class
class AppError extends Error {
constructor(
public message: string,
public statusCode: number = 500,
public code: string = 'INTERNAL_ERROR'
) {
super(message);
}
}
// Specific errors
class NotFoundError extends AppError {
constructor(resource: string) {
super(`${resource} not found`, 404, 'NOT_FOUND');
}
}
class ValidationError extends AppError {
constructor(message: string) {
super(message, 400, 'VALIDATION_ERROR');
}
}
```
### Validation with Zod
```typescript
import { z } from 'zod';
const schema = z.object({
email: z.string().email(),
password: z.string().min(8),
name: z.string().min(1).max(100),
});
type Input = z.infer<typeof schema>;
```
### Service Pattern
```typescript
class UserService {
constructor(private repository: UserRepository) {}
async create(input: CreateUserInput): Promise<User> {
// Validate
// Business logic
// Persist
return this.repository.create(input);
}
}
```
---
## Project Structure Templates
### Standard Full-Stack
```
project/
├── src/
│ ├── app/ # Routes/pages
│ ├── components/ # UI components
│ ├── lib/ # Utilities
│ ├── services/ # Business logic
│ └── types/ # TypeScript types
├── prisma/
│ └── schema.prisma
├── tests/
│ ├── unit/
│ ├── integration/
│ └── e2e/
├── docker-compose.yml
└── package.json
```
### Monorepo
```
project/
├── apps/
│ ├── web/
│ └── api/
├── packages/
│ ├── ui/
│ ├── database/
│ └── types/
├── docker/
├── .github/workflows/
└── turbo.json
```
---
## Quick Commands
```bash
# Development
npm run dev # Start dev server
npm run build # Production build
npm run lint # Lint code
npm run typecheck # Type check
# Testing
npm test # Run all tests
npm run test:unit # Unit tests
npm run test:e2e # E2E tests
npm run test:coverage # Coverage report
# Database
npx prisma migrate dev # Create migration
npx prisma db push # Push schema
npx prisma studio # Database GUI
# Docker
docker compose up -d # Start services
docker compose logs -f # View logs
docker compose down # Stop services
```
---
## Escalation Path
When OpenCode struggles with a task:
1. **Cycle 1**: OpenCode implements → OpenCode reviews
2. **Cycle 2**: OpenCode implements → Claude reads manager guide → Claude reviews
3. **Cycle 3**: Claude implements (with guide) → Claude reviews
See CLAUDE.md Part 3 for details.