Communitygithub.com

wshobson/antes-de-construir

Revisão de riscos de pré-lançamento de produtos e recursos para fundadores, gerentes de produto e construtores assistidos por IA. Use esta habilidade quando o usuário estiver prestes a construir uma landing page, MVP, produto SaaS, ferramenta interna, fluxo de trabalho de agente ou recurso importante e precisar verificar demanda, posicionamento, monetização, retenção, confiança, distribuição e risco de adoção antes de iniciar a implementação.

O que é antes-de-construir?

Esta habilidade, "Antes de Construir", auxilia fundadores, gerentes de produto e desenvolvedores a realizarem uma pré-análise de riscos antes de iniciar a implementação de um novo produto, recurso ou iniciativa. O objetivo não é impedir o desenvolvimento, mas sim identificar a suposição de maior risco, o menor passo de validação possível e o escopo de construção que deve ser adiado até que haja evidências mais sólidas. A habilidade é útil para qualquer plataforma de agente de IA (como Claude Code, Cursor ou Codex) que auxilie na construção de software, e funciona através de uma lista de verificação de riscos (demanda, posicionamento, monetização, retenção, confiança, distribuição e adoção) seguida por um formato de saída conciso que resume o veredito de risco, a principal suposição, a evidência a ser encontrada primeiro, o próximo passo e o que não construir ainda. A habilidade recomenda ser direto sobre evidências fracas, preferir etapas de validação menores, separar risco do produto da dificuldade de engenharia e não inventar reivindicações de mercado quando informações estão faltando.

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

Perguntar na sua IA favorita

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

Documentação

Antes de Construir

Execute uma pré-análise compacta antes da implementação. O objetivo não é bloquear a construção; é identificar a suposição de maior risco, a menor etapa de validação e o escopo de construção que deve ser adiado até que as evidências melhorem.

Quando Usar

Use esta habilidade quando um usuário pedir para construir ou lançar:

  • Um novo produto, MVP, protótipo, landing page, aplicativo SaaS, marketplace, site de conteúdo, fluxo de trabalho de agente ou ferramenta interna
  • Um recurso importante com impacto pouco claro em adoção, receita, retenção, confiança ou distribuição
  • Um ativo de lançamento público onde um posicionamento fraco pode desperdiçar esforço de desenvolvimento ou promoção

Pule esta habilidade quando a tarefa for uma correção de implementação estreita, refatoração, reparo de teste, atualização de dependência ou uma mudança já validada com critérios de aceitação claros.

Lista de Verificação de Riscos

Revise a ideia em relação a estes riscos:

  • Demanda: Existe evidência de que um comprador ou usuário específico deseja isso urgentemente?
  • Posicionamento: O usuário-alvo consegue entender o que é e por que é importante em uma frase?
  • Monetização: Existe um caminho crível para pagamento, orçamento ou valor estratégico?
  • Retenção: Existe um motivo para os usuários retornarem após a primeira tentativa?
  • Confiança: O produto requer credibilidade, acesso a dados, integrações ou mudança de comportamento que os usuários podem resistir?
  • Distribuição: Existe uma maneira repetível de alcançar o usuário-alvo?
  • Adoção de recursos: Para trabalho de recursos, o recurso mudará o comportamento do usuário ou apenas adicionará área de superfície?

Se o veredito não for óbvio, use references/risk-checklist.md para perguntas mais aprofundadas.

Formato de Saída

Mantenha a resposta curta e orientada a decisão:

  1. Veredito de risco: Baixo, médio ou alto risco, com uma frase explicando por quê.
  2. Suposição principal: A única suposição com maior probabilidade de quebrar o projeto.
  3. Evidência a encontrar primeiro: O menor sinal útil antes de construir mais.
  4. Próximo passo: Uma etapa de validação concreta ou escopo de construção reduzido.
  5. Adiar: O que ainda não construir.

Orientação

  • Seja direto sobre evidências fracas, mas evite descartar a ideia do usuário.
  • Prefira etapas de validação menores em vez de grandes planos de pesquisa.
  • Separe o risco do produto da dificuldade de engenharia.
  • Se a ideia já estiver validada, diga quais evidências a tornam de menor risco e sugira a menor fatia de implementação.
  • Se faltarem fatos, mencione a evidência faltante em vez de inventar alegações de 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.

Habilidades Relacionadas