feat: ADHD対応プロジェクト管理システムの設計
- README.mdにシステム概要を追加 - PROJECT_MANAGEMENT_DETAIL.mdに詳細設計書を作成 - GitHub Projects + issueベースの管理方針を策定 - AIを活用した優先度提案システムの設計を含む
This commit is contained in:
parent
07340e2ca1
commit
9b40f789c8
2 changed files with 375 additions and 1 deletions
279
PROJECT_MANAGEMENT_DETAIL.md
Normal file
279
PROJECT_MANAGEMENT_DETAIL.md
Normal file
|
|
@ -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 による作業時間予測
|
||||||
|
- 自動スケジューリング
|
||||||
|
- チーム協業機能
|
||||||
97
README.md
97
README.md
|
|
@ -1 +1,96 @@
|
||||||
# raphael-wisdom-lord
|
# 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作成
|
||||||
|
- [ ] 週次レポートの自動生成
|
||||||
Loading…
Add table
Add a link
Reference in a new issue