Communitygithub.com

wshobson/before-you-build

Revisión de riesgos de producto y características antes de construir, para fundadores, gerentes de producto y constructores asistidos por IA.

¿Qué es before-you-build?

Este skill, 'Before You Build' (Antes de Construir), está diseñado para ayudar a fundadores, gerentes de producto y desarrolladores asistidos por IA a realizar una autopsia previa rápida antes de comenzar la implementación de un producto, MVP, página de aterrizaje, flujo de trabajo de agente o función importante. Su objetivo no es bloquear el desarrollo, sino identificar el supuesto de mayor riesgo, el paso de validación más pequeño y el alcance de construcción que debería retrasarse hasta que haya más evidencia. Útil para prevenir errores costosos en demanda, posicionamiento, monetización, retención, confianza, distribución y adopción de funciones. Se integra en plataformas como Claude Code, Cursor y Codex, proporcionando una lista de verificación de riesgos estructurada y un formato de salida conciso y orientado a decisiones. Funciona guiando al usuario a través de un análisis de riesgos en siete áreas clave (demanda, posicionamiento, monetización, retención, confianza, distribución y adopción de funciones), y produce un veredicto de riesgo, el supuesto principal, la evidencia a buscar primero, el siguiente paso concreto y lo que se debe retrasar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/plugins/before-you-build/skills/before-you-build

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Before You Build (Antes de Construir)

Realiza una autopsia previa compacta antes de la implementación. El objetivo no es bloquear la construcción; es identificar el supuesto de mayor riesgo, el paso de validación más pequeño y el alcance de construcción que debería retrasarse hasta que mejore la evidencia.

Cuándo Usarlo

Usa este skill cuando un usuario pida construir o lanzar:

  • Un nuevo producto, MVP, prototipo, página de aterrizaje, aplicación SaaS, marketplace, sitio de contenido, flujo de trabajo de agente o herramienta interna.
  • Una función importante con impacto poco claro en adopción, ingresos, retención, confianza o distribución.
  • Un activo de lanzamiento público donde un posicionamiento débil podría desperdiciar el esfuerzo de desarrollo o promoción.

Omite este skill cuando la tarea sea una corrección de implementación específica, refactorización, reparación de pruebas, actualización de dependencias o un cambio ya validado con criterios de aceptación claros.

Lista de Verificación de Riesgos

Revisa la idea a través de estos riesgos:

  • Demanda: ¿Hay evidencia de que un comprador o usuario específico necesita esto con urgencia?
  • Posicionamiento: ¿Puede el usuario objetivo entender qué es y por qué es importante en una sola frase?
  • Monetización: ¿Hay un camino creíble hacia el pago, presupuesto o valor estratégico?
  • Retención: ¿Hay una razón por la que los usuarios regresarían después del primer intento?
  • Confianza: ¿El producto requiere credibilidad, acceso a datos, integraciones o cambio de comportamiento que los usuarios podrían resistir?
  • Distribución: ¿Hay una forma repetible de llegar al usuario objetivo?
  • Adopción de la función: Para trabajo en funciones, ¿cambiará la función el comportamiento del usuario o solo añadirá superficie?

Si el veredicto no es obvio, usa references/risk-checklist.md para preguntas más profundas.

Formato de Salida

Mantén la respuesta breve y orientada a decisiones:

  1. Veredicto de riesgo: Bajo, medio o alto riesgo, con una frase que explique por qué.
  2. Supuesto principal: El único supuesto con más probabilidades de romper el proyecto.
  3. Evidencia a buscar primero: La señal útil más pequeña antes de construir más.
  4. Siguiente paso: Un paso de validación concreto o un alcance de construcción reducido.
  5. Retraso: Qué no construir todavía.

Orientación

  • Sé directo sobre la evidencia débil, pero evita descartar la idea del usuario.
  • Prefiere pasos de validación más pequeños sobre grandes planes de investigación.
  • Separa el riesgo del producto de la dificultad técnica.
  • Si la idea ya está validada, di qué evidencia la hace de menor riesgo y sugiere el fragmento de implementación más pequeño.
  • Si faltan hechos, nombra la evidencia faltante en lugar de inventar afirmaciones del mercado.

Individual skills in this repo

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

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

wshobson/changelog-automation

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

Skills relacionados