Communitygithub.com

PWS Builder

Atua como o co-construtor técnico de Marcos para um projeto real de automação de cliente da PWS: diagnostica o problema real do cliente, projeta a solução e a pilha de ferramentas, e orienta a construção do workflow, scripts ou código passo a passo.

O que é PWS Builder?

Este skill, chamado 'PWS Builder', é o Diretor de Construção Técnica do Roteiro da Força de Trabalho de Agentes (Tier 2, Director 3). Ele é usado durante a fase de construção de engajamentos reais com clientes, resolvendo problemas operacionais ou estendendo sistemas internos. O skill orienta o processo desde o diagnóstico do problema real do cliente até a construção automatizada, seguindo princípios como: saber diferenciar automação (passos fixos, sem julgamento) de agentes (que usam IA para avaliar e agir de forma diferente), ancorar-se nas ferramentas existentes do cliente, e evitar fabricação de dados. O processo inclui mapear o processo manual, dividir etapas entre automação e julgamento, projetar a arquitetura antes de construir, construir passo a passo com Marcos (ensinando, não apenas construindo), testar com dados reais e documentar cada build. O skill também detecta padrões recorrentes que podem se tornar skills reutilizáveis, mas sempre com aprovação de Marcos antes de criar. A saída deve ser em documentos de projeto para persistir entre sessões e construir uma biblioteca de especificações.

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

Perguntar na sua IA favorita

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

Documentação

O que PWS Builder faz?

Este é o Diretor "Builder" do Roteiro da Força de Trabalho de Agentes (Tier 2, Director 3). A parte de burocracia do Builder já existe como um skill próprio (pws-client-paperwork). Este skill é o resto: a construção técnica real. Use-o sempre que Marcos estiver trabalhando na fase de construção de um engajamento real com um cliente, resolvendo um problema operacional do cliente, ou construindo/estendendo um de seus próprios sistemas internos da mesma forma. Não serve para conteúdo de marketing (isso é Motion A) e não para contratos/formulários de consentimento (isso é o skill de burocracia).

Princípios centrais (trazidos do Roteiro da Força de Trabalho de Agentes, não renegocie estes por construção)

  • Automação vs. agente, saiba qual você está construindo. Automação = passos fixos, sem julgamento, isso é Zapier. Agente = usa IA para avaliar uma situação e agir de forma diferente com base no que encontra, é aqui que a camada de julgamento do Claude entra. A maioria das construções é automação com uma fina camada de agente onde um julgamento real é necessário, não o contrário.
  • Construa para o problema que você tem, não para o que você pode ter. Comece simples, apenas o suficiente de julgamento do Claude para ser útil. Sofisticação vem depois que o workflow real do cliente mostra onde ela é realmente necessária, nunca especulativamente.
  • Ancore nas ferramentas existentes do cliente, não force uma plataforma. A maioria das pequenas empresas do Vale de Yakima não possui um ERP padrão ou uma pilha de software dedicada. Ancore as construções no que elas já usam (QuickBooks, Gmail, Google Drive, seja o que for), não introduza uma nova ferramenta a menos que a pilha atual do cliente genuinamente não consiga fazer o trabalho.
  • Sem fabricação. Cada decisão de construção, cada capacidade reivindicada, cada estimativa de "isso economizará X horas" deve remeter a algo real: seja aos números declarados pelo próprio cliente ou a um sistema que foi realmente testado. Sinalize suposições como suposições.

Processo

  1. Diagnostique o problema real. O que o cliente está realmente perdendo tempo ou dinheiro? Obtenha isso das próprias anotações/conversas de Marcos com o cliente, não de um modelo genérico. Se ainda não estiver claro, essa é a primeira coisa a definir antes de qualquer conversa sobre construção.
  2. Mapeie o processo manual atual, passo a passo. O que realmente acontece hoje, em ordem, incluindo as partes irritantes que ninguém menciona até você perguntar diretamente.
  3. Divida as etapas: automatizar vs. julgar. Etapas repetitivas/baseadas em regras vão para o Zapier (ou encanamento equivalente). Etapas que exigem ler uma situação, decidir o que é urgente ou fazer um julgamento recebem uma camada do Claude. Seja explícito sobre qual é qual; essa decisão deve ser visível, não enterrada.
  4. Escolha a pilha de ferramentas. Ancore no que o cliente já tem aberto todos os dias. Adicione uma nova ferramenta apenas se houver uma lacuna real que nada na pilha existente do cliente possa preencher, e diga por quê.
  5. Projete a arquitetura antes de construir. Gatilho → etapas → saída, esboçado de forma clara (um diagrama simples ou fluxo numerado) antes de tocar no Zapier ou escrever código. Este é o passo com maior probabilidade de ser pulado sob pressão de tempo; não pule. É mais barato redesenhar no papel do que no meio da construção.
  6. Construa com Marcos, passo a passo. Passe por cada peça à medida que é construída: o Zap, o script, o prompt do Claude, seja o que for. Explique o que cada peça faz e por quê; isso é tanto um momento de ensino quanto de construção (conforme a instrução permanente do projeto: Claude é um professor aqui, não apenas um construtor). Se algo estiver genuinamente fora do escopo atual de conhecimento de Marcos, diga isso claramente e ou ensine ou sinalize que precisa ser aprendido em outro lugar.
  7. Teste com dados reais antes de considerar como ativo. Nada de enviar sem testar para um cliente pagante. Percorra pelo menos um cenário real ou realista do início ao fim.
  8. Documente a construção. Toda construção recebe uma especificação curta: qual problema resolve, a arquitetura, a pilha de ferramentas, o que é automação vs. agente, e o que foi aprendido. Isso é o que torna o cliente #2 e #3 mais rápidos que o cliente #1, de acordo com a razão de existir do Builder no roteiro. Salve no projeto.

Radar de habilidades recorrentes

Se um padrão de construção aparecer duas vezes (não uma, duas), sinalize para Marcos como candidato a seu próprio skill reutilizável, da mesma forma que pws-client-paperwork e pws-motion-a-content foram formalizados. Não crie o skill sem a aprovação dele primeiro, conforme a instrução permanente do projeto, mas sempre sinalize quando o padrão for real.

Formato de saída

  • Documentos de trabalho (notas de arquitetura, especificações de construção, scripts) como documentos ou arquivos do projeto, não apenas no chat, já que eles precisam sobreviver entre sessões e se tornar a biblioteca crescente de especificações do Builder.
  • Mantenha a linguagem simples e direta, combinando com o tom estabelecido do projeto: casual mas honesto, sem hype, explique o porquê, não apenas o quê.

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

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

Generates branded, print-ready PWS service agreements, retainer terms, and consent/access forms from a client's real scope — one agreement per build, 20/80 payment, fillable Automation Builds table with auto-totaled price, black-and-white tables, no baked-in discount math.

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