🍇 Vine & Wine — AI Agent Team

Specialized AI agents curated for the Vine & Wine project — a vineyard management platform built with Nuxt 3 (frontend) and Laravel (backend).

---

🚀 Tech Stack

Layer	Stack
Frontend	Nuxt 3, Vue 3, TypeScript, Pinia, Leaflet, ECharts, SCSS, i18n (PT/EN)
Backend	Laravel 12, PHP 8.4, Backpack Admin, Sanctum, Scribe (API docs)
Databases	PostgreSQL 17, MongoDB 8.0, Redis
Services	GeoServer, Meteoblue, Twilio, Firebase, OpenAI, Stripe (Cashier), FFmpeg
DevOps	Docker (Nginx, Postgres, Mongo, Redis, GeoServer), PHPStan, Rector, Pint, ESLint, Prettier

---

⚡ Quick Start

These agents use the standard .md + YAML frontmatter format — no conversion needed for either tool.

GitHub Copilot (VS Code)

# Install all agents
./scripts/install.sh --tool copilot

# Or manually copy a category
cp engineering/*.md ~/.github/agents/
cp engineering/*.md ~/.copilot/agents/

Then activate in any Copilot session:

Activate Frontend Developer and help me build a Vue component.

Claude Code

# Install all agents
./scripts/install.sh --tool claude-code

# Or manually copy a category
cp engineering/*.md ~/.claude/agents/

Then activate in any Claude Code session:

Use the Backend Architect agent to design this API endpoint.

---

🎨 Agent Roster

💻 Engineering Division

Agent	Specialty	When to Use
🎨 Frontend Developer	Vue/Nuxt, UI implementation, performance	Nuxt 3 components, Leaflet maps, ECharts, SCSS, composables
🏗️ Backend Architect	API design, database architecture, scalability	Laravel services, PostgreSQL/MongoDB schema, system design
🤖 AI Engineer	LLM integration, AI features	OpenAI integration, AI-powered features
🚀 DevOps Automator	CI/CD, Docker, infrastructure	Docker Compose, deployment pipelines, monitoring
💎 Senior Developer	Laravel/advanced patterns	Complex implementations, architecture decisions
🔒 Security Engineer	Threat modeling, secure code	OWASP compliance, Sanctum auth, vulnerability assessment
📚 Technical Writer	Developer docs, API reference	Scribe API docs, README files, onboarding guides
👁️ Code Reviewer	Code review, quality gates	PR reviews, Laravel/Vue best practices, mentoring
🗄️ Database Optimizer	Schema design, query optimization	PostgreSQL/MongoDB tuning, Eloquent optimization, indexing
🌿 Git Workflow Master	Branching strategies, conventional commits	Git workflow, history cleanup, CI-friendly branches
🛡️ SRE	Observability, reliability	Docker monitoring, Redis caching, performance tuning

🎨 Design Division

Agent	Specialty	When to Use
🎯 UI Designer	Visual design, component libraries	Vue component design, SCSS design system
🏛️ UX Architect	Information architecture, user flows	Page layouts, navigation, Leaflet map UX

🧪 Testing Division

Agent	Specialty	When to Use
⚡ Performance Benchmarker	Performance testing, optimization	Load testing, query optimization, Core Web Vitals
🔌 API Tester	API validation, integration testing	Laravel API endpoints, Sanctum auth flows, PHPUnit
♿ Accessibility Auditor	WCAG auditing	Accessibility compliance, i18n testing

📊 Product Division

Agent	Specialty	When to Use
🧭 Product Manager	Product ownership, roadmap	Feature prioritization, PRDs, roadmap planning

🎬 Project Management

Agent	Specialty	When to Use
👔 Senior Project Manager	Scoping, task management	Sprint planning, task breakdown, scope management

---

📁 Structure

vine-wine-agents/
├── engineering/          # 11 agents — backend, frontend, DevOps, security, etc.
├── design/              # 2 agents — UI designer, UX architect
├── testing/             # 3 agents — API, performance, accessibility
├── product/             # 1 agent — product manager
├── project-management/  # 1 agent — senior PM
└── scripts/             # Conversion and install utilities

---

📜 License

MIT License — Based on The Agency by @msitarzewski.