Communitygithub.com

PWS Client Paperwork Generator

Gera acordos de serviço, termos de retenção e formulários de consentimento/ acesso da PWS, prontos para impressão e com a marca, a partir do escopo real do cliente — um acordo por compilação, pagamento 20/80, tabela preenchível de Automações com total automático, tabelas em preto e branco, sem cálculos de desconto.

O que é PWS Client Paperwork Generator?

Esta skill gera documentação profissional e personalizada para clientes da Peak Workflow Solutions (PWS), transformando um escopo de engajamento real em contratos e formulários prontos para assinatura, com a identidade visual da empresa. Ela é projetada para ser usada diretamente no projeto do cliente, garantindo que o escopo, os preços e as notas reais estejam disponíveis durante a criação. A skill suporta a criação de acordos de serviço únicos (com pagamento 20/80), termos de retenção recorrentes (com autorização de pagamento automático e aviso de cancelamento de 30 dias) e formulários de Consentimento e Acesso do Cliente. O processo inclui a geração de documentos em formato Word (docx) com marca d'água, tabelas em preto e branco e uma estrutura padronizada, além de verificação rigorosa (conversão para PDF, visualização de páginas) para garantir que não haja erros de numeração, descontos ou valores não autorizados. A skill é especialmente útil para desenvolvedores e agentes de IA que precisam automatizar a criação de documentos legais e comerciais de forma consistente e sem erros, mantendo a integridade das informações do cliente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/pws-client-paperwork

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Gerador de Documentação para Clientes PWS

Este é o processo de documentação de integração do Diretor de Construção. Ele transforma um engajamento com escopo definido em documentos prontos para assinatura, com a marca, a partir do modelo mestre da PWS — não modelos cheios de instruções para si mesmo. Use-o a partir do projeto do próprio cliente (não do projeto geral da PWS) ao criar a documentação real desse cliente, para que seu escopo, preços e anotações reais estejam disponíveis enquanto você o preenche.

Gatilho

  • Um novo cliente está pronto para um acordo de serviços (qualquer engajamento, único ou recorrente).
  • Um cliente existente está iniciando uma nova compilação distinta (um novo SOW) além do que já assinou.
  • O engajamento de um cliente precisa de uma Autorização de Consentimento e Acesso do Cliente correspondente (sempre que a PWS precisar acessar as próprias contas/arquivos/sistemas do cliente).

Decisões centrais (tome estas antes de escrever qualquer coisa — nunca suponha)

  1. Um acordo por compilação, não um contrato gigante. Agrupe entregáveis em um único acordo apenas quando eles estiverem sendo escopados/entregues juntos, aproximadamente no mesmo cronograma. Divida em acordos separados quando os cronogramas ou a prontidão divergirem — os "80% devidos na conclusão" de um único acordo funcionam de forma limpa apenas quando tudo em seu Anexo A termina aproximadamente ao mesmo tempo. Cada acordo independente pode ser rotulado como sua própria "Fase" (Fase 1, Fase 2, ...) por meio do campo preenchível próximo ao topo do acordo, idealmente na ordem de prioridade declarada pelo cliente — isso é um rótulo em um documento completo e com preço separado, nunca uma forma de dividir o escopo de um documento em uma parte com preço e uma parte pendente sem preço.
  2. Estrutura de pagamento: trabalho único é uma taxa total fixa, 20% devidos na assinatura / 80% devidos na conclusão. A seção Taxas e Pagamento NÃO imprime seus próprios valores em dólar — ela faz referência ao Preço Total de Compilação Inicial do Anexo A como a única fonte de verdade ("a taxa total pelo Escopo do Trabalho é o Preço Total de Compilação Inicial declarado no Anexo A"). O trabalho recorrente/retido nunca é incluído nessa divisão 20/80 — ele vive em sua própria seção "Serviços Recorrentes, Pagamento Automático e Cancelamento" com autorização de pagamento automático e um aviso de cancelamento por escrito de 30 dias necessário, cobrado mensalmente.
  3. Nunca imprima cálculos de desconto. Sem comparações de tarifa padrão, sem "você está economizando X%", sem enquadramento de "tarifa de primeiro cliente" no próprio documento. Marcos apresenta qualquer desconto verbalmente quando apresenta o negócio. O documento apenas declara a taxa. Pedidos de depoimento/direitos de revenda (se usados) são independentes, não enquadrados como uma troca por um desconto.
  4. Nunca invente números. Valores de taxas, datas-alvo, horas-incluídas-por-mês, tempos de resposta — se Marcos não deu um número real, deixe como uma linha em branco para preenchimento, nunca um palpite. Extraia a linguagem de escopo real dos e-mails/notas do próprio cliente quando disponível — não parafraseie de memória se o original for acessível (verifique Gmail/Notion para isso).
  5. Conteúdo de retenção, quando aplicável: o que está incluído (monitoramento, correções de quebras causadas por mudanças em plataformas conectadas, uma cota mensal limitada de horas/ajustes), um compromisso de tempo de resposta, autorização de pagamento automático e o aviso de cancelamento de 30 dias. Preços iniciais sugeridos para aconselhar Marcos (não para imprimir): ~$150–250/mês apenas para monitoramento, até ~$350–500/mês se incluir trabalho ativo como ajuste de canal de geração de leads — sempre bem abaixo de qualquer sinal de sensibilidade a preço que o cliente já tenha dado.

Processo de construção

  1. Obtenha entradas reais. Nome legal/comercial do cliente, data de vigência (ou em branco), os itens de escopo reais (de seus e-mails/notas, não parafraseados de memória), se cada item é único ou recorrente e qualquer preço que Marcos realmente decidiu. Pergunte a ele diretamente sobre qualquer coisa ainda não decidida, em vez de adivinhar.
  2. Use o módulo de marca compartilhada (reconstrua se este ambiente não o tiver — é curto, reproduza-o do trecho abaixo em brand.js junto com uma cópia recortada do logotipo da PWS):
const BRAND = {
  navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
  bodyFont: "Times New Roman", // serifa profissional/legal universal
  headingFont: "Poppins", // sans-serif geométrica em negrito, ecoa a marca PEAK
};
function docStyles() {
  return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): imagem do logotipo + título em negrito na cor navy (fonte: BRAND.headingFont) sob uma linha laranja
// footer(): "Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com" centralizado, pequeno, cinza, linha azul no topo
// h1(texto) / h2(texto): títulos em negrito na cor navy, fonte: BRAND.headingFont

Propague ...docStyles() em cada chamada new Document({...}) para que o texto do corpo padrão seja Times New Roman; os títulos/cabeçalhos substituem explicitamente para Poppins em Negrito.

  1. Os cabeçalhos das tabelas são em preto e branco, nunca com sombreamento colorido. Uma versão anterior sombreava as células do cabeçalho em azul escuro — o texto do cabeçalho não tinha cor definida, então aparecia como preto sobre azul escuro, com baixo contraste genuíno em algumas telas. Os cabeçalhos das tabelas são apenas texto preto em negrito sobre fundo branco com bordas de grade simples. Não reintroduza uma cor de shade/preenchimento nas células do cabeçalho.

  2. Linhas em branco para preenchimento: use um espaço em branco curto dentro das células da tabela. A linha em branco padrão (U = "________________", 16 sublinhados) é para texto do corpo e células largas. Dentro de células de tabela mais estreitas (uma coluna de Cronograma, uma célula de preço da linha de Total) ela quebra em uma segunda linha e parece quebrada — use um espaço em branco mais curto lá (US = "__________", 10 sublinhados).

  3. Fluxo de seção padrão (docx-js via a skill docx): bloco de abertura/partes, então uma linha preenchível "Fase ___ — ___ (nome do engajamento)"; Serviços e Escopo do Trabalho; Prazo; Taxas e Pagamento (cláusulas numeradas: Taxa [referencia o Total do Anexo A, sem espaço em branco separado para dólar], Cronograma de Pagamento [20/80, sem espaços em branco separados para dólar], Escopo adicional vai para um novo acordo, Faturamento, Atraso no pagamento); [Serviços Recorrentes, Pagamento Automático e Cancelamento — somente se este engajamento tiver um componente de retenção]; Responsabilidades do Cliente; Acesso a Sistemas e Dados do Cliente; Propriedade Intelectual e Direitos de Revenda (Resultados específicos do cliente, Ferramentas do provedor, Depoimento, Direitos de revenda); Confidencialidade; Garantia e Isenção de Responsabilidade; Limitação de Responsabilidade; Contratante Independente; Rescisão; Lei Aplicável; Acordo Integral e Emendas; quebra de página; Anexo A; Assinaturas.

  4. Estrutura do Anexo A — sempre use esta forma:

    • Tabela "Compilações de Automação": colunas Automação | Descrição | Cronograma | Preço de Compilação Inicial. Uma linha para cada automação/entregável distinto neste engajamento — um projeto de 20 linhas obtém 20 linhas, um projeto de 2 linhas obtém 2. Quando Marcos fornece itens de linha reais (nome, descrição, cronograma, preço), preencha cada linha diretamente, em vez de deixá-la em branco. Termine com uma linha inferior, primeiras três colunas mescladas (columnSpan: 3) lendo "Preço Total de Compilação Inicial", última coluna contendo o total em dólar — some você mesmo os preços por linha inseridos em vez de deixar em branco quando cada item de linha tiver um preço real; deixe como uma linha em branco para preenchimento apenas se um ou mais itens de linha ainda não tiverem um preço decidido.
    • Seção "Retenção/Manutenção Mensal" imediatamente abaixo, sua própria tabela pequena com apenas três colunas — Frequência | Taxa | Pagamento Automático (sem coluna "Serviço"; Marcos achou pouco claro o que iria lá quando o engajamento tem apenas uma linha de retenção) — "Mensal" pré-preenchido em Frequência, uma caixa de seleção ☐ Autorizado (Seção 4.3) em Pagamento Automático. Inclua esta tabela apenas se o engajamento tiver um componente recorrente; caso contrário, afirme claramente "Nenhum serviço de manutenção ou retenção recorrente se aplica a este engajamento." em vez de excluir a seção (mantém cada Anexo A com a mesma forma).
  5. Armadilhas de numeração (específicas do docx-js, já batidas duas vezes — não repita):

    • Uma string numbering.reference conta continuamente em TODO o documento se reutilizada entre seções. Dê a cada bloco de cláusula numerada (Taxas, Recorrente, PI) seu próprio nome de referência (por exemplo, clausesFees, clausesRecurring, clausesIP), nunca uma referência "clauses" compartilhada.
    • Quando a lista de seções de um documento varia (por exemplo, seção Recorrente presente ou ausente), não digite manualmente o texto "Seção 4" / "Seção 12" — ele se desvia no momento em que seções são adicionadas ou removidas. Pré-calcule um array ordenado de chaves de seção, mapeie cada uma para seu número uma vez e interpole esse número em referências cruzadas. Veja o padrão: construa sectionOrder (incluindo condicionalmente "recurring"), então secNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), então referencie secNum.termination etc. sempre que um número de seção for mencionado no texto do corpo.
    • TableCell precisa de uma opção columnSpan passada através do seu helper cell() para construir a linha Total mesclada — não se esqueça de adicioná-la se estiver reutilizando um helper cell() mais antigo que só lida com width/shade.
  6. Construa a Autorização de Consentimento e Acesso correspondente para qualquer engajamento que envolva novos sistemas — não reutilize linhas de tabela de acesso de um engajamento antigo para uma compilação diferente. Mesma marca, mesmo padrão de tabela preto e branco preenchível (Sistema/Conta, Item Específico, Acesso Concedido, Propósito).

  7. Verifique antes de entregar — sempre: converta para PDF (o script soffice.py --headless --convert-to pdf da skill docx), renderize para JPG (pdftoppm -jpeg -r 100) e realmente Leia cada imagem de página para confirmar: marca correta, números de seção estão sequenciais e referências cruzadas correspondem, nenhuma linguagem de desconto/tarifa padrão apareceu, espaços em branco estão genuinamente em branco (não números obsoletos de um cliente anterior), nenhuma quebra de linha feia em espaços em branco curtos e o total de Compilações de Automação realmente é igual à soma de suas linhas. Nunca envie uma reconstrução sem reverificar.

  8. Entregue via SendUserFile e registre o que foi construído + quaisquer decisões de preço/estrutura no projeto/registro de construção do próprio cliente, não no projeto geral da PWS.

Verificação

  • Nenhum valor em dólar, data ou número de horas aparece no documento a menos que Marcos tenha fornecido explicitamente
  • Nenhuma linguagem de cálculo de desconto, porcentagem de economia ou "tarifa de primeiro cliente" em nenhum lugar
  • Cada serviço recorrente está sob sua própria Seção (pagamento automático + cancelamento de 30 dias), nunca dentro da divisão 20/80 de serviço único
  • Os números de seção foram lidos do PDF real renderizado, não assumidos do código
  • O Preço Total de Compilação Inicial do Anexo A é igual à soma de seus itens de linha preenchidos
  • A seção Taxas e Pagamento faz referência ao total do Anexo A em vez de imprimir seu próprio espaço em branco separado para dólar
  • Os cabeçalhos da tabela são texto preto em negrito sobre fundo branco — sem sombreamento de cor em nenhum lugar
  • A tabela de retenção tem exatamente três colunas (Frequência | Taxa | Pagamento Automático), sem coluna Serviço
  • A marca (logotipo, azul escuro/azul/laranja, corpo Times New Roman / títulos Poppins em Negrito, rodapé) corresponde em todas as páginas
  • Um lembrete foi dado de que um advogado licenciado em WA deve revisar antes que qualquer cliente realmente assine

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

PeakWorkflowSolutions/pws-portfolio

Runs an AI Assistant Discoverability Audit (GEO/AEO) for a local service business — crawler access, llms.txt, content extractability, answer-shaped content, schema.org, NAP consistency, and live citation testing — output as a findings table + prioritized action list.

PeakWorkflowSolutions/pws-portfolio

Generates client-ready contractor bids that reproduce a specific business's own template and voice exactly, changing only the job-specific content (scope, price, materials, timeline, client info). Use this skill whenever building, adapting, or troubleshooting a bid/proposal generator for a contractor business, whenever the user mentions "bid generator," "proposal generator," extracting a business's bid style, or onboarding a new contractor client for PWS's bid generation offer. Status: Complete (v1).

PeakWorkflowSolutions/pws-portfolio

Turns a new client's intake answers into a complete, ready-to-deploy PWS lead capture system package — Zap configs, the customized Claude prompt, Google Form fields, Sheet columns, and an owner's one-pager guide, all generated together from one intake conversation. Use this skill whenever onboarding a new client for PWS's missed-call lead capture system, whenever the user mentions "new client," "onboarding," "intake," or wants to set up the lead capture system for a specific business. This skill builds directly on top of lead-capture-skill — read that skill first if it's available, since this skill reuses its finalized prompt structure and system design.

PeakWorkflowSolutions/pws-portfolio

Scans top-performing content in a specific person's industry and local market, then builds a content playbook and tailored post ideas for lead generation. Use for Marcos's own content or any client's team/agents.

PeakWorkflowSolutions/pws-portfolio

Documents PWS's AI-Powered Missed Call Lead Capture System — an OpenPhone + Zapier + Claude + Google Forms/Sheets workflow that turns missed calls into captured leads automatically. Use this skill whenever building, adapting, explaining, or troubleshooting a missed-call lead capture system for a client, whenever the user mentions OpenPhone, Zapier lead capture, missed call automation, or a new client onboarding for PWS's flagship offer.

PeakWorkflowSolutions/pws-portfolio

Acts as Marcos's technical co-builder for a real PWS client automation project: diagnoses the client's actual problem, designs the solution and tool stack, and walks through building the workflow, scripts, or code step by step.

PeakWorkflowSolutions/pws-portfolio

Use when Marcos reports how a sales call went (in any wording, any time of day) so the lead's record in the Notion Prospects database gets updated.

PeakWorkflowSolutions/pws-portfolio

Use before Marcos's daily cold calls: pulls today's due leads from the Notion Prospects database and builds a researched, honest call script for each.

PeakWorkflowSolutions/pws-portfolio

Turns a recorded client meeting into a structured intake ready for the paperwork skill — pulls the Wispr Flow transcript, checks it against a fixed Scope/Timeline/Pricing/Payment/Access checklist, and publishes an interactive artifact so Marcos can fill in whatever the meeting didn't cover before it ends.

PeakWorkflowSolutions/pws-portfolio

Turns a new PWS video script/transcript into a ready-to-post batch of platform-specific social copy — the established priority channel set, brand voice, and per-platform formatting rules baked in.

PeakWorkflowSolutions/pws-portfolio

Runs the structured intake-to-demo pattern for a PWS website-build client: a fixed discovery questionnaire, a completeness check, and an auto-drafted first demo site built from the client's real answers with honest placeholders.

Habilidades Relacionadas