idea-coach

# Idea Coach > Your critical sparring partner for ideas, problems, and challenges — now with GitHub integration! ## What It Does Idea Coach helps you: - **Capture** ideas, problems, and challenges as they come - **Categorize** by type, domain, energy, urgency, and importance - **Review** periodically (daily → quarterly based on importance) - **Ship** ideas to GitHub repos when ready - **Track** progress and know when to let go ## Philosophy **Be critical, not just supportive.** Idea Coach will: - Suggest dropping ideas that aren't worth pursuing - Ask hard questions during reviews - Track which ideas actually ship vs. rot forever ## Commands ### Core Commands | Command | Description | |---------|-------------| | `/idea <text>` | Capture a new idea | | `/idea_list` | List active ideas | | `/idea_list --due` | Show ideas due for review | | `/idea_get <id>` | Get idea details | | `/idea_update <id>` | Update idea attributes | | `/idea_review <id>` | Add review interaction | | `/idea_drop <id>` | Mark as dropped (requires reason) | | `/idea_done <id>` | Mark as completed | | `/idea_stats` | Show statistics | ### GitHub Commands | Command | Description | |---------|-------------| | `/idea_link <id> <owner/repo>` | Link to existing repo | | `/idea_ship <id>` | Create new repo for idea | | `/idea_ship <id> --public` | Create public repo | | `/idea_repo <id>` | Show linked repo status | | `/idea_sync <id>` | Create/update GitHub issue | ## Attributes ### Types - 💡 **idea** — Something to build or create - 🔧 **problem** — Something to fix or solve - 🎯 **challenge** — Something to overcome ### Status Flow ``` captured → exploring → developing → shipped/done ↓ ↓ parked blocked ↓ dropped ``` ### Importance → Review Cycle | Importance | Energy | Review Cycle | |------------|--------|--------------| | critical | high | daily | | critical | * | weekly | | important | high | weekly | | important | * | biweekly | | nice-to-have | * | monthly | | parked | * | quarterly | ## GitHub Integration ### Prerequisites - `gh` CLI installed and authenticated - Run `gh auth login` if not set up ### Workflow Example ``` # 1. Capture idea /idea "Build a CLI for task management" # 2. Develop it /idea_update abc123 --status developing # 3. Ship it to GitHub /idea_ship abc123 # 4. Or link to existing repo /idea_link abc123 moinsen-dev/my-cli # 5. Check repo status /idea_repo abc123 # 6. Sync as GitHub issue /idea_sync abc123 ``` ## CLI Usage ```bash # Add idea python scripts/coach.py add "Build something cool" --type idea --importance important # List ideas python scripts/coach.py list python scripts/coach.py list --due python scripts/coach.py list --github # Only with linked repos # GitHub operations python scripts/coach.py link <id> owner/repo python scripts/coach.py ship <id> --owner moinsen-dev python scripts/coach.py repo-status <id> python scripts/coach.py sync-issue <id> --labels enhancement,idea ``` ## Data Storage Ideas are stored in `~/.openclaw/idea-coach/ideas.json` Each idea tracks: - Basic info (title, description, type, domain) - Status and progress - Energy, urgency, importance - Review schedule and history - **GitHub integration** (repo, issue, sync timestamps) - Interaction log ## Tips 1. **Capture quickly** — Don't overthink the initial capture 2. **Review honestly** — Use reviews to kill stale ideas 3. **Ship early** — Create a repo as soon as an idea has momentum 4. **Sync issues** — Use GitHub issues for detailed tracking 5. **Drop freely** — A dropped idea is a decision, not a failure