espasyoMLS Development Assistant
Specialized assistant for developing the espasyoMLS monorepo project, which contains shared scripts and configuration for the espasyoMLS platform.
Purpose
This skill provides context-aware coding assistance for the espasyoMLS monorepo, ensuring code follows project conventions and leverages the active technology stack effectively.
Technology Stack
Active Technologies
**TypeScript (ES2022)** with Next.js 15 (App Router)**Go** for backend services**Frontend**: shadcn/ui, TailwindCSS, Zustand (state management)**Authentication**: NextAuth.js**Forms**: React Hook Form with Zod validation**Infrastructure**: Docker, Docker Compose**Database**: In-memory storage (development), PostgreSQL (production)Instructions
When assisting with espasyoMLS development, follow these guidelines:
1. Project Structure
Maintain the standard structure: `src/` for source code, `tests/` for test filesOrganize code according to Next.js 15 App Router conventionsKeep shared scripts and configuration centralized in the monorepo2. Code Style Standards
**TypeScript**: Follow ES2022 standards and TypeScript best practices**Go**: Follow standard Go conventions and idiomsUse consistent naming conventions across the codebaseMaintain type safety throughout TypeScript code3. Frontend Development
Use shadcn/ui components as the primary UI libraryStyle with TailwindCSS utility classesManage global state with Zustand when appropriateImplement forms using React Hook Form with Zod schema validationFollow Next.js 15 App Router patterns (Server Components by default, Client Components when needed)4. Backend Development
Write Go backend services following standard conventionsEnsure proper error handling and loggingUse PostgreSQL for production database operationsImplement in-memory storage for development/testing5. Docker & Infrastructure
Use Docker Compose for local development orchestrationWrite shell scripts for common development tasksMaintain YAML configuration files with proper formattingFollow containerization best practices6. Authentication & Security
Implement authentication using NextAuth.jsFollow security best practices for credential handlingValidate all user input with Zod schemas7. Testing & Quality
Run `npm test` to execute test suiteRun `npm run lint` before committing codeWrite tests for new features and bug fixesMaintain high test coverage for critical paths8. Recent Updates Context
**005-i-want-to**: Added comprehensive form handling stack (React Hook Form, Zod)**004-standardize-the-docker**: Standardized Docker setup across services**002-create-3-dashboard**: Established dashboard architecture with Next.js 15Commands
```bash
Run tests
npm test
Lint code
npm run lint
Docker operations (inferred from tech stack)
docker-compose up
docker-compose down
```
Best Practices
1. **Never propose changes to code you haven't read** - Always examine existing code before suggesting modifications
2. **Follow TypeScript standards** - Use proper typing, avoid `any`, leverage ES2022 features
3. **Maintain consistency** - Match existing code style and architecture patterns
4. **Prioritize security** - Validate inputs, sanitize outputs, follow OWASP guidelines
5. **Document as you go** - Add comments for complex logic, update documentation when needed
6. **Test thoroughly** - Write tests for new features, run the test suite before committing
Notes
This is a monorepo containing shared configuration - changes may affect multiple servicesDatabase setup differs between environments (in-memory for dev, PostgreSQL for prod)Follow the established patterns from recent features (002, 004, 005) when adding new functionality