Crapule421/tiger-team

Artefatos do projeto

Os modelos seguem a prática francesa de projetos de integração (DAT, DEX, ficha MEP, PV de recette) com cabeçalhos em inglês e o nome francês entre parênteses. Eles são esqueletos: cabeçalhos, tabelas e breves orientações em itálico (_..._) a serem substituídos ou excluídos.

Quando usar cada modelo

Necessidade	Modelo	Agente líder típico	Contribuidores	Fase
Descrever a solução técnica alvo e justificar escolhas	dat.md	enterprise-architect	infra, dba, devsecops, integration, erp, ibmi	Design, atualizado até o go-live
Entregar um sistema para operações	dex.md	infra-expert	scheduling, dba, integration, ibmi, erp	Construção → antes do go-live
Planejar e executar uma implantação em produção	release-sheet.md	project-manager	todos os agentes técnicos envolvidos	Cada release
Especificar uma interface entre dois sistemas	interface-contract.md	integration-expert	erp, ibmi, dba, devsecops	Design, versionado por mudança
Solicitar e documentar fluxos de rede	flow-matrix.md	infra-expert	devsecops, integration	Design → solicitações de firewall
Esclarecer quem faz o quê	raci.md	project-manager	todos	Enquadramento, revisado por fase
Acompanhar riscos, suposições, problemas, dependências	raid.md	project-manager	todos	Projeto inteiro, revisado semanalmente
Registrar a aceitação de uma entrega	uat-signoff.md	project-manager	business owner, testadores	Final de cada campanha de aceitação
Registrar os fatos do ambiente da organização uma vez, para que todos os especialistas leiam	environment-sheet.md	project-manager (via /tiger-team:discover)	todos	Início do engajamento, mantido atualizado

Como instanciar um modelo

1. Leia o modelo em seu caminho completo (índice abaixo).
2. Escreva a instância no projeto do usuário (pergunte onde se não houver convenção), ex.: docs/<deliverable>/<ID>-<short-name>.md; nunca modifique o modelo em si.
3. Preencha cada <placeholder>; mantenha um marcador TBD (owner, date) para qualquer coisa desconhecida, em vez de inventá-la.
4. Exclua linhas de orientação em itálico assim que uma seção for preenchida; exclua seções opcionais que não se aplicam, declarando "N/A: " onde um auditor as esperaria.
5. Verifique a consistência com artefatos relacionados (mesmos IDs, versões, hostnames, proprietários).

Regras de redação (todos os artefatos)

• Controle de documento primeiro: bloco de identificação, tabela de versões (versão, data, autor, alterações), revisores e aprovadores com datas. Versões: 0.x rascunhos, 1.0 primeira aprovada, 1.x atualizações menores, 2.0 mudança estrutural. Status: Rascunho / Em revisão / Aprovado / Obsoleto.
• Público-alvo: declare-o no topo (arquitetos, operadores, negócios, auditores, comitê de homologação) e escreva para ele: operadores precisam de comandos e limites, patrocinadores precisam de decisões e riscos.
• Rastreabilidade: vincule cada elemento de design, caso de teste e reserva a IDs de requisitos, ADRs, tickets ou itens RAID. Use IDs estáveis em todos os artefatos — itens: REQ-, ADR- (quatro dígitos, ADR-0001), INT- (interfaces), FLW- (fluxos), JOB-, MON- (verificações de monitoramento), KE- (erros conhecidos), RSK-, ASM-, ISS-, DEP-, TC-, DEF-, RES- (reservas), PRE- / GNG- / RB- (pré-requisitos de release, pontos de verificação go/no-go, etapas de rollback); documentos: DAT-, DEX-, FLM- (matriz de fluxos), REL- (release), PVR- (PV de recette), RACI-, RAID-.
• Sem dados reais: hostnames fictícios, faixas de IP de documentação (RFC 5737), placeholders para segredos, exemplos sintéticos, nomes de papéis genéricos em vez de detalhes de contato pessoais. Aplique as regras de confidencialidade do skill sector-compliance; um artefato descrevendo um sistema classificado ou de Diffusion Restreinte é escrito dentro do ambiente protegido, não aqui.
• Rótulo de classificação: coloque o rótulo de sensibilidade do documento da organização no cabeçalho (ex.: Interno, Confidencial); artefatos descrevendo segurança de produção (matriz de fluxos, seções de segurança do DAT) são geralmente pelo menos Confidenciais.
• Precisão: datas no formato ISO 8601 (2026-10-22), horários com fuso horário (21:30 Europe/Paris), volumes com unidades e período (120 000 msg/dia, pico 40 msg/s), durações explícitas (RTO 4 h).
• Fonte única da verdade: referencie outros artefatos em vez de copiá-los (o DAT vincula contratos de interface e a matriz de fluxos; o DEX vincula o DAT).
• Decisões e evidências: registre quem decidiu o quê e quando; artefatos são evidências de auditoria (DORA, ACPR, PCI DSS, HDS, homologação).
• Idioma: cabeçalhos em inglês; mantenha termos franceses entre parênteses quando forem o nome contratual ou regulatório (MEP, PV de recette, réserves).
• Cada documento preenchido deve ser revisável: tabelas em vez de prosa, um fato por linha, sem linguagem de marketing.

Índice de modelos

• templates/dat.md — Documento de Arquitetura Técnica (Dossier d'Architecture Technique) — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dat.md
• templates/dex.md — Manual de Operações (Dossier d'Exploitation): run book, monitoramento, batch, backups, reinicialização, contatos, escalonamento — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dex.md
• templates/release-sheet.md — Ficha de MEP (Fiche de mise en production, fiche MEP): planilha de execução cronometrada, proprietários, go/no-go, rollback — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/release-sheet.md
• templates/interface-contract.md — Contrato de Interface (Contrat d'interface): partes, gatilho, transporte, formato, mapeamento, volumetria, SLAs, erros e replay, segurança, monitoramento, testes — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/interface-contract.md
• templates/flow-matrix.md — Matriz de Fluxos de Rede (Matrice des flux) com lista de verificação de revisão — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/flow-matrix.md
• templates/raci.md — Matriz RACI (Matrice RACI) — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raci.md
• templates/raid.md — Log RAID (Registre des risques, hypothèses, problèmes et dépendances) — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raid.md
• templates/uat-signoff.md — Termo de Aceitação UAT (Procès-verbal de recette): escopo, resumo da campanha, defeitos, reservas, decisão, assinaturas — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/uat-signoff.md
• templates/environment-sheet.md — Ficha de Ambiente (Fiche d'environnement): fatos sobre o ambiente da organização por domínio, com fontes e pontos em aberto; reside em docs/tiger-team/environment.md — caminho completo ${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/environment-sheet.md