Communitygithub.com

PWS Builder

Agit en tant que co-technicien de Marcos pour un projet réel d'automatisation client chez PWS : diagnostique le problème réel du client, conçoit la solution et la pile d'outils, puis guide la construction étape par étape du workflow, des scripts ou du code.

Qu'est-ce que PWS Builder ?

PWS Builder est le compétence 'Directeur de construction' de la feuille de route Agent Workforce (Tier 2, Directeur 3). Elle est destinée aux phases de construction techniques réelles pour les clients de PWS. Elle se concentre sur la résolution des problèmes opérationnels des clients en automatisant des processus ou en créant des agents IA. La compétence suit un processus structuré : diagnostiquer le problème réel, cartographier le processus manuel actuel, diviser les étapes en automatisation et en jugement IA, choisir la pile d'outils en fonction de l'existant du client, concevoir l'architecture avant de construire, construire étape par étape avec Marcos, tester avec des données réelles, et documenter le résultat. Elle fonctionne sur toutes les plateformes où un assistant IA de codage (comme Claude Code, Cursor, Codex) est utilisé. Les principes clés incluent : savoir si on construit une automatisation (Zapier) ou un agent (Claude), construire pour le problème réel et non spéculatif, ancrer la solution sur les outils existants du client, interdiction de fabrication (chaque affirmation doit être vérifiée), et utiliser un langage clair et direct sans hype.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait PWS Builder ?

Ceci est le "Directeur de construction" de la feuille de route Agent Workforce (Tier 2, Directeur 3). La partie administrative du Builder existe déjà en tant que compétence distincte (pws-client-paperwork). Cette compétence est le reste : la construction technique réelle. Utilisez-la chaque fois que Marcos travaille sur une phase de construction d'un engagement client réel, résout un problème opérationnel d'un client, ou construit/étend un de ses propres systèmes internes de la même manière. Pas pour le contenu marketing (c'est Motion A) ni pour les contrats/formulaires de consentement (c'est la compétence paperasse).

Principes fondamentaux (repris de la feuille de route Agent Workforce, ne les re-discutez pas à chaque construction)

  • Automatisation vs. agent, sachez ce que vous construisez. Automatisation = étapes fixes, pas de jugement, c'est Zapier. Agent = utilise l'IA pour évaluer une situation et agir différemment selon ce qu'il trouve, c'est là qu'intervient la couche de jugement de Claude. La plupart des constructions sont de l'automatisation avec une fine couche d'agent là où une véritable décision est nécessaire, pas l'inverse.
  • Construisez pour le problème que vous avez, pas pour celui que vous pourriez avoir. Commencez simple, juste assez de jugement Claude pour être utile. La sophistication vient après que le workflow réel du client montre où elle est réellement nécessaire, jamais de manière spéculative.
  • Ancrez-vous sur les outils existants du client, n'imposez pas une plateforme. La plupart des petites entreprises de Yakima Valley n'ont pas d'ERP standardisé ou de pile logicielle dédiée. Ancrez vos constructions sur ce qu'ils utilisent déjà (QuickBooks, Gmail, Google Drive, peu importe ce que c'est réellement), n'introduisez pas un nouvel outil à moins que la pile actuelle du client ne puisse vraiment pas faire le travail.
  • Pas de fabrication. Chaque décision de construction, chaque capacité revendiquée, chaque estimation "cela fera gagner X heures" doit remonter à quelque chose de réel, soit les chiffres indiqués par le client lui-même, soit un système qui a réellement été testé. Signalez les hypothèses comme telles.

Processus

  1. Diagnostiquez le vrai problème. Qu'est-ce qui fait réellement perdre du temps ou de l'argent au client ? Obtenez cela à partir des notes/échanges de Marcos avec le client, pas d'un modèle générique. Si ce n'est pas encore clair, c'est la première chose à déterminer avant toute discussion de construction.
  2. Cartographiez le processus manuel actuel, étape par étape. Que se passe-t-il réellement aujourd'hui, dans l'ordre, y compris les parties ennuyeuses que personne ne mentionne tant qu'on ne demande pas directement.
  3. Divisez les étapes : automatisation vs. jugement. Les étapes répétitives/basées sur des règles vont sur Zapier (ou l'équivalent de plomberie). Les étapes qui nécessitent de lire une situation, de décider ce qui est urgent ou de porter un jugement obtiennent une couche Claude. Soyez explicite sur ce qui est quoi, cette décision doit être visible, pas cachée.
  4. Choisissez la pile d'outils. Ancrez-vous sur ce que le client a déjà ouvert chaque jour. N'ajoutez un nouvel outil que s'il y a un vrai trou que rien dans sa pile existante ne peut combler, et dites pourquoi.
  5. Concevez l'architecture avant de construire. Déclencheur → étapes → résultat, esquissé clairement (un diagramme simple ou un flux numéroté) avant de toucher à Zapier ou d'écrire du code. C'est l'étape la plus susceptible d'être sautée sous la pression du temps, ne la sautez pas, il est moins coûteux de reconcevoir sur le papier qu'en plein milieu de la construction.
  6. Construisez avec Marcos, étape par étape. Parcourez chaque pièce au fur et à mesure qu'elle est construite : le Zap, le script, le prompt Claude, peu importe ce que c'est. Expliquez ce que chaque pièce fait et pourquoi, c'est autant un moment d'enseignement qu'une construction (conformément à la consigne permanente du projet : Claude est un enseignant ici, pas seulement un constructeur). Si quelque chose est vraiment en dehors du champ de connaissances actuel de Marcos, dites-le clairement et soit enseignez-le, soit signalez qu'il doit être appris ailleurs.
  7. Testez avec des données réelles avant de déclarer le système opérationnel. Ne livrez jamais quelque chose sans test à un client payant. Parcourez au moins un scénario réel ou réaliste de bout en bout.
  8. Documentez la construction. Chaque construction reçoit un court cahier des charges : quel problème elle résout, l'architecture, la pile d'outils, ce qui est automatisation vs. agent, et ce qui a été appris. C'est ce qui rend les clients #2 et #3 plus rapides que le client #1, conformément à la raison d'être du Builder dans la feuille de route. Enregistrez-le dans le projet.

Radar de compétences récurrentes

Si un modèle de construction apparaît deux fois (pas une fois, deux fois), signalez-le à Marcos comme candidat pour sa propre compétence réutilisable, de la même manière que pws-client-paperwork et pws-motion-a-content ont été formalisées. Ne créez pas la compétence sans son approbation d'abord, conformément à la consigne permanente du projet, mais signalez-la toujours lorsque le modèle est réel.

Format de sortie

  • Documents de travail (notes d'architecture, cahiers des charges de construction, scripts) sous forme de documents ou fichiers de projet, pas seulement dans le chat, car ils doivent survivre entre les sessions et devenir la bibliothèque croissante de spécifications du Builder.
  • Gardez le langage clair et direct, en accord avec le ton établi du projet : décontracté mais honnête, pas de battage médiatique, expliquez le pourquoi pas seulement le quoi.

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.

Skills associés