auto-project-management/README.md

Claude Code対話型Ganttチャート自動生成システム

Claude Codeとの対話でプロジェクトを設計し、JSONファイルを自動生成して、Google Apps Scriptでスプレッドシートに美しいGanttチャートを自動作成するシステムです。

📋 目次

• 機能概要
• システム構成
• セットアップ
• 使い方
• データ仕様
• GAS統合
• トラブルシューティング

---

🎯 機能概要

Phase 1: Claude Code側（このリポジトリ）

• 対話型プロジェクト設計: /gantt スラッシュコマンドで段階的にプロジェクト情報を入力
• JSON自動生成: プロジェクト基本情報とタスク一覧を構造化JSONで出力
• 対話履歴保存: プロジェクト作成プロセスをMarkdown形式で記録
• Google Driveアップロード: 生成したJSONファイルを自動アップロード

Phase 2: GAS側（✅ 実装完了）

• 自動Ganttチャート生成: JSONファイルからスプレッドシートに視覚的なGanttチャートを作成
• 4シート構成: プロジェクト一覧、全プロジェクトタスク、期日切れタスク、Todoistタスク、個別Ganttチャート
• タスク管理機能: 進捗率、依存関係、担当者、優先度の管理
• Todoist統合: TodoistのInboxタスクを自動同期してスプレッドシートで一元管理
• 期日切れタスク通知: 期日を過ぎたタスクを自動検出してDiscord通知
• Discord通知: 成功/エラー通知をDiscordに自動送信

---

🏗️ システム構成

185-automatic-gantt-chart-creation/
├── .claude/
│   └── commands/
│       └── gantt.md            # /gantt スラッシュコマンド定義
├── src/
│   └── gantt-helper.ts         # ヘルパースクリプト（状態管理・JSON生成・Discord通知）
├── gas/                         # Google Apps Script ファイル ✨ NEW
│   ├── Config.gs               # 設定管理（スプレッドシートID、Discord、色設定）
│   ├── SheetManager.gs         # シート操作（作成、更新、データ投入）
│   ├── GanttRenderer.gs        # Ganttチャート描画（バー、ヘッダー、スタイル）
│   ├── Code.gs                 # メインスクリプト（実行エントリーポイント）
│   └── README.md               # GAS導入手順・使い方
├── outputs/                     # JSONファイル保存先
├── docs/                        # 対話履歴ファイル保存先
├── package.json                 # 依存関係
├── tsconfig.json                # TypeScript設定
├── .env.example                 # 環境変数テンプレート
├── .gitignore
└── README.md

---

🚀 クイックスタート

初めての方: 詳細なセットアップ手順は INSTALL.md をご覧ください。

3ステップでスタート

ステップ1: 依存関係のインストール

npm install
npm run build

ステップ2: 環境変数の設定

cp .env.example .env
# .envファイルを編集してGoogle Drive設定を追加

最小限の設定項目:

GOOGLE_DRIVE_FOLDER_ID=your_folder_id_here
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here

📝 詳細: Google Cloud設定、OAuth認証の完全ガイドは INSTALL.md を参照

ステップ3: 初回認証とGantt作成

# Google認証（初回のみ）
npm run gantt:auth

# Claude Codeでプロジェクト作成
claude code
> /gantt

# JSONファイル生成・アップロード
npm run gantt:save

📝 GAS連携: スプレッドシート連携とトリガー設定は INSTALL.md を参照

---

📖 使い方

基本ワークフロー

1. Claude Codeで対話形式で作成

claude code
> /gantt

システムが段階的に質問します：

• プロジェクト基本情報（ID、名前、目的、期限）
• タスク設計（タスク名、日程、担当者、依存関係）

2. JSONファイル生成

対話完了後、「完了」と入力してから：

npm run gantt:save

これで以下が自動生成されます：

• outputs/{プロジェクトID}_{プロジェクト名}.json
• docs/{プロジェクトID}_{プロジェクト名}.md（対話履歴）

3. Ganttチャート自動生成

Google Driveにアップロード後、1分以内に自動的にスプレッドシートが更新されます。

📝 詳細: GASトリガー設定、手動実行方法は INSTALL.md を参照

---

📊 データ仕様

プロジェクトJSON形式

{
  "project_id": "PRJ001",
  "project_name": "新規ECサイト開発",
  "project_purpose": "個人事業",
  "project_type": "開発",
  "project_deadline": "2025-06-30",
  "tasks": [
    {
      "task_id": "T001",
      "task_name": "要件定義",
      "start_date": "2025-01-01",
      "end_date": "2025-01-15",
      "assignee": "山田太郎",
      "dependencies": [],
      "progress": 0,
      "priority": "★★★★★",
      "parent_task_id": null,
      "tags": ["企画・計画"],
      "estimated_hours": 40,
      "is_milestone": false
    }
  ]
}

タスクフィールド詳細

フィールド	型	説明	例
task_id	string	タスクID（自動採番）	T001, T002
task_name	string	タスク名	要件定義
start_date	string	開始日（YYYY-MM-DD）	2025-01-01
end_date	string	終了日（YYYY-MM-DD）	2025-01-15
assignee	string	担当者（フリーテキスト）	山田太郎
dependencies	array	依存タスクID配列	["T001", "T002"]
progress	number	進捗率（0-100）	50
priority	string	優先度（6段階★）	★★★★★
parent_task_id	string|null	親タスクID	T001 or null
tags	array	タグ配列	["企画・計画", "技術"]
estimated_hours	number	見積工数（時間）	40
is_milestone	boolean	マイルストーンフラグ	true or false

優先度（6段階）

• ★★★★★ - 最重要
• ★★★★☆ - 重要
• ★★★☆☆ - 中
• ★★☆☆☆ - 普通
• ★☆☆☆☆ - 低
• ☆☆☆☆☆ - 最低

タグ分類（10種類）

タグ名	色	説明
企画・計画	青	プロジェクト企画、要件定義
設計	緑	システム設計、UI/UX設計
開発・実装	黄	プログラミング、コーディング
テスト・検証	橙	テスト、品質保証
リリース・デプロイ	赤	リリース作業、デプロイ
運用・保守	紫	運用、保守、監視
マーケティング	ピンク	広告、プロモーション
営業・商談	水色	営業活動、商談
事務・管理	グレー	事務作業、管理業務
その他	白	上記以外

---

🔗 GAS統合

生成される5つのシート

1. プロジェクト一覧: 全プロジェクトのサマリー（ステータス、進捗率）
2. 全プロジェクトタスク: タスクを一元管理、自動同期
3. 期日切れタスク: 遅延タスクの自動抽出、Discord通知連携
4. Todoistタスク（オプション）: Inbox自動同期、優先度色分け
5. 個別Ganttチャート: プロジェクトごとのタイムライン可視化

自動処理の仕組み

GAS側の時間トリガー（1分間隔）がGoogle Driveフォルダを監視し、新しいJSONファイルを自動処理します。

📝 詳細: GAS導入手順、clasp自動デプロイ、トリガー設定は INSTALL.md および gas/README.md を参照

---

🛠️ よくある質問

Q1. JSONファイルが生成されない

A: npm run build → npm run gantt:save を実行してください。

Q2. Google認証エラーが発生する

A: .envファイルのクライアントID/シークレット、リダイレクトURIを確認してください。

Q3. Ganttチャートが自動生成されない

A: GAS側の時間トリガー設定とConfig.gsのフォルダIDを確認してください。

📝 詳しいトラブルシューティング: INSTALL.md を参照

---

📝 ライセンス

MIT License

---

🙏 貢献

プルリクエストを歓迎します！バグ報告や機能要望はIssuesでお願いします。

---

📞 サポート

質問・問題がある場合は、Issuesでお問い合わせください。