Desenvolvimento

Pipeline de 5 fases para desenvolvimento orientado a especificação: cada funcionalidade passa por Brainstorm → Define → Design → Build → Ship com revisão automática por agentes.

• •/brainstorm — Opus: exploração de ideias e alinhamento de requisitos
• •/define — Opus: extração de requisitos com Clarity Score (mínimo 12/15)
• •/design — Opus: arquitetura, manifesto de ficheiros e lista de tarefas
• •/build — Sonnet (esforço alto): implementação com ciclo implementador → revisor de spec → revisor de qualidade
• •/ship — Sonnet (esforço médio): arquivo com lições aprendidas em .claude/sdd/archive/

O agente /define avalia cada pedido em 5 dimensões (0–3 cada) antes de avançar para design. Pontuação mínima: 12/15.

• •Clareza do problema — 3 pontos
• •Utilizadores identificados — 3 pontos
• •Objetivos definidos — 3 pontos
• •Sucesso mensurável — 3 pontos
• •Âmbito delimitado — 3 pontos
• •Se < 12/15, o agente faz perguntas e pontua de novo

O /build despacha um sub-agente por tarefa. Cada tarefa passa por três revisores em sequência antes de avançar para a próxima.

• •Implementador: escreve código, corre npm run test:unit + lint, faz self-review
• •Revisor de spec: confirma que o código corresponde ao DESIGN — repete até ✅
• •Revisor de qualidade: aprova qualidade de código — repete até ✅
• •Nunca avança com problemas em aberto

Agentes disponíveis em todas as sessões Claude Code via ~/.claude/agents/. Incluem o pipeline SDD completo e revisores de qualidade.

• •Workflow: brainstorm-agent, define-agent, design-agent, build-agent, ship-agent, iterate-agent
• •Qualidade: code-reviewer, code-cleaner, code-documenter, test-generator
• •Disponíveis em qualquer projeto — não requerem configuração

Agentes específicos da plataforma com conhecimento do stack técnico e das regras de negócio do Medituga.

• •medituga-architect — decisões de arquitetura SDD (Opus)
• •supabase-specialist — migrações, RLS, autenticação iOS Safari
• •nextjs-specialist — App Router, hidratação, deploy Vercel
• •Localizados em .claude/agents/domain/ no repositório

Desenvolvimento ágil orientado por ficheiros PROMPT.md com recuperação de sessão, execução por prioridade e rastreio de progresso.

• •/dev "quero construir X" — o crafter guia a criação do PROMPT
• •/dev tasks/PROMPT_X.md — executa o PROMPT existente
• •/dev tasks/PROMPT_X.md --resume — retoma sessão interrompida
• •Tarefas com prioridade 🔴🟡🟢; progresso em .claude/dev/progress/
• •Indicado para KB, protótipos, funcionalidades simples e utilitários

4 domínios de conhecimento específicos do Medituga para orientar agentes com contexto técnico e clínico validado.

• •vaccines — PNV, calendário, regras de governança de dados clínicos
• •supabase — RLS, autenticação iOS Safari, padrões de cliente server/browser
• •nextjs-vercel — App Router, hidratação segura, Stripe via fetch direto
• •portuguese-healthcare — hierarquia EMA→INFARMED→DGS→Marina→Bruno, RGPD
• •Localizada em .claude/kb/ — limite de 150 linhas/conceito, 200/padrão