feat: ADHD対応プロジェクト管理システムの設計

- README.mdにシステム概要を追加 - PROJECT_MANAGEMENT_DETAIL.mdに詳細設計書を作成 - GitHub Projects + issueベースの管理方針を策定 - AIを活用した優先度提案システムの設計を含む
2025-07-29 11:37:11 +09:00 · 2025-07-29 11:37:11 +09:00 · 9b40f789c8
commit 9b40f789c8
parent 07340e2ca1
2 changed files with 375 additions and 1 deletions
--- a/PROJECT_MANAGEMENT_DETAIL.md
+++ b/PROJECT_MANAGEMENT_DETAIL.md
@ -0,0 +1,279 @@
+# ADHD対応プロジェクト管理システム 詳細設計書
+
+## 1. 背景と課題
+
+### 現在の問題
+- **ADHD特性による課題**
+  - すぐに興味を持つが飽きやすい
+  - かなりの忘れっぽさ
+  - 中長期プロジェクトを完遂できない
+  - 10個程度のプロジェクトを同時進行している
+
+- **環境的な制約**
+  - PCとスマホを併用（リアルタイム同期が必要）
+  - 開発作業が中心（GitHubとの親和性重要）
+  - 既存ツールとの連携（Cursor, Claude Code CLI等）
+
+## 2. システムの目的
+
+### 主目的
+**ADHDの特性を前提とした、中長期プロジェクトの完遂支援システム**
+
+### 具体的な達成目標
+1. どのプロジェクトも忘れずに進捗を管理できる
+2. その日の気分で取り組むプロジェクトを選べる
+3. 期日を守れるようになる
+4. 小さな達成を積み重ねてモチベーション維持
+
+## 3. システム設計思想
+
+### 基本原則
+1. **記憶に頼らない**
+   - 全てを外部化（GitHub issue）
+   - 検索可能な形で保存
+
+2. **認知負荷を最小化**
+   - 1画面で全体把握
+   - 選択肢を3つに絞る
+
+3. **柔軟性を持たせる**
+   - 興味の波に乗れる
+   - 無理な計画を立てない
+
+4. **自動化を最大活用**
+   - 手動作業を減らす
+   - リマインダーで忘れ防止
+
+## 4. システム構成
+
+### 4.1 基盤
+- **GitHub Projects（個人アカウント版）**
+  - 全プロジェクトを横断する統合ダッシュボード
+  - issueベースのタスク管理
+
+### 4.2 データ構造
+
+#### Issue（タスク）の構成
+```markdown
+タイトル: [プロジェクト名] 具体的なタスク内容
+本文:
+- 詳細な説明
+- 受け入れ条件
+- 参考リンク
+
+メタデータ:
+- Labels: task, bug, feature, urgent等
+- Milestone: スプリント or リリース
+- Assignees: 自分
+```
+
+#### カスタムフィールド
+| フィールド名 | 型 | 用途 | 例 |
+|------------|---|------|---|
+| 期日 | Date | タスクの締切日 | 2024-02-01 |
+| 優先度 | Single Select | 重要度の3段階評価 | 高/中/低 |
+| 進捗率 | Number | 完了度合い（%） | 0-100 |
+| プロジェクト | Single Select | 所属プロジェクト | project-A |
+| 見積時間 | Number | 予想作業時間 | 3（時間） |
+| 実績時間 | Number | 実際の作業時間 | 2.5（時間） |
+| 最終更新 | Date | 最後に触った日 | 自動更新 |
+| 次のアクション | Text | 次に何をすべきか | APIエンドポイント実装 |
+| ブロッカー | Text | 進行を妨げている要因 | 仕様未確定 |
+
+### 4.3 ビュー設計
+
+#### 1. デイリービュー（メイン画面）
+```
+フィルター: 
+- 期日 <= 今日 + 3日 
+- ステータス != 完了
+- 優先度でソート
+
+表示項目:
+- タスク名
+- プロジェクト（色分け）
+- 期日（残り日数表示）
+- 進捗バー
+```
+
+#### 2. プロジェクト別ビュー
+```
+グループ化: プロジェクト名
+表示: カンバン形式
+列: Todo → 進行中 → レビュー → 完了
+```
+
+#### 3. 期限管理ビュー
+```
+表示: カレンダー or タイムライン
+色分け:
+- 赤: 期限切れ
+- 橙: 3日以内
+- 黄: 1週間以内
+- 緑: 余裕あり
+```
+
+#### 4. 放置アラートビュー
+```
+フィルター: 最終更新 > 7日前
+ソート: 最終更新日（古い順）
+ハイライト: 1ヶ月以上放置
+```
+
+## 5. 運用フロー
+
+### 5.1 日次サイクル
+
+#### 朝のルーティン（5-10分）
+```bash
+# 1. Claude Codeで今日のタスク提案を受ける
+claude code "GitHub Projectから今日やるべき3つのタスクを提案して"
+
+# 2. 提案を確認し、やる気の出るものを選ぶ
+# 3. 選んだタスクのステータスを「進行中」に変更
+```
+
+#### 作業中
+```bash
+# タスク開始時
+- issueに「作業開始」コメント
+- 必要ならサブタスクをチェックリストで追加
+
+# 進捗があったら
+- issueにコメントで記録
+- 進捗率を更新（10%単位でOK）
+
+# 詰まったら
+- ブロッカーフィールドに記入
+- 別のタスクに切り替え
+```
+
+#### 夜の振り返り（3-5分）
+```bash
+# 1. 完了したタスクをクローズ
+gh issue close ISSUE_NUMBER
+
+# 2. 進捗率の更新
+# 3. 明日の準備（気になるタスクにコメント）
+```
+
+### 5.2 週次レビュー
+- 完了タスク数の確認（達成感）
+- 放置プロジェクトの棚卸し
+- 優先度の見直し
+
+## 6. 自動化設計
+
+### 6.1 GitHub Actions
+
+#### 期日アラート（deadline-alert.yml）
+```yaml
+name: 期日アラート
+on:
+  schedule:
+    - cron: '0 9 * * *'  # 毎朝9時
+
+jobs:
+  check-deadlines:
+    steps:
+      - 3日前: Discordに通知
+      - 1日前: Discord + メール
+      - 当日: 全チャンネルに緊急通知
+      - 期限切れ: 優先度を「高」に自動変更
+```
+
+#### 放置アラート（stale-check.yml）
+```yaml
+name: 放置プロジェクトチェック
+on:
+  schedule:
+    - cron: '0 10 * * MON'  # 毎週月曜10時
+
+jobs:
+  find-stale:
+    steps:
+      - 7日放置: ラベル「attention」追加
+      - 14日放置: 優先度アップ
+      - 30日放置: 特別レポート作成
+```
+
+### 6.2 Claude Code統合
+
+#### 朝の提案スクリプト
+```javascript
+// 優先度スコア計算
+score = (期日の近さ × 10) + (放置日数 × 5) + (優先度 × 3)
+
+// 興味の波を考慮
+- 昨日触ったプロジェクトの関連タスクを優先
+- 完了しやすい小タスクを1つ含める
+- バラエティを持たせる（3つ別プロジェクト）
+```
+
+## 7. スマホ連携
+
+### GitHub公式アプリ
+- Projectビューの確認
+- issueへのコメント追加
+- ステータス変更
+
+### ショートカット設定
+```bash
+# Termuxでの設定例
+alias today="gh issue list --label today"
+alias add="gh issue create"
+alias done="gh issue close"
+```
+
+## 8. 成功指標（KPI）
+
+### 定量指標
+- 週間タスク完了数
+- プロジェクト別の進捗率
+- 平均放置日数の減少
+- 期限遵守率
+
+### 定性指標
+- 「何をすべきか」で迷う時間の減少
+- プロジェクトの忘れ防止
+- 達成感の増加
+
+## 9. 段階的導入計画
+
+### Phase 1: 基本構築（1週目）
+1. GitHub Project作成
+2. カスタムフィールド設定
+3. 既存タスク10個を登録
+4. 日次ルーティン開始
+
+### Phase 2: 自動化（2-3週目）
+1. GitHub Actions設定
+2. 通知連携
+3. Claude Code統合
+
+### Phase 3: 最適化（4週目以降）
+1. ビューの調整
+2. ルールの見直し
+3. 新機能追加
+
+## 10. トラブルシューティング
+
+### よくある問題と対策
+| 問題 | 原因 | 対策 |
+|-----|------|------|
+| issue作成を忘れる | 習慣化されていない | スマホにリマインダー設定 |
+| 優先度が分からない | 基準が曖昧 | 期日ベースで機械的に決定 |
+| 進捗更新が面倒 | 粒度が細かすぎる | 10%単位でOKにする |
+| モチベーション低下 | 成果が見えない | 完了数をグラフ化 |
+
+## 11. 将来の拡張案
+
+### 短期的改善
+- 音声入力でのissue作成
+- 週次レポートの自動生成
+- Slackボット統合
+
+### 長期的ビジョン
+- AI による作業時間予測
+- 自動スケジューリング
+- チーム協業機能
--- a/README.md
+++ b/README.md
@ -1 +1,96 @@
 # raphael-wisdom-lord
+
+# ADHD対応プロジェクト管理システム
+
+## 概要
+ADHDの特性（飽き性、忘れっぽさ）に対応した、GitHub Projects + AI を活用したプロジェクト管理システム。
+10個程度の中長期プロジェクトを同時進行で管理することを想定。
+
+## システム構成
+
+### 基本方針
+- **GitHub Projects（個人アカウント）** で全プロジェクトを一元管理
+- 各プロジェクトのタスクは全て **issue** で管理
+- AI（Claude Code）と GitHub Actions で自動化
+
+### 主な機能
+1. **一元管理ダッシュボード**
+   - 全プロジェクトのissueを1つのProjectボードに集約
+   - 期日、優先度、進捗率をカスタムフィールドで管理
+
+2. **AI優先度提案**
+   - 毎朝Claude Codeが「今日やるべき3つ」を提案
+   - 期日、放置日数、進捗を総合的に分析
+
+3. **期日アラート**
+   - 3日前：🟡 軽い通知
+   - 1日前：🟠 強めの通知
+   - 当日：🔴 緊急アラート
+
+## セットアップ手順
+
+### 1. GitHub Project作成
+```bash
+# GitHub.comで
+自分のアイコン → Your projects → New project
+テンプレート: "Team planning"
+```
+
+### 2. カスタムフィールド追加
+- 📅 期日（Date型）
+- 🎯 優先度（Single select: 高/中/低）
+- 📊 進捗率（Number型: 0-100）
+- 📱 プロジェクト名（Single select）
+
+### 3. issueテンプレート作成
+各プロジェクトに以下を追加：
+```markdown
+# .github/ISSUE_TEMPLATE/task.md
+---
+name: タスク
+about: やることを記録
+labels: task
+---
+## やること
+<!-- 1行で書く -->
+
+## 期日
+<!-- YYYY-MM-DD -->
+```
+
+## 日次運用フロー
+
+### 朝（5分）
+```bash
+# Claude Codeで優先度提案
+claude code "GitHubプロジェクトから今日やる3つを提案"
+
+# GitHub CLIでissue作成
+gh issue create --title "タスク名" --project PROJECT_NUMBER
+```
+
+### 作業中
+- issueにコメントで進捗記録
+- 完了したらissueをclose
+
+### 夜（3分）
+- Projectボードで進捗率更新
+- 明日の予定を確認
+
+## 使用ツール
+- GitHub Projects
+- GitHub CLI
+- Claude Code CLI
+- GitHub Actions（自動化用）
+- Discord/Slack（通知用）
+
+## Tips
+- issueは思いついた瞬間に作成（スマホからでもOK）
+- 1日1個でも進捗があればOK
+- 興味の波に乗って、その日やりたいプロジェクトから着手
+
+## 今後の拡張案
+- [ ] GitHub Actions での自動優先度計算
+- [ ] 進捗の可視化（草グラフ的な）
+- [ ] 音声入力でのissue作成
+- [ ] 週次レポートの自動生成