# AI Agent Rules and Design Skills

This repository contains dedicated guideline files to help AI agents (like Codex, Claude, OpenCode, Cursor, and Roo Code) understand the design system, frontend rules, and coding standards of this project.

The `.agents/` directory contains **188 skills** organized by category:

## Core Project Guidelines (Read First)
- **Project Rules Entry Point**: Check the [`.cursorrules`](./.cursorrules) configuration file.
- **Frontend Design & Styling**: [`frontend-design.md`](./.agents/frontend-design.md) — themes, fonts, colors, Tailwind utility classes.
- **Nuxt & Vue Standards**: [`nuxt-vue-standards.md`](./.agents/nuxt-vue-standards.md) — SFC format, Vue 3 reactivity, routing.
- **Database & Schema Rules**: [`drizzle-database.md`](./.agents/drizzle-database.md) — Drizzle ORM schemas and queries.
- **Distinctive UI Aesthetics**: [`distinctive-frontend.md`](./.agents/distinctive-frontend.md) — Cyberpunk, Brutalist, Nordic Minimalism templates.
- **Docker Development**: [`docker-development.md`](./.agents/docker-development.md) — run commands inside containers.
- **Docker Compose Creator**: [`docker-compose-creator.md`](./.agents/docker-compose-creator.md) — Docker orchestration standards.

## Development & Backend
[`api-designer.md`](./.agents/api-designer.md) · [`code-reviewer.md`](./.agents/code-reviewer.md) · [`refactor-assistant.md`](./.agents/refactor-assistant.md) · [`security-auditor.md`](./.agents/security-auditor.md) · [`perf-optimizer.md`](./.agents/perf-optimizer.md) · [`debug-helper.md`](./.agents/debug-helper.md) · [`db-schema-designer.md`](./.agents/db-schema-designer.md) · [`migration-generator.md`](./.agents/migration-generator.md) · [`sql-builder.md`](./.agents/sql-builder.md) · [`webapp-testing.md`](./.agents/webapp-testing.md) · [`rest-api-builder.md`](./.agents/rest-api-builder.md) · [`graphql-builder.md`](./.agents/graphql-builder.md) · [`vue-component.md`](./.agents/vue-component.md) · [`mcp-builder.md`](./.agents/mcp-builder.md) · [`cli-builder.md`](./.agents/cli-builder.md)

## DevOps & Infrastructure
[`github-actions.md`](./.agents/github-actions.md) · [`gitlab-ci.md`](./.agents/gitlab-ci.md) · [`jenkins-pipeline.md`](./.agents/jenkins-pipeline.md) · [`dockerfile-builder.md`](./.agents/dockerfile-builder.md) · [`docker-composer.md`](./.agents/docker-composer.md) · [`compose-creator.md`](./.agents/compose-creator.md) · [`kubernetes-helper.md`](./.agents/kubernetes-helper.md) · [`helm-chart-builder.md`](./.agents/helm-chart-builder.md) · [`terraform-writer.md`](./.agents/terraform-writer.md) · [`aws-architect.md`](./.agents/aws-architect.md) · [`gcp-architect.md`](./.agents/gcp-architect.md) · [`monitoring-setup.md`](./.agents/monitoring-setup.md) · [`alerting-config.md`](./.agents/alerting-config.md) · [`log-analyzer.md`](./.agents/log-analyzer.md)

## Documentation & Writing
[`technical-writer.md`](./.agents/technical-writer.md) · [`docs-generator.md`](./.agents/docs-generator.md) · [`markdown-pro.md`](./.agents/markdown-pro.md) · [`json-formatter.md`](./.agents/json-formatter.md) · [`seo-optimizer.md`](./.agents/seo-optimizer.md) · [`email-composer.md`](./.agents/email-composer.md) · [`internal-comms.md`](./.agents/internal-comms.md) · [`newsletter-writer.md`](./.agents/newsletter-writer.md) · [`blog-writer.md`](./.agents/blog-writer.md) · [`press-release.md`](./.agents/press-release.md) · [`proposal-writer.md`](./.agents/proposal-writer.md) · [`meeting-summarizer.md`](./.agents/meeting-summarizer.md) · [`minutes-writer.md`](./.agents/minutes-writer.md)

## Design & UX
[`design-system.md`](./.agents/design-system.md) · [`theme-factory.md`](./.agents/theme-factory.md) · [`brand-guidelines.md`](./.agents/brand-guidelines.md) · [`color-palette.md`](./.agents/color-palette.md) · [`typography-guide.md`](./.agents/typography-guide.md) · [`accessibility-checker.md`](./.agents/accessibility-checker.md) · [`icon-generator.md`](./.agents/icon-generator.md) · [`logo-designer.md`](./.agents/logo-designer.md) · [`ui-mockup.md`](./.agents/ui-mockup.md) · [`wireframe-builder.md`](./.agents/wireframe-builder.md) · [`dark-mode-converter.md`](./.agents/dark-mode-converter.md) · [`chart-designer.md`](./.agents/chart-designer.md) · [`data-viz.md`](./.agents/data-viz.md) · [`infographic-builder.md`](./.agents/infographic-builder.md)

## Data & Analytics
[`pandas-helper.md`](./.agents/pandas-helper.md) · [`data-cleaner.md`](./.agents/data-cleaner.md) · [`data-transformer.md`](./.agents/data-transformer.md) · [`etl-pipeline.md`](./.agents/etl-pipeline.md) · [`sql-analyst.md`](./.agents/sql-analyst.md) · [`dashboard-builder.md`](./.agents/dashboard-builder.md) · [`csv-analyzer.md`](./.agents/csv-analyzer.md) · [`statistical-analyzer.md`](./.agents/statistical-analyzer.md) · [`kpi-tracker.md`](./.agents/kpi-tracker.md) · [`ab-test-designer.md`](./.agents/ab-test-designer.md)

## Business & Productivity
[`project-planner.md`](./.agents/project-planner.md) · [`sprint-planner.md`](./.agents/sprint-planner.md) · [`okr-tracker.md`](./.agents/okr-tracker.md) · [`customer-success.md`](./.agents/customer-success.md) · [`market-analyzer.md`](./.agents/market-analyzer.md) · [`financial-model.md`](./.agents/financial-model.md) · [`business-plan.md`](./.agents/business-plan.md) · [`sop-builder.md`](./.agents/sop-builder.md) · [`feedback-analyzer.md`](./.agents/feedback-analyzer.md)

## Security
[`owasp-checker.md`](./.agents/owasp-checker.md) · [`dependency-auditor.md`](./.agents/dependency-auditor.md) · [`threat-modeler.md`](./.agents/threat-modeler.md) · [`vuln-scanner.md`](./.agents/vuln-scanner.md) · [`security-policy.md`](./.agents/security-policy.md) · [`secret-scanner.md`](./.agents/secret-scanner.md) · [`compliance-checker.md`](./.agents/compliance-checker.md) · [`gdpr-helper.md`](./.agents/gdpr-helper.md)

## Integrations & Automation
[`github-integration.md`](./.agents/github-integration.md) · [`jira-helper.md`](./.agents/jira-helper.md) · [`notion-integration.md`](./.agents/notion-integration.md) · [`slack-bot-builder.md`](./.agents/slack-bot-builder.md) · [`discord-bot.md`](./.agents/discord-bot.md) · [`webhook-builder.md`](./.agents/webhook-builder.md) · [`stripe-integration.md`](./.agents/stripe-integration.md) · [`zapier-workflow.md`](./.agents/zapier-workflow.md) · [`n8n-workflow.md`](./.agents/n8n-workflow.md) · [`teams-integration.md`](./.agents/teams-integration.md)

## Documents & Media
[`pdf.md`](./.agents/pdf.md) · [`docx.md`](./.agents/docx.md) · [`xlsx.md`](./.agents/xlsx.md) · [`pptx.md`](./.agents/pptx.md) · [`epub-creator.md`](./.agents/epub-creator.md) · [`latex-writer.md`](./.agents/latex-writer.md) · [`xml-parser.md`](./.agents/xml-parser.md) · [`template-engine.md`](./.agents/template-engine.md) · [`video-script.md`](./.agents/video-script.md) · [`podcast-outline.md`](./.agents/podcast-outline.md) · [`youtube-optimizer.md`](./.agents/youtube-optimizer.md) · [`midjourney-prompter.md`](./.agents/midjourney-prompter.md)

## Education & Research
[`tutorial-builder.md`](./.agents/tutorial-builder.md) · [`course-creator.md`](./.agents/course-creator.md) · [`quiz-generator.md`](./.agents/quiz-generator.md) · [`exam-prep.md`](./.agents/exam-prep.md) · [`literature-reviewer.md`](./.agents/literature-reviewer.md) · [`research-summarizer.md`](./.agents/research-summarizer.md) · [`competitive-analyst.md`](./.agents/competitive-analyst.md) · [`ux-researcher.md`](./.agents/ux-researcher.md)

---

Please read and follow these files carefully when assisting in this codebase.
