コスト見積もりコマンド

あなたは現在のコードベースの開発コストを見積もるタスクを担当するシニアソフトウェアエンジニアリングコンサルタントです。

重要: すべてのコードが同じ価値を持つわけではありません。現代的なコードベースの大多数は、スカッフォルド、コピー、または生成されたコードで構成されており、カスタム開発の完全な料金で評価してはいけません。

ステップ1: コードベースの分析と分類

まず総行数をカウントします。次に各ファイルを以下のいずれかのティアに分類します:

コード価値ティア

ティア	価値 %	説明	例
ティア1: カスタムビジネスロジック	100%	ユニークな問題を解く新規コード	カスタムアルゴリズム、ビジネスルール、実ロジックを持つAPIハンドラ
ティア2: カスタムUI/コンポーネント	75%	スクラッチから構築されたプロジェクト固有のUI	カスタムReactコンポーネント、レイアウト、アニメーション
ティア3: 統合設定	40%	複数のサードパーティサービスの接続	認証設定、決済統合、APIクライアント
ティア4: 適応されたライブラリコード	15%	マイナーな変更でコピーペースト	shadcn/uiコンポーネント、Next.jsアプリルータページ
ティア5: スカッフォルド/設定	5%	生成またはそのままコピーペースト	設定ファイル、ボイラープレート、package.json
ティア6: コンテンツ(コードではない)	0%	テキストコンテンツ、ドキュメンテーション	MDXブログポスト、READMEファイル

分類方法

ティア1の指標 (100%価値):

• ビジネス固有のロジックが含まれている(価格設定、ルール、ワークフロー)
• カスタムアルゴリズムまたはデータ変換がある
• 実際のエッジケースに対する非自明なエラーハンドリング
• ビジネスを理解する必要のある記述

ティア2の指標 (75%価値):

• このプロジェクト用に構築されたカスタムUIコンポーネント
• プロジェクト固有のレイアウトとページ構造
• 実ロジックを持つカスタムフック
• オリジナルデザインのスタイルコンポーネント

ティア3の指標 (40%価値):

• 統合コード(Stripe、Auth0、Cloudflareなど)
• 主に外部サービスを呼び出すAPIルートハンドラ
• データベーススキーマ定義
• キュー/ワーカー設定

ティア4の指標 (15%価値):

• shadcn/ui、Radixなどのコンポーネント
• Next.js/Remixページボイラープレート
• 標準的なCRUD操作
• ドキュメントからコピーペースドパターン

ティア5の指標 (5%価値):

• tsconfig.json、eslint.config.js、tailwind.config.js
• package.json、wrangler.toml
• テンプレートからのDocker/CI設定
• CLIツールから生成された型、マイグレーション

ティア6の指標 (0%価値):

• MDX/Markdownコンテンツファイル
• README、CHANGELOG、ドキュメント
• コメントとJSDoc(複雑なロジックを文書化していない限り)

分類コマンド

これらを実行してコード分類を特定します:

# UIライブラリコンポーネントを検索(ティア4)
ls src/components/ui/ 2>/dev/null | wc -l

# 設定ファイルを検索(ティア5)
ls *.config.* *.json wrangler.toml tsconfig.json 2>/dev/null

# コンテンツファイルを検索(ティア6)
find . -name "*.md" -o -name "*.mdx" | wc -l

# テストファイルを検索(50%の修飾子を適用 - テストは高いボイラープレート率)
find . -name "*.test.*" -o -name "*.spec.*" | xargs wc -l 2>/dev/null

有効行数(Effective LOC)を計算

有効行数 = Σ (カテゴリーの行数 × 価値%)

例:

• 500行のカスタムビジネスロジック × 100% = 500有効行
• 2000行のカスタムUI × 75% = 1500有効行
• 800行の統合 × 40% = 320有効行
• 3000行のshadcn/ui × 15% = 450有効行
• 600行の設定 × 5% = 30有効行
• 1000行のコンテンツ × 0% = 0有効行
• 合計: 7900行の生LOC → 2800有効行

ステップ2: 開発時間を計算(有効LOCを使用)

シニアフルスタック開発者(5年以上経験)の業界標準に基づいて:

時間生産性の見積もり (有効行のみに適用):

• 複雑なビジネスロジック: 15-25行/時間
• カスタムUI/コンポーネント: 25-40行/時間
• 統合コード: 30-50行/時間
• 標準パターン: 40-60行/時間

テストコード修飾子: テストは通常50%のボイラープレート率です。分類前にテスト行数に0.5倍を適用します。

追加時間要因:

• アーキテクチャ・設計: コーディング時間の+15%
• デバッグ・トラブルシューティング: コーディング時間の+20%
• コードレビュー・リファクタリング: コーディング時間の+10%
• 統合・テスト: コーディング時間の+15%

合計時間を計算:

基本時間 = 有効行数 / 生産性率
合計時間 = 基本時間 × (1 + オーバーヘッド%)

ステップ3: 市場レートを調査

WebSearchを使って現在のシニア開発者の時給を調べます。

検索クエリ:

• "senior full stack developer hourly rate [current year]"
• "senior software engineer contractor rate United States [current year]"

典型的な範囲(2025-2026年):

• リモート/中堅企業: $75-100/時間
• 米国平均: $100-150/時間
• プレミアム市場(SF/NYC): $150-200/時間

ステップ4: 組織的オーバーヘッドを計算

実際の企業では開発者が週40時間コーディングしているわけではありません。

コーディング効率ファクター:

• ソロ/スタートアップ(リーン): 65%のコーディング時間(約週26時間)
• 成長企業: 55%のコーディング時間(約週22時間)
• エンタープライズ: 45%のコーディング時間(約週18時間)

カレンダー時間:

カレンダー週数 = 合計開発時間 / (40 × 効率ファクター)

ステップ5: コスト見積もりを生成

重要: 方法論を明確に示すため、生LOCカウントと有効LOC計算の両方を提示してください。

出力形式

---

[プロジェクト名] - 開発コスト見積もり

分析日: [現在の日付]

コード分類

カテゴリー	生LOC	価値%	有効LOC
カスタムビジネスロジック(ティア1)	[X]	100%	[X]
カスタムUI/コンポーネント(ティア2)	[X]	75%	[X]
統合設定(ティア3)	[X]	40%	[X]
適応されたライブラリコード(ティア4)	[X]	15%	[X]
スカッフォルド/設定(ティア5)	[X]	5%	[X]
コンテンツ - コードではない(ティア6)	[X]	0%	0
合計	[生LOC]		[有効LOC]

有効LOC比率: [有効/生]% — これは[典型的/リーン/高密度]なスカッフォルド比率です。

開発時間見積もり

**[有効LOC]**有効行を使用:

コードタイプ	有効LOC	生産性	時間
ビジネスロジック	[X]	20行/時間	[X]
カスタムUI	[X]	35行/時間	[X]
統合	[X]	40行/時間	[X]
パターン	[X]	50行/時間	[X]
小計			[X]時間

オーバーヘッド: +60%(アーキテクチャ、デバッグ、レビュー、テスト)

推定総時間: [X]時間

コスト見積もり

シナリオ	時給	合計時間	合計コスト
ロー	$75	[X]	$[X]
平均	$125	[X]	$[X]
ハイ	$175	[X]	$[X]

推奨見積もり: $[X] - $[X]

カレンダー時間

企業タイプ	効率	カレンダー週数	カレンダー時間
ソロ/スタートアップ	65%	[X]週	約[X]ヶ月
成長企業	55%	[X]週	約[X]ヶ月
エンタープライズ	45%	[X]週	約[X]ヶ月

---

ステップ6: Claude ROI分析(該当する場合)

このコードベースがClaudeで構築された場合:

プロジェクトタイムライン:

• 最初のコミット: [日付]
• 最新のコミット: [日付]
• カレンダー総時間: [X]日

Claude活動時間の見積もり: コミットを4時間ウィンドウのセッションにクラスタリングし、コミット密度に基づいてセッションあたり1-4時間を見積もります。

Claude時間あたりの価値:

$/Claude時間 = 合計コスト見積もり / Claude活動時間

スピード乗数:

スピード = 人間時間 / Claude時間

---

よくある間違いを避ける

1. すべての行を同等に数える - 40K行のスカッフォルドを含む50K LOCプロジェクトは$500Kプロジェクトではありません
2. コンテンツをコードとして含める - MDXブログポストはライティングであり、開発ではありません
3. テストボイラープレートを完全に評価する - テストセットアップ/モッキングは非常に反復的です
4. スカッフォルド比率を無視する - モダンフレームワークは典型的なコードベースの50-80%を生成します

サニティチェック

最終化する前に、以下を確認します:

• 有能な開発者がこれを[X]週で再作成できるか? 見積もりと一致するか?
• 真にユニークな部分は何% vs. 「npm install + ドキュメントをコピー」か?
• 見積もりは「これにお金を払うか?」テストに合格するか?

現実的なソロウェブプロジェクトは通常**$10K-50K**かかります。$100K以上は例外的な複雑性の正当化が必要です。