business-problem-to-blueprint

ビジネス課題からソフトウェア設計図へ

退屈なB2Bのビジネス課題を、実際に構築できる完全なソフトウェアソリューションの設計図へと変換します。

このスキルでできること

ビジネス課題を説明すると（例：「ジムでパーソナルトレーナー、スケジュール、クライアントのチェックインを管理する必要がある」）、このスキルは以下を含む完全な CLAUDE.md ファイルを生成します。

✅ ソフトウェアアーキテクチャ - システムのハイレベルな設計
✅ データベーススキーマ - テーブル、関連、データ構造
✅ 機能の内訳 - MVP、フェーズ2、フェーズ3に分けて整理
✅ 技術スタックの推奨 - この課題に最適なテクノロジー
✅ 段階的な実装計画 - Claude Code 向けの順序立てたタスク
✅ 開発時間の見積もり - 現実的なスケジュールの目安
✅ デプロイ戦略 - ソフトウェアの公開とホスティング方法

対象者

以下のようなSoftware Tailors向けです。

• クライアントの課題を技術仕様に落とし込む必要がある方
• 開発者でなくても、プロフェッショナルなプロジェクト計画を作成したい方
• Claude Code に明確で構造化された指示を与えたい方
• プロジェクトの範囲と複雑さを見積もりたい方
• 技術に詳しくないクライアントに技術的なソリューションを提案したい方

このスキルの使い方

入力形式

ビジネス課題を平易な英語で説明します。

入力例：

Business: Fire inspection company
Problem: They manage 200+ inspections per month using Excel spreadsheets and paper forms. Inspectors waste 2 hours per day on paperwork. Office staff can't track which buildings are due for re-inspection. Clients call constantly asking for reports.

Key Requirements:
- Schedule and assign inspections to field inspectors
- Mobile app for inspectors to complete reports on-site
- Automatic reminders for upcoming inspections
- Generate PDF reports for clients
- Dashboard showing inspection status

出力形式

このスキルは、以下のような構成の完全な CLAUDE.md ファイルを生成します。

# [Project Name] - Software Blueprint

## Project Overview
[Clear description of what you're building and why]

## Target Users
[Who will use this software]

## Core Problem Being Solved
[The specific pain points this addresses]

## Software Architecture

### System Components
1. **Frontend Application**
   - User interface for office staff
   - Mobile app for field workers

2. **Backend API**
   - Business logic and data management
   - Authentication and permissions

3. **Database**
   - Data storage and relationships

4. **Integrations**
   - Third-party services needed

### Tech Stack Recommendation
- **Frontend:** [Technology + why it's best for this project]
- **Backend:** [Technology + why]
- **Database:** [Technology + why]
- **Hosting:** [Platform + why]
- **Mobile:** [Approach + why]

## Database Schema

### Tables and Relationships

**inspections**
- id (primary key)
- building_id (foreign key → buildings)
- inspector_id (foreign key → users)
- scheduled_date
- status (scheduled, in_progress, completed)
- due_date
- created_at

**buildings**
- id (primary key)
- name
- address
- client_id (foreign key → clients)
- inspection_frequency (monthly, quarterly, annual)
- last_inspection_date
- next_inspection_due

[... complete schema with all tables]

### Relationships
- One building → Many inspections
- One inspector → Many inspections
- One client → Many buildings

## Feature Breakdown

### MVP Features (Phase 1) - Must-Have for Launch
**Estimated Build Time: 40-60 hours**

1. **User Authentication & Roles**
   - Admin login
   - Inspector login
   - Role-based permissions

2. **Building Management**
   - Add/edit/delete buildings
   - Store client information
   - Set inspection frequency

3. **Inspection Scheduling**
   - Create new inspections
   - Assign to inspectors
   - View upcoming inspections

4. **Basic Inspection Form**
   - Mobile-friendly checklist
   - Pass/fail items
   - Photo upload
   - Notes field

5. **Simple Dashboard**
   - Today's inspections
   - Overdue inspections
   - Inspector availability

### Phase 2 Features - Enhanced Functionality
**Estimated Build Time: 20-30 hours**

1. **PDF Report Generation**
   - Branded inspection reports
   - Photo attachments
   - Digital signatures

2. **Automated Reminders**
   - Email notifications for upcoming inspections
   - SMS alerts for inspectors
   - Client notification when inspection complete

3. **Advanced Dashboard**
   - Analytics and metrics
   - Revenue tracking
   - Inspector performance

### Phase 3 Features - Nice-to-Haves
**Estimated Build Time: 15-20 hours**

1. **Client Portal**
   - Clients can view their inspection history
   - Download past reports
   - Request new inspections

2. **Route Optimization**
   - Suggest efficient inspection routes
   - Map view of scheduled inspections

3. **Invoice Generation**
   - Automatic invoicing after inspection
   - Payment tracking

## Step-by-Step Implementation Plan

### Week 1: Foundation Setup
**Tasks for Claude Code:**

1. **Project Initialization**
   - "Set up a Next.js project with TypeScript and Tailwind CSS"
   - "Configure Supabase for database and authentication"
   - "Create basic folder structure: /components, /pages, /lib, /types"

2. **Database Setup**
   - "Create Supabase tables: users, buildings, clients, inspections"
   - "Set up row-level security policies for multi-tenant access"
   - "Create database relationships and foreign keys"

3. **Authentication**
   - "Implement Supabase authentication with email/password"
   - "Create login and signup pages"
   - "Add role-based middleware for admin vs inspector access"

### Week 2: Core Features
**Tasks for Claude Code:**

1. **Building Management**
   - "Create a buildings list page with search and filter"
   - "Build add/edit building form with client assignment"
   - "Implement CRUD operations for buildings"

2. **Inspection Scheduling**
   - "Create inspection scheduling interface"
   - "Build inspector assignment dropdown"
   - "Add calendar view of scheduled inspections"

[... detailed week-by-week breakdown continues]

## Deployment Strategy

### Recommended Hosting
- **Frontend + Backend:** Vercel (seamless Next.js deployment)
- **Database:** Supabase (managed PostgreSQL)
- **File Storage:** Supabase Storage (for photos)
- **Domain:** Client's domain via Vercel custom domains

### Deployment Steps
1. Push code to GitHub repository
2. Connect Vercel to GitHub repo
3. Configure environment variables in Vercel
4. Deploy production build
5. Set up custom domain (client's domain)

### Estimated Costs
- **Hosting:** $20/month (Vercel Pro + Supabase Pro)
- **Domain:** $12/year
- **Total Monthly Cost:** ~$20-25

## Testing & Quality Assurance

### Pre-Launch Checklist
- [ ] All user roles tested (admin, inspector)
- [ ] Mobile responsiveness verified
- [ ] Forms validate correctly
- [ ] Database backups configured
- [ ] Error handling implemented
- [ ] Loading states on all actions
- [ ] Client data secure and isolated

## Handoff to Client

### Training Materials Needed
- Admin user guide (how to add buildings, schedule inspections)
- Inspector user guide (how to complete inspections on mobile)
- Video walkthrough of core features

### Support Plan
- 30-day bug fix guarantee included
- Optional monthly maintenance package ($500-1500/month)

## Project Timeline Summary

**Total Estimated Build Time:** 75-110 hours
- MVP (Phase 1): 40-60 hours → 2-3 weeks
- Phase 2: 20-30 hours → 1-2 weeks
- Phase 3: 15-20 hours → 1 week

**Realistic Client Timeline:** 4-6 weeks from kickoff to launch

## Pricing Recommendation

Based on complexity and value delivered:
- **MVP Only:** $12,000 - $15,000
- **MVP + Phase 2:** $18,000 - $22,000
- **Full Build (All Phases):** $25,000 - $35,000

**Justification:**
- Saves 2 hours/day × 5 inspectors = 50 hours/week saved
- At $30/hour labor cost = $1,500/week saved
- Software pays for itself in 10-15 weeks
- Annual savings: $78,000

## Next Steps

1. **Review this blueprint with client** - Confirm it matches their needs
2. **Prioritize features** - Decide which phase to start with
3. **Sign contract** - Lock in scope and pricing
4. **Begin development** - Use this CLAUDE.md file to guide Claude Code
5. **Weekly check-ins** - Show progress and get feedback

---

**This blueprint is ready to use as your CLAUDE.md project instruction file. Simply copy this into your project and start building with Claude Code.**

ベストプラクティス

設計図を作成する際に

推奨事項：

• ✅ エッジケースについて確認の質問をする
• ✅ 技術的な制約（連携、コンプライアンス）を早い段階で特定する
• ✅ 複雑な機能を、より小さく構築可能な単位に分割する
• ✅ 現実的な所要時間を見積もる
• ✅ リスクを軽減するため、段階的なリリースを提案する
• ✅ モバイル／タブレットの利用パターンを考慮する
• ✅ データセキュリティとプライバシーを考慮する

避けること：

• ❌ ソリューションを過剰に複雑化する
• ❌ 正当な理由なく最先端技術を提案する
• ❌ 専用ハードウェアが必要な機能を約束する
• ❌ 事業拡大に伴うスケーラビリティを無視する
• ❌ ユーザーの役割と権限を忘れる

よくあるビジネス課題のパターン

スケジュール管理と配車：

• フィールドサービス事業（HVAC、配管、検査）
• 医療機関の予約
• 配送ルート管理

在庫・資産管理：

• 建設機器
• レンタル事業
• 倉庫管理

クライアント／プロジェクト管理：

• 代理店やコンサルティング会社
• フリーランサーのワークフロー
• 請負業者の作業管理

フォームのデジタル化：

• 紙のフォームをモバイルでのデータ収集に置き換える
• 点検チェックリスト
• 監査・コンプライアンスレポート

社内ツール：

• 従業員の勤怠管理
• リソース配分
• 承認ワークフロー

出力品質基準

すべての設計図に、以下を含める必要があります。

• ✅ 明確な課題の説明
• ✅ 完全なデータベーススキーマ
• ✅ 所要時間の見積もりを含む、段階的な機能の内訳
• ✅ 根拠を示した具体的な技術スタック
• ✅ 段階的な実装計画
• ✅ 現実的な価格設定の提案
• ✅ クライアントへの説明に使えるROIの計算

開発ワークフローとの連携

この設計図は、実際の開発に使うCLAUDE.md ファイルになります。

1. 設計図を CLAUDE.md として保存し、プロジェクトのルートに配置します
2. Claude Code を開き、このファイルを参照します
3. 実装計画からタスクをコピーして貼り付けます
4. 設計図に沿って、機能ごとに開発します
5. 進捗に応じて、完了した項目にチェックを付けます

忘れないでください

作成するのは単なる技術仕様ではなく、ソフトウェア製品のビジネスプランです。すべての機能が実際の課題を解決し、測定可能な価値をもたらす必要があります。クライアントに「はい、まさにこれが必要です。15Kドルの価値があります」と言ってもらえる設計図にしましょう。