Communitygithub.com

wshobson/before-you-build

プロダクトや機能の構築前に、需要、ポジショニング、収益化、定着率、信頼、流通、採用リスクを評価するためのプリモーテムレビュースキルです。ファウンダー、プロダクトマネージャー、AI支援ビルダー向けに設計されています。

before-you-build とは?

このスキルは、新製品、MVP、ランディングページ、SaaSアプリ、エージェントワークフロー、内部ツールなど、構築を開始する前に「プリモーテム」(事前検死)レビューを実行するためのものです。プロダクトリスクを体系的に評価し、最も重要な仮定を特定し、最小限の検証ステップを提案します。開発リソースを無駄にしないために「何を今すぐ構築すべきか」「何を延期すべきか」を明確にします。対応プラットフォームは、Claude Code、Cursor、Codex、Windsurf、Gemini Code Assistなど、AIエージェントまたはアシスタントがSKILL.mdを参照できる環境全般です。CLIコマンドやファイルパス、コードブロックは翻訳せず、日本語の説明文にのみ翻訳を施します。

対応~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

実装前にコンパクトなプリモーテム(事前検死)を実行します。目的は構築を妨げることではなく、最もリスクの高い仮定、最小の検証ステップ、および証拠が改善されるまで延期すべき構築範囲を特定することです。

使用タイミング

以下のような構築やリリースを求められた場合にこのスキルを使用します。

  • 新製品、MVP、プロトタイプ、ランディングページ、SaaSアプリ、マーケットプレイス、コンテンツサイト、エージェントワークフロー、または内部ツール
  • 採用、収益、定着率、信頼、または流通への影響が不明確な主要機能
  • 弱いポジショニングにより開発やプロモーションの努力が無駄になる可能性がある公開ローンチアセット

以下の場合はこのスキルをスキップします。タスクが狭い実装の修正、リファクタリング、テスト修復、依存関係の更新、または明確な受け入れ基準を持つ既に検証済みの変更である場合。

リスクチェックリスト

以下のリスクにわたってアイデアをレビューします。

  • 需要: 特定の購入者またはユーザーがこれを緊急に欲しているという証拠はありますか?
  • ポジショニング: ターゲットユーザーは、それが何であり、なぜ重要なのかを1文で理解できますか?
  • 収益化: 支払い、予算、または戦略的価値への信頼できる経路はありますか?
  • 定着率: ユーザーが初回利用後に戻ってくる理由はありますか?
  • 信頼: 製品が、ユーザーが抵抗する可能性のある信頼性、データアクセス、統合、または行動変容を必要としていますか?
  • 流通: ターゲットユーザーにリーチするための再現可能な方法はありますか?
  • 機能採用: 機能開発の場合、その機能はユーザーの行動を変えるのでしょうか、それとも単に表面積を増やすだけでしょうか?

判定が明確でない場合は、references/risk-checklist.md を使用してより深い質問を参照してください。

出力形式

回答は簡潔で決定指向に保ちます。

  1. リスク判定: 低、中、または高リスク。理由を1文で説明します。
  2. 主要仮定: プロジェクトを壊す可能性が最も高い単一の仮定。
  3. 最初に見つけるべき証拠: さらに構築する前に得るべき最小の有用なシグナル。
  4. 次にやること: 具体的な検証ステップ1つ、または構築範囲の縮小。
  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.

関連スキル