Communitygithub.com

wshobson/before-you-build

제품 및 기능 구축 전 리스크 검토를 위한 스킬로, 창업자, 제품 관리자, AI 기반 개발자가 랜딩 페이지, MVP, SaaS 제품, 내부 도구, 에이전트 워크플로우 또는 주요 기능을 구현하기 전에 수요, 포지셔닝, 수익화, 유지, 신뢰, 배포 및 채택 리스크를 확인할 수 있습니다.

before-you-build란 무엇인가요?

이 스킬은 실제 개발에 돌입하기 전에 제품 또는 기능 아이디어에 대한 간결한 사전 사망 진단(pre-mortem)을 수행하도록 설계되었습니다. 주요 목표는 개발을 막는 것이 아니라 가장 위험한 가정, 가장 작은 검증 단계, 그리고 증거가 확보될 때까지 연기해야 할 빌드 범위를 식별하는 것입니다. 이 스킬은 랜딩 페이지, MVP, SaaS 앱, 마켓플레이스, 콘텐츠 사이트, 에이전트 워크플로우, 내부 도구와 같은 새로운 제품 구축부터 명확하지 않은 채택, 수익, 유지, 신뢰 또는 배포 영향을 가진 주요 기능에 이르기까지 다양한 시나리오에 적용됩니다. 리스크 체크리스트를 통해 수요, 포지셔닝, 수익화, 유지, 신뢰, 배포 및 기능 채택의 7가지 핵심 영역을 평가하고, 결과를 바탕으로 리스크 평결, 주요 가정, 찾아야 할 증거, 다음 단계 및 연기할 항목을 결정 지향적인 형식으로 제공합니다. Claude Code, Cursor, Codex 등 모든 AI 기반 코딩 도구에서 사용할 수 있으며, 특히 빠른 아이디어 검증이 중요한 초기 단계의 빌더에게 유용합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

구축하기 전에 (Before You Build)

구현 전에 간결한 사전 사망 진단(pre-mortem)을 실행합니다. 목표는 구축을 막는 것이 아니라, 가장 위험한 가정, 가장 작은 검증 단계, 그리고 증거가 개선될 때까지 연기해야 할 빌드 범위를 식별하는 것입니다.

사용 시기

사용자가 다음을 구축하거나 출시하려고 할 때 이 스킬을 사용하세요:

  • 새로운 제품, MVP, 프로토타입, 랜딩 페이지, SaaS 앱, 마켓플레이스, 콘텐츠 사이트, 에이전트 워크플로우 또는 내부 도구
  • 채택, 수익, 유지, 신뢰 또는 배포 영향이 명확하지 않은 주요 기능
  • 약한 포지셔닝으로 인해 개발 또는 홍보 노력이 낭비될 수 있는 공개 출시 자산

작업이 좁은 범위의 구현 수정, 리팩터링, 테스트 수리, 의존성 업데이트 또는 명확한 승인 기준이 있는 이미 검증된 변경인 경우 이 스킬을 건너뛰세요.

리스크 체크리스트

다음 리스크에 걸쳐 아이디어를 검토하세요:

  • 수요: 특정 구매자나 사용자가 이 기능을 긴급하게 원한다는 증거가 있습니까?
  • 포지셔닝: 대상 사용자가 한 문장으로 그것이 무엇인지, 왜 중요한지 이해할 수 있습니까?
  • 수익화: 지불, 예산 또는 전략적 가치에 대한 신뢰할 수 있는 경로가 있습니까?
  • 유지: 사용자가 첫 번째 시도 후에 다시 돌아올 이유가 있습니까?
  • 신뢰: 제품이 사용자가 거부할 수 있는 신뢰성, 데이터 액세스, 통합 또는 행동 변화를 요구합니까?
  • 배포: 대상 사용자에게 도달할 수 있는 반복 가능한 방법이 있습니까?
  • 기능 채택: 기능 작업의 경우, 기능이 사용자 행동을 변화시킬 것입니까, 아니면 단지 표면적만 추가할 것입니까?

결론이 명확하지 않은 경우, 더 깊은 질문을 위해 references/risk-checklist.md를 사용하세요.

출력 형식

응답을 짧고 결정 지향적으로 유지하세요:

  1. 리스크 평결: 낮음, 중간 또는 높음 리스크와 그 이유를 한 문장으로 설명합니다.
  2. 주요 가정: 프로젝트를 망가뜨릴 가능성이 가장 높은 단일 가정입니다.
  3. 먼저 찾아야 할 증거: 더 많이 구축하기 전에 가장 작은 유용한 신호입니다.
  4. 다음 단계: 하나의 구체적인 검증 단계 또는 축소된 빌드 범위입니다.
  5. 연기: 아직 구축하지 말아야 할 항목입니다.

지침

  • 약한 증거에 대해 직접적으로 말하되, 사용자의 아이디어를 무시하지 마십시오.
  • 큰 연구 계획보다는 더 작은 검증 단계를 선호하십시오.
  • 제품 리스크와 엔지니어링 난이도를 분리하십시오.
  • 아이디어가 이미 검증된 경우, 어떤 증거가 리스크를 낮추는지 말하고 가장 작은 구현 조각을 제안하십시오.
  • 사실이 누락된 경우, 시장 주장을 만들어내지 말고 누락된 증거의 이름을 명시하십시오.

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.

관련 스킬