jhow-studio-development

name: jhow-studio-development description: Use quando precisar de desenvolvimento de software - criar MVPs/protótipos rápidos, desenvolver frontend React/Vue, arquitetar backend/APIs, construir apps mobile, integrar AI/ML, automatizar DevOps/CI/CD, modelar banco de dados, fazer code review, escrever testes, ou design de APIs RESTful/GraphQL.

Jhow Studio Development 🚀

Skill para desenvolvimento de software completo, cobrindo desde protótipos rápidos até sistemas escaláveis em produção.

Matriz de Decisão Rápida

Instruções de Seleção de Agente

Por Fase do Projeto

1. Início de Projeto (Semana 1-2)

• Use rapid-prototyper para scaffold do projeto e funcionalidades core
• Use database-engineer para modelagem inicial do banco de dados
• Use api-designer para definição dos contratos de API

2. Desenvolvimento Ativo (Semana 2-4)

• Use frontend-developer para construção das interfaces
• Use backend-architect para implementação da lógica de negócio
• Use mobile-app-builder se houver app nativo
• Use ai-engineer para features de inteligência artificial

3. Preparação para Produção (Semana 5-6)

• Use devops-automator para CI/CD e infraestrutura
• Use test-writer-fixer para cobertura de testes
• Use code-reviewer para revisão final de qualidade

Por Tipo de Tarefa

Tarefas de Criação

• Nova funcionalidade → backend-architect + frontend-developer
• Novo app mobile → mobile-app-builder
• Feature com AI → ai-engineer
• Protótipo rápido → rapid-prototyper

Tarefas de Qualidade

• Code review → code-reviewer
• Escrever testes → test-writer-fixer
• Otimizar performance → database-engineer (queries) ou frontend-developer (UI)
• Revisar API → api-designer

Tarefas de Infraestrutura

• Setup de deploy → devops-automator
• Configurar CI/CD → devops-automator
• Modelagem de dados → database-engineer
• Design de API → api-designer

Agentes Disponíveis

🟢 rapid-prototyper

Especialista em criar MVPs e protótipos rapidamente.

• Quando usar: Novos projetos, validação de ideias, demos para stakeholders
• Stack: React/Next.js, React Native/Expo, Supabase, Tailwind, Vercel
• Entrega: Protótipo funcional deployado em dias

🔵 frontend-developer

Especialista em interfaces modernas e performáticas.

• Quando usar: Componentes React/Vue, otimização de UI, responsive design
• Stack: React, Vue, Next.js, Tailwind, TypeScript, Framer Motion
• Foco: Performance, acessibilidade, experiência do usuário

🟣 backend-architect

Arquiteto de sistemas backend escaláveis.

• Quando usar: APIs, microservices, autenticação, lógica de negócio
• Stack: Node.js, Python, Go, PostgreSQL, Redis, Docker
• Foco: Escalabilidade, segurança, arquitetura limpa

🟢 mobile-app-builder

Desenvolvedor de apps nativos e cross-platform.

• Quando usar: Apps iOS/Android, React Native, Flutter
• Stack: Swift, Kotlin, React Native, Flutter, Expo
• Foco: Performance nativa, experiência mobile, App Store

🔵 ai-engineer

Especialista em integração de AI/ML.

• Quando usar: LLMs, recomendações, visão computacional, NLP
• Stack: OpenAI, Anthropic, PyTorch, Vector DBs, RAG
• Foco: Implementação prática, otimização de custos, prompts efetivos

🟠 devops-automator

Especialista em automação e infraestrutura.

• Quando usar: CI/CD, cloud, containers, monitoramento
• Stack: GitHub Actions, Terraform, Kubernetes, AWS/GCP
• Foco: Deploys automáticos, observabilidade, segurança

🟡 database-engineer

Arquiteto de dados e otimização.

• Quando usar: Modelagem, queries lentas, indexação, migrations
• Stack: PostgreSQL, MongoDB, Redis, Prisma, Drizzle
• Foco: Performance, integridade, escalabilidade de dados

🔴 code-reviewer

Guardião da qualidade de código.

• Quando usar: Revisão de PRs, garantia de padrões, mentoria
• Foco: SOLID, testes, segurança, legibilidade
• Entrega: Feedback estruturado com sugestões concretas

🟣 test-writer-fixer

Especialista em testes automatizados.

• Quando usar: Após mudanças de código, cobertura de testes, testes quebrados
• Stack: Jest, Vitest, Pytest, Testing Library
• Foco: Manter suite de testes saudável e confiável

🔌 api-designer

Especialista em design de APIs.

• Quando usar: Design de endpoints, validação de APIs, documentação
• Foco: RESTful, GraphQL, OpenAPI, consistência
• Entrega: APIs bem documentadas e fáceis de consumir

Workflows Recomendados

Workflow: Nova Feature

1. api-designer → Definir contratos de API
2. database-engineer → Modelar dados necessários
3. backend-architect → Implementar lógica de negócio
4. frontend-developer → Construir interface
5. test-writer-fixer → Escrever testes
6. code-reviewer → Revisar código

Workflow: Novo Projeto/MVP

1. rapid-prototyper → Scaffold e funcionalidades core
2. database-engineer → Modelagem inicial
3. devops-automator → Setup de deploy
4. test-writer-fixer → Testes críticos
5. code-reviewer → Revisão antes do lançamento

Workflow: Refatoração

1. code-reviewer → Identificar problemas
2. backend-architect / frontend-developer → Executar refatoração
3. test-writer-fixer → Garantir que testes passam
4. code-reviewer → Revisar mudanças

Workflow: Performance

1. database-engineer → Otimizar queries e índices
2. frontend-developer → Otimizar renderização e bundle
3. devops-automator → Configurar caching e CDN
4. test-writer-fixer → Validar que tudo funciona

Workflow: App Mobile

1. rapid-prototyper → Protótipo validado
2. api-designer → Definir API do app
3. mobile-app-builder → Desenvolver app
4. backend-architect → Backend de suporte
5. devops-automator → CI/CD e deploy para stores

Workflow: Feature com AI

1. ai-engineer → Definir abordagem e integrar modelos
2. api-designer → Design de endpoints de AI
3. backend-architect → Implementar APIs
4. frontend-developer → Interface para interação com AI
5. test-writer-fixer → Testes de comportamento do AI

Comandos Comuns

Executar um agente específico

<agent>
  <name>frontend-developer</name>
  <task>Criar componente de dashboard com gráficos</task>
</agent>

Ou referencie diretamente:

Vou usar o [frontend-developer](references/frontend-developer.md) para construir essa interface.

Combinar múltiplos agentes

Para esta feature, vou:
1. Usar o [api-designer](references/api-designer.md) para definir o contrato
2. Depois o [backend-architect](references/backend-architect.md) para implementar
3. Finalmente o [frontend-developer](references/frontend-developer.md) para a UI

Dicas de Uso

1. Comece com o escopo certo: Protótipos → rapid-prototyper. Produção → agentes especializados.

2. Sempre revise código: Use code-reviewer antes de mergear qualquer código significativo.

3. Testes são não-negociáveis: Use test-writer-fixer após mudanças de código.

4. Design primeiro: Use api-designer antes de implementar APIs. Use database-engineer antes de criar tabelas.

5. MVP rápido, escalar depois: Protótipo com rapid-prototyper, depois refatore com agentes especializados.

6. Mobile é especializado: Apps mobile devem usar mobile-app-builder, não apenas frontend-developer.

7. AI requer expertise: Integrações LLM devem usar ai-engineer para prompts e otimização de custos.

Estrutura de Arquivos

~/.config/agents/skills/jhow-studio-development/
├── SKILL.md                          # Este arquivo
└── references/
    ├── rapid-prototyper.md           # MVPs e protótipos
    ├── frontend-developer.md         # React/Vue/Angular
    ├── backend-architect.md          # APIs e backend
    ├── mobile-app-builder.md         # iOS/Android
    ├── ai-engineer.md                # LLMs e ML
    ├── devops-automator.md           # CI/CD e infra
    ├── database-engineer.md          # Banco de dados
    ├── code-reviewer.md              # Revisão de código
    ├── test-writer-fixer.md          # Testes automatizados
    └── api-designer.md               # Design de APIs