# MCP Prompts

O MCP Server oferece 5 prompts para workflows guiados.

# Visao Geral

Prompts sao templates de conversacao que guiam tarefas complexas passo a passo.

# Prompts Disponiveis

# setup_new_project

Configura novo projeto para CI/CD.

Parametros:

Fluxo:

1. Valida repositorio existe
2. Cria estrutura de branches
3. Gera .deploy.yml
4. Registra no Runner
5. Configura primeiro deploy

Exemplo de uso:

User: Configure o projeto usuario/meu-app como frontend em app.meusite.com.br

Claude: [usa prompt setup_new_project]
        Vou configurar o projeto passo a passo:

        1. Verificando repositorio...
        2. Criando branch dist...
        3. Gerando .deploy.yml...
        [continua com cada etapa]

# diagnose_deploy

Diagnostica falha de deploy.

Parametros:

Fluxo:

1. Verifica logs recentes
2. Analisa health check
3. Verifica container
4. Analisa configuracao
5. Sugere solucoes

Exemplo de uso:

User: O deploy do meu-app falhou, pode verificar?

Claude: [usa prompt diagnose_deploy]
        Vou diagnosticar o problema:

        1. Verificando logs...
           Encontrei erro: "health check timeout"

        2. Analisando container...
           Container iniciou mas endpoint /health retorna 500

        3. Sugestao: O endpoint /health esta com erro.
           Verifique os logs do container...

# canary_workflow

Guia canary deployment completo.

Parametros:

Fluxo:

1. Verifica estado atual
2. Executa deploy da nova versao
3. Inicia com 10% de trafego
4. Monitora metricas
5. Aumenta para 50%
6. Monitora novamente
7. Promove para 100%

Exemplo de uso:

User: Quero fazer canary do meu-app com v1.1.0

Claude: [usa prompt canary_workflow]
        Vou guiar o canary deployment:

        Etapa 1: Verificando estado atual
        - Versao atual: v1.0.0 (100% trafego)

        Etapa 2: Deployando v1.1.0
        - Deploy concluido, container healthy

        Etapa 3: Iniciando canary com 10%
        - Executando: runner weight meu-app production v1.1.0 10

        Quer que eu continue para 50%?

# migrate_config

Migra configuracao para formato v1.0.0.

Parametros:

Fluxo:

1. Le configuracao atual
2. Identifica formato (legado ou v1.0.0)
3. Cria backup
4. Converte para novo formato
5. Valida nova configuracao
6. Aplica mudancas

Exemplo de uso:

User: Migre a config do meu-app para o novo formato

Claude: [usa prompt migrate_config]
        Vou migrar a configuracao:

        1. Lendo .deploy.yml atual...
           Formato detectado: legado (containers[])

        2. Criando backup...
           Salvo em .deploy.yml.backup

        3. Convertendo para v1.0.0...
           - containers[] -> instances{}
           - versioning -> keep_versions

        4. Nova configuracao:
           [mostra preview]

        Confirma a migracao?

# staging_pr

Guia deploy de PR para staging.

Parametros:

Fluxo:

1. Verifica PR existe
2. Verifica limites de staging
3. Executa deploy
4. Mostra URL de acesso
5. Explica TTL e cleanup

Exemplo de uso:

User: Crie staging para a PR 42 do meu-app

Claude: [usa prompt staging_pr]
        Vou criar o ambiente de staging:

        1. Verificando PR #42...
           Branch: feature/login
           Autor: usuario

        2. Verificando limites...
           Stagings ativos: 2/5 (OK)

        3. Criando ambiente...
           [executa runner_stage_deploy]

        Ambiente criado!
        URL: https://pr-42.staging.meusite.com.br
        TTL: 48 horas

        O ambiente sera destruido automaticamente em 2 dias.

# Quando Usar Prompts

# Diferenca entre Prompts e Tools