GitScrum / Docs
Todas as Boas Práticas

Templates de Tarefa GitScrum | Guia Passo-a-Passo

Guia completo: criar, usar e gerenciar templates. Descrição pré-preenchida, labels, checklists, placeholders {{field}}. Seções condicionais e herança.

7 min de leitura

Templates de tarefa no GitScrum transformam como você lida com trabalho recorrente. Em vez de escrever as mesmas descrições, adicionar as mesmas labels e criar os mesmos checklists repetidamente, templates permitem capturar melhores práticas uma vez e aplicá-las instantaneamente.

Recursos do Template

RecursoDescrição
Descrição pré-preenchidaConteúdo padrão para tipo de tarefa
Labels padrãoLabels aplicadas automaticamente
ChecklistsItens passo-a-passo para completar
Campos customizadosValores pré-definidos de campo
PlaceholdersCampos dinâmicos para preencher

Criando Templates

Guia Passo-a-Passo

CRIANDO UM TEMPLATE DE TAREFA
════════════════════════════

PASSO 1: Acessar Configurações de Template
─────────────────────────────────────────
Projeto → Configurações → Templates de Tarefa
Clicar "Criar Novo Template"

PASSO 2: Informações Básicas
─────────────────────────────────────────
┌─────────────────────────────────────────────────────────┐
│  Nome do Template: [Relatório de Bug                 ] │
│  Descrição:        [Formato padrão de relatório de bug] │
│  Ícone:            [🐛 ▼]                               │
│  Categoria:        [Desenvolvimento ▼]                  │
└─────────────────────────────────────────────────────────┘

PASSO 3: Valores Padrão
─────────────────────────────────────────
┌─────────────────────────────────────────────────────────┐
│  PADRÕES:                                              │
│  ├── Labels: [bug] [needs-triage]                      │
│  ├── Responsável: [Não atribuído ▼]                    │
│  ├── Prioridade: [Médio ▼]                             │
│  ├── Esforço: [Auto-estimar ▼]                         │
│  └── Sprint: [Backlog ▼]                               │
└─────────────────────────────────────────────────────────┘

PASSO 4: Template de Descrição
─────────────────────────────────────────
[Editor Markdown com conteúdo do template]

## Ambiente
- Browser/SO: {{browser}}
- Versão: {{version}}

## Passos para Reproduzir
1. {{step1}}
2. {{step2}}

## Esperado vs Real
Esperado: {{expected}}
Real: {{actual}}

PASSO 5: Checklist
─────────────────────────────────────────
☑ Itens de Checklist Padrão:
├── ☐ Bug reproduzido
├── ☐ Prioridade avaliada
├── ☐ Correção implementada
├── ☐ Testes adicionados
└── ☐ Verificado em staging

PASSO 6: Salvar Template
─────────────────────────────────────────
[Salvar Template]

Editor de Template

EDITOR DE DESCRIÇÃO DE TEMPLATE
══════════════════════════════

RECURSOS:
├── Suporte Markdown
├── Placeholders: {{field_name}}
├── Seções condicionais
├── Blocos de código
└── Tabelas

PLACEHOLDERS:
├── {{title}} - Irá solicitar entrada
├── {{date}} - Preenche data atual automaticamente
├── {{user}} - Preenche criador automaticamente
├── {{sprint}} - Nome do sprint atual
└── {{custom_field}} - Qualquer campo customizado

EXEMPLO:
─────────────────────────────────────────
## Solicitação de Recurso

**Solicitado por:** {{requester}}
**Data:** {{date}}

### User Story
Como um {{user_type}}
Eu quero {{goal}}
Para que {{benefit}}

### Critérios de Aceitação
- [ ] {{criteria_1}}
- [ ] {{criteria_2}}
- [ ] {{criteria_3}}

### Prioridade
{{priority_justification}}
─────────────────────────────────────────

Usando Templates

Criando Tarefa de Template

USANDO UM TEMPLATE
══════════════════

MÉTODO 1: Botão Nova Tarefa
─────────────────────────────────────────
Clicar "+" → "Do Template"
Selecionar template da lista
Preencher placeholders
Criar

MÉTODO 2: Criação Rápida
─────────────────────────────────────────
Pressionar "T" (atalho teclado)
Digitar nome do template
Pressionar Enter
Preencher detalhes

MÉTODO 3: Menu de Contexto
─────────────────────────────────────────
Clicar direito na coluna do board
"Novo do Template"
Selecionar template

MÉTODO 4: Paleta de Comando
─────────────────────────────────────────
Cmd/Ctrl + K
"Criar do template: Relatório de Bug"
Enter

APÓS CRIAÇÃO:
─────────────────────────────────────────
Conteúdo do template pré-preenchido
Placeholders destacados para entrada
Modificar conforme necessário
Salvar tarefa

Seletor de Template

UI DO SELETOR DE TEMPLATE
═════════════════════════

┌─────────────────────────────────────────────────────────┐
│  Criar do Template                           [Buscar] │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  RECENTES                                               │
│  ├── 🐛 Relatório de Bug              Usado 12x        │
│  └── ✨ Solicitação de Recurso        Usado 8x         │
│                                                         │
│  DESENVOLVIMENTO                                       │
│  ├── 🐛 Relatório de Bug                               │
│  ├── ✨ Solicitação de Recurso                         │
│  ├── 🔧 Dívida Técnica                                 │
│  └── 🔬 Spike/Pesquisa                                 │
│                                                         │
│  OPERAÇÕES                                              │
│  ├── 🚀 Deployment                                     │
│  ├── 🔥 Hotfix                                         │
│  └── 🛠 Manutenção                                     │
│                                                         │
│  PROCESSO DA EQUIPE                                     │
│  ├── 📋 Planejamento de Sprint                         │
│  └── 🔄 Retrospectiva                                  │
│                                                         │
└─────────────────────────────────────────────────────────┘

Gerenciamento de Templates

Organizando Templates

ORGANIZAÇÃO DE TEMPLATES
════════════════════════

CATEGORIAS:
├── Desenvolvimento
│   ├── Relatório de Bug
│   ├── Solicitação de Recurso
│   ├── Dívida Técnica
│   └── Spike/Pesquisa
│
├── Operações
│   ├── Deployment
│   ├── Hotfix
│   └── Manutenção
│
├── Processo
│   ├── Planejamento de Sprint
│   ├── Retrospectiva
│   └── Preparação de Demo
│
└── Cliente
    ├── Solicitação do Cliente
    ├── Aprovação
    └── Entregável

PERMISSÕES:
├── Ver: Todos membros do projeto
├── Criar: Admins do projeto, leads
├── Editar: Proprietário do template, admins
└── Deletar: Apenas admins

Analytics de Template

ANALYTICS DE USO DE TEMPLATE
═══════════════════════════

┌─────────────────────────────────────────────────────────┐
│  Uso de Template (Últimos 30 dias)                     │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Template            │ Usos │ Usuários │ Tempo Médio   │
│  ────────────────────┼──────┼──────────┼──────────────  │
│  Relatório de Bug    │  42  │    8     │ 5 min         │
│  Solicitação Recurso │  28  │    6     │ 8 min         │
│  Deployment          │  12  │    3     │ 10 min        │
│  Retrospectiva       │   4  │    1     │ 15 min        │
│  Hotfix              │   3  │    2     │ 5 min         │
│                                                         │
│  TEMPO TOTAL ECONOMIZADO: ~8 horas                     │
│                                                         │
│  TEMPLATES NÃO USADOS (Considere arquivar):            │
│  ├── Template Bug Antigo (0 usos, 60 dias)            │
│  └── Recurso Legado (0 usos, 45 dias)                 │
│                                                         │
└─────────────────────────────────────────────────────────┘

Recursos Avançados

Seções Condicionais

SEÇÕES CONDICIONAIS DE TEMPLATE
══════════════════════════════

CONFIGURAÇÃO:
─────────────────────────────────────────
Ao criar do template, perguntar:
☐ Tem migração de banco?
☐ Tem feature flag?
☐ Requer revisão de segurança?

CONTEÚDO DO TEMPLATE:
─────────────────────────────────────────
## Passos Padrão de Deployment
1. Criar tag de release
2. Deploy para staging
3. Verificar staging
4. Deploy para produção

{{if has_migration}}
## Migração de Banco
- [ ] Backup do banco
- [ ] Testar migração em staging
- [ ] Executar migração em produção
- [ ] Verificar integridade dos dados
{{/if}}

{{if has_feature_flag}}
## Feature Flag
- [ ] Flag criado e configurado
- [ ] Porcentagem de rollout definida
- [ ] Kill switch testado
{{/if}}

{{if security_review}}
## Revisão de Segurança
- [ ] Checklist de segurança completo
- [ ] Pen test agendado (se major)
- [ ] Aprovação da equipe de segurança
{{/if}}

Herança de Template

HIERARQUIA DE TEMPLATE
══════════════════════

TEMPLATE DE ORGANIZAÇÃO (Base):
─────────────────────────────────────────
"Relatório de Bug da Empresa"
├── Seções de descrição padrão
├── Labels em toda empresa
└── Checklist base

TEMPLATE DE PROJETO (Estende):
─────────────────────────────────────────
"Relatório de Bug App Mobile" estende "Relatório de Bug da Empresa"
├── + Campos específicos do dispositivo
├── + Campo de versão do app
└── + Itens de checklist específicos da plataforma

USO:
├── Template da empresa usado como padrão
├── Projetos podem customizar
├── Mudanças na base propagam (opcional)
└── Overrides do projeto preservados

Melhores Práticas

Para Templates do GitScrum

  • Nomeie claramente — Propósito óbvio do nome
  • Inclua exemplos — Mostre conteúdo esperado
  • Use placeholders — Force entrada obrigatória
  • Checklist tudo — Não confie na memória
  • Revise uso — Arquive templates não usados
  • Anti-Padrões

    ERROS DE TEMPLATE:
    ✗ Templates demais (esmagador)
    ✗ Genérico demais (não útil)
    ✗ Nunca atualizado (desatualizado)
    ✗ Sem placeholders (copy-paste necessário)
    ✗ Itens chave de checklist faltando
    ✗ Templates não usados bagunçando lista
    

    Soluções Relacionadas